Order notification

POST https://webhook.example.com

These notifications are sent to the URL provided in theorderWebhookUrl field.

application/json

Body Required

  • account object

    Additional properties are allowed.

    Hide account attributes Show account attributes object
    • The unique identifier of the account.

    • The internal identifier of the table.

    • The code of the account (order) profile associated with this order.
      See the order profiles definition for more details.

    • The unique identifier of the account (order) profile associated with this order.

    • The name of the account (order) profile associated with this order.

    • The unique identifier of the business location.

    • closeDate integer(int64) | null

      The timestamp of when transaction was completed, in milliseconds.

    • consumerRecord object | null

      Additional properties are allowed.

      Hide consumerRecord attributes Show consumerRecord attributes object | null
    • coverCount integer(int64)

      The number of covers associated with the transaction.

    • The ISO-4217 3 letter currency code.

    • The active course. Starts with 0.

    • discounts array[object]
      Hide discounts attributes Show discounts attributes object
      • code string

        The discount code.

      • The name of the discount.

      • id string

        The unique identifier of the discount.

      • rate number

        The discount rate.

      • taxFree boolean

        Indicates if the discount is considered tax free.

    • externalReferences array[object]

      The unique identifiers of this transaction provided by 3rd parties or the K-Series backend.

      Hide externalReferences attributes Show externalReferences attributes object
    • The tip amount.

    • id string

      Legacy account identifier created by the POS (for backwards compatibility).

    • Hide latestExternalReferences attributes Show latestExternalReferences attributes object
    • name string

      The name of the transaction or tab.

    • offset integer(int32)

      The UTC Offset of the location, in minutes.

    • openDate integer(int64)

      The timestamp of when transaction was started, in milliseconds.

    • originAccountId integer(int64) | null

      Legacy reference identifier of origin account created by the POS (for backwards compatibility).

    • originAccountNumber string | null

      A unique identifier of an account, used to identify sales transactions.

    • The amount paid.

    • paymentLines array[object]
      Hide paymentLines attributes Show paymentLines attributes object
      • Legacy account identifier created by the POS (supplied because older API provides it to 3rd parties).

      • amount number

        Amount given by the customer to settle the transaction.

      • An ISO-4217 3 letter currency code

      • date integer(int64)

        Timestamp in ms of the moment when the line was registered. by the user

      • Amount of tip given by the customer using the payment method.

      • id integer(int64)

        Legacy line identifier created by the POS (supplied because older API provides it to 3rd parties).

      • Short code of the payment method the customer used to settle the transaction.

      • Name of the payment method used.

    • The amount before tax.

    • The unique identifier of the final transaction.

    • The sum of all surcharges applied to the transaction.

    • staffId string

      The unique identifier of staff member who created/started and owns the transaction.

    • The name of staff member who created/started and owns the transaction.

    • The name of the table.

    • Integer number of the table.

    • The total amount of tax.

    • The total amount of the receipt.

    • The applied discount rate, as a percentage.

    • transactionLines array[object]
      Hide transactionLines attributes Show transactionLines attributes object
      • Legacy account identifier created by the POS (supplied because older API provides it to 3rd parties).

      • The unique identifier of the product group assigned to the item.

      • Name of the product group assigned to the item.

      • Additional properties are allowed.

        Hide activeTax attributes Show activeTax attributes object
        • code string

          Code of the tax as defined in the configuration context.

        • Name of the tax as defined in the configuration context.

        • rate number(double)

          Tax percentage (e.g. 19% => '1.19').

        • Indicates whether the tax is VAT or Sales Tax.

      • amount number

        The actual (final) amount the customer will be charged, ie. regularAmount with modifiers applied.

      • Taxable amount not including any taxes.

      • Final amount including taxes.

      • categories array[object]

        A list of the reporting categories in which the sale is to be aggregated.

        Hide categories attributes Show categories attributes object
        • category string

          The reporting category name.

        • value string

          The reporting category value.

      • date integer(int64)

        Timestamp in ms of the moment when the line was registered. by the user

      • The line discount amount applied to the line.

      • Regular price for one unit of the line item.

      • id string

        Legacy line identifier created by the POS (supplied because older API provides it to 3rd parties).

      • Name of the item sold.

      • itemId string

        The unique identifier of the item at the business location.

      • itemSku string

        SKU (stock keeping unit) of the item.

      • modifiers array[object]

        A production instruction entered for a line.

        Hide modifiers attributes Show modifiers attributes object
      • Manually entered item name

      • phase integer(int32)

        Course number assigned to the line.

      • quantity number

        Quantity

      • tags string

        Array of tags associated with the sales line.

      • Actual amount for one unit of the line item including all markup, markdowns & surcharges.

    • type string

      The sale line type.

    • updateDate integer(int64)

      The timestamp of when the complete update was finalized at the POS, in milliseconds.

  • businessLocationId integer(int64)

    The unique identifier of the business location.

  • Values are OPEN, UPDATE, CLOSE, or CANCEL.

  • The external platform's unique identifier for the restaurant.

    Format should match the following pattern: [a-zA-Z0-9_-]+.

Responses

  • Your server returns this code if it accepts the callback.

POST Order notification
Request examples
{
  "account": {
    "accountNumber": "A833754.74",
    "accountObjectId": "25769805453",
    "accountProfileCode": "zoneB",
    "accountProfileId": "25769805764",
    "accountProfileName": "Livraison Zone B",
    "businessLocationId": "77309411330",
    "closeDate": 1694083785354,
    "consumerRecord": {
      "consumer": {
        "emailAddress": "napoleon@bonapart.fr",
        "id": "111466"
      },
      "consumerRecordUUID": "8649450c-5c10-4e63-8461-12bbf5a51cbc",
      "contactInformation": {
        "city": "Paris",
        "companyName": "Non",
        "emailReceipts": false,
        "firstName": "Alexandr",
        "fullName": "Alexandr Pushkin",
        "lastName": "Pushkin",
        "taxIdentifier": "23142342134"
      },
      "externalReferences": [
        {
          "key": "open-table-api-client",
          "reference": "OO.11.opentable-anonymous"
        }
      ],
      "id": "36577"
    },
    "coverCount": 2,
    "currencyCode": "EUR",
    "currentProductionPhase": 0,
    "discounts": [
      {
        "code": "test_discount",
        "description": "test discount description",
        "id": "197568495841",
        "rate": 0.9,
        "taxFree": false
      }
    ],
    "externalReferences": [
      {
        "prefix": "TASK",
        "reference": "RN-197568495618-reservation_id_123213126"
      }
    ],
    "gratuityAmount": 20,
    "id": "21474836499",
    "latestExternalReferences": [
      {
        "prefix": "TASK",
        "reference": "RN-197568495618-reservation_id_123213126"
      }
    ],
    "name": "Floor 1, Table 2",
    "offset": 240,
    "openDate": 1694083785354,
    "originAccountId": 21474836579,
    "originAccountNumber": "A1.5",
    "paidAmount": 45,
    "paymentLines": [
      {
        "accountId": "21474836499",
        "amount": 45,
        "currencyCode": "GBP",
        "date": 1694084890294,
        "gratuityAmount": 50,
        "id": 21474836506,
        "paymentMethod": "IKGIFT",
        "paymentMethodDescription": "Geschenkkarte"
      }
    ],
    "preTaxAmount": 201.78,
    "receiptNumber": "R1.2",
    "serviceCharge": 34.2,
    "staffId": "13",
    "staffName": "Manager",
    "tableName": "Table 112",
    "tableNumber": 112,
    "taxAmount": 14.12,
    "totalAmount": 30,
    "totalDiscount": 0.9,
    "transactionLines": [
      {
        "accountId": "502721627029505",
        "accountingGroupId": "77309411368",
        "accountingGroupName": "Misc",
        "activeTax": {
          "code": "TVA77",
          "description": "TVA 7.7%",
          "rate": 1.07,
          "taxIncluded": true
        },
        "amount": 0.45,
        "amountLessTax": 4.21,
        "amountWithTax": 4.5,
        "categories": [
          {
            "category": "default",
            "value": "Misc"
          }
        ],
        "date": 1694083815402,
        "discountedAmount": 0.05,
        "grossUnitAmount": 4.5,
        "id": "502721627029513",
        "itemDescription": "Dom Pérignon",
        "itemId": "77309411427",
        "itemSku": "6",
        "modifiers": [
          {
            "name": "Milch",
            "quantity": 1
          }
        ],
        "nameOverride": "Burger for our friend Ben",
        "phase": 0,
        "quantity": 6,
        "tags": "Test tag 4",
        "unitAmount": 0.9
      }
    ],
    "type": "SALE",
    "updateDate": 1694083819623
  },
  "businessLocationId": 9765040300495493,
  "notificationType": "OPEN",
  "platformRestaurantId": "Restaurant-123",
  "sequenceId": "string"
}