---
updatedAt: 2026-09-03T16:21:12.000Z
---

Fetch the complete documentation index at: https://developers.deliverect.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Commerce Basket - Model

<HTMLBlock>{`
<div class="callout-banner callout-banner--required">
  <span class="callout-icon"><i class="fa-duotone fa-list-check"></i></span>
  <p><strong>Required Attributes</strong><br>
  Fields marked with
  <i class="fa-solid fa-asterisk" style="color: #038851;"></i>
  must be included in the request payload — the request will be rejected without them.
  </p>
</div>
`}</HTMLBlock>

<br />

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameters
      </th>

      <th>
        Meaning
      </th>

      <th>
        Type
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `storeId`<span style={{color: "#038851"}}><i className="fa-solid fa-asterisk"></i></span>
      </td>

      <td>
        A storeId is the unique identifier for a store–channel (ordering platform) at a specific location. and may also be referenced as channelLinkId

        In order to retrieve the stores existing on a specific location the <Anchor target="_blank" href="https://developers.deliverect.com/v3.0-ordering-experience/reference/commerce-get-stores">Get Stores</Anchor> should be used
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        `channelLinkId`
      </td>

      <td>
        alternative to `storeId`
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        `fulfillment`
      </td>

      <td>
        Defines how the order will be fulfilled.
      </td>

      <td>
        Object
      </td>
    </tr>

    <tr>
      <td>
        fullfillment.`type`<span style={{color: "#038851"}}><i className="fa-solid fa-asterisk"></i></span>
      </td>

      <td>
        Types of orders to be included inside on the fulfilllment object. These are the allowed values

        `_pickup`- Takeaway orders

        `_delivery` - Delivery handled directly by the ordering platform

        `_eatIn` - Orders consumed on premises (dine-in)
      </td>

      <td>
        enum
      </td>
    </tr>

    <tr>
      <td>
        `time`
      </td>

      <td>
        Timestamp is in UTC yyyy-MM-ddTHH:mm:ssZ all time values in our API are in UTC time as per <Anchor target="_blank" href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601</Anchor>

        \*(for delivery, pickup and any non-asap order)
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        `address`
      </td>

      <td>
        Delivery address information for the order. Required when type = "delivery"
      </td>

      <td>
        object
      </td>
    </tr>

    <tr>
      <td>
        address.`line`
      </td>

      <td>
        Full formatted delivery address line
        Example: "Foreestelaan 82, 9000 Gent, Belgium"
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        address.`coordinates`
      </td>

      <td>
        Geographical coordinates of the delivery address in \[long, lat] order, used for precise location mapping and routing. eg., `[51.03162341734958, 3.7337162550022622]`
      </td>

      <td>
        Array
      </td>
    </tr>

    <tr>
      <td>
        `spot`
      </td>

      <td>
        Identifier of the dining spot (such as a table number)

        Required when type = "eatIn"
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        `note`
      </td>

      <td>
        Optional free-text field that contains special instructions or comments from the customer about the order (e.g., cooking preferences, dietary requests, packaging notes)
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        **items**
      </td>

      <td>
        List of products the customer wants to order
      </td>

      <td>
        array of objects
      </td>
    </tr>

    <tr>
      <td>
        items.`menuId`
      </td>

      <td>
        internal Deliverect menu id. You can retrieve the menuId via <Anchor target="_blank" href="https://developers.deliverect.com/v3.0-ordering-experience/reference/commerce-get-menus">GET Store Menu</Anchor>
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        items.`plu`
      </td>

      <td>
        Unique identifier of the item, to be used when creating orders
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        items.`quantity`
      </td>

      <td>
        Number of units of the item added to the basket
      </td>

      <td>
        integer
      </td>
    </tr>

    <tr>
      <td>
        items. `note`
      </td>

      <td>
        Special instructions for the item
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        items. `subItems`
      </td>

      <td>
        modifiers applied to the parent item. Each subItem corresponds to a chosen modifier (where applicable)
      </td>

      <td>
        array of objects
      </td>
    </tr>

    <tr>
      <td>
        subItems. `plu`
      </td>

      <td>
        Unique identifier of the item (modifier)
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        subItems.`customizationPlu`
      </td>

      <td>
        PLU of the modifier group that the subItem belongs to
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        subItems. `quantity`
      </td>

      <td>
        Number of times this modifier is applied to the item
      </td>

      <td>
        integer
      </td>
    </tr>

    <tr>
      <td>
        `customer`
      </td>

      <td>
        Information about the customer placing the orde
      </td>

      <td>
        object
      </td>
    </tr>

    <tr>
      <td>
        customer. `name`
      </td>

      <td>
        Full name of the customer
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`companyName`
      </td>

      <td>
        Name of the company or organization associated with the order.
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`phoneNumber`
      </td>

      <td>
        Customer's contact number for order confirmation or delivery communication. Eg., "+3211223344"
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`email`
      </td>

      <td>
        Customer's email address
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer. `externalId`
      </td>

      <td>
        External reference ID for the customer in a third-party system
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`loyaltyProviderCustomerId`
      </td>

      <td>
        Unique identifier for the customer in the loyalty provider system
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`tin`
      </td>

      <td>
        Tax identification or fiscal equivalent number for the customer
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`crmProfileId`
      </td>

      <td>
        Unique identifier for the customer's profile in the Deliverect CRM system
      </td>

      <td>
        string
      </td>
    </tr>

    <tr>
      <td>
        customer.`sendNotifications`
      </td>

      <td>
        Flag to control whether order notifications should be sent to the customer
      </td>

      <td>
        boolean
      </td>
    </tr>

    <tr>
      <td>
        customer.`allowMarketing`
      </td>

      <td>
        Flag to indicate whether the customer has opted in to receive marketing communications
      </td>

      <td>
        boolean
      </td>
    </tr>

    <tr>
      <td>
        customer.`sendReceiptSMS`
      </td>

      <td>
        Flag to control whether the order receipt should be sent via SMS
      </td>

      <td>
        boolean
      </td>
    </tr>

    <tr>
      <td>
        customer.`sendReceiptEmail`
      </td>

      <td>
        Flag to control whether the order receipt should be sent via email
      </td>

      <td>
        boolean
      </td>
    </tr>
  </tbody>
</Table>