Keyline API documentation version 2.0

https://app.keyline-mis.com/api/v2

API for interacting with Keyline, the modern Print MIS

Authentication

Keyline requires API users to authenticate before they can access any information, and leverages a bearer token based authentication scheme to secure access.

All valid requests to the Keyline API must therefore contain the Authorization header field, which contains a valid API key, prefixed with the string Bearer, so that the header line looks similar to the following:

Authorization: Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e

You can add or revoke access tokens in the Settings > API section of Keyline.

Response Paging

Responses to GET requests that hit index endpoints, such as /api/v2/configuration/customers will at most get back a result set of size 100. If the total size of the desired result set exceeds 100, multiple requests need to be made.

If a response's result set was paged, the response headers contain the following extra headers:

X-Keyline-Result-Page: Gives the page number of the current returned result subset
X-Keyline-Result-Per-Page: Gives the maximum size of the current returned result subset. Is always 100.
X-Keyline-Result-Total: Gives the total number of results across all pages.

If a client wants to fetch a page number different from the first, it must specify the page number as a request header X-Keyline-Requested-Page, where the value is the page to fetch as an integer. The lowest page number is always 1.

Status Codes

The Keyline API uses standardised HTTP response codes the inform the caller about the status of any requests.

These are the most common codes you'll get to see:

200 OK: Everything is okay
201 Created: You just created a new resource
204 No Content: The update or delete operation you just ran was successful
400 Bad request: The request you made is missing required parameters and cannot be executed
401 Unauthorized: You're not allowed to access this resource. Check your access token
404 Not found: You tried to access a resource that doesn't exist
422 Unprocessable Entity: The validation of the resource you wanted to create or change failed. The JSON will contain a detailed error description
500 Internal Server Error: Yikes! This is pretty bad and might be our fault. If you encounter one of these, we are automatically informed, but please contact us with some in-depth infos.

Encoding of Decimal Numbers

Keyline internally uses a number datatype (Ruby's BigDecimal) that allows for higher precision than the Javascript float datatype. In order to preserve this high level of precision and aim for highest compatibility of API clients consuming the JSON responses of the Keyline API, such numbers are encoded as strings in the JSON responses.

It is the obligation of the API clients to correctly parse decimal numbers that are encoded as strings in JSON responses.

/accounting

/accounting/customer_invoices get post

The collection of CustomerInvoices

get

Get a list of all CustomerInvoice objects.

post

Creating customer invoices which are not related to an order or a product.

Get a list of all CustomerInvoice objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of common.Invoice

Items: CustomerInvoice

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

[
  {
      "id": 13569,
      "number": null,
      "net_total": 96411,
      "gross_total": 114729,
      "paid_at": null,
      "created_at": "2018-04-06T11:38:47.211+02:00",
      "updated_at": "2018-04-10T11:20:40.134+02:00",
      "custom_text": null,
      "taxes": {
          "0.19": 18318
      },
      "due_at": null,
      "printery_id": 17,
      "billed_at": null,
      "sent_at": null,
      "business_unit_id": 23,
      "custom_references": {},
      "recipient_type": "Organization",
      "recipient_id": 6710,
      "reversal_invoice_id": null,
      "reversed_invoice_id": null,
      "services_performed_at": "2018-03-26",
      "recipient": {
        "id": 6710,
        "name": "Crispy",
        "tax_identifier": "DE 123456789",
        "email": "crispy@example.com",
        "reference": "Num 12345",
        "debitor_identifier": null,
        "creditor_identifier": null,
        "preferred_locale": null,
        "created_at": "2018-07-03T11:44:52.210+02:00",
        "updated_at": "2018-07-03T11:44:52.210+02:00"
      },
      "contact": {
        "id": 1245,
        "salutation": "Frau",
        "name": "Schöller",
        "first_name": "Maria",
        "mobile": null,
        "phone": null,
        "fax": null,
        "tax_identifier": null,
        "email": "maria@example.com",
        "reference": "HAXEZ3",
        "debitor_identifier": null,
        "preferred_locale": null,
        "created_at": "2017-07-19T13:44:16.332+02:00",
        "updated_at": "2017-08-30T15:40:18.054+02:00"
      },
      "address": {
          "addressee": "Crispy Mountain GmbH",
          "street": "Emmerich Josef Straße",
          "number": "1a",
          "addition": "",
          "zip_code": "55116",
          "town": "Mainz",
          "country_code": "DE"
      },
      "line_items": [
          {
              "id": 19890,
              "invoice_id": 13569,
              "description": "Visitenkarte\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: CMYK / CMYK",
              "qty": 500,
              "unit": "piece",
              "net_total": 96411,
              "created_at": "2018-04-06T11:39:04.718+02:00",
              "updated_at": "2018-04-06T11:39:04.718+02:00",
              "tax_rate": "0.19",
              "gross_total": "114729.0",
              "billable_id": 56046,
              "billable_type": "Product",
              "net": "192.821",
              "discount": "0.0",
              "discounted_net_total": 96411,
              "order_number": "EB-9M-BR",
              "accounting_category_id": null,
              "environmental_certifications": []
          }
      ]
  },
  {
      "id": 12994,
      "number": null,
      "net_total": 25010,
      "gross_total": 29762,
      "paid_at": null,
      "created_at": "2018-03-22T11:53:48.570+01:00",
      "updated_at": "2018-03-22T11:54:00.502+01:00",
      "custom_text": null,
      "taxes": {
          "0.19": 4752
      },
      "due_at": null,
      "printery_id": 17,
      "billed_at": null,
      "sent_at": null,
      "business_unit_id": 23,
      "custom_references": {},
      "reversal_invoice_id": null,
      "reversed_invoice_id": null,
      "services_performed_at": null,
      "recipient_type": "Organization",
      "recipient_id": 7250,
      "recipient":   {
          "id": 7250,
          "name": "German Tax Office",
          "tax_identifier": null,
          "email": null,
          "reference": "1069800",
          "debitor_identifier": "10698",
          "creditor_identifier": null,
          "preferred_locale": null,
          "created_at": "2016-12-14T08:05:33.983+01:00",
          "updated_at": "2017-04-27T08:22:22.656+02:00"
        },
      "contact": {
        "id": 1244,
        "salutation": "Frau",
        "name": "König",
        "first_name": "Melanie",
        "mobile": null,
        "phone": "+4912345678",
        "fax": null,
        "tax_identifier": null,
        "email": "melanie@example.com",
        "reference": "A2NK84",
        "debitor_identifier": null,
        "preferred_locale": null,
        "created_at": "2017-11-17T12:25:23.479+01:00",
        "updated_at": "2017-11-17T12:25:23.479+01:00"
      },
      "address": {
          "addressee": "Crispy Mountain GmbH",
          "street": "Emmerich Josef Straße",
          "number": "1a",
          "addition": "",
          "zip_code": "55116",
          "town": "Mainz",
          "country_code": "DE"
      },
      "line_items": [
          {
              "id": 19004,
              "invoice_id": 12994,
              "description": "Visitenkarte\nKarte:\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Marmor Umschlag Chamois Hellbraun chamois-hellbraun (FSC Mix Credit)\nGrammatur: 200 g/m²\nFarben: CMYK / CMYK\nWeiterverarbeitung: Eckrunden\n\nSchuber:\nSeiten: 4\nGeschlossenes Format: 85 × 55 mm\nOffenes Format: 170 × 55 mm\nPapier: Marmor Umschlag Chamois Hellbraun chamois-hellbraun (FSC Mix Credit)\nGrammatur: 300 g/m²\nFarben: K / K\n\n\nSorten: Müller, Meier",
              "qty": 500,
              "unit": "piece",
              "net_total": 25010,
              "created_at": "2018-03-22T11:54:00.461+01:00",
              "updated_at": "2018-03-22T11:54:00.461+01:00",
              "tax_rate": "0.19",
              "gross_total": "29762.0",
              "billable_id": 45770,
              "billable_type": "Product",
              "net": "50.02",
              "discount": "0.0",
              "discounted_net_total": 25010,
              "order_number": "TQ-7T-MZ",
              "accounting_category_id": null,
              "environmental_certifications": [
                  "FSC Mix Credit"
              ]
          }
      ]
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Creating customer invoices which are not related to an order or a product.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Body

Media type: application/json

Type: object

Properties

customer_invoice: required (object)
- number: (string)
- paid_at: (date-only)
- custom_text: (string)
- due_at: (date-only)
- billed_at: (date-only)
- sent_at: (date-only)
- business_unit_id: (integer)
- customer_id: required (integer)
- services_performed_at: (date-only)

Example:

{
  "customer_invoice": {
    "recipient_id": 57,
    "business_unit_id": 23,
    "number": "221028",
    "custom_text": "Steuerfrei nach § 4 Nr. 1 b i. V. m § 6 a UStG.",
    "services_performed_at": "2018-04-08"
  }
}

HTTP status code 201

This response is returned if creating a new CustomerInvoice was successful.

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

{
    "id": 13569,
    "number": null,
    "net_total": 96411,
    "gross_total": 114729,
    "paid_at": null,
    "created_at": "2018-04-06T11:38:47.211+02:00",
    "updated_at": "2018-04-10T11:20:40.134+02:00",
    "custom_text": null,
    "taxes": {
        "0.19": 18318
    },
    "due_at": null,
    "printery_id": 17,
    "billed_at": null,
    "sent_at": null,
    "business_unit_id": 23,
    "custom_references": {},
    "reversal_invoice_id": null,
    "reversed_invoice_id": null,
    "services_performed_at": "2018-03-26",
    "recipient_type": "Organization",
    "recipient_id": 6710,
    "recipient": {
      "id": 6710,
      "name": "Crispy",
      "tax_identifier": "DE 123456789",
      "email": "crispy@example.com",
      "reference": "Num 12345",
      "debitor_identifier": null,
      "creditor_identifier": null,
      "preferred_locale": null,
      "created_at": "2018-07-03T11:44:52.210+02:00",
      "updated_at": "2018-07-03T11:44:52.210+02:00"
    },
    "contact": {
      "id": 1245,
      "salutation": "Frau",
      "name": "Schöller",
      "first_name": "Maria",
      "mobile": null,
      "phone": null,
      "fax": null,
      "tax_identifier": null,
      "email": "maria@example.com",
      "reference": "HAXEZ3",
      "debitor_identifier": null,
      "preferred_locale": null,
      "created_at": "2017-07-19T13:44:16.332+02:00",
      "updated_at": "2017-08-30T15:40:18.054+02:00"
    },
    "address": {
        "addressee": "Crispy Mountain GmbH",
        "street": "Emmerich Josef Straße",
        "number": "1a",
        "addition": "",
        "zip_code": "55116",
        "town": "Mainz",
        "country_code": "DE"
    },
    "line_items": [
        {
            "id": 19890,
            "invoice_id": 13569,
            "description": "Visitenkarte\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: CMYK / CMYK",
            "qty": 500,
            "unit": "piece",
            "net_total": 96411,
            "created_at": "2018-04-06T11:39:04.718+02:00",
            "updated_at": "2018-04-06T11:39:04.718+02:00",
            "tax_rate": "0.19",
            "gross_total": "114729.0",
            "billable_id": 56046,
            "billable_type": "Product",
            "net": "192.821",
            "discount": "0.0",
            "discounted_net_total": 96411,
            "order_number": "EB-9M-BR",
            "accounting_category_id": null,
            "environmental_certifications": []
        }
    ]
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id} get patch delete

The collection of CustomerInvoices.

get

Get a single CustomerInvoice record.

patch

Update details for a draft customer invoice.

delete

Delete a draft customer invoice.

Get a single CustomerInvoice record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

{
    "id": 13569,
    "number": null,
    "net_total": 96411,
    "gross_total": 114729,
    "paid_at": null,
    "created_at": "2018-04-06T11:38:47.211+02:00",
    "updated_at": "2018-04-10T11:20:40.134+02:00",
    "custom_text": null,
    "taxes": {
        "0.19": 18318
    },
    "due_at": null,
    "printery_id": 17,
    "billed_at": null,
    "sent_at": null,
    "business_unit_id": 23,
    "custom_references": {},
    "reversal_invoice_id": null,
    "reversed_invoice_id": null,
    "services_performed_at": "2018-03-26",
    "recipient_type": "Organization",
    "recipient_id": 6710,
    "recipient": {
      "id": 6710,
      "name": "Crispy",
      "tax_identifier": "DE 123456789",
      "email": "crispy@example.com",
      "reference": "Num 12345",
      "debitor_identifier": null,
      "creditor_identifier": null,
      "preferred_locale": null,
      "created_at": "2018-07-03T11:44:52.210+02:00",
      "updated_at": "2018-07-03T11:44:52.210+02:00"
    },
    "contact": {
      "id": 1245,
      "salutation": "Frau",
      "name": "Schöller",
      "first_name": "Maria",
      "mobile": null,
      "phone": null,
      "fax": null,
      "tax_identifier": null,
      "email": "maria@example.com",
      "reference": "HAXEZ3",
      "debitor_identifier": null,
      "preferred_locale": null,
      "created_at": "2017-07-19T13:44:16.332+02:00",
      "updated_at": "2017-08-30T15:40:18.054+02:00"
    },
    "address": {
        "addressee": "Crispy Mountain GmbH",
        "street": "Emmerich Josef Straße",
        "number": "1a",
        "addition": "",
        "zip_code": "55116",
        "town": "Mainz",
        "country_code": "DE"
    },
    "line_items": [
        {
            "id": 19890,
            "invoice_id": 13569,
            "description": "Visitenkarte\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: CMYK / CMYK",
            "qty": 500,
            "unit": "piece",
            "net_total": 96411,
            "created_at": "2018-04-06T11:39:04.718+02:00",
            "updated_at": "2018-04-06T11:39:04.718+02:00",
            "tax_rate": "0.19",
            "gross_total": "114729.0",
            "billable_id": 56046,
            "billable_type": "Product",
            "net": "192.821",
            "discount": "0.0",
            "discounted_net_total": 96411,
            "order_number": "EB-9M-BR",
            "accounting_category_id": null,
            "environmental_certifications": []
        }
    ]
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a draft customer invoice.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: object

Properties

customer_invoice: required (object)
- number: (string)
- paid_at: (date-only)
- custom_text: (string)
- due_at: (date-only)
- billed_at: (date-only)
- sent_at: (date-only)
- business_unit_id: (integer)
- customer_id: required (integer)
- services_performed_at: (date-only)

Example:

{
  "customer_invoice": {
    "recipient_id": 57,
    "business_unit_id": 23,
    "number": "221028",
    "custom_text": "Steuerfrei nach § 4 Nr. 1 b i. V. m § 6 a UStG.",
    "services_performed_at": "2018-04-08"
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete a draft customer invoice.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id}/contact post patch

The Contact record associated with the parent record.

post

Create a new Contact record.

patch

Update details for a contact.

Create a new Contact record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: ContactRequest

HTTP status code 201

This response is returned if creating a new Contact was successful.

Body

Media type: application/json

Type: Contact

Example:

Can not resolve examples/api-v2/configuration/contacts/get_id_200_response.json

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a contact.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: ContactRequest

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id}/address post patch

The Address record associated with the parent record.

post

Create a new Address record.

patch

Update details for an address.

Create a new Address record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: object

Properties

address: required (object)
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information

Example:

Can not resolve ../../../examples/api-v2/configuration/addresses/post_patch_request.json

HTTP status code 201

This response is returned if creating a new Address was successful.

Body

Media type: application/json

Type: object

Properties

addressee: required (string)
town: required (string)
number: (string)
country_code: required (string)
ISO Country code of country this address is located in.
zip_code: required (string)
street: (string)
addition: (string)
An optional additional information, usually displayed right below the address.

Example:

Can not resolve examples/api-v2/configuration/addresses//get_id_200_response.json

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for an address.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: object

Properties

address: required (object)
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information

Example:

Can not resolve ../../../examples/api-v2/configuration/addresses/post_patch_request.json

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id}/line_items get post

The collection of LineItems

get

Get a list of all LineItem objects.

post

Create a new LineItem object.

Get a list of all LineItem objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: LineItem

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
description: required (string)
qty: required (integer - minimum: 1)
unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
net_total: required (integer)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
tax_rate: required (number - minimum: 0 - maximum: 1)
gross_total: required (number)
billable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billable_type: required (string)
net: required (number)
For credit notes net, must be less than or equal to 0
discount: required (number)
discounted_net_total: required (integer)
order_number: required (string)
accounting_category_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
environmental_certifications: required (string)

Example:

[
  {
      "id": 17874,
      "invoice_id": 12268,
      "description": "Visitenkarte\nKarte:\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Marmor Umschlag Chamois Hellbraun chamois-hellbraun (FSC Mix Credit)\nGrammatur: 200 g/m²\nFarben: CMYK / CMYK\nWeiterverarbeitung: Eckrunden\n\nSchuber:\nSeiten: 4\nGeschlossenes Format: 85 × 55 mm\nOffenes Format: 170 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: K / K\n\n\nSorten: Meier, Müller",
      "qty": 1000,
      "unit": "piece",
      "net_total": 33333,
      "created_at": "2018-03-06T12:13:54.033+01:00",
      "updated_at": "2018-03-06T12:13:54.033+01:00",
      "tax_rate": "0.19",
      "gross_total": "39666.0",
      "billable_id": 53991,
      "billable_type": "Product",
      "net": "33.33333333333334",
      "discount": "0.0",
      "discounted_net_total": 33333,
      "order_number": "4W-2K-CS",
      "accounting_category_id": null,
      "environmental_certifications": [
          "FSC Mix Credit"
      ]
  },
  {
      "id": 17875,
      "invoice_id": 12268,
      "description": "Freistellen",
      "qty": 1,
      "unit": "hours",
      "net_total": 6000,
      "created_at": "2018-03-06T12:13:54.079+01:00",
      "updated_at": "2018-03-06T12:13:54.079+01:00",
      "tax_rate": "0.19",
      "gross_total": "7140.0",
      "billable_id": 326,
      "billable_type": "Service",
      "net": "6000.0",
      "discount": "0.0",
      "discounted_net_total": 6000,
      "order_number": null,
      "accounting_category_id": null,
      "environmental_certifications": []
  },
  {
      "id": 17876,
      "invoice_id": 12268,
      "description": "Versand",
      "qty": 1,
      "unit": null,
      "net_total": 450,
      "created_at": "2018-03-06T12:13:54.124+01:00",
      "updated_at": "2018-03-06T12:13:54.124+01:00",
      "tax_rate": "0.19",
      "gross_total": "536.0",
      "billable_id": null,
      "billable_type": null,
      "net": "450.0",
      "discount": "0.0",
      "discounted_net_total": 450,
      "order_number": null,
      "accounting_category_id": null,
      "environmental_certifications": []
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new LineItem object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: object

Properties

line_item: required (object)
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (one of pdf, piece, plate, sheet, folded_sheet, meter, sqmeter, sqmillimeter, millimeter, liter, milliliter, gram, kilogram, ream, minutes, hours)
- tax_rate: required (number - minimum: 0 - maximum: 1)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: (number)
- order_number: (string)
- accounting_category_id: (integer)

Example:

{
  "line_item": {
    "description": "Freistellen",
    "qty": 1,
    "unit": "hours",
    "tax_rate": 0.19,
    "net": 6000.0,
    "discount": 0.0,
    "order_number": "XE-G4-D2"
  }
}

HTTP status code 201

This response is returned if creating a new LineItem was successful.

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
description: required (string)
qty: required (integer - minimum: 1)
unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
net_total: required (integer)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
tax_rate: required (number - minimum: 0 - maximum: 1)
gross_total: required (number)
billable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billable_type: required (string)
net: required (number)
For credit notes net, must be less than or equal to 0
discount: required (number)
discounted_net_total: required (integer)
order_number: required (string)
accounting_category_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
environmental_certifications: required (string)

Example:

{
  "id": 17875,
  "invoice_id": 12268,
  "description": "Freistellen",
  "qty": 1,
  "unit": "hours",
  "net_total": 6000,
  "created_at": "2018-03-06T12:13:54.079+01:00",
  "updated_at": "2018-03-06T12:13:54.079+01:00",
  "tax_rate": "0.19",
  "gross_total": "7140.0",
  "billable_id": 326,
  "billable_type": "Service",
  "net": "6000.0",
  "discount": "0.0",
  "discounted_net_total": 6000,
  "order_number": null,
  "accounting_category_id": null,
  "environmental_certifications": []
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id}/line_items/{line_item_id} get patch delete

The collection of LineItems.

get

Get a single LineItem record.

patch

Update details for a line item.

delete

Delete a line item for draft customer invoice.

Get a single LineItem record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)
line_item_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
description: required (string)
qty: required (integer - minimum: 1)
unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
net_total: required (integer)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
tax_rate: required (number - minimum: 0 - maximum: 1)
gross_total: required (number)
billable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billable_type: required (string)
net: required (number)
For credit notes net, must be less than or equal to 0
discount: required (number)
discounted_net_total: required (integer)
order_number: required (string)
accounting_category_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
environmental_certifications: required (string)

Example:

{
  "id": 17875,
  "invoice_id": 12268,
  "description": "Freistellen",
  "qty": 1,
  "unit": "hours",
  "net_total": 6000,
  "created_at": "2018-03-06T12:13:54.079+01:00",
  "updated_at": "2018-03-06T12:13:54.079+01:00",
  "tax_rate": "0.19",
  "gross_total": "7140.0",
  "billable_id": 326,
  "billable_type": "Service",
  "net": "6000.0",
  "discount": "0.0",
  "discounted_net_total": 6000,
  "order_number": null,
  "accounting_category_id": null,
  "environmental_certifications": []
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a line item.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)
line_item_id: required (string)

Body

Media type: application/json

Type: object

Properties

line_item: required (object)
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (one of pdf, piece, plate, sheet, folded_sheet, meter, sqmeter, sqmillimeter, millimeter, liter, milliliter, gram, kilogram, ream, minutes, hours)
- tax_rate: required (number - minimum: 0 - maximum: 1)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: (number)
- order_number: (string)
- accounting_category_id: (integer)

Example:

{
  "line_item": {
    "description": "Freistellen",
    "qty": 1,
    "unit": "hours",
    "tax_rate": 0.19,
    "net": 6000.0,
    "discount": 0.0,
    "order_number": "XE-G4-D2"
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete a line item for draft customer invoice.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)
line_item_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id}/payment_terms post patch

The PaymentTerms record associated with the parent record.

post

Create a new PaymentTerm record.

patch

Update details for payment terms.

Create a new PaymentTerm record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: object

Properties

payment_terms: required (object)
- time_for_payment: required (integer - minimum: 0)
- accepted_means_of_payment: (string)
- time_for_first_cashback: (integer - minimum: 1)
- first_cashback_discount: (number - minimum: 0.1 - maximum: 1)
- time_for_second_cashback: (integer - minimum: 1)
- second_cashback_discount: (number - minimum: 0.1 - maximum: 1)

Example:

{
  "payment_terms": {
    "time_for_payment": 7,
    "time_for_first_cashback": 3,
    "first_cashback_discount": 0.1
  }
}

HTTP status code 201

This response is returned if creating a new PaymentTerm was successful.

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
payment_termable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
payment_termable_type: required (string)
time_for_payment: required (integer - minimum: 0)
accepted_means_of_payment: required (string)
time_for_first_cashback: required (integer - minimum: 1)
first_cashback_discount: required (number - minimum: 0.1 - maximum: 1)
time_for_second_cashback: required (integer - minimum: 1)
second_cashback_discount: required (number - minimum: 0.1 - maximum: 1)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.

Example:

{
  "id": 16492,
  "payment_termable_id": 13661,
  "payment_termable_type": "Invoice",
  "time_for_payment": 7,
  "accepted_means_of_payment": null,
  "time_for_first_cashback": 3,
  "first_cashback_discount": 0.1,
  "time_for_second_cashback": null,
  "second_cashback_discount": null,
  "created_at": "2018-04-10T14:59:40.970+02:00",
  "updated_at": "2018-04-10T14:59:40.970+02:00"
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for payment terms.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

Body

Media type: application/json

Type: object

Properties

payment_terms: required (object)
- time_for_payment: required (integer - minimum: 0)
- accepted_means_of_payment: (string)
- time_for_first_cashback: (integer - minimum: 1)
- first_cashback_discount: (number - minimum: 0.1 - maximum: 1)
- time_for_second_cashback: (integer - minimum: 1)
- second_cashback_discount: (number - minimum: 0.1 - maximum: 1)

Example:

{
  "payment_terms": {
    "time_for_payment": 7,
    "time_for_first_cashback": 3,
    "first_cashback_discount": 0.1
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/customer_invoices/{customer_invoice_id}/reversal_invoice post

The ReversalInvoice record associated with the parent record.

post

Cancel a billed customer invoice and create a reversal invoice.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

customer_invoice_id: required (string)

HTTP status code 201

This response is returned if creating a new ReversalInvoice was successful.

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

{
  "id": 13668,
  "number": "180411002",
  "net_total": -96411,
  "gross_total": -114729,
  "paid_at": null,
  "created_at": "2018-04-11T10:27:54.298+02:00",
  "updated_at": "2018-04-11T10:27:54.356+02:00",
  "custom_text": null,
  "taxes": {
      "0.19": -18318
  },
  "due_at": "2018-04-11",
  "printery_id": 17,
  "billed_at": "2018-04-11",
  "sent_at": null,
  "business_unit_id": 23,
  "custom_references": {},
  "reversal_invoice_id": null,
  "reversed_invoice_id": 13569,
  "services_performed_at": "2018-03-26",
  "recipient_type": "Organization",
  "recipient_id": 6710,
  "recipient": {
    "id": 6710,
    "name": "Crispy",
    "tax_identifier": "DE 123456789",
    "email": "crispy@example.com",
    "reference": "Num 12345",
    "debitor_identifier": null,
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2018-07-03T11:44:52.210+02:00",
    "updated_at": "2018-07-03T11:44:52.210+02:00"
  },
  "contact": {
    "id": 1245,
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-07-19T13:44:16.332+02:00",
    "updated_at": "2017-08-30T15:40:18.054+02:00"
  },
  "address": {
      "addressee": "Crispy Mountain GmbH",
      "street": "Emmerich Josef Straße",
      "number": "1a",
      "addition": "",
      "zip_code": "55116",
      "town": "Mainz",
      "country_code": "DE"
  },
  "line_items": [
      {
          "id": 19999,
          "invoice_id": 13668,
          "description": "Visitenkarte\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: CMYK / CMYK",
          "qty": 500,
          "unit": "piece",
          "net_total": -96411,
          "created_at": "2018-04-11T10:27:54.318+02:00",
          "updated_at": "2018-04-11T10:27:54.318+02:00",
          "tax_rate": "0.19",
          "gross_total": "-114729.0",
          "billable_id": 56046,
          "billable_type": "Product",
          "net": "-192.821",
          "discount": "0.0",
          "discounted_net_total": -96411,
          "order_number": "EB-9M-BR",
          "accounting_category_id": null,
          "environmental_certifications": []
      }
  ]
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/credit_notes get post

The collection of CreditNotes

get

Get a list of all CreditNote objects.

post

Create a new CreditNote object.

Get a list of all CreditNote objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of common.Invoice

Items: CreditNote

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

[
  {
      "id": 13664,
      "number": "180410002",
      "net_total": -6000,
      "gross_total": -7140,
      "paid_at": null,
      "created_at": "2018-04-10T13:28:22.932+02:00",
      "updated_at": "2018-04-10T13:28:59.972+02:00",
      "custom_text": null,
      "taxes": {
          "0.19": -1140
      },
      "due_at": null,
      "printery_id": 17,
      "billed_at": "2018-04-10",
      "sent_at": null,
      "business_unit_id": 23,
      "custom_references": {},
      "reversal_invoice_id": null,
      "reversed_invoice_id": null,
      "services_performed_at": "2018-03-06",
      "recipient_type": "Organization",
      "recipient_id": 6710,
      "recipient": {
        "id": 6710,
        "name": "Crispy",
        "tax_identifier": "DE 123456789",
        "email": "crispy@example.com",
        "reference": "Num 12345",
        "debitor_identifier": null,
        "creditor_identifier": null,
        "preferred_locale": null,
        "created_at": "2018-07-03T11:44:52.210+02:00",
        "updated_at": "2018-07-03T11:44:52.210+02:00"
      },
      "contact": {
        "id": 1245,
        "salutation": "Frau",
        "name": "Schöller",
        "first_name": "Maria",
        "mobile": null,
        "phone": null,
        "fax": null,
        "tax_identifier": null,
        "email": "maria@example.com",
        "reference": "HAXEZ3",
        "debitor_identifier": null,
        "preferred_locale": null,
        "created_at": "2017-07-19T13:44:16.332+02:00",
        "updated_at": "2017-08-30T15:40:18.054+02:00"
      },
      "address": {
          "addressee": "Crispy Mountain GmbH",
          "street": "Emmerich Josef Straße",
          "number": "1a",
          "addition": "",
          "zip_code": "55116",
          "town": "Mainz",
          "country_code": "DE"
      },
      "line_items": [
          {
              "id": 19997,
              "invoice_id": 13664,
              "description": "Provision für Produkt CR-SS-Q2",
              "qty": 1,
              "unit": "piece",
              "net_total": -6000,
              "created_at": "2018-04-10T13:28:50.813+02:00",
              "updated_at": "2018-04-10T13:28:50.813+02:00",
              "tax_rate": "0.19",
              "gross_total": "-7140.0",
              "billable_id": null,
              "billable_type": null,
              "net": "-6000.0",
              "discount": "0.0",
              "discounted_net_total": -6000,
              "order_number": null,
              "accounting_category_id": null,
              "environmental_certifications": []
          }
      ]
  },
  {
      "id": 13663,
      "number": "180410001",
      "net_total": -12000,
      "gross_total": -14280,
      "paid_at": null,
      "created_at": "2018-04-10T13:26:46.965+02:00",
      "updated_at": "2018-04-10T13:28:11.627+02:00",
      "custom_text": null,
      "taxes": {
          "0.19": -2280
      },
      "due_at": null,
      "printery_id": 17,
      "billed_at": "2018-04-10",
      "sent_at": null,
      "business_unit_id": 23,
      "custom_references": {},
      "reversal_invoice_id": null,
      "reversed_invoice_id": null,
      "services_performed_at": "2018-04-09",
      "recipient_type": "Organization",
      "recipient_id": 6710,
      "recipient": {
        "id": 6710,
        "name": "Crispy",
        "tax_identifier": "DE 123456789",
        "email": "crispy@example.com",
        "reference": "Num 12345",
        "debitor_identifier": null,
        "creditor_identifier": null,
        "preferred_locale": null,
        "created_at": "2018-07-03T11:44:52.210+02:00",
        "updated_at": "2018-07-03T11:44:52.210+02:00"
      },
      "contact": {
        "id": 1245,
        "salutation": "Frau",
        "name": "Schöller",
        "first_name": "Maria",
        "mobile": null,
        "phone": null,
        "fax": null,
        "tax_identifier": null,
        "email": "maria@example.com",
        "reference": "HAXEZ3",
        "debitor_identifier": null,
        "preferred_locale": null,
        "created_at": "2017-07-19T13:44:16.332+02:00",
        "updated_at": "2017-08-30T15:40:18.054+02:00"
      },
      "address": {
          "addressee": "Crispy Mountain GmbH",
          "street": "Emmerich Josef Straße",
          "number": "1a",
          "addition": "",
          "zip_code": "55116",
          "town": "Mainz",
          "country_code": "DE"
      },
      "line_items": [
          {
              "id": 19996,
              "invoice_id": 13663,
              "description": "Provision",
              "qty": 1,
              "unit": null,
              "net_total": -12000,
              "created_at": "2018-04-10T13:28:01.035+02:00",
              "updated_at": "2018-04-10T13:28:01.035+02:00",
              "tax_rate": "0.19",
              "gross_total": "-14280.0",
              "billable_id": null,
              "billable_type": null,
              "net": "-12000.0",
              "discount": "0.0",
              "discounted_net_total": -12000,
              "order_number": null,
              "accounting_category_id": null,
              "environmental_certifications": []
          }
      ]
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new CreditNote object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Body

Media type: application/json

Type: object

Properties

credit_note: required (object)
- number: (string)
- paid_at: (date-only)
- custom_text: (string)
- due_at: (date-only)
- billed_at: (date-only)
- sent_at: (date-only)
- business_unit_id: (integer)
- affiliate_id: required (integer)
- services_performed_at: (date-only)

Example:

{
  "credit_note": {
    "recipient_id": 57,
    "business_unit_id": 23,
    "number": "221028",
    "services_performed_at": "2018-04-08"
  }
}

HTTP status code 201

This response is returned if creating a new CreditNote was successful.

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

{
  "id": 13664,
  "number": "180410002",
  "net_total": -6000,
  "gross_total": -7140,
  "paid_at": null,
  "created_at": "2018-04-10T13:28:22.932+02:00",
  "updated_at": "2018-04-10T13:28:59.972+02:00",
  "custom_text": null,
  "taxes": {
      "0.19": -1140
  },
  "due_at": null,
  "printery_id": 17,
  "billed_at": "2018-04-10",
  "sent_at": null,
  "business_unit_id": 23,
  "custom_references": {},
  "reversal_invoice_id": null,
  "reversed_invoice_id": null,
  "services_performed_at": "2018-03-06",
  "recipient_id": 6710,
  "recipient": {
    "id": 6710,
    "name": "Crispy",
    "tax_identifier": "DE 123456789",
    "email": "crispy@example.com",
    "reference": "Num 12345",
    "debitor_identifier": null,
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2018-07-03T11:44:52.210+02:00",
    "updated_at": "2018-07-03T11:44:52.210+02:00"
  },
  "contact": {
    "id": 1245,
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-07-19T13:44:16.332+02:00",
    "updated_at": "2017-08-30T15:40:18.054+02:00"
  },
  "address": {
      "addressee": "Crispy Mountain GmbH",
      "street": "Emmerich Josef Straße",
      "number": "1a",
      "addition": "",
      "zip_code": "55116",
      "town": "Mainz",
      "country_code": "DE"
  },
  "line_items": [
      {
          "id": 19997,
          "invoice_id": 13664,
          "description": "Provision für Produkt CR-SS-Q2",
          "qty": 1,
          "unit": "piece",
          "net_total": -6000,
          "created_at": "2018-04-10T13:28:50.813+02:00",
          "updated_at": "2018-04-10T13:28:50.813+02:00",
          "tax_rate": "0.19",
          "gross_total": "-7140.0",
          "billable_id": null,
          "billable_type": null,
          "net": "-6000.0",
          "discount": "0.0",
          "discounted_net_total": -6000,
          "order_number": null,
          "accounting_category_id": null,
          "environmental_certifications": []
      }
  ]
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/credit_notes/{credit_note_id} get patch delete

The collection of CreditNotes.

get

Get a single CreditNote record.

patch

Update details for a draft credit note.

delete

Delete a draft credit note.

Get a single CreditNote record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

{
  "id": 13664,
  "number": "180410002",
  "net_total": -6000,
  "gross_total": -7140,
  "paid_at": null,
  "created_at": "2018-04-10T13:28:22.932+02:00",
  "updated_at": "2018-04-10T13:28:59.972+02:00",
  "custom_text": null,
  "taxes": {
      "0.19": -1140
  },
  "due_at": null,
  "printery_id": 17,
  "billed_at": "2018-04-10",
  "sent_at": null,
  "business_unit_id": 23,
  "custom_references": {},
  "reversal_invoice_id": null,
  "reversed_invoice_id": null,
  "services_performed_at": "2018-03-06",
  "recipient_id": 6710,
  "recipient": {
    "id": 6710,
    "name": "Crispy",
    "tax_identifier": "DE 123456789",
    "email": "crispy@example.com",
    "reference": "Num 12345",
    "debitor_identifier": null,
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2018-07-03T11:44:52.210+02:00",
    "updated_at": "2018-07-03T11:44:52.210+02:00"
  },
  "contact": {
    "id": 1245,
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-07-19T13:44:16.332+02:00",
    "updated_at": "2017-08-30T15:40:18.054+02:00"
  },
  "address": {
      "addressee": "Crispy Mountain GmbH",
      "street": "Emmerich Josef Straße",
      "number": "1a",
      "addition": "",
      "zip_code": "55116",
      "town": "Mainz",
      "country_code": "DE"
  },
  "line_items": [
      {
          "id": 19997,
          "invoice_id": 13664,
          "description": "Provision für Produkt CR-SS-Q2",
          "qty": 1,
          "unit": "piece",
          "net_total": -6000,
          "created_at": "2018-04-10T13:28:50.813+02:00",
          "updated_at": "2018-04-10T13:28:50.813+02:00",
          "tax_rate": "0.19",
          "gross_total": "-7140.0",
          "billable_id": null,
          "billable_type": null,
          "net": "-6000.0",
          "discount": "0.0",
          "discounted_net_total": -6000,
          "order_number": null,
          "accounting_category_id": null,
          "environmental_certifications": []
      }
  ]
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a draft credit note.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

Body

Media type: application/json

Type: object

Properties

credit_note: required (object)
- number: (string)
- paid_at: (date-only)
- custom_text: (string)
- due_at: (date-only)
- billed_at: (date-only)
- sent_at: (date-only)
- business_unit_id: (integer)
- affiliate_id: required (integer)
- services_performed_at: (date-only)

Example:

{
  "credit_note": {
    "recipient_id": 57,
    "business_unit_id": 23,
    "number": "221028",
    "services_performed_at": "2018-04-08"
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete a draft credit note.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/credit_notes/{credit_note_id}/contact post patch

The Contact record associated with the parent record.

post

Create a new Contact record.

patch

Update details for a contact.

Create a new Contact record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

Body

Media type: application/json

Type: ContactRequest

HTTP status code 201

This response is returned if creating a new Contact was successful.

Body

Media type: application/json

Type: Contact

Example:

Can not resolve examples/api-v2/configuration/contacts/get_id_200_response.json

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a contact.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

Body

Media type: application/json

Type: ContactRequest

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/credit_notes/{credit_note_id}/address post patch

The Address record associated with the parent record.

post

Create a new Address record.

patch

Update details for an address.

Create a new Address record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

Body

Media type: application/json

Type: object

Properties

address: required (object)
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information

Example:

Can not resolve ../../../examples/api-v2/configuration/addresses/post_patch_request.json

HTTP status code 201

This response is returned if creating a new Address was successful.

Body

Media type: application/json

Type: object

Properties

addressee: required (string)
town: required (string)
number: (string)
country_code: required (string)
ISO Country code of country this address is located in.
zip_code: required (string)
street: (string)
addition: (string)
An optional additional information, usually displayed right below the address.

Example:

Can not resolve examples/api-v2/configuration/addresses//get_id_200_response.json

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for an address.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

Body

Media type: application/json

Type: object

Properties

address: required (object)
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information

Example:

Can not resolve ../../../examples/api-v2/configuration/addresses/post_patch_request.json

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/credit_notes/{credit_note_id}/line_items get post

The collection of LineItems

get

Get a list of all LineItem objects.

post

Create a new LineItem object.

Get a list of all LineItem objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: LineItem

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
description: required (string)
qty: required (integer - minimum: 1)
unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
net_total: required (integer)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
tax_rate: required (number - minimum: 0 - maximum: 1)
gross_total: required (number)
billable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billable_type: required (string)
net: required (number)
For credit notes net, must be less than or equal to 0
discount: required (number)
discounted_net_total: required (integer)
order_number: required (string)
accounting_category_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
environmental_certifications: required (string)

Example:

[
  {
      "id": 19997,
      "invoice_id": 13664,
      "description": "Provision für Produkt CR-SS-Q2",
      "qty": 1,
      "unit": "piece",
      "net_total": -6000,
      "created_at": "2018-04-10T13:28:50.813+02:00",
      "updated_at": "2018-04-10T13:28:50.813+02:00",
      "tax_rate": "0.19",
      "gross_total": "-7140.0",
      "billable_id": null,
      "billable_type": null,
      "net": "-6000.0",
      "discount": "0.0",
      "discounted_net_total": -6000,
      "order_number": null,
      "accounting_category_id": null,
      "environmental_certifications": []
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new LineItem object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)

Body

Media type: application/json

Type: object

Properties

line_item: required (object)
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (one of pdf, piece, plate, sheet, folded_sheet, meter, sqmeter, sqmillimeter, millimeter, liter, milliliter, gram, kilogram, ream, minutes, hours)
- tax_rate: required (number - minimum: 0 - maximum: 1)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: (number)
- order_number: (string)
- accounting_category_id: (integer)

Example:

{
  "line_item": {
    "description": "Provision für Produkt CR-SS-Q2",
    "qty": 1,
    "unit": "piece",
    "tax_rate": 0.19,
    "net": "-6000.0",
    "discount": 0.0,
  }
}

HTTP status code 201

This response is returned if creating a new LineItem was successful.

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
description: required (string)
qty: required (integer - minimum: 1)
unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
net_total: required (integer)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
tax_rate: required (number - minimum: 0 - maximum: 1)
gross_total: required (number)
billable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billable_type: required (string)
net: required (number)
For credit notes net, must be less than or equal to 0
discount: required (number)
discounted_net_total: required (integer)
order_number: required (string)
accounting_category_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
environmental_certifications: required (string)

Example:

{
  "id": 19997,
  "invoice_id": 13664,
  "description": "Provision für Produkt CR-SS-Q2",
  "qty": 1,
  "unit": "piece",
  "net_total": -6000,
  "created_at": "2018-04-10T13:28:50.813+02:00",
  "updated_at": "2018-04-10T13:28:50.813+02:00",
  "tax_rate": "0.19",
  "gross_total": "-7140.0",
  "billable_id": null,
  "billable_type": null,
  "net": "-6000.0",
  "discount": "0.0",
  "discounted_net_total": -6000,
  "order_number": null,
  "accounting_category_id": null,
  "environmental_certifications": []
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/credit_notes/{credit_note_id}/line_items/{line_item_id} get patch delete

The collection of LineItems.

get

Get a single LineItem record.

patch

Update details for a line item.

delete

Delete a line item for draft credit note.

Get a single LineItem record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)
line_item_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
description: required (string)
qty: required (integer - minimum: 1)
unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
net_total: required (integer)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
tax_rate: required (number - minimum: 0 - maximum: 1)
gross_total: required (number)
billable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billable_type: required (string)
net: required (number)
For credit notes net, must be less than or equal to 0
discount: required (number)
discounted_net_total: required (integer)
order_number: required (string)
accounting_category_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
environmental_certifications: required (string)

Example:

{
  "id": 19997,
  "invoice_id": 13664,
  "description": "Provision für Produkt CR-SS-Q2",
  "qty": 1,
  "unit": "piece",
  "net_total": -6000,
  "created_at": "2018-04-10T13:28:50.813+02:00",
  "updated_at": "2018-04-10T13:28:50.813+02:00",
  "tax_rate": "0.19",
  "gross_total": "-7140.0",
  "billable_id": null,
  "billable_type": null,
  "net": "-6000.0",
  "discount": "0.0",
  "discounted_net_total": -6000,
  "order_number": null,
  "accounting_category_id": null,
  "environmental_certifications": []
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a line item.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)
line_item_id: required (string)

Body

Media type: application/json

Type: object

Properties

line_item: required (object)
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (one of pdf, piece, plate, sheet, folded_sheet, meter, sqmeter, sqmillimeter, millimeter, liter, milliliter, gram, kilogram, ream, minutes, hours)
- tax_rate: required (number - minimum: 0 - maximum: 1)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: (number)
- order_number: (string)
- accounting_category_id: (integer)

Example:

{
  "line_item": {
    "description": "Provision für Produkt CR-SS-Q2",
    "qty": 1,
    "unit": "piece",
    "tax_rate": 0.19,
    "net": "-6000.0",
    "discount": 0.0,
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete a line item for draft credit note.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

credit_note_id: required (string)
line_item_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/reversal_invoices get

The collection of ReversalInvoices

get

Get a list of all ReversalInvoice objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of common.Invoice

Items: ReversalInvoice

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

[
  {
    "id": 13668,
    "number": "180411002",
    "net_total": -96411,
    "gross_total": -114729,
    "paid_at": null,
    "created_at": "2018-04-11T10:27:54.298+02:00",
    "updated_at": "2018-04-11T10:27:54.356+02:00",
    "custom_text": null,
    "taxes": {
        "0.19": -18318
    },
    "due_at": "2018-04-11",
    "printery_id": 17,
    "billed_at": "2018-04-11",
    "sent_at": null,
    "business_unit_id": 23,
    "custom_references": {},
    "reversal_invoice_id": null,
    "reversed_invoice_id": 13569,
    "services_performed_at": "2018-03-26",
    "recipient_type": "Organization",
    "recipient_id": 6710,
    "recipient": {
      "id": 6710,
      "name": "Crispy",
      "tax_identifier": "DE 123456789",
      "email": "crispy@example.com",
      "reference": "Num 12345",
      "debitor_identifier": null,
      "creditor_identifier": null,
      "preferred_locale": null,
      "created_at": "2018-07-03T11:44:52.210+02:00",
      "updated_at": "2018-07-03T11:44:52.210+02:00"
    },
    "contact": {
      "id": 1245,
      "salutation": "Frau",
      "name": "Schöller",
      "first_name": "Maria",
      "mobile": null,
      "phone": null,
      "fax": null,
      "tax_identifier": null,
      "email": "maria@example.com",
      "reference": "HAXEZ3",
      "debitor_identifier": null,
      "preferred_locale": null,
      "created_at": "2017-07-19T13:44:16.332+02:00",
      "updated_at": "2017-08-30T15:40:18.054+02:00"
    },
    "address": {
        "addressee": "Crispy Mountain GmbH",
        "street": "Emmerich Josef Straße",
        "number": "1a",
        "addition": "",
        "zip_code": "55116",
        "town": "Mainz",
        "country_code": "DE"
    },
    "line_items": [
        {
            "id": 19999,
            "invoice_id": 13668,
            "description": "Visitenkarte\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: CMYK / CMYK",
            "qty": 500,
            "unit": "piece",
            "net_total": -96411,
            "created_at": "2018-04-11T10:27:54.318+02:00",
            "updated_at": "2018-04-11T10:27:54.318+02:00",
            "tax_rate": "0.19",
            "gross_total": "-114729.0",
            "billable_id": 56046,
            "billable_type": "Product",
            "net": "-192.821",
            "discount": "0.0",
            "discounted_net_total": -96411,
            "order_number": "EB-9M-BR",
            "accounting_category_id": null,
            "environmental_certifications": []
        }
    ]
},
{
    "id": 912,
    "number": "27",
    "net_total": -241014,
    "gross_total": -286807,
    "paid_at": null,
    "created_at": "2016-11-30T14:31:58.341+01:00",
    "updated_at": "2016-11-30T14:31:58.728+01:00",
    "custom_text": null,
    "taxes": {
        "0.19": -45793
    },
    "due_at": "2016-11-30",
    "printery_id": 17,
    "billed_at": "2016-11-30",
    "sent_at": null,
    "business_unit_id": 23,
    "custom_references": {},
    "reversal_invoice_id": null,
    "reversed_invoice_id": 911,
    "services_performed_at": "2016-11-30",
    "recipient_type": "Organization",
    "recipient_id": 7250,
    "recipient":   {
        "id": 7250,
        "name": "German Tax Office",
        "tax_identifier": null,
        "email": null,
        "reference": "1069800",
        "debitor_identifier": "10698",
        "creditor_identifier": null,
        "preferred_locale": null,
        "created_at": "2016-12-14T08:05:33.983+01:00",
        "updated_at": "2017-04-27T08:22:22.656+02:00"
      },
    "contact": {
      "id": 1244,
      "salutation": "Frau",
      "name": "König",
      "first_name": "Melanie",
      "mobile": null,
      "phone": "+4912345678",
      "fax": null,
      "tax_identifier": null,
      "email": "melanie@example.com",
      "reference": "A2NK84",
      "debitor_identifier": null,
      "preferred_locale": null,
      "created_at": "2017-11-17T12:25:23.479+01:00",
      "updated_at": "2017-11-17T12:25:23.479+01:00"
    },
    "address": {
        "addressee": "Autohaus Müller GmbH",
        "street": "Musterstraße",
        "number": "123",
        "addition": "",
        "zip_code": "12345",
        "town": "Musterstadt",
        "country_code": "DE"
    },
    "line_items": [
        {
            "id": 994,
            "invoice_id": 912,
            "description": "Broschüre (Rückendrahtheftung)\nUmschlag:\n\tSeiten: 4\n\tGeschlossenes Format: A4\n\tOffenes Format: 420 mm × 297 mm (A3)\n\tPapier: Multiart Silk Weiß\n\tGrammatur: 250 g/m²\n\tFarben: CMYK / CMYK\n\tWeiterverarbeitung: Rillen, Dispersionslackieren\n\nInnenteil:\n\tSeiten: 32\n\tGeschlossenes Format: A4\n\tOffenes Format: 420 mm × 297 mm (A3)\n\tPapier: Multiart Silk Weiß\n\tGrammatur: 150 g/m²\n\tFarben: CMYK / CMYK\n\nEinhefter:\n\tSeiten: 4\n\tGeschlossenes Format: A4\n\tOffenes Format: 420 mm × 297 mm (A3)\n\tPapier: Multiart Silk Weiß\n\tGrammatur: 100 g/m²\n\tFarben: K, HKS 10 K / K, HKS 10 K\n\tWeiterverarbeitung: Perforieren\n\n\nWeiterverarbeitung: Rückendrahtheften",
            "qty": 1000,
            "unit": "piece",
            "net_total": -241014,
            "created_at": "2016-11-30T14:31:58.529+01:00",
            "updated_at": "2016-11-30T14:31:58.529+01:00",
            "tax_rate": "0.19",
            "gross_total": "-286807.0",
            "billable_id": 3261,
            "billable_type": "Product",
            "net": "-241.014",
            "discount": "0.0",
            "discounted_net_total": -241014,
            "order_number": "S9-NP-4E",
            "accounting_category_id": null,
            "environmental_certifications": []
        }
    ]
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/accounting/reversal_invoices/{reversal_invoice_id} get

The collection of ReversalInvoices.

get

Get a single ReversalInvoice record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

reversal_invoice_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
number: required (string)
If not specified, the invoice number is generated automatically.
net_total: required (integer)
gross_total: required (integer)
paid_at: required (date-only)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
custom_text: required (string)
taxes: required (object)
Contains the tax rates for each line item of the invoice
due_at: required (date-only)
If not specified, the due date will be set automatically, based on the specified payment terms.
printery_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
billed_at: required (date-only)
sent_at: required (date-only)
business_unit_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
checked_at: required (datetime)
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the invoice
reversal_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reversed_invoice_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
type: required (string)
services_performed_at: required (date-only)
If not specified, the services date will be set automatically to the invoice date.
recipient: required (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
recipient_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
recipient_type: required (string)
address: required (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
line_items: required (array of response.LineItem)
Items: LineItem
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- invoice_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- description: required (string)
- qty: required (integer - minimum: 1)
- unit: required (pdf piece plate sheet folded_sheet meter sqmeter sqmillimeter millimeter liter milliliter gram kilogram ream minutes hours)
- net_total: required (integer)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- tax_rate: required (number - minimum: 0 - maximum: 1)
- gross_total: required (number)
- billable_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- billable_type: required (string)
- net: required (number)
  For credit notes net, must be less than or equal to 0
- discount: required (number)
- discounted_net_total: required (integer)
- order_number: required (string)
- accounting_category_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- environmental_certifications: required (string)

Example:

{
  "id": 13668,
  "number": "180411002",
  "net_total": -96411,
  "gross_total": -114729,
  "paid_at": null,
  "created_at": "2018-04-11T10:27:54.298+02:00",
  "updated_at": "2018-04-11T10:27:54.356+02:00",
  "custom_text": null,
  "taxes": {
      "0.19": -18318
  },
  "due_at": "2018-04-11",
  "printery_id": 17,
  "billed_at": "2018-04-11",
  "sent_at": null,
  "business_unit_id": 23,
  "custom_references": {},
  "reversal_invoice_id": null,
  "reversed_invoice_id": 13569,
  "services_performed_at": "2018-03-26",
  "recipient_type": "Organization",
  "recipient_id": 6710,
  "recipient": {
    "id": 6710,
    "name": "Crispy",
    "tax_identifier": "DE 123456789",
    "email": "crispy@example.com",
    "reference": "Num 12345",
    "debitor_identifier": null,
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2018-07-03T11:44:52.210+02:00",
    "updated_at": "2018-07-03T11:44:52.210+02:00"
  },
  "contact": {
    "id": 1245,
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-07-19T13:44:16.332+02:00",
    "updated_at": "2017-08-30T15:40:18.054+02:00"
  },
  "address": {
      "addressee": "Crispy Mountain GmbH",
      "street": "Emmerich Josef Straße",
      "number": "1a",
      "addition": "",
      "zip_code": "55116",
      "town": "Mainz",
      "country_code": "DE"
  },
  "line_items": [
      {
          "id": 19999,
          "invoice_id": 13668,
          "description": "Visitenkarte\nSeiten: 2\nFormat: 85 × 55 mm\nPapier: Kartei  U. Leitkarte Chamois chamois\nGrammatur: 250 g/m²\nFarben: CMYK / CMYK",
          "qty": 500,
          "unit": "piece",
          "net_total": -96411,
          "created_at": "2018-04-11T10:27:54.318+02:00",
          "updated_at": "2018-04-11T10:27:54.318+02:00",
          "tax_rate": "0.19",
          "gross_total": "-114729.0",
          "billable_id": 56046,
          "billable_type": "Product",
          "net": "-192.821",
          "discount": "0.0",
          "discounted_net_total": -96411,
          "order_number": "EB-9M-BR",
          "accounting_category_id": null,
          "environmental_certifications": []
      }
  ]
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/customer_relations

/customer_relations/organizations get post

The collection of Organizations

get

Get a list of all Organization objects.

post

Create a new Organization object.

Get a list of all Organization objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Organization

name: required (string)
email: (string)
preferred_locale: (string)
A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
creditor_identifier: (string)
debitor_identifier: (string)
tax_identifier: (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reference: (string)

Example:

[
  {
    "id": 7241,
    "name": "Volksbank Mainz eG",
    "tax_identifier": null,
    "email": null,
    "reference": "HCMZ19",
    "debitor_identifier": null,
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2016-12-14T07:49:01.051+01:00",
    "updated_at": "2016-12-14T10:47:15.384+01:00"
  },
  {
    "id": 7250,
    "name": "German Tax Office",
    "tax_identifier": null,
    "email": null,
    "reference": "1069800",
    "debitor_identifier": "10698",
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2016-12-14T08:05:33.983+01:00",
    "updated_at": "2017-04-27T08:22:22.656+02:00"
  },
  {
    "id": 6710,
    "name": "Crispy",
    "tax_identifier": "DE 123456789",
    "email": "crispy@example.com",
    "reference": "Num 12345",
    "debitor_identifier": "",
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2018-07-03T11:44:52.210+02:00",
    "updated_at": "2018-07-03T11:44:52.210+02:00"
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new Organization object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Body

Media type: application/json

Type: object

Properties

organization: required (object)
- name: (string)
- reference: (string)
- email: (string)
- tax_identifier: (string)
- debitor_identifier: (string)
- creditor_identifier: (string)
- preferred_locale: (string)

Example:

{
  "organization": {
    "name": "Crispy",
    "reference": "Num 12345",
    "email": "crispy@example.com",
    "tax_identifier": "DE 123456789"
  }
}

HTTP status code 201

This response is returned if creating a new Organization was successful.

Body

Media type: application/json

Type: object

Properties

name: required (string)
email: (string)
preferred_locale: (string)
A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
creditor_identifier: (string)
debitor_identifier: (string)
tax_identifier: (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reference: (string)

Example:

{
  "id": 6710,
  "name": "Crispy",
  "tax_identifier": "DE 123456789",
  "email": "crispy@example.com",
  "reference": "Num 12345",
  "debitor_identifier": null,
  "creditor_identifier": null,
  "preferred_locale": null,
  "created_at": "2018-07-03T11:44:52.210+02:00",
  "updated_at": "2018-07-03T11:44:52.210+02:00"
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/customer_relations/organizations/{organization_id} get patch

The collection of Organizations.

get

Get a single Organization record.

patch

Update the given Organization record with provided data.

Get a single Organization record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

name: required (string)
email: (string)
preferred_locale: (string)
A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
creditor_identifier: (string)
debitor_identifier: (string)
tax_identifier: (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reference: (string)

Example:

{
  "id": 6710,
  "name": "Crispy",
  "tax_identifier": "DE 123456789",
  "email": "crispy@example.com",
  "reference": "Num 12345",
  "debitor_identifier": null,
  "creditor_identifier": null,
  "preferred_locale": null,
  "created_at": "2018-07-03T11:44:52.210+02:00",
  "updated_at": "2018-07-03T11:44:52.210+02:00"
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given Organization record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)

Body

Media type: application/json

Type: object

Properties

organization: required (object)
- name: (string)
- reference: (string)
- email: (string)
- tax_identifier: (string)
- debitor_identifier: (string)
- creditor_identifier: (string)
- preferred_locale: (string)

Example:

{
  "organization": {
    "name": "Crispy",
    "reference": "Num 12345",
    "email": "crispy@example.com",
    "tax_identifier": "DE 123456789"
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/customer_relations/organizations/{organization_id}/people get post

The collection of People

get

Get a list of all Person objects.

post

Create a new Person object.

Get a list of all Person objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Person

salutation: required (string)
first_name: required (string)
name: required (string)
email: (string)
phone: (string)
fax: (string)
mobile: (string)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
debitor_identifier: (string)
tax_identifier: (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reference: (string)
preferred_locale: (string)
A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.

Example:

[
  {
    "id": 1245,
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-07-19T13:44:16.332+02:00",
    "updated_at": "2017-08-30T15:40:18.054+02:00"
  },
  {
    "id": 1244,
    "salutation": "Frau",
    "name": "König",
    "first_name": "Melanie",
    "mobile": null,
    "phone": "+4912345678",
    "fax": null,
    "tax_identifier": null,
    "email": "melanie@example.com",
    "reference": "A2NK84",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-11-17T12:25:23.479+01:00",
    "updated_at": "2017-11-17T12:25:23.479+01:00"
  },
  {
    "id": 1243,
    "salutation": "Herr Dr.",
    "name": "Christian",
    "first_name": "Weyer",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "w@example.com",
    "reference": "643D8V",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2016-12-14T07:50:45.625+01:00",
    "updated_at": "2016-12-14T08:55:54.524+01:00"
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new Person object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)

Body

Media type: application/json

Type: object

Properties

person: required (object)
- salutation: (string)
- first_name: required (string)
- name: required (string)
- email: required (string)
- phone: (string)
- fax: (string)
- mobile: (string)
- debitor_identifier: (string)
- preferred_locale: (string)
- tax_identifier: (string)
- reference: (string)

Example:

{
  "person": {
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": "+4912345678",
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null
  }
}

HTTP status code 201

This response is returned if creating a new Person was successful.

Body

Media type: application/json

Type: object

Properties

salutation: required (string)
first_name: required (string)
name: required (string)
email: (string)
phone: (string)
fax: (string)
mobile: (string)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
debitor_identifier: (string)
tax_identifier: (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reference: (string)
preferred_locale: (string)
A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.

Example:

{
  "id": 1245,
  "salutation": "Frau",
  "name": "Schöller",
  "first_name": "Maria",
  "mobile": null,
  "phone": null,
  "fax": null,
  "tax_identifier": null,
  "email": "maria@example.com",
  "reference": "HAXEZ3",
  "debitor_identifier": null,
  "preferred_locale": null,
  "created_at": "2017-07-19T13:44:16.332+02:00",
  "updated_at": "2017-08-30T15:40:18.054+02:00"
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/customer_relations/organizations/{organization_id}/people/{person_id} get patch delete

The collection of People.

get

Get a single Person record.

patch

Update the given Person record with provided data.

delete

Delete the given Person record.

Get a single Person record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)
person_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

salutation: required (string)
first_name: required (string)
name: required (string)
email: (string)
phone: (string)
fax: (string)
mobile: (string)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
debitor_identifier: (string)
tax_identifier: (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
reference: (string)
preferred_locale: (string)
A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.

Example:

{
  "id": 1245,
  "salutation": "Frau",
  "name": "Schöller",
  "first_name": "Maria",
  "mobile": null,
  "phone": null,
  "fax": null,
  "tax_identifier": null,
  "email": "maria@example.com",
  "reference": "HAXEZ3",
  "debitor_identifier": null,
  "preferred_locale": null,
  "created_at": "2017-07-19T13:44:16.332+02:00",
  "updated_at": "2017-08-30T15:40:18.054+02:00"
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given Person record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)
person_id: required (string)

Body

Media type: application/json

Type: object

Properties

person: required (object)
- salutation: (string)
- first_name: required (string)
- name: required (string)
- email: required (string)
- phone: (string)
- fax: (string)
- mobile: (string)
- debitor_identifier: (string)
- preferred_locale: (string)
- tax_identifier: (string)
- reference: (string)

Example:

{
  "person": {
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": "+4912345678",
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete the given Person record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

organization_id: required (string)
person_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/configuration

/configuration/stock_finishings get

get

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Stock Finishing

kind: required (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
common: required (boolean)
permitted_finishable_type: required (one of product, component, any)
To what kind of object can this finishing be applied? A Product or Component only, or any kind.
properties: required (array of response.FinishingProperty)
Items: Finishing Property
- key: required (string)
- show_to_customer: required (boolean)
- kind: required (one of boolean, integer, float, string)
- unit: required (one of pdf, piece, plate, sheet, folded_sheet, meter, sqmeter, sqmillimeter, millimeter, liter, milliliter, gram, kilogram, ream)
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.

Example:

[
  {
    "id": 171,
    "kind": "Blockleimen",
    "permitted_finishable_type": "any",
    "properties": [],
    "created_at": "2016-08-22T18:09:26.252+02:00",
    "updated_at": "2016-08-22T18:09:26.252+02:00",
    "common": true
  },
  {
    "id": 147,
    "kind": "Dispersionslackieren",
    "permitted_finishable_type": "any",
    "properties": [
      {
        "key": "beidseitig",
        "kind": "boolean",
        "show_to_customer": false
      }
    ],
    "created_at": "2016-08-01T12:11:10.706+02:00",
    "updated_at": "2016-08-01T12:12:20.242+02:00",
    "common": false
  },
  {
    "id": 19,
    "kind": "Durchschlagnummerieren",
    "permitted_finishable_type": "any",
    "properties": [],
    "created_at": "2015-11-23T18:28:22.847+01:00",
    "updated_at": "2016-01-05T11:45:20.594+01:00",
    "common": true
  },
  {
    "id": 14,
    "kind": "Eckrunden",
    "permitted_finishable_type": "any",
    "properties": [
      {
        "key": "Anzahl der Ecken",
        "kind": "integer",
        "unit": "piece",
        "show_to_customer": false
      }
    ],
    "created_at": "2015-11-23T18:28:22.814+01:00",
    "updated_at": "2016-07-19T16:58:16.266+02:00",
    "common": true
  },
  {
    "id": 11,
    "kind": "Fadenheftung",
    "permitted_finishable_type": "any",
    "properties": [],
    "created_at": "2015-11-23T18:28:22.794+01:00",
    "updated_at": "2016-01-05T11:43:01.964+01:00",
    "common": true
  },
  {
    "id": 3,
    "kind": "Folienprägen",
    "permitted_finishable_type": "any",
    "properties": [
      {
        "key": "Kosten für Folienprägestempel in EUR",
        "kind": "integer",
        "show_to_customer": false
      },
      {
        "key": "Folierungsbereich",
        "kind": "float",
        "unit": "sqmillimeter",
        "show_to_customer": false
      }
    ],
    "created_at": "2015-11-23T18:28:22.744+01:00",
    "updated_at": "2016-08-15T21:05:28.134+02:00",
    "common": true
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/configuration/stock_substrates get post

The collection of StockSubstrates

get

Get a list of all StockSubstrate objects.

post

Create a new StockSubstrate object.

Get a list of all StockSubstrate objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Stock Substrate

name: required (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
material_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
dimensions: required (array of integer - minItems: 2 - maxItems: 2)
The dimensions of the paper in mm, where the first element of the array is the width and the second being height.
grain: (one of long, short)
grammage: required (integer - minimum: 1)
Grammage of the paper (in gsm)
color_saturation: required (number - minimum: 0)
color: required (string)
A string describing the color. These are usually not comparable across suppliers.
thickness: (integer)
category: (string)
Describes the category of substrate that is represented by this object as a string.
kind: (string)
Describes the kind of substrate that is represented by this object as a string.
environmental_certification: (one of PEFC 70%, PEFC 100%, FSC 30%, FSC 50%, FSC 70%, FSC 80%, FSC 100%, FSC Mix Credit, FSC Mix 30%, FSC Mix 50%, FSC Mix 70%, FSC Mix 80%, FSC Recycled Credit, FSC Recycled 30%, FSC Recycled 50%, FSC Recycled 70%, FSC Recycled 80%, FSC Recycled 100%)
texture: (string)
A string describing the texture of the substrate. These are usually not comparable across suppliers.
delivered_precut: (boolean)

Example:

[
  {
    "id": 20083,
    "name": "Affichenpapier Rs Blau",
    "dimensions": [
      630,
      880
    ],
    "grain": "long",
    "grammage": 115,
    "color_saturation": null,
    "color": "weiß",
    "thickness": null,
    "category": "Bilderdruckpapier",
    "kind": "sheet",
    "environmental_certification": null,
    "texture": null,
    "delivered_precut": false,
    "created_at": "2016-09-06T16:48:25.349+02:00",
    "updated_at": "2017-07-19T13:37:26.226+02:00",
    "material_id": 69557,
  },
  {
    "id": 15078,
    "name": "Alaska Plus",
    "dimensions": [
      720,
      1020
    ],
    "grain": "long",
    "grammage": 235,
    "color_saturation": null,
    "color": "weiß",
    "thickness": null,
    "category": "Naturpapier matt",
    "kind": "sheet",
    "environmental_certification": null,
    "texture": null,
    "delivered_precut": false,
    "created_at": "2016-08-31T23:05:50.383+02:00",
    "updated_at": "2017-03-24T15:15:12.102+01:00",
    "material_id": 69224,
  },
  {
    "id": 15082,
    "name": "Alaska Plus",
    "dimensions": [
      720,
      1020
    ],
    "grain": "long",
    "grammage": 280,
    "color_saturation": null,
    "color": "weiß",
    "thickness": null,
    "category": "Naturpapier matt",
    "kind": "sheet",
    "environmental_certification": null,
    "texture": null,
    "delivered_precut": false,
    "created_at": "2016-08-31T23:05:51.751+02:00",
    "updated_at": "2017-03-24T15:15:13.030+01:00",
    "material_id": 69228,
  },
  {
    "id": 15083,
    "name": "Alaska Plus",
    "dimensions": [
      1020,
      720
    ],
    "grain": "short",
    "grammage": 280,
    "color_saturation": null,
    "color": "weiß",
    "thickness": null,
    "category": "Naturpapier matt",
    "kind": "sheet",
    "environmental_certification": null,
    "texture": null,
    "delivered_precut": false,
    "created_at": "2016-08-31T23:05:52.090+02:00",
    "updated_at": "2017-03-24T15:15:13.273+01:00",
    "material_id": 69229,
  },
  {
    "id": 21690,
    "name": "Algro Design",
    "dimensions": [
      720,
      1020
    ],
    "grain": "long",
    "grammage": 160,
    "color_saturation": null,
    "color": "weiß",
    "thickness": 181,
    "category": null,
    "kind": "sheet",
    "environmental_certification": "FSC Mix Credit",
    "texture": null,
    "delivered_precut": false,
    "created_at": "2016-09-06T16:55:55.649+02:00",
    "updated_at": "2016-09-06T16:55:55.649+02:00",
    "material_id": 70227,
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new StockSubstrate object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Body

Media type: application/json

Type: object

Properties

stock_substrate: required (object)
- name: required (string)
- dimensions: required (array of integer - minItems: 2 - maxItems: 2)
  The dimensions of the substrate in mm, where the first element of the array is the width and the second being height.
- grain: (one of long, short)
- grammage: required (integer - minimum: 1)
  Grammage of the substrate (in gsm)
- color_saturation: (number - minimum: 0)
- color: required (string)
  A string describing the color. These are usually not comparable across suppliers.
- thickness: (integer)
- category: (string)
  Describes the category of the substrate that is represented by this object as a string.
- kind: (string)
  Describes the kind of the substrate that is represented by this object as a string.
- environmental_certification: (one of PEFC 70%, PEFC 100%, FSC 30%, FSC 50%, FSC 70%, FSC 80%, FSC 100%, FSC Mix Credit, FSC Mix 30%, FSC Mix 50%, FSC Mix 70%, FSC Mix 80%, FSC Recycled Credit, FSC Recycled 30%, FSC Recycled 50%, FSC Recycled 70%, FSC Recycled 80%, FSC Recycled 100%)
- texture: (string)
  A string describing the texture of the substrate. These are usually not comparable across suppliers.
- delivered_precut: (boolean)

Example:

{
  "stock_substrate": {
    "name": "Conqueror Cx22",
    "dimensions": [640, 450],
    "category": "Naturpapier matt",
    "grain": null,
    "color": "Brilliant White",
    "grammage": 100,
    "thickness": 0
  }
}

HTTP status code 201

This response is returned if creating a new StockSubstrate was successful.

Body

Media type: application/json

Type: object

Properties

name: required (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
material_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
dimensions: required (array of integer - minItems: 2 - maxItems: 2)
The dimensions of the paper in mm, where the first element of the array is the width and the second being height.
grain: (one of long, short)
grammage: required (integer - minimum: 1)
Grammage of the paper (in gsm)
color_saturation: required (number - minimum: 0)
color: required (string)
A string describing the color. These are usually not comparable across suppliers.
thickness: (integer)
category: (string)
Describes the category of substrate that is represented by this object as a string.
kind: (string)
Describes the kind of substrate that is represented by this object as a string.
environmental_certification: (one of PEFC 70%, PEFC 100%, FSC 30%, FSC 50%, FSC 70%, FSC 80%, FSC 100%, FSC Mix Credit, FSC Mix 30%, FSC Mix 50%, FSC Mix 70%, FSC Mix 80%, FSC Recycled Credit, FSC Recycled 30%, FSC Recycled 50%, FSC Recycled 70%, FSC Recycled 80%, FSC Recycled 100%)
texture: (string)
A string describing the texture of the substrate. These are usually not comparable across suppliers.
delivered_precut: (boolean)

Example:

{
  "id": 15078,
  "name": "Alaska Plus",
  "dimensions": [
    720,
    1020
  ],
  "grain": "long",
  "grammage": 235,
  "color_saturation": null,
  "color": "weiß",
  "thickness": null,
  "category": "Naturpapier matt",
  "kind": "sheet",
  "environmental_certification": null,
  "texture": null,
  "delivered_precut": false,
  "created_at": "2016-08-31T23:05:50.383+02:00",
  "updated_at": "2017-03-24T15:15:12.102+01:00",
  "material_id": 69224
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/configuration/stock_substrates/{stock_substrate_id} get patch delete

The collection of StockSubstrates.

get

Get a single StockSubstrate record.

patch

Update the given StockSubstrate record with provided data.

delete

Delete the given StockSubstrate record.

Get a single StockSubstrate record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

stock_substrate_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

name: required (string)
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
material_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
dimensions: required (array of integer - minItems: 2 - maxItems: 2)
The dimensions of the paper in mm, where the first element of the array is the width and the second being height.
grain: (one of long, short)
grammage: required (integer - minimum: 1)
Grammage of the paper (in gsm)
color_saturation: required (number - minimum: 0)
color: required (string)
A string describing the color. These are usually not comparable across suppliers.
thickness: (integer)
category: (string)
Describes the category of substrate that is represented by this object as a string.
kind: (string)
Describes the kind of substrate that is represented by this object as a string.
environmental_certification: (one of PEFC 70%, PEFC 100%, FSC 30%, FSC 50%, FSC 70%, FSC 80%, FSC 100%, FSC Mix Credit, FSC Mix 30%, FSC Mix 50%, FSC Mix 70%, FSC Mix 80%, FSC Recycled Credit, FSC Recycled 30%, FSC Recycled 50%, FSC Recycled 70%, FSC Recycled 80%, FSC Recycled 100%)
texture: (string)
A string describing the texture of the substrate. These are usually not comparable across suppliers.
delivered_precut: (boolean)

Example:

{
  "id": 15078,
  "name": "Alaska Plus",
  "dimensions": [
    720,
    1020
  ],
  "grain": "long",
  "grammage": 235,
  "color_saturation": null,
  "color": "weiß",
  "thickness": null,
  "category": "Naturpapier matt",
  "kind": "sheet",
  "environmental_certification": null,
  "texture": null,
  "delivered_precut": false,
  "created_at": "2016-08-31T23:05:50.383+02:00",
  "updated_at": "2017-03-24T15:15:12.102+01:00",
  "material_id": 69224
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given StockSubstrate record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

stock_substrate_id: required (string)

Body

Media type: application/json

Type: object

Properties

stock_substrate: required (object)
- name: required (string)
- dimensions: required (array of integer - minItems: 2 - maxItems: 2)
  The dimensions of the substrate in mm, where the first element of the array is the width and the second being height.
- grain: (one of long, short)
- grammage: required (integer - minimum: 1)
  Grammage of the substrate (in gsm)
- color_saturation: (number - minimum: 0)
- color: required (string)
  A string describing the color. These are usually not comparable across suppliers.
- thickness: (integer)
- category: (string)
  Describes the category of the substrate that is represented by this object as a string.
- kind: (string)
  Describes the kind of the substrate that is represented by this object as a string.
- environmental_certification: (one of PEFC 70%, PEFC 100%, FSC 30%, FSC 50%, FSC 70%, FSC 80%, FSC 100%, FSC Mix Credit, FSC Mix 30%, FSC Mix 50%, FSC Mix 70%, FSC Mix 80%, FSC Recycled Credit, FSC Recycled 30%, FSC Recycled 50%, FSC Recycled 70%, FSC Recycled 80%, FSC Recycled 100%)
- texture: (string)
  A string describing the texture of the substrate. These are usually not comparable across suppliers.
- delivered_precut: (boolean)

Example:

{
  "stock_substrate": {
    "name": "Conqueror Cx22",
    "dimensions": [640, 450],
    "category": "Naturpapier matt",
    "grain": null,
    "color": "Brilliant White",
    "grammage": 100,
    "thickness": 0
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete the given StockSubstrate record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

stock_substrate_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/configuration/printery get

get

Returns all printery-wide settings.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: configuration.Printery

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/sales

/sales/orders get post

The collection of Orders

get

Get a list of all orders in draft state, that is orders that haven't been confirmed by their customer yet, and for which production hasn't started yet.

post

Create a new Order object.

Get a list of all orders in draft state, that is orders that haven't been confirmed by their customer yet, and for which production hasn't started yet.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Order

custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
custom_offer_text: (string)
An additional string that should appear on the offer to the customer.
due_at: (datetime)
The point in time until which the order must be delivered to the customer.
products: required (array of response.Product)
Items: Product
- name: required (string - minLength: 1 - maxLength: 200)
- order_id: required (integer)
  The id of the order, this product belongs to.
- reference: required (string - pattern: ^[0-9A-Z]{6}$)
  A 6-character, alphanumeric string, that uniquely identifies an object.
  
  Example:
```
N4XTC8
```
- custom_references: required (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the product
- state: required (one of draft, prepress, press, postpress, packing, shipping, completed, exception, canceled)
  Denotes the state which the product is currently in
- kind: required (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
  The kind of product
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
contact: (object)
Describes a natural person
- salutation: required (string)
- first_name: required (string)
- name: required (string)
- email: (string)
- phone: (string)
- fax: (string)
- mobile: (string)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
address: (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
customer: (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
reference: required (string - pattern: ^[0-9A-Z]{6}$)
A 6-character, alphanumeric string, that uniquely identifies an object.

Example:
```
N4XTC8
```
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

[
  {
    "id": 16054,
    "reference": "VGQGB4",
    "custom_references": {
      "Besteller": "Knusper Berg"
    },
    "custom_offer_text": null,
    "due_at": null,
    "created_at": "2017-11-28T17:44:21.526+01:00",
    "updated_at": "2017-12-04T08:26:14.592+01:00",
    "customer_id": 6710,
    "customer_type": "Organization",
    "customer": {
      "id": 6710,
      "name": "Crispy",
      "tax_identifier": "DE 123456789",
      "email": "crispy@example.com",
      "reference": "Num 12345",
      "debitor_identifier": null,
      "creditor_identifier": null,
      "preferred_locale": null,
      "created_at": "2018-07-03T11:44:52.210+02:00",
      "updated_at": "2018-07-03T11:44:52.210+02:00"
    },
    "contact": {
      "id": 1245,
      "salutation": "Frau",
      "name": "Schöller",
      "first_name": "Maria",
      "mobile": null,
      "phone": null,
      "fax": null,
      "tax_identifier": null,
      "email": "maria@example.com",
      "reference": "HAXEZ3",
      "debitor_identifier": null,
      "preferred_locale": null,
      "created_at": "2017-07-19T13:44:16.332+02:00",
      "updated_at": "2017-08-30T15:40:18.054+02:00"
    },
    "address": {
      "addressee": "Crispy Mountain GmbH",
      "street": "Emmerich Josef Straße",
      "number": "1a",
      "addition": "",
      "zip_code": "55116",
      "town": "Mainz",
      "country_code": "DE"
    },
    "products": [
      {
        "id": 23511,
        "order_id": 16054,
        "reference": "CHC71H",
        "custom_references": {},
        "state": "draft",
        "name": "New Product",
        "kind": "book",
        "created_at": "2017-11-28T17:44:49.868+01:00",
        "updated_at": "2017-11-28T17:44:49.868+01:00"
      }
    ]
  },
  {
    "id": 13013,
    "reference": "NC8G8E",
    "custom_references": {},
    "custom_offer_text": null,
    "due_at": null,
    "created_at": "2017-10-17T11:47:54.764+02:00",
    "updated_at": "2017-10-17T11:47:54.764+02:00",
    "address": null,
    "customer_id": null,
    "customer_type": null,
    "contact": null,
    "products": [
      {
        "id": 20012,
        "order_id": 13013,
        "reference": "G62ZTU",
        "custom_references": {},
        "state": "draft",
        "name": "Blatt",
        "kind": "custom",
        "created_at": "2017-10-17T11:48:09.478+02:00",
        "updated_at": "2017-10-17T11:48:09.478+02:00"
      }
    ]
  },
  {
    "id": 12359,
    "reference": "ZRHFZW",
    "custom_references": {},
    "custom_offer_text": null,
    "due_at": null,
    "created_at": "2017-10-04T11:49:01.273+02:00",
    "updated_at": "2017-10-04T11:57:01.596+02:00",
    "address": {
      "addressee": "Keyline\r\nc/o Crispy Mountain GmbH",
      "street": "Emmerich-Josef-Str.",
      "number": "1a",
      "addition": "Hinterhaus",
      "zip_code": "55116",
      "town": "Mainz",
      "country_code": "DE"
    },
    "customer_id": 6710,
    "customer_type": "Organization",
    "customer": {
      "id": 6710,
      "name": "Crispy",
      "tax_identifier": "DE 123456789",
      "email": "crispy@example.com",
      "reference": "Num 12345",
      "debitor_identifier": null,
      "creditor_identifier": null,
      "preferred_locale": null,
      "created_at": "2018-07-03T11:44:52.210+02:00",
      "updated_at": "2018-07-03T11:44:52.210+02:00"
    },
    "contact": {
      "id": 1245,
      "salutation": "Frau",
      "name": "Schöller",
      "first_name": "Maria",
      "mobile": null,
      "phone": null,
      "fax": null,
      "tax_identifier": null,
      "email": "maria@example.com",
      "reference": "HAXEZ3",
      "debitor_identifier": null,
      "preferred_locale": null,
      "created_at": "2017-07-19T13:44:16.332+02:00",
      "updated_at": "2017-08-30T15:40:18.054+02:00"
    },
    "products": [
      {
        "id": 19145,
        "order_id": 12359,
        "reference": "K7KD1D",
        "custom_references": {},
        "state": "draft",
        "name": "Great Stickers",
        "kind": "sticker",
        "created_at": "2017-10-04T11:51:40.845+02:00",
        "updated_at": "2017-10-04T11:51:40.845+02:00"
      }
    ]
  },
  {
    "id": 12314,
    "reference": "T3EPVR",
    "custom_references": {},
    "custom_offer_text": null,
    "due_at": null,
    "created_at": "2017-10-02T15:47:37.663+02:00",
    "updated_at": "2017-10-02T15:47:37.663+02:00",
    "address": null,
    "customer": null,
    "contact": null,
    "products": [
      {
        "id": 19088,
        "order_id": 12314,
        "reference": "MQKX72",
        "custom_references": {},
        "state": "draft",
        "name": "Visitenkarte",
        "kind": "business_card",
        "created_at": "2017-10-02T15:47:43.213+02:00",
        "updated_at": "2017-10-02T15:47:43.213+02:00"
      },
      {
        "id": 19089,
        "order_id": 12314,
        "reference": "8UU1DR",
        "custom_references": {},
        "state": "draft",
        "name": "Visitenkarte (basiert auf MQKX72)",
        "kind": "business_card",
        "created_at": "2017-10-02T15:48:32.623+02:00",
        "updated_at": "2017-10-02T15:48:32.623+02:00"
      }
    ]
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new Order object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Body

Media type: application/json

Type: object

Properties

order: required (object)
- custom_references: (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
- custom_offer_text: (string)
  An additional string that should appear on the offer to the customer.
- due_at: (datetime)
  The point in time until which the order must be delivered to the customer.
- customer_id: (integer)
  The id of the customer this order should be associated to.

Example:

{
  "order": {
    "custom_references": {
      "Ordering Person": "Ms Stark"
    },
    "custom_offer_text": "This is urgent",
    "due_at": "2017-12-12T17:00:00+02:00",
    "customer_id": 57
  }
}

HTTP status code 201

This response is returned if creating a new Order was successful.

Body

Media type: application/json

Type: object

Properties

custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
custom_offer_text: (string)
An additional string that should appear on the offer to the customer.
due_at: (datetime)
The point in time until which the order must be delivered to the customer.
products: required (array of response.Product)
Items: Product
- name: required (string - minLength: 1 - maxLength: 200)
- order_id: required (integer)
  The id of the order, this product belongs to.
- reference: required (string - pattern: ^[0-9A-Z]{6}$)
  A 6-character, alphanumeric string, that uniquely identifies an object.
  
  Example:
```
N4XTC8
```
- custom_references: required (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the product
- state: required (one of draft, prepress, press, postpress, packing, shipping, completed, exception, canceled)
  Denotes the state which the product is currently in
- kind: required (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
  The kind of product
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
contact: (object)
Describes a natural person
- salutation: required (string)
- first_name: required (string)
- name: required (string)
- email: (string)
- phone: (string)
- fax: (string)
- mobile: (string)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
address: (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
customer: (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
reference: required (string - pattern: ^[0-9A-Z]{6}$)
A 6-character, alphanumeric string, that uniquely identifies an object.

Example:
```
N4XTC8
```
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 16054,
  "reference": "VGQGB4",
  "custom_references": {},
  "custom_offer_text": null,
  "due_at": null,
  "created_at": "2017-11-28T17:44:21.526+01:00",
  "updated_at": "2017-12-04T08:26:14.592+01:00",
  "address": null,
  "customer_id": null,
  "customer_type": null,
  "contact": null,
  "products": []
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/sales/orders/{order_id} get patch delete

The collection of Orders.

get

Get details for a single order, which is in draft state, that is it hasn't been confirmed by it's customer yet and production of the order hasn't started yet.

patch

Update details for a single draft order.

delete

Delete a draft order.

Get details for a single order, which is in draft state, that is it hasn't been confirmed by it's customer yet and production of the order hasn't started yet.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

order_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
custom_offer_text: (string)
An additional string that should appear on the offer to the customer.
due_at: (datetime)
The point in time until which the order must be delivered to the customer.
products: required (array of response.Product)
Items: Product
- name: required (string - minLength: 1 - maxLength: 200)
- order_id: required (integer)
  The id of the order, this product belongs to.
- reference: required (string - pattern: ^[0-9A-Z]{6}$)
  A 6-character, alphanumeric string, that uniquely identifies an object.
  
  Example:
```
N4XTC8
```
- custom_references: required (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the product
- state: required (one of draft, prepress, press, postpress, packing, shipping, completed, exception, canceled)
  Denotes the state which the product is currently in
- kind: required (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
  The kind of product
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
contact: (object)
Describes a natural person
- salutation: required (string)
- first_name: required (string)
- name: required (string)
- email: (string)
- phone: (string)
- fax: (string)
- mobile: (string)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
address: (object)
An Address object represents a postal Address
- addressee: required (string)
- town: required (string)
- number: (string)
- country_code: required (string)
  ISO Country code of country this address is located in.
- zip_code: required (string)
- street: (string)
- addition: (string)
  An optional additional information, usually displayed right below the address.
customer: (object)
A Organization object represents a customer of a printery
- name: required (string)
- email: (string)
- preferred_locale: (string)
  A two-letter ISO country code, that identifies the language the person or organization prefers to be contacted with.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- creditor_identifier: (string)
- debitor_identifier: (string)
- tax_identifier: (string)
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- reference: (string)
reference: required (string - pattern: ^[0-9A-Z]{6}$)
A 6-character, alphanumeric string, that uniquely identifies an object.

Example:
```
N4XTC8
```
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 16054,
  "reference": "VGQGB4",
  "custom_references": {
    "Besteller": "Knusper Berg"
  },
  "custom_offer_text": null,
  "due_at": null,
  "created_at": "2017-11-28T17:44:21.526+01:00",
  "updated_at": "2017-12-04T08:26:14.592+01:00",
  "customer_id": 6710,
  "customer_type": "Organization",
  "customer": {
    "id": 6710,
    "name": "Crispy",
    "tax_identifier": "DE 123456789",
    "email": "crispy@example.com",
    "reference": "Num 12345",
    "debitor_identifier": null,
    "creditor_identifier": null,
    "preferred_locale": null,
    "created_at": "2018-07-03T11:44:52.210+02:00",
    "updated_at": "2018-07-03T11:44:52.210+02:00"
  },
  "contact": {
    "id": 1245,
    "salutation": "Frau",
    "name": "Schöller",
    "first_name": "Maria",
    "mobile": null,
    "phone": null,
    "fax": null,
    "tax_identifier": null,
    "email": "maria@example.com",
    "reference": "HAXEZ3",
    "debitor_identifier": null,
    "preferred_locale": null,
    "created_at": "2017-07-19T13:44:16.332+02:00",
    "updated_at": "2017-08-30T15:40:18.054+02:00"
  },
  "address": {
    "addressee": "Crispy Mountain GmbH",
    "street": "Emmerich Josef Straße",
    "number": "1a",
    "addition": "",
    "zip_code": "55116",
    "town": "Mainz",
    "country_code": "DE"
  },
  "products": [
    {
      "id": 23511,
      "order_id": 16054,
      "reference": "CHC71H",
      "custom_references": {},
      "state": "draft",
      "name": "New Product",
      "kind": "book",
      "created_at": "2017-11-28T17:44:49.868+01:00",
      "updated_at": "2017-11-28T17:44:49.868+01:00"
    }
  ]
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update details for a single draft order.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

order_id: required (string)

Body

Media type: application/json

Type: object

Properties

order: required (object)
- custom_references: (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
- custom_offer_text: (string)
  An additional string that should appear on the offer to the customer.
- due_at: (datetime)
  The point in time until which the order must be delivered to the customer.
- customer_id: (integer)
  The id of the customer this order should be associated to.

Example:

{
  "order": {
    "custom_references": {
      "Ordering Person": "Ms Stark"
    },
    "custom_offer_text": "This is urgent",
    "due_at": "2017-12-12T17:00:00+02:00",
    "customer_id": 57
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete a draft order.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

order_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/sales/orders/{order_id}/products get post

The collection of Products

get

Get a list of all Product objects.

post

Create a new Product object.

Get a list of all Product objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

order_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Product

name: required (string - minLength: 1 - maxLength: 200)
order_id: required (integer)
The id of the order, this product belongs to.
reference: required (string - pattern: ^[0-9A-Z]{6}$)
A 6-character, alphanumeric string, that uniquely identifies an object.

Example:
```
N4XTC8
```
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the product
state: required (one of draft, prepress, press, postpress, packing, shipping, completed, exception, canceled)
Denotes the state which the product is currently in
kind: required (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
The kind of product
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

[
  {
    "id": 23426,
    "order_id": 15532,
    "reference": "VRHKQH",
    "custom_references": {},
    "state": "draft",
    "name": "Visitenkarte",
    "kind": "business_card",
    "created_at": "2017-11-28T10:21:33.329+01:00",
    "updated_at": "2017-11-28T10:21:33.329+01:00"
  },
  {
    "id": 23430,
    "order_id": 15532,
    "reference": "UQQV1C",
    "custom_references": {},
    "state": "draft",
    "name": "Broschüre (Rückendrahtheftung)",
    "kind": "brochure",
    "created_at": "2017-11-28T10:34:11.209+01:00",
    "updated_at": "2017-11-28T10:34:11.209+01:00"
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new Product object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

order_id: required (string)

Body

Media type: application/json

Type: object

Properties

product: required (object)
Either product_template_id or name have to be given when creating a product.
- custom_references: (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
- product_template_id: (integer)
  The id of the pre-defined product template on which this product should be based.
- name: (string)
  Name of the product being printed.
- kind: (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
  Denotes the kind of product being printed.

Example:

{
   "product": {
     "name": "Great Business Cards",
     "kind": "business_card",
     "custom_references": {
       "PO": "1234"
     }
   }
}

HTTP status code 201

This response is returned if creating a new Product was successful.

Body

Media type: application/json

Type: object

Properties

name: required (string - minLength: 1 - maxLength: 200)
order_id: required (integer)
The id of the order, this product belongs to.
reference: required (string - pattern: ^[0-9A-Z]{6}$)
A 6-character, alphanumeric string, that uniquely identifies an object.

Example:
```
N4XTC8
```
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the product
state: required (one of draft, prepress, press, postpress, packing, shipping, completed, exception, canceled)
Denotes the state which the product is currently in
kind: required (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
The kind of product
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 25088,
  "order_id": 15532,
  "reference": "H9WPQ7",
  "custom_references": {
    "PO": "123"
  },
  "state": "draft",
  "name": "Visitenkarte",
  "kind": "business_card",
  "created_at": "2017-12-11T14:39:36.904+01:00",
  "updated_at": "2017-12-11T14:39:36.904+01:00"
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception

/conception/products/{product_id} get delete patch

The collection of Products.

get

Get details for a single product, which is in draft state, that is the order it belongs to hasn't been confirmed by it's customer yet and production hasn't started yet.

delete

Delete a product in draft state.

patch

Update the given Product record with provided data.

Get details for a single product, which is in draft state, that is the order it belongs to hasn't been confirmed by it's customer yet and production hasn't started yet.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

name: required (string - minLength: 1 - maxLength: 200)
order_id: required (integer)
The id of the order, this product belongs to.
reference: required (string - pattern: ^[0-9A-Z]{6}$)
A 6-character, alphanumeric string, that uniquely identifies an object.

Example:
```
N4XTC8
```
custom_references: required (object)
Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the product
state: required (one of draft, prepress, press, postpress, packing, shipping, completed, exception, canceled)
Denotes the state which the product is currently in
kind: required (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
The kind of product
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 25088,
  "order_id": 15532,
  "reference": "H9WPQ7",
  "custom_references": {
    "PO": "123"
  },
  "state": "draft",
  "name": "Visitenkarte",
  "kind": "business_card",
  "created_at": "2017-12-11T14:39:36.904+01:00",
  "updated_at": "2017-12-11T14:39:36.904+01:00"
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete a product in draft state.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given Product record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

Body

Media type: application/json

Type: object

Properties

product: required (object)
Either product_template_id or name have to be given when creating a product.
- custom_references: (object)
  Contains up to 5 arbitrary key-value entries, for data that doesn't fit into any other category of the order
- product_template_id: (integer)
  The id of the pre-defined product template on which this product should be based.
- name: (string)
  Name of the product being printed.
- kind: (one of brochure, book, business_card, sticker, pad, pages, couvert, custom)
  Denotes the kind of product being printed.

Example:

{
   "product": {
     "name": "Great Business Cards",
     "kind": "business_card",
     "custom_references": {
       "PO": "1234"
     }
   }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception/products/{product_id}/production_paths get post

The collection of ProductionPaths

get

Get a list of all ProductionPath objects.

post

Create a new ProductionPath object.

Get a list of all ProductionPath objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: ProductionPath

circulation: required (integer - minimum: 1)
The product's combined circulation, that is the sum of all variants' circulations. This also means, that if you want to change this value, you need to adjust the circulations for the respective variants.
state: required (one of done, pending, preparing, imposing, planning, calculating, error)
Describes the state of this production path. This usually done and only changes when Keyline calculates the conception of the product.
selected_for_production: required (boolean)
Denotes if this production path has been selected for the actual production of the product.
show_in_offer: required (boolean)
Denotes, if this production path with all it's details should be added to the offer that's sent to the customer.
production_costs: required (integer)
costs_per_unit: required (number)
costs_per_thousand: required (integer)
discounted_total: required (integer)
outsourced: required (boolean)
If set to true, no production planning will happen for this production path.
keep_total: required (boolean)
If set to true, then the value for total is fixed and the margin is adjusted. If set to false, then margin is fixed and the value of total will be adjusted, based on the production_costs and margin.
sub_total: required (integer)
Denotes the sub_total price for this production path, which is the total minus any service costs, and must be given in the smallest currency unit of the printery.
total: required (integer)
Denotes the total price for this production path.
discount: required (number - minimum: 0 - maximum: 1)
Denotes the discount, given as a percentage, that should be applied to this production paths costs in order to calculate the total price of the printed goods. The discount is not applied to services associated with the current product.
margin: required (number - minimum: 0)
Denotes the margin that should be applied to the costs of this production path's printed goods.
product_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

[
  {
    "id": 34207,
    "product_id": 23426,
    "state": "done",
    "circulation": 300,
    "selected_for_production": false,
    "show_in_offer": true,
    "production_costs": 186335,
    "costs_per_unit": "633.54",
    "costs_per_thousand": 633540,
    "total": 190062,
    "margin": "0.02",
    "discount": "0.0",
    "discounted_total": 190062,
    "outsourced": false,
    "keep_total": false,
    "created_at": "2017-12-12T10:06:04.652+01:00",
    "updated_at": "2017-12-12T10:07:38.851+01:00"
  },
  {
    "id": 32069,
    "product_id": 23426,
    "state": "done",
    "circulation": 3000,
    "selected_for_production": true,
    "show_in_offer": true,
    "production_costs": 187164,
    "costs_per_unit": "63.636",
    "costs_per_thousand": 63636,
    "total": 190908,
    "margin": "0.02",
    "discount": "0.0",
    "discounted_total": 190908,
    "outsourced": false,
    "keep_total": false,
    "created_at": "2017-11-28T10:21:33.373+01:00",
    "updated_at": "2017-12-11T16:38:22.812+01:00"
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new ProductionPath object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

Body

Media type: application/json

Type: object

Properties

production_path: required (object)
- show_in_offer: (boolean)
  Denotes, if this production path with all it's details should be added to the offer that's sent to the customer.
- outsourced: (boolean)
  If set to true, no production planning will happen for this production path.
- keep_total: (boolean)
  If set to true, then the value for total is fixed and the margin is adjusted. If set to false, then margin is fixed and
- sub_total: (integer)
  Denotes the sub_total price for this production path, which is the total minus any service costs, and must be given in the smallest currency unit of the printery.
- discount: (number - minimum: 0 - maximum: 1)
  Denotes the discount, given as a percentage, that should be applied to this production paths costs in order to calculate the total price of the printed goods. The discount is not applied to services associated with the current product.
- margin: (number - minimum: 0)
  Denotes the margin that should be applied to the costs of this production path's printed goods.

Example:

{
  "production_path": {
    "show_in_offer": false
  }
}

HTTP status code 201

This response is returned if creating a new ProductionPath was successful.

Body

Media type: application/json

Type: object

Properties

circulation: required (integer - minimum: 1)
The product's combined circulation, that is the sum of all variants' circulations. This also means, that if you want to change this value, you need to adjust the circulations for the respective variants.
state: required (one of done, pending, preparing, imposing, planning, calculating, error)
Describes the state of this production path. This usually done and only changes when Keyline calculates the conception of the product.
selected_for_production: required (boolean)
Denotes if this production path has been selected for the actual production of the product.
show_in_offer: required (boolean)
Denotes, if this production path with all it's details should be added to the offer that's sent to the customer.
production_costs: required (integer)
costs_per_unit: required (number)
costs_per_thousand: required (integer)
discounted_total: required (integer)
outsourced: required (boolean)
If set to true, no production planning will happen for this production path.
keep_total: required (boolean)
If set to true, then the value for total is fixed and the margin is adjusted. If set to false, then margin is fixed and the value of total will be adjusted, based on the production_costs and margin.
sub_total: required (integer)
Denotes the sub_total price for this production path, which is the total minus any service costs, and must be given in the smallest currency unit of the printery.
total: required (integer)
Denotes the total price for this production path.
discount: required (number - minimum: 0 - maximum: 1)
Denotes the discount, given as a percentage, that should be applied to this production paths costs in order to calculate the total price of the printed goods. The discount is not applied to services associated with the current product.
margin: required (number - minimum: 0)
Denotes the margin that should be applied to the costs of this production path's printed goods.
product_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 34207,
  "product_id": 23426,
  "state": "done",
  "circulation": 300,
  "selected_for_production": false,
  "show_in_offer": true,
  "production_costs": 186335,
  "costs_per_unit": "633.54",
  "costs_per_thousand": 633540,
  "total": 190062,
  "margin": "0.02",
  "discount": "0.0",
  "discounted_total": 190062,
  "outsourced": false,
  "keep_total": false,
  "created_at": "2017-12-12T10:06:04.652+01:00",
  "updated_at": "2017-12-12T10:07:38.851+01:00"
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception/products/{product_id}/production_paths/{production_path_id} get patch delete

The collection of ProductionPaths.

get

Get a single ProductionPath record.

patch

Update the given ProductionPath record with provided data.

delete

Delete the given ProductionPath record.

Get a single ProductionPath record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
production_path_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

circulation: required (integer - minimum: 1)
The product's combined circulation, that is the sum of all variants' circulations. This also means, that if you want to change this value, you need to adjust the circulations for the respective variants.
state: required (one of done, pending, preparing, imposing, planning, calculating, error)
Describes the state of this production path. This usually done and only changes when Keyline calculates the conception of the product.
selected_for_production: required (boolean)
Denotes if this production path has been selected for the actual production of the product.
show_in_offer: required (boolean)
Denotes, if this production path with all it's details should be added to the offer that's sent to the customer.
production_costs: required (integer)
costs_per_unit: required (number)
costs_per_thousand: required (integer)
discounted_total: required (integer)
outsourced: required (boolean)
If set to true, no production planning will happen for this production path.
keep_total: required (boolean)
If set to true, then the value for total is fixed and the margin is adjusted. If set to false, then margin is fixed and the value of total will be adjusted, based on the production_costs and margin.
sub_total: required (integer)
Denotes the sub_total price for this production path, which is the total minus any service costs, and must be given in the smallest currency unit of the printery.
total: required (integer)
Denotes the total price for this production path.
discount: required (number - minimum: 0 - maximum: 1)
Denotes the discount, given as a percentage, that should be applied to this production paths costs in order to calculate the total price of the printed goods. The discount is not applied to services associated with the current product.
margin: required (number - minimum: 0)
Denotes the margin that should be applied to the costs of this production path's printed goods.
product_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.
id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 34207,
  "product_id": 23426,
  "state": "done",
  "circulation": 300,
  "selected_for_production": false,
  "show_in_offer": true,
  "production_costs": 186335,
  "costs_per_unit": "633.54",
  "costs_per_thousand": 633540,
  "total": 190062,
  "margin": "0.02",
  "discount": "0.0",
  "discounted_total": 190062,
  "outsourced": false,
  "keep_total": false,
  "created_at": "2017-12-12T10:06:04.652+01:00",
  "updated_at": "2017-12-12T10:07:38.851+01:00"
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given ProductionPath record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
production_path_id: required (string)

Body

Media type: application/json

Type: object

Properties

production_path: required (object)
- show_in_offer: (boolean)
  Denotes, if this production path with all it's details should be added to the offer that's sent to the customer.
- outsourced: (boolean)
  If set to true, no production planning will happen for this production path.
- keep_total: (boolean)
  If set to true, then the value for total is fixed and the margin is adjusted. If set to false, then margin is fixed and
- sub_total: (integer)
  Denotes the sub_total price for this production path, which is the total minus any service costs, and must be given in the smallest currency unit of the printery.
- discount: (number - minimum: 0 - maximum: 1)
  Denotes the discount, given as a percentage, that should be applied to this production paths costs in order to calculate the total price of the printed goods. The discount is not applied to services associated with the current product.
- margin: (number - minimum: 0)
  Denotes the margin that should be applied to the costs of this production path's printed goods.

Example:

{
  "production_path": {
    "show_in_offer": false
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete the given ProductionPath record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
production_path_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception/products/{product_id}/production_paths/{production_path_id}/circulations get

The collection of Circulations

get

Get a list of all Circulation objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
production_path_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Circulation

circulation: required (object)
- amount: required (integer - minimum: 1)
- variant_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.

Example:

[
  {
    "id": 38433,
    "variant_id": 47691,
    "amount": 1000,
    "created_at": "2017-12-12T10:50:22.770+01:00",
    "updated_at": "2017-12-12T10:50:22.770+01:00"
  },
  {
    "id": 38434,
    "variant_id": 49742,
    "amount": 1000,
    "created_at": "2017-12-12T10:50:22.781+01:00",
    "updated_at": "2017-12-12T10:50:22.781+01:00"
  },
  {
    "id": 38435,
    "variant_id": 49743,
    "amount": 1000,
    "created_at": "2017-12-12T10:50:22.798+01:00",
    "updated_at": "2017-12-12T10:50:22.798+01:00"
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception/products/{product_id}/production_paths/{production_path_id}/circulations/{circulation_id} get patch

The collection of Circulations.

get

Get a single Circulation record.

patch

Update the given Circulation record with provided data.

Get a single Circulation record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
production_path_id: required (string)
circulation_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

circulation: required (object)
- amount: required (integer - minimum: 1)
- variant_id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 38433,
  "variant_id": 47691,
  "amount": 1000,
  "created_at": "2017-12-12T10:50:22.770+01:00",
  "updated_at": "2017-12-12T10:50:22.770+01:00"
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given Circulation record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
production_path_id: required (string)
circulation_id: required (string)

Body

Media type: application/json

Type: object

Properties

circulation: required (object)
- amount: required (integer - minimum: 1)

Example:

{
  "circulation": {
    "amount": 10000
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception/products/{product_id}/variants get post

The collection of Variants

get

Get a list of all Variant objects.

post

Create a new Variant object.

Get a list of all Variant objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Variant

variant: required (object)
- name: required (string - minLength: 1 - maxLength: 200)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.

Example:

[
  {
    "id": 47691,
    "name": "French Cards",
    "created_at": "2017-11-28T10:21:33.384+01:00",
    "updated_at": "2017-12-11T16:38:17.174+01:00"
  },
  {
    "id": 49742,
    "name": "English Cards",
    "created_at": "2017-12-11T16:38:05.856+01:00",
    "updated_at": "2017-12-11T16:38:05.856+01:00"
  },
  {
    "id": 49743,
    "name": "German Cards",
    "created_at": "2017-12-11T16:38:21.358+01:00",
    "updated_at": "2017-12-11T16:38:21.358+01:00"
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Create a new Variant object.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)

Body

Media type: application/json

Type: object

Properties

variant: required (object)
- name: required (string - minLength: 1 - maxLength: 200)

Example:

{
   "variant": {
     "name": "English Business Cards"
   }
}

HTTP status code 201

This response is returned if creating a new Variant was successful.

Body

Media type: application/json

Type: object

Properties

variant: required (object)
- name: required (string - minLength: 1 - maxLength: 200)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 49742,
  "name": "English Cards",
  "created_at": "2017-12-11T16:38:05.856+01:00",
  "updated_at": "2017-12-11T16:38:05.856+01:00"
}

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/conception/products/{product_id}/variants/{variant_id} get patch delete

The collection of Variants.

get

Get a single Variant record.

patch

Update the given Variant record with provided data.

delete

Delete the given Variant record.

Get a single Variant record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
variant_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

variant: required (object)
- name: required (string - minLength: 1 - maxLength: 200)
- created_at: required (datetime)
  The exact time the respective object was created.
- updated_at: required (datetime)
  The exact time the respective object was last updated.
- id: required (integer - minimum: 1)
  Unique identifier for every object. Is used when referencing resources in URLs.

Example:

{
  "id": 49742,
  "name": "English Cards",
  "created_at": "2017-12-11T16:38:05.856+01:00",
  "updated_at": "2017-12-11T16:38:05.856+01:00"
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given Variant record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
variant_id: required (string)

Body

Media type: application/json

Type: object

Properties

variant: required (object)
- name: required (string - minLength: 1 - maxLength: 200)

Example:

{
   "variant": {
     "name": "English Business Cards"
   }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Delete the given Variant record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

product_id: required (string)
variant_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/production

/production/tasks get

The collection of Tasks

get

Get a list of all Task objects.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

Response
Security

HTTP status code 200

Body

Media type: application/json

Type: array of object

Items: Task

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
workable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
workable_type: required (string)
state: required (one of draft, waiting_for_go, waiting_for_checkpoint, waiting_for_materials, unfulfillable_material_demand, ready, running, completed, exception, canceled)
checkpoint: required (string)
kind: required (string)
description: required (string)
phase: required (string)
formula_for_preparations: required (string)
formula_for_execution: required (string)
formula_for_cleanup: required (string)
formula_for_additional_external_costs: required (string)
duration_for_preparations: required (integer)
duration_for_execution: required (integer)
duration_for_cleanup: required (integer)
duration: required (integer)
actual_duration_for_preparations: required (integer)
actual_duration_for_execution: required (integer)
actual_duration_for_cleanup: required (integer)
actual_duration: required (integer)
costs_per_hour: required (integer)
additional_external_costs: required (integer)
costs: required (integer)
required_variables: required (object)
automation: required (string)
outsourced: required (boolean)
inline: required (boolean)
actual_duration_for_exception: required (integer)
production_path_id: required (integer)
formula_for_additional_internal_costs: required (string)
additional_internal_costs: required (integer)
means_of_production_id: required (integer)
required_means_of_production_capability: required (string)
duration_for_pause_until_next_task: required (integer)
formula_for_pause_until_next_task: required (string)
manufactured_product: required (string)
product_processing: required (string)
formula_for_amount_of_manufactured_products: required (string)
amount_of_manufactured_products: required (integer)
actual_amount_of_manufactured_products: required (integer)
formula_for_amount_of_wasted_manufactured_products: required (string)
amount_of_wasted_manufactured_products: required (integer)
actual_amount_of_wasted_manufactured_products: required (integer)
minimum_viable_amount_of_manufactured_products: required (integer)
stock_task_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.

Example:

[
  {
      "id": 170889,
      "workable_id": 26130,
      "workable_type": "Finishing",
      "state": "unfulfillable_material_demand",
      "checkpoint": "none",
      "kind": "Handzusammentragen",
      "description": null,
      "phase": "postpress",
      "formula_for_preparations": "30",
      "formula_for_execution": "(number_of_components*5)*(circulation*5)",
      "formula_for_cleanup": "30",
      "formula_for_additional_external_costs": "",
      "duration_for_preparations": 30,
      "duration_for_execution": 3375,
      "duration_for_cleanup": 30,
      "duration": 3435,
      "actual_duration_for_preparations": 30,
      "actual_duration_for_execution": 3375,
      "actual_duration_for_cleanup": 30,
      "actual_duration": 3435,
      "costs_per_hour": 3000,
      "additional_external_costs": 0,
      "costs": 6233,
      "created_at": "2017-09-12T14:12:08.596+02:00",
      "updated_at": "2018-02-14T15:15:33.510+01:00",
      "required_variables": {
          "circulation": {
              "value": 45,
              "errors": false,
              "resolved_by": "product",
              "display_key_as": "Auflage"
          },
          "number_of_components": {
              "value": 3,
              "errors": false,
              "resolved_by": "product",
              "display_key_as": "Anzahl der Komponenten"
          }
      },
      "automation": "for_finishing_with_same_name",
      "outsourced": false,
      "inline": false,
      "actual_duration_for_exception": 0,
      "production_path_id": 24459,
      "formula_for_additional_internal_costs": "",
      "additional_internal_costs": 0,
      "means_of_production_id": 540,
      "required_means_of_production_capability": "Handzusammentragen",
      "duration_for_pause_until_next_task": 0,
      "formula_for_pause_until_next_task": "",
      "manufactured_product": "product",
      "product_processing": "zusammengetragen",
      "formula_for_amount_of_manufactured_products": "circulation",
      "amount_of_manufactured_products": 45,
      "actual_amount_of_manufactured_products": 45,
      "formula_for_amount_of_wasted_manufactured_products": "",
      "amount_of_wasted_manufactured_products": 0,
      "actual_amount_of_wasted_manufactured_products": 0,
      "minimum_viable_amount_of_manufactured_products": 45,
      "stock_task_id": 647
  },
  {
      "id": 202993,
      "workable_id": 29028,
      "workable_type": "Component",
      "state": "unfulfillable_material_demand",
      "checkpoint": "none",
      "kind": "Digitaldruck",
      "description": null,
      "phase": "press",
      "formula_for_preparations": "ruestgrundzeit*60",
      "formula_for_execution": "IF(machine=\"HP Indigo 7800\",3600/IF(number_of_front_colors<3,IF(number_of_back_colors=0,impressionen_pro_stunde,(IF(number_of_back_colors<3,impressionen_pro_stunde/2,IF(number_of_front_colors=1,impressionen_pro_stunde/(number_of_front_colors+1+number_of_back_colors)*2,impressionen_pro_stunde/(number_of_front_colors+number_of_back_colors)*2)))),IF(number_of_front_colors>2,IF(number_of_back_colors=1,impressionen_pro_stunde/(number_of_front_colors+number_of_back_colors+1)*2,impressionen_pro_stunde/(number_of_front_colors+number_of_back_colors)*2),0))*number_of_sheets,(number_of_front_colors+number_of_back_colors)*number_of_sheets/click_pro_stunde*3600)",
      "formula_for_cleanup": "aufraeumgrundzeit*60",
      "formula_for_additional_external_costs": "IF(machine=\"HP Indigo 7800\",(IF(number_of_colors>2,multi_color_impression*number_of_colors*number_of_sheets,0)+IF(number_of_colors=2,two_color_impression*2*number_of_sheets,0)+IF(number_of_colors=1,one_color_impression*number_of_sheets,0)+IF(epm,epm_impression*number_of_sheets,0))*number_of_printed_surfaces_per_sheet*100+((IF(CONTAINS(front_colors,\"Digimatt Lack\"),2,0)*number_of_sheets)+(IF(CONTAINS(back_colors,\"Digimatt Lack\"),2,0)*number_of_sheets)+(IF(CONTAINS(front_colors,\"deckweiss\"),2,0)*number_of_sheets)+(IF(CONTAINS(back_colors,\"digilack_transparent_glanz\"),2,0)*number_of_sheets)+(IF(CONTAINS(front_colors,\"digilack_transparent_glanz\"),2,0)*number_of_sheets)+(IF(CONTAINS(back_colors,\"deckweiss\"),2,0)*number_of_sheets)),IF(number_of_colors>1,(((number_of_colors-1)*click_multicolor)+click_black)*number_of_sheets,click_black*number_of_sheets)*number_of_printed_surfaces_per_sheet*100)",
      "duration_for_preparations": 300,
      "duration_for_execution": 107,
      "duration_for_cleanup": 300,
      "duration": 707,
      "actual_duration_for_preparations": null,
      "actual_duration_for_execution": null,
      "actual_duration_for_cleanup": null,
      "actual_duration": null,
      "costs_per_hour": 21000,
      "additional_external_costs": 552,
      "costs": 7147,
      "created_at": "2017-11-07T13:34:10.026+01:00",
      "updated_at": "2018-02-14T15:15:23.766+01:00",
      "required_variables": {
          "epm": {
              "value": false,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "EPM"
          },
          "machine": {
              "value": "HP Indigo 12000",
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Maschine"
          },
          "waste_rate": {
              "value": 0.05,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Ausschussrate"
          },
          "back_colors": {
              "value": [],
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Farben der Rückseite"
          },
          "click_black": {
              "value": 0.009,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Click Black"
          },
          "front_colors": {
              "value": [
                  "CMYK/Cyan",
                  "CMYK/Magenta",
                  "CMYK/Yellow",
                  "CMYK/Black"
              ],
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Farben der Vorderseite"
          },
          "epm_impression": {
              "value": null,
              "errors": true,
              "resolved_by": "unresolvable",
              "display_key_as": "unresolvable"
          },
          "ruestgrundzeit": {
              "value": 5,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Rüstgrundzeit"
          },
          "click_multicolor": {
              "value": 0.017,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Click Multicolor"
          },
          "click_pro_stunde": {
              "value": 12420,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Click pro Stunde"
          },
          "number_of_colors": {
              "value": 4,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der unterschiedlichen Farben"
          },
          "number_of_sheets": {
              "value": 92,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der Bogen"
          },
          "aufraeumgrundzeit": {
              "value": 5,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Aufräumgrundzeit"
          },
          "one_color_impression": {
              "value": null,
              "errors": true,
              "resolved_by": "unresolvable",
              "display_key_as": "unresolvable"
          },
          "two_color_impression": {
              "value": null,
              "errors": true,
              "resolved_by": "unresolvable",
              "display_key_as": "unresolvable"
          },
          "number_of_back_colors": {
              "value": 0,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der unterschiedlichen Farben für die Rückseite"
          },
          "total_processed_goods": {
              "value": 97,
              "errors": false,
              "resolved_by": "task",
              "display_key_as": "Gesamtmenge der zu verarbeiteten Güter"
          },
          "multi_color_impression": {
              "value": null,
              "errors": true,
              "resolved_by": "unresolvable",
              "display_key_as": "unresolvable"
          },
          "number_of_front_colors": {
              "value": 4,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der unterschiedlichen Farben für die Vorderseite"
          },
          "impressionen_pro_stunde": {
              "value": null,
              "errors": true,
              "resolved_by": "unresolvable",
              "display_key_as": "unresolvable"
          },
          "number_of_printed_surfaces_per_sheet": {
              "value": 1,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der bedruckten Oberflächen"
          }
      },
      "automation": "for_digital",
      "outsourced": false,
      "inline": false,
      "actual_duration_for_exception": 0,
      "production_path_id": 29193,
      "formula_for_additional_internal_costs": null,
      "additional_internal_costs": 0,
      "means_of_production_id": 919,
      "required_means_of_production_capability": "Digitaldruck",
      "duration_for_pause_until_next_task": 0,
      "formula_for_pause_until_next_task": null,
      "manufactured_product": "sheet",
      "product_processing": "bedruckt",
      "formula_for_amount_of_manufactured_products": "number_of_sheets",
      "amount_of_manufactured_products": 92,
      "actual_amount_of_manufactured_products": 92,
      "formula_for_amount_of_wasted_manufactured_products": "total_processed_goods*waste_rate",
      "amount_of_wasted_manufactured_products": 5,
      "actual_amount_of_wasted_manufactured_products": 0,
      "minimum_viable_amount_of_manufactured_products": 92,
      "stock_task_id": 587
  },
  {
      "id": 208360,
      "workable_id": 29766,
      "workable_type": "Component",
      "state": "unfulfillable_material_demand",
      "checkpoint": "none",
      "kind": "Vorschneiden",
      "description": null,
      "phase": "prepress",
      "formula_for_preparations": "120",
      "formula_for_execution": "(ROUNDUP(number_of_sheets*IF(paper_thickness=0,0.150,paper_thickness)/einlegehoehe))*(cuts_to_setup*(3600/schnitte_pro_stunde))+(IF(machine=\"Horizon Smart Slitter SMSL-100\", number_of_sheets*2,0) )",
      "formula_for_cleanup": "120",
      "formula_for_additional_external_costs": "0",
      "duration_for_preparations": 120,
      "duration_for_execution": 300,
      "duration_for_cleanup": 120,
      "duration": 540,
      "actual_duration_for_preparations": null,
      "actual_duration_for_execution": null,
      "actual_duration_for_cleanup": null,
      "actual_duration": null,
      "costs_per_hour": 3000,
      "additional_external_costs": 0,
      "costs": 6950,
      "created_at": "2017-11-14T12:22:34.228+01:00",
      "updated_at": "2018-02-14T15:15:32.114+01:00",
      "required_variables": {
          "machine": {
              "value": "Vorschneiden Wareneingang",
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Maschine"
          },
          "einlegehoehe": {
              "value": 70,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Einlegehöhe"
          },
          "cuts_to_setup": {
              "value": 20,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Einzustellende Schnitte"
          },
          "paper_thickness": {
              "value": 0.31,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Papierstärke"
          },
          "number_of_sheets": {
              "value": 20,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der Bogen"
          },
          "schnitte_pro_stunde": {
              "value": 240,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Schnitte pro Stunde"
          }
      },
      "automation": "for_precutting",
      "outsourced": false,
      "inline": false,
      "actual_duration_for_exception": 0,
      "production_path_id": 29984,
      "formula_for_additional_internal_costs": null,
      "additional_internal_costs": 0,
      "means_of_production_id": 852,
      "required_means_of_production_capability": "Schneiden",
      "duration_for_pause_until_next_task": 0,
      "formula_for_pause_until_next_task": null,
      "manufactured_product": "sheet",
      "product_processing": "vorgeschnitten",
      "formula_for_amount_of_manufactured_products": "number_of_sheets",
      "amount_of_manufactured_products": 20,
      "actual_amount_of_manufactured_products": 21,
      "formula_for_amount_of_wasted_manufactured_products": null,
      "amount_of_wasted_manufactured_products": 0,
      "actual_amount_of_wasted_manufactured_products": 0,
      "minimum_viable_amount_of_manufactured_products": 21,
      "stock_task_id": 640
  },
  {
      "id": 211699,
      "workable_id": 30176,
      "workable_type": "Component",
      "state": "unfulfillable_material_demand",
      "checkpoint": "none",
      "kind": "Vorschneiden",
      "description": null,
      "phase": "prepress",
      "formula_for_preparations": "120",
      "formula_for_execution": "(ROUNDUP(number_of_sheets*IF(paper_thickness=0,0.150,paper_thickness)/einlegehoehe))*(cuts_to_setup*(3600/schnitte_pro_stunde))+(IF(machine=\"Horizon Smart Slitter SMSL-100\", number_of_sheets*2,0) )",
      "formula_for_cleanup": "120",
      "formula_for_additional_external_costs": "0",
      "duration_for_preparations": 120,
      "duration_for_execution": 90,
      "duration_for_cleanup": 120,
      "duration": 330,
      "actual_duration_for_preparations": null,
      "actual_duration_for_execution": null,
      "actual_duration_for_cleanup": null,
      "actual_duration": null,
      "costs_per_hour": 3000,
      "additional_external_costs": 0,
      "costs": 2204,
      "created_at": "2017-11-17T13:15:07.729+01:00",
      "updated_at": "2018-02-14T15:15:31.549+01:00",
      "required_variables": {
          "machine": {
              "value": "Vorschneiden Wareneingang",
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Maschine"
          },
          "einlegehoehe": {
              "value": 70,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Einlegehöhe"
          },
          "cuts_to_setup": {
              "value": 6,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Einzustellende Schnitte"
          },
          "paper_thickness": {
              "value": 0,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Papierstärke"
          },
          "number_of_sheets": {
              "value": 8,
              "errors": false,
              "resolved_by": "component",
              "display_key_as": "Anzahl der Bogen"
          },
          "schnitte_pro_stunde": {
              "value": 240,
              "errors": false,
              "resolved_by": "means_of_production",
              "display_key_as": "Schnitte pro Stunde"
          }
      },
      "automation": "for_precutting",
      "outsourced": false,
      "inline": false,
      "actual_duration_for_exception": 0,
      "production_path_id": 30618,
      "formula_for_additional_internal_costs": null,
      "additional_internal_costs": 0,
      "means_of_production_id": 852,
      "required_means_of_production_capability": "Schneiden",
      "duration_for_pause_until_next_task": 0,
      "formula_for_pause_until_next_task": null,
      "manufactured_product": "sheet",
      "product_processing": "vorgeschnitten",
      "formula_for_amount_of_manufactured_products": "number_of_sheets",
      "amount_of_manufactured_products": 8,
      "actual_amount_of_manufactured_products": 9,
      "formula_for_amount_of_wasted_manufactured_products": null,
      "amount_of_wasted_manufactured_products": 0,
      "actual_amount_of_wasted_manufactured_products": 0,
      "minimum_viable_amount_of_manufactured_products": 9,
      "stock_task_id": 640
  }
]

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

/production/tasks/{task_id} get patch delete

The collection of Tasks.

get

Get a single Task record.

patch

Update the given Task record with provided data.

delete

Set a task to canceled.

Get a single Task record.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

task_id: required (string)

HTTP status code 200

Body

Media type: application/json

Type: object

Properties

id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
workable_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
workable_type: required (string)
state: required (one of draft, waiting_for_go, waiting_for_checkpoint, waiting_for_materials, unfulfillable_material_demand, ready, running, completed, exception, canceled)
checkpoint: required (string)
kind: required (string)
description: required (string)
phase: required (string)
formula_for_preparations: required (string)
formula_for_execution: required (string)
formula_for_cleanup: required (string)
formula_for_additional_external_costs: required (string)
duration_for_preparations: required (integer)
duration_for_execution: required (integer)
duration_for_cleanup: required (integer)
duration: required (integer)
actual_duration_for_preparations: required (integer)
actual_duration_for_execution: required (integer)
actual_duration_for_cleanup: required (integer)
actual_duration: required (integer)
costs_per_hour: required (integer)
additional_external_costs: required (integer)
costs: required (integer)
required_variables: required (object)
automation: required (string)
outsourced: required (boolean)
inline: required (boolean)
actual_duration_for_exception: required (integer)
production_path_id: required (integer)
formula_for_additional_internal_costs: required (string)
additional_internal_costs: required (integer)
means_of_production_id: required (integer)
required_means_of_production_capability: required (string)
duration_for_pause_until_next_task: required (integer)
formula_for_pause_until_next_task: required (string)
manufactured_product: required (string)
product_processing: required (string)
formula_for_amount_of_manufactured_products: required (string)
amount_of_manufactured_products: required (integer)
actual_amount_of_manufactured_products: required (integer)
formula_for_amount_of_wasted_manufactured_products: required (string)
amount_of_wasted_manufactured_products: required (integer)
actual_amount_of_wasted_manufactured_products: required (integer)
minimum_viable_amount_of_manufactured_products: required (integer)
stock_task_id: required (integer - minimum: 1)
Unique identifier for every object. Is used when referencing resources in URLs.
created_at: required (datetime)
The exact time the respective object was created.
updated_at: required (datetime)
The exact time the respective object was last updated.

Example:

{
  "id": 170889,
  "workable_id": 26130,
  "workable_type": "Finishing",
  "state": "unfulfillable_material_demand",
  "checkpoint": "none",
  "kind": "Handzusammentragen",
  "description": null,
  "phase": "postpress",
  "formula_for_preparations": "30",
  "formula_for_execution": "(number_of_components*5)*(circulation*5)",
  "formula_for_cleanup": "30",
  "formula_for_additional_external_costs": "",
  "duration_for_preparations": 30,
  "duration_for_execution": 3375,
  "duration_for_cleanup": 30,
  "duration": 3435,
  "actual_duration_for_preparations": 30,
  "actual_duration_for_execution": 3375,
  "actual_duration_for_cleanup": 30,
  "actual_duration": 3435,
  "costs_per_hour": 3000,
  "additional_external_costs": 0,
  "costs": 6233,
  "created_at": "2017-09-12T14:12:08.596+02:00",
  "updated_at": "2018-02-14T15:15:33.510+01:00",
  "required_variables": {
      "circulation": {
          "value": 45,
          "errors": false,
          "resolved_by": "product",
          "display_key_as": "Auflage"
      },
      "number_of_components": {
          "value": 3,
          "errors": false,
          "resolved_by": "product",
          "display_key_as": "Anzahl der Komponenten"
      }
  },
  "automation": "for_finishing_with_same_name",
  "outsourced": false,
  "inline": false,
  "actual_duration_for_exception": 0,
  "production_path_id": 24459,
  "formula_for_additional_internal_costs": "",
  "additional_internal_costs": 0,
  "means_of_production_id": 540,
  "required_means_of_production_capability": "Handzusammentragen",
  "duration_for_pause_until_next_task": 0,
  "formula_for_pause_until_next_task": "",
  "manufactured_product": "product",
  "product_processing": "zusammengetragen",
  "formula_for_amount_of_manufactured_products": "circulation",
  "amount_of_manufactured_products": 45,
  "actual_amount_of_manufactured_products": 45,
  "formula_for_amount_of_wasted_manufactured_products": "",
  "amount_of_wasted_manufactured_products": 0,
  "actual_amount_of_wasted_manufactured_products": 0,
  "minimum_viable_amount_of_manufactured_products": 45,
  "stock_task_id": 647
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Update the given Task record with provided data.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

task_id: required (string)

Body

Media type: application/json

Type: object

Properties

task_execution: required (object)
- state: required (one of draft, waiting_for_go, waiting_for_checkpoint, waiting_for_materials, unfulfillable_material_demand, ready, running, completed, exception, canceled)
- actual_amount_of_manufactured_products: required (integer)
- actual_amount_of_wasted_manufactured_products: required (integer)

Example:

{
  "task": {
    "state": "completed",
    "actual_amount_of_manufactured_products": 200,
    "actual_amount_of_wasted_manufactured_products": 10
  }
}

HTTP status code 204

Returned if the record was successfully updated.

HTTP status code 422

This response is returned in case the request contained invalid data.

Body

Media type: application/json

Type: object

Properties

errors: required (object)

Example:

{
  "errors": {
    "name": [
      "is too short (minimum is 1 character)"
    ]
  }
}

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Set a task to canceled.

Secured by BearerToken

Keyline requires API users to authenticate before they can access any information.

URI Parameters

task_id: required (string)

HTTP status code 204

Returned if the record was successfully deleted.

Secured by BearerToken

Headers

Authorization: required (string - minLength: 71 - maxLength: 71 - pattern: ^Bearer [0-9a-fA-F]{64}$)
Contains the key for using the API, which prefixed with the string 'Bearer'. # Token administration You can add or revoke access tokens in Keyline in the Settings > API section.

Example:
```
Bearer f338bc59b1ee082ee08600f85022cf7d661426ee342b22c73c18d3875f2e9885
```

HTTP status code 401

Header missing or No token provided

HTTP status code 403

Bad token.

Keyline API documentation version 2.0

/accounting

get /accounting/customer_invoices

HTTP status code 200

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

post /accounting/customer_invoices

Body

HTTP status code 201

Body

HTTP status code 422

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

get /accounting/customer_invoices/{customer_invoice_id}

URI Parameters

HTTP status code 200

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

patch /accounting/customer_invoices/{customer_invoice_id}

URI Parameters

Body

HTTP status code 204

HTTP status code 422

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

delete /accounting/customer_invoices/{customer_invoice_id}

URI Parameters

HTTP status code 204

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

post /accounting/customer_invoices/{customer_invoice_id}/contact

URI Parameters

Body

HTTP status code 201

Body

HTTP status code 422

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

patch /accounting/customer_invoices/{customer_invoice_id}/contact

URI Parameters

Body

HTTP status code 204

HTTP status code 422

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

post /accounting/customer_invoices/{customer_invoice_id}/address

URI Parameters

Body

HTTP status code 201

Body

HTTP status code 422

Body

Secured by BearerToken

Headers

HTTP status code 401

HTTP status code 403

patch /accounting/customer_invoices/{customer_invoice_id}/address

URI Parameters

Body

HTTP status code 204