---
title: "Create Local Order"
method: POST
path: "/o/op/1/order/local"
tags: ["Order and Pay"]
---

# Create Local Order

`POST /o/op/1/order/local`

Creates a new dine-in order for a specific business location. See [Online Ordering Basics](https://api-portal.lsk.lightspeed.app/guides/tutorials/online-ordering-basics) for more details.

If the [accountIdentifier](https://api-docs.lsk.lightspeed.app/operation/operation-apelocalorder#operation-apelocalorder-body-application-json-accountidentifier) of an existing order is provided in the body of the request, the request will update the existing order.

## Request body

- object
  - `businessLocationId` integer, required — The unique identifier for the business location.
  - `thirdPartyReference` string, required — The external reference provided for this order. Must be unique. This value will be included in the order details sent to the [webhook URL](https://api-docs.lsk.lightspeed.app/operation/operation-apecreatewebhookoo#operation-apecreatewebhookoo-body-application-json-url).
  - `endpointId` string, required — Endpoint ID for a unique webhook that has been created using [the webhook endpoint](https://api-docs.lsk.lightspeed.app/operation/operation-apecreatewebhookoo).
  - `customerInfo` ApeCustomerInfo, required
    - `firstName` string, required — Customer first name.
    - `lastName` string — Customer last name.
    - `thirdPartyReference` string — The unique reference for this customer which can help to identify them later on. If the email is left empty, this should be empty as well.
    - `email` string — The email address for this customer.
    - `contactNumberAsE164` string — The customer phone number in E164 format.
    - `notes` string — The notes attached to the customer.
    - `salutation` string — Salutation for the customer (Mr., Mrs., Dr., etc...).
    - `sendEmailReceipts` boolean — Default value of emailNotification setting for new customers
    - `emailNotification` 'ENABLE' | 'DISABLE' | 'DONT_CHANGE' — Update the customer email notification setting. For example, sendEmailReceipts = true, emailNotification = DONT_CHANGE - sends receipt email for all users who haven't disabled it in the Backoffice. sendEmailReceipts = false, emailNotification = DONT_CHANGE - will not send receipt email for all users except those who enabled it in the Backoffice
  - `orderNote` string — A note added to this order and displayed on the printed dockets.
  - `maxTimeToAttemptOrderDeliverToPos` integer — ** Use of this feature is strongly recommended ** Maximum time to attempt delivery of this order to the POS. In milliseconds. The minimum value is 60000ms (1 minute). If [`scheduledTimeForOrderAsIso8601`](https://api-docs.lsk.lightspeed.app/operation/operation-apelocalorder#operation-apelocalorder-body-application-json-scheduledtimefororderasiso8601) is used, this value will be added to the scheduled order time.
  - `staffId` integer — The unique identifier for the staff member.
  - `accountProfileCode` string — A valid order profile [code](https://api-docs.lsk.lightspeed.app/operation/operation-apeaccountprofiles#operation-apeaccountprofiles-200-body-application-json-accountprofilelist-code) to associate with this order. See the [order profiles](https://api-portal.lsk.lightspeed.app/guides/definitions/order-profiles) definition for more details.
  - `scheduledTimeForOrderAsIso8601` string, date-time — The time that the order will be sent to the POS. Must be in the future.
  - `payment` ApeOrderPayment
    - `paymentMethod` string — Payment method code as configured by the merchant.
    - `paymentAmount` number, required — The total amount of the payment including tips if any.
    - `tipAmount` number — The tip amount, if any.
  - `accountId` string — The system-generated account identifier for this order (Applies to iKentoo V2). If this is specified, the associated order will be updated.
  - `accountIdentifier` string — The system-generated account identifier for this order (Applies to iKentoo V3+). If this is specified, the associated order will be updated.
  - `tableNumber` string — The table number for this local order. If updating an existing order, (ie.`accountIdentifier` is specified), the `tableNumber` cannot be updated.
  - `clientCount` integer — The number of customers for this order. If updating an existing order, (ie.`accountIdentifier` is specified), the `clientCount` cannot be updated.
  - `items` ApeLocalOrderItemLine[] — The items in this order.
    - `quantity` integer, required — Quantity of item to be ordered.
    - `sku` string, required — The SKU of the item to be ordered.
    - `customItemName` string — The custom name to be used, if overwriting is permitted for this item.
    - `customItemPrice` number — The custom price to be used, if custom pricing is permitted for this item.
    - `discountAmountOverride` number — The custom discount amount applied to this item. Only one of `discountAmountOverride` or `discountPercentOverride` can be set. Must be used in conjunction with a [discountCode](https://api-docs.lsk.lightspeed.app/operation/operation-apelocalorder#operation-apelocalorder-body-application-json-items-discountcode) and this discount must be configured as a "manual discount" in the POS. See [Understanding Discounts](https://k-series-support.lightspeedhq.com/hc/en-us/articles/1260804657089-Understanding-discounts).
    - `discountPercentOverride` number — The custom percentage discount applied to this item. Only one of `discountAmountOverride` or `discountPercentOverride` can be set. Must be used in conjunction with a [discountCode](https://api-docs.lsk.lightspeed.app/operation/operation-apelocalorder#operation-apelocalorder-body-application-json-items-discountcode) and this discount must be configured as a "manual discount" in the POS. See [Understanding Discounts](https://k-series-support.lightspeedhq.com/hc/en-us/articles/1260804657089-Understanding-discounts).
    - `modifiers` ApeItemModifier[] — Collection of [modifiers](https://api-docs.lsk.lightspeed.app/operation/operation-apeloadallmodifiers) to be applied to this item.
      - `modifierId` string — Modifier ID to be applied to this item.
    - `discountCode` string — The discount code being applied to this item, if applicable.
    - `course` integer — The course number for this item, if applicable.
    - `subItems` ApeSubItemOrderLine[] — The sub-items applied to this item.
      - `quantity` integer, required — Quantity of sub-item to be ordered.
      - `sku` string, required — The SKU of the sub-item to be ordered.
      - `customItemName` string — The custom name to be used if overwriting is supported for this sub-item.
      - `customItemPrice` number — The custom price to be used if overwriting is supported for this sub-item.
      - `modifiers` ApeItemModifier[] — Collection of modifiers to be applied to this sub-item.
        - `modifierId` string — Modifier ID to be applied to this item.
      - `subItems` ApeSubItemOrderLine[] — Product modifiers applied to this item.
  - `targetPrinterProfileId` integer — The printer profile id to use for printing the receipt for this payment. If not provided, the default active printer profile for the business location will be used.

## Response `200`

accepted

- object
  - `status` string — The response.

## Other responses

- `400` — Bad Request.
- `409` — Conflict

---

[API](https://skmtc.net/lightspeed/apis/lightspeed-restaurant-k-series-api.md) · [All operations](https://skmtc.net/lightspeed/apis/lightspeed-restaurant-k-series-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeed/lightspeed-restaurant-k-series-api/revisions/0e481cddec74/schema)