# Create a new order

Creates a new order record.

Endpoint: POST /v1/api/order
Version: 1.2.4
Security: X-Api-Key

## Request fields (application/json):

  - `currency` (string)
    Currency of the Order.
    Example: "USD"

  - `receiptId` (string, required)
    Receipt ID of the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `status` (string, required)
    Status of the Order.
    Example: "pending"

  - `customerId` (string)
    Customer ID of the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `source` (string, required)
    Source of the Order.
    Example: "final"

  - `sessionId` (string)
    Session ID of the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `balance` (string, required)
    Balance amount of the Order.
    Example: "1000.50"

  - `externalId` (string)
    External ID associated with the Order when synced from external source. If present, it will set fromFinal to true.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `customerNote` (string)
    Customer note of the Order.
    Example: "Customer note"

  - `parkReduceStock` (string)
    When the order is parked, the stock will be reduced by this amount. If 0, the stock will not be reduced.
    Example: "0"

  - `parkExpiryDate` (string)
    Expiry date of the parked order.
    Example: "never"

  - `signature` (string)
    Signature of the Order in Base64 format.
    Example: "SGVsbG8gV29ybGQ="

  - `summary` (object, required)
    Summary of the Order.
    Example: {"discountTotal":"1000.50","shippingTotal":"1000.50","total":"1000.50","totalTaxes":"1000.50","isTaxInclusive":false,"subTotal":"1000.50","taxes":[{"name":"Tax 1","percentage":10,"amount":"1000.50","taxTableName":"Tax Table 1","compounding":true,"priority":1,"taxTableId":"1234567890","id":"1234567890"}],"tip":{"percentage":0.15,"amount":"1000.50"}}

  - `summary.discountTotal` (string, required)
    Total discount amount of the Order.
    Example: "1000.50"

  - `summary.shippingTotal` (string)
    Total shipping amount of the Order.
    Example: "1000.50"

  - `summary.total` (string, required)
    Total amount of the Order.
    Example: "1000.50"

  - `summary.totalTaxes` (string, required)
    Total taxes amount of the Order.
    Example: "1000.50"

  - `summary.isTaxInclusive` (boolean, required)
    Flag to indicate if the order is tax inclusive.

  - `summary.subTotal` (string, required)
    Subtotal amount of the Order.
    Example: "1000.50"

  - `summary.taxes` (array, required)
    Taxes associated with the Order.
    Example: [{"name":"Tax 1","percentage":10,"amount":"1000.50","taxTableName":"Tax Table 1","compounding":true,"priority":1,"taxTableId":"1234567890","id":"1234567890"}]

  - `summary.taxes.name` (string, required)
    Name of the tax.
    Example: "Tax 1"

  - `summary.taxes.taxTableId` (string)
    ID of the tax table.
    Example: "1234567890"

  - `summary.taxes.taxTableName` (string)
    Name of the tax table.
    Example: "Standard Tax"

  - `summary.taxes.id` (string)
    ID of the tax.
    Example: "1234567890"

  - `summary.taxes.percentage` (number, required)
    Percentage of the tax (e.g. 0.15 for 15%).
    Example: 0.15

  - `summary.taxes.amount` (string, required)
    Amount of the tax.
    Example: "1000.50"

  - `summary.taxes.compounding` (boolean)
    Flag to indicate if the tax is compounding.

  - `summary.taxes.priority` (number)
    Priority of the tax.
    Example: 1

  - `summary.taxes._id` (string)

  - `summary.tip` (object)
    Tip associated with the Order.
    Example: {"percentage":0.15,"amount":"1000.50"}

  - `summary.tip.percentage` (number)
    Percentage of the tip.
    Example: 0.15

  - `summary.tip.amount` (string)
    Amount of the tip.
    Example: "1000.50"

  - `summary.tip.tipTo` (string)
    ID of the tip to.
    Example: "1234567890"

  - `cartDiscount` (object)
    Cart discount of the Order.
    Example: {"label":"Cart Discount 1","amount":"1000.50","percentage":0.15}

  - `cartDiscount.amount` (string, required)
    Amount of the cart discount.
    Example: "1000.50"

  - `cartDiscount.percentage` (number, required)
    Percentage of the cart discount.
    Example: 0.15

  - `cartDiscount.label` (string)
    Label of the cart discount.
    Example: "Cart Discount 1"

  - `cartFees` (array)
    Cart fees of the Order.
    Example: [{"id":"1234567890","label":"Cart Fee 1","amount":"1000.50","percentage":0.15,"taxName":"Tax 1","taxTableId":"1234567890","tax":"1.10"}]

  - `cartFees.label` (string, required)
    Label of the cart fee.
    Example: "Cart Fee 1"

  - `cartFees.id` (string)
    ID of the cart fee.
    Example: "1234567890"

  - `cartFees.percentage` (number, required)
    Percentage of the cart fee.
    Example: 0.15

  - `cartFees.amount` (string, required)
    Amount of the cart fee.
    Example: "1000.50"

  - `cartFees.taxName` (string)
    Name of the tax.
    Example: "Tax 1"

  - `cartFees.tax` (string)
    Tax of the cart fee.
    Example: "1000.50"

  - `paymentMethods` (array, required)

  - `posData` (object)
    POS data of the order.
    Example: {"outlet":"1234567890","station":"1234567890","employee":"1234567890"}

  - `posData.outlet` (string)
    Outlet ID of the order.
    Example: "1234567890"

  - `posData.station` (string)
    Station ID of the order.
    Example: "1234567890"

  - `posData.employee` (string)
    Employee ID of the order.
    Example: "1234567890"

  - `metadata` (array)
    Metadata associated with the Customer.
    Example: [{"key":"key1","value":"value1","externalId":"ext123"},{"key":"key2","value":"value2","externalId":"ext123"}]

  - `metadata.key` (string, required)
    Key of the metadata entry.
    Example: "key1"

  - `metadata.value` (string, required)
    Value of the metadata entry.
    Example: "value1"

  - `metadata.externalId` (string)
    External ID associated with the metadata entry.
    Example: "ext123"

  - `notes` (array)
    Notes associated with the Order.
    Example: [{"author":"John Doe","note":"This is a note","addedByUser":true,"dateCreated":"2025-12-07T19:31:48.436+00:00","externalId":"ext123","customerNote":true}]

  - `notes.author` (string, required)
    Author of the note.
    Example: "John Doe"

  - `notes.note` (string, required)
    Note of the order.
    Example: "This is a note"

  - `notes.externalId` (string)
    External ID of the note.
    Example: "1234567890"

  - `notes.addedByUser` (boolean, required)
    Added by user of the note.
    Example: true

  - `notes.dateCreated` (string, required)
    Date created of the note.
    Example: "2025-12-07T19:31:48.436+00:00"

  - `notes.customerNote` (boolean)
    Customer note of the order.
    Example: true

  - `billing` (object)
    Billing address associated with the Order.
    Example: {"firstName":"John","lastName":"Doe","address1":"123 Main St","address2":"Suite 100","city":"New York","state":"NY","country":"USA","postCode":"10001"}

  - `billing.firstName` (string)
    First name of the person associated with the Address.
    Example: "John"

  - `billing.lastName` (string)
    Last name of the person associated with the Address.
    Example: "Doe"

  - `billing.address1` (string)
    First line of the address.
    Example: "123 Main St"

  - `billing.address2` (string)
    Second line of the address.
    Example: "Suite 100"

  - `billing.city` (string)
    City of the address.
    Example: "New York"

  - `billing.state` (string)
    State of the address.
    Example: "NY"

  - `billing.country` (string)
    Country of the address.
    Example: "USA"

  - `billing.postCode` (string)
    Post code of the address.
    Example: "10001"

  - `shipping` (object)
    Shipping address associated with the Order.
    Example: {"firstName":"John","lastName":"Doe","address1":"123 Main St","address2":"Suite 100","city":"New York","state":"NY","country":"USA","postCode":"10001"}

  - `lineItems` (array)
    Line items associated with the Order.
    Example: [{"productId":"507f1f77bcf86cd799439011","variantId":"507f1f77bcf86cd799439012","name":"Sweet Tea","quantity":1,"manageStock":true,"price":"100.00","description":"Refreshing sweet tea","sku":"SKU-001","totalTax":"10.00","total":"110.00","taxes":[{"name":"Sales Tax","percentage":10,"amount":"10.00","taxTableName":"Default Tax","compounding":false,"priority":1,"taxTableId":"507f1f77bcf86cd799439013","id":"507f1f77bcf86cd799439014"}]}]

  - `lineItems.productId` (string)
    ID of the product.
    Example: "1234567890"

  - `lineItems.variantId` (string, required)
    ID of the variant.
    Example: "1234567890"

  - `lineItems.name` (string, required)
    Name of the line item.
    Example: "Sweet Tea"

  - `lineItems.quantity` (number, required)
    Quantity of the line item.
    Example: 1

  - `lineItems.manageStock` (boolean, required)
    Whether the line item manages stock.
    Example: true

  - `lineItems.price` (string, required)
    Price of the line item.
    Example: "100.00"

  - `lineItems.description` (string)
    Description of the line item.
    Example: "Sweet Tea is a refreshing drink made with tea and sugar."

  - `lineItems.sku` (string)
    SKU of the line item.
    Example: "1234567890"

  - `lineItems.totalTax` (string, required)
    Total tax of the line item.
    Example: "100.00"

  - `lineItems.total` (string, required)
    Total of the line item.
    Example: "100.00"

  - `lineItems.productExternalId` (string)
    External ID of the product.
    Example: "1234567890"

  - `lineItems.variantExternalId` (string)
    External ID of the variant.
    Example: "1234567890"

  - `lineItems.lineItemExternalId` (string)
    External ID of the line item.
    Example: "1234567890"

  - `lineItems.internalId` (string)
    Internal ID of the line item.
    Example: "1234567890"

  - `lineItems.note` (string)
    Note of the line item.
    Example: "This is a note"

  - `lineItems.image` (string)
    Image of the line item.
    Example: "https://example.com/image.jpg"

  - `lineItems.attributes` (string)
    Attributes of the line item.
    Example: "color: red, size: small"

  - `lineItems.discount` (object)
    Discount associated with the Line Item.
    Example: {"itemDiscount":{"percentage":10,"amount":"5.00"},"cartDiscount":{"percentage":5,"amount":"2.50"}}

  - `lineItems.discount.itemDiscount` (object)
    Item-level discount.
    Example: {"percentage":10,"amount":"5.00"}

  - `lineItems.discount.itemDiscount.percentage` (number, required)
    Percentage of the adjustment.
    Example: 10

  - `lineItems.discount.itemDiscount.amount` (string, required)
    Amount of the adjustment.
    Example: "5.00"

  - `lineItems.discount.itemDiscount.label` (string)
    Label for the adjustment.
    Example: "Holiday Discount"

  - `lineItems.discount.itemDiscount.tax` (string)
    Tax amount for the adjustment.
    Example: "0.50"

  - `lineItems.discount.itemDiscount.taxTableId` (string)
    Tax table ID for the adjustment.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `lineItems.discount.cartDiscount` (object)
    Cart-level discount.
    Example: {"percentage":5,"amount":"2.50"}

  - `lineItems.fee` (object)
    Fee associated with the Line Item.
    Example: {"cartFee":{"percentage":3,"amount":"1.50"},"itemFee":{"percentage":2,"amount":"1.00"}}

  - `lineItems.fee.cartFee` (object)
    Cart-level fee.
    Example: {"percentage":3,"amount":"1.50"}

  - `lineItems.fee.itemFee` (object)
    Item-level fee.
    Example: {"percentage":2,"amount":"1.00"}

  - `lineItems.metadata` (array)
    Metadata associated with the Line Item.
    Example: [{"key":"key1","value":"value1","externalId":"ext123"},{"key":"key2","value":"value2","externalId":"ext123"}]

  - `lineItems.subTotal` (string)
    Subtotal of the line item.
    Example: "100.00"

  - `customSales` (array)
    Custom sales associated with the Order.
    Example: [{"customSaleId":"507f1f77bcf86cd799439011","name":"Custom Sale 1","applyTaxes":true,"quantity":1,"price":"1000.50","totalTax":"100.05","total":"1100.55","discount":{"cartDiscount":{"percentage":5,"amount":"50.00"}}}]

  - `customSales.customSaleId` (string, required)
    ID of the custom sale.
    Example: "1234567890"

  - `customSales.applyTaxes` (boolean, required)
    Flag to indicate if the custom sale is applied.

  - `customSales.quantity` (number, required)
    Quantity of the custom sale.
    Example: 1

  - `customSales.name` (string, required)
    Name of the custom sale.
    Example: "Custom Sale 1"

  - `customSales.price` (string, required)
    Price of the custom sale.
    Example: "1000.50"

  - `customSales.totalTax` (string, required)
    Total tax of the custom sale.
    Example: "1000.50"

  - `customSales.total` (string, required)
    Total of the custom sale.
    Example: "1000.50"

  - `customSales.taxes` (array)
    Taxes of the custom sale.
    Example: [{"name":"Tax 1","percentage":10,"amount":"1000.50","taxTableName":"Tax Table 1","compounding":true,"priority":1,"taxTableId":"1234567890","id":"1234567890"}]

  - `customSales.discount` (object)
    Discount of the custom sale.
    Example: {"cartDiscount":{"label":"Cart Discount 1","amount":"1000.50","percentage":0.15}}

  - `customSales.discount.cartDiscount` (object, required)
    Cart discount of the custom sale.
    Example: {"label":"Cart Discount 1","amount":"1000.50","percentage":0.15}

  - `customSales.fee` (object)
    Fee of the custom sale.
    Example: {"cartFee":{"label":"Cart Fee 1","amount":"1000.50","percentage":0.15,"taxName":"Tax 1","taxTableId":"1234567890"}}

  - `customSales.fee.cartFee` (object, required)
    Cart fee of the custom sale.
    Example: {"label":"Cart Fee 1","amount":"1000.50","percentage":0.15,"taxName":"Tax 1","taxTableId":"1234567890"}

  - `refund` (string)

## Response 201 fields (application/json):

  - `id` (string)
    Unique identifier for the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `createdAt` (string)
    Timestamp when the Order was created.
    Example: "2025-12-07T19:31:48.436+00:00"

  - `updatedAt` (string)
    Timestamp when the Order was last updated.
    Example: "2025-12-07T19:35:48.436+00:00"

  - `companyId` (string)
    Company ID associated with the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `currency` (string)
    Currency of the Order.
    Example: "USD"

  - `receiptId` (string)
    Receipt ID of the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `status` (string)
    Status of the Order.
    Example: "pending"

  - `customerId` (string)
    Customer ID of the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `source` (string)
    Source of the Order.
    Example: "final"

  - `sessionId` (string)
    Session ID of the Order.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `balance` (string)
    Balance amount of the Order.
    Example: "1000.50"

  - `externalId` (string)
    External ID associated with the Order when synced from external source. If present, it will set fromFinal to true.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `fromFinal` (boolean)
    Flag to indicate if the Order is created from Final.

  - `customerNote` (string)
    Customer note of the Order.
    Example: "Customer note"

  - `parkReduceStock` (string)
    When the order is parked, the stock will be reduced by this amount. If 0, the stock will not be reduced.
    Example: "0"

  - `parkExpiryDate` (string)
    Expiry date of the parked order.
    Example: "never"

  - `signature` (string)
    Signature of the Order in Base64 format.
    Example: "SGVsbG8gV29ybGQ="

  - `summary` (object)
    Summary of the Order.
    Example: {"discountTotal":"1000.50","shippingTotal":"1000.50","total":"1000.50","totalTaxes":"1000.50","isTaxInclusive":false,"subTotal":"1000.50","taxes":[{"name":"Tax 1","percentage":10,"amount":"1000.50","taxTableName":"Tax Table 1","compounding":true,"priority":1,"taxTableId":"1234567890","id":"1234567890"}],"tip":{"percentage":0.15,"amount":"1000.50"}}

  - `summary.discountTotal` (string, required)
    Total discount amount of the Order.
    Example: "1000.50"

  - `summary.shippingTotal` (string)
    Total shipping amount of the Order.
    Example: "1000.50"

  - `summary.total` (string, required)
    Total amount of the Order.
    Example: "1000.50"

  - `summary.totalTaxes` (string, required)
    Total taxes amount of the Order.
    Example: "1000.50"

  - `summary.isTaxInclusive` (boolean, required)
    Flag to indicate if the order is tax inclusive.

  - `summary.subTotal` (string, required)
    Subtotal amount of the Order.
    Example: "1000.50"

  - `summary.taxes` (array, required)
    Taxes associated with the Order.
    Example: [{"name":"Tax 1","percentage":10,"amount":"1000.50","taxTableName":"Tax Table 1","compounding":true,"priority":1,"taxTableId":"1234567890","id":"1234567890"}]

  - `summary.taxes.name` (string, required)
    Name of the tax.
    Example: "Tax 1"

  - `summary.taxes.taxTableId` (string)
    ID of the tax table.
    Example: "1234567890"

  - `summary.taxes.taxTableName` (string)
    Name of the tax table.
    Example: "Standard Tax"

  - `summary.taxes.id` (string)
    ID of the tax.
    Example: "1234567890"

  - `summary.taxes.percentage` (number, required)
    Percentage of the tax (e.g. 0.15 for 15%).
    Example: 0.15

  - `summary.taxes.amount` (string, required)
    Amount of the tax.
    Example: "1000.50"

  - `summary.taxes.compounding` (boolean)
    Flag to indicate if the tax is compounding.

  - `summary.taxes.priority` (number)
    Priority of the tax.
    Example: 1

  - `summary.taxes._id` (string)

  - `summary.tip` (object)
    Tip associated with the Order.
    Example: {"percentage":0.15,"amount":"1000.50"}

  - `summary.tip.percentage` (number)
    Percentage of the tip.
    Example: 0.15

  - `summary.tip.amount` (string)
    Amount of the tip.
    Example: "1000.50"

  - `summary.tip.tipTo` (string)
    ID of the tip to.
    Example: "1234567890"

  - `cartDiscount` (object)
    Cart discount of the Order.
    Example: {"label":"Cart Discount 1","amount":"1000.50","percentage":0.15}

  - `cartDiscount.amount` (string, required)
    Amount of the cart discount.
    Example: "1000.50"

  - `cartDiscount.percentage` (number, required)
    Percentage of the cart discount.
    Example: 0.15

  - `cartDiscount.label` (string)
    Label of the cart discount.
    Example: "Cart Discount 1"

  - `cartFees` (array)
    Cart fees of the Order.
    Example: [{"id":"1234567890","label":"Cart Fee 1","amount":"1000.50","percentage":0.15,"taxName":"Tax 1","taxTableId":"1234567890","tax":"1.10"}]

  - `cartFees.label` (string, required)
    Label of the cart fee.
    Example: "Cart Fee 1"

  - `cartFees.id` (string)
    ID of the cart fee.
    Example: "1234567890"

  - `cartFees.percentage` (number, required)
    Percentage of the cart fee.
    Example: 0.15

  - `cartFees.amount` (string, required)
    Amount of the cart fee.
    Example: "1000.50"

  - `cartFees.taxName` (string)
    Name of the tax.
    Example: "Tax 1"

  - `cartFees.tax` (string)
    Tax of the cart fee.
    Example: "1000.50"

  - `paymentMethods` (array)

  - `posData` (object)
    POS data of the order.
    Example: {"outlet":"1234567890","station":"1234567890","employee":"1234567890"}

  - `posData.outlet` (string)
    Outlet ID of the order.
    Example: "1234567890"

  - `posData.station` (string)
    Station ID of the order.
    Example: "1234567890"

  - `posData.employee` (string)
    Employee ID of the order.
    Example: "1234567890"

  - `metadata` (array)
    Metadata associated with the Customer.
    Example: [{"key":"key1","value":"value1","externalId":"ext123"},{"key":"key2","value":"value2","externalId":"ext123"}]

  - `metadata.key` (string, required)
    Key of the metadata entry.
    Example: "key1"

  - `metadata.value` (string, required)
    Value of the metadata entry.
    Example: "value1"

  - `metadata.externalId` (string)
    External ID associated with the metadata entry.
    Example: "ext123"

  - `notes` (array)
    Notes associated with the Order.
    Example: [{"author":"John Doe","note":"This is a note","addedByUser":true,"dateCreated":"2025-12-07T19:31:48.436+00:00","externalId":"ext123","customerNote":true}]

  - `notes.author` (string, required)
    Author of the note.
    Example: "John Doe"

  - `notes.note` (string, required)
    Note of the order.
    Example: "This is a note"

  - `notes.externalId` (string)
    External ID of the note.
    Example: "1234567890"

  - `notes.addedByUser` (boolean, required)
    Added by user of the note.
    Example: true

  - `notes.dateCreated` (string, required)
    Date created of the note.
    Example: "2025-12-07T19:31:48.436+00:00"

  - `notes.customerNote` (boolean)
    Customer note of the order.
    Example: true

  - `billing` (object)
    Billing address associated with the Order.
    Example: {"firstName":"John","lastName":"Doe","address1":"123 Main St","address2":"Suite 100","city":"New York","state":"NY","country":"USA","postCode":"10001"}

  - `billing.firstName` (string)
    First name of the person associated with the Address.
    Example: "John"

  - `billing.lastName` (string)
    Last name of the person associated with the Address.
    Example: "Doe"

  - `billing.address1` (string)
    First line of the address.
    Example: "123 Main St"

  - `billing.address2` (string)
    Second line of the address.
    Example: "Suite 100"

  - `billing.city` (string)
    City of the address.
    Example: "New York"

  - `billing.state` (string)
    State of the address.
    Example: "NY"

  - `billing.country` (string)
    Country of the address.
    Example: "USA"

  - `billing.postCode` (string)
    Post code of the address.
    Example: "10001"

  - `shipping` (object)
    Shipping address associated with the Order.
    Example: {"firstName":"John","lastName":"Doe","address1":"123 Main St","address2":"Suite 100","city":"New York","state":"NY","country":"USA","postCode":"10001"}

  - `lineItems` (array)
    Line items associated with the Order.
    Example: [{"productId":"507f1f77bcf86cd799439011","variantId":"507f1f77bcf86cd799439012","name":"Sweet Tea","quantity":1,"manageStock":true,"price":"100.00","description":"Refreshing sweet tea","sku":"SKU-001","totalTax":"10.00","total":"110.00","taxes":[{"name":"Sales Tax","percentage":10,"amount":"10.00","taxTableName":"Default Tax","compounding":false,"priority":1,"taxTableId":"507f1f77bcf86cd799439013","id":"507f1f77bcf86cd799439014"}]}]

  - `lineItems.productId` (string)
    ID of the product.
    Example: "1234567890"

  - `lineItems.variantId` (string, required)
    ID of the variant.
    Example: "1234567890"

  - `lineItems.name` (string, required)
    Name of the line item.
    Example: "Sweet Tea"

  - `lineItems.quantity` (number, required)
    Quantity of the line item.
    Example: 1

  - `lineItems.manageStock` (boolean, required)
    Whether the line item manages stock.
    Example: true

  - `lineItems.price` (string, required)
    Price of the line item.
    Example: "100.00"

  - `lineItems.description` (string)
    Description of the line item.
    Example: "Sweet Tea is a refreshing drink made with tea and sugar."

  - `lineItems.sku` (string)
    SKU of the line item.
    Example: "1234567890"

  - `lineItems.totalTax` (string, required)
    Total tax of the line item.
    Example: "100.00"

  - `lineItems.total` (string, required)
    Total of the line item.
    Example: "100.00"

  - `lineItems.productExternalId` (string)
    External ID of the product.
    Example: "1234567890"

  - `lineItems.variantExternalId` (string)
    External ID of the variant.
    Example: "1234567890"

  - `lineItems.lineItemExternalId` (string)
    External ID of the line item.
    Example: "1234567890"

  - `lineItems.internalId` (string)
    Internal ID of the line item.
    Example: "1234567890"

  - `lineItems.note` (string)
    Note of the line item.
    Example: "This is a note"

  - `lineItems.image` (string)
    Image of the line item.
    Example: "https://example.com/image.jpg"

  - `lineItems.attributes` (string)
    Attributes of the line item.
    Example: "color: red, size: small"

  - `lineItems.discount` (object)
    Discount associated with the Line Item.
    Example: {"itemDiscount":{"percentage":10,"amount":"5.00"},"cartDiscount":{"percentage":5,"amount":"2.50"}}

  - `lineItems.discount.itemDiscount` (object)
    Item-level discount.
    Example: {"percentage":10,"amount":"5.00"}

  - `lineItems.discount.itemDiscount.percentage` (number, required)
    Percentage of the adjustment.
    Example: 10

  - `lineItems.discount.itemDiscount.amount` (string, required)
    Amount of the adjustment.
    Example: "5.00"

  - `lineItems.discount.itemDiscount.label` (string)
    Label for the adjustment.
    Example: "Holiday Discount"

  - `lineItems.discount.itemDiscount.tax` (string)
    Tax amount for the adjustment.
    Example: "0.50"

  - `lineItems.discount.itemDiscount.taxTableId` (string)
    Tax table ID for the adjustment.
    Example: "o1p2q3r4s5t6u7v8w9x0y1z2"

  - `lineItems.discount.cartDiscount` (object)
    Cart-level discount.
    Example: {"percentage":5,"amount":"2.50"}

  - `lineItems.fee` (object)
    Fee associated with the Line Item.
    Example: {"cartFee":{"percentage":3,"amount":"1.50"},"itemFee":{"percentage":2,"amount":"1.00"}}

  - `lineItems.fee.cartFee` (object)
    Cart-level fee.
    Example: {"percentage":3,"amount":"1.50"}

  - `lineItems.fee.itemFee` (object)
    Item-level fee.
    Example: {"percentage":2,"amount":"1.00"}

  - `lineItems.metadata` (array)
    Metadata associated with the Line Item.
    Example: [{"key":"key1","value":"value1","externalId":"ext123"},{"key":"key2","value":"value2","externalId":"ext123"}]

  - `lineItems.subTotal` (string)
    Subtotal of the line item.
    Example: "100.00"

  - `customSales` (array)
    Custom sales associated with the Order.
    Example: [{"customSaleId":"507f1f77bcf86cd799439011","name":"Custom Sale 1","applyTaxes":true,"quantity":1,"price":"1000.50","totalTax":"100.05","total":"1100.55","discount":{"cartDiscount":{"percentage":5,"amount":"50.00"}}}]

  - `customSales.customSaleId` (string, required)
    ID of the custom sale.
    Example: "1234567890"

  - `customSales.applyTaxes` (boolean, required)
    Flag to indicate if the custom sale is applied.

  - `customSales.quantity` (number, required)
    Quantity of the custom sale.
    Example: 1

  - `customSales.name` (string, required)
    Name of the custom sale.
    Example: "Custom Sale 1"

  - `customSales.price` (string, required)
    Price of the custom sale.
    Example: "1000.50"

  - `customSales.totalTax` (string, required)
    Total tax of the custom sale.
    Example: "1000.50"

  - `customSales.total` (string, required)
    Total of the custom sale.
    Example: "1000.50"

  - `customSales.taxes` (array)
    Taxes of the custom sale.
    Example: [{"name":"Tax 1","percentage":10,"amount":"1000.50","taxTableName":"Tax Table 1","compounding":true,"priority":1,"taxTableId":"1234567890","id":"1234567890"}]

  - `customSales.discount` (object)
    Discount of the custom sale.
    Example: {"cartDiscount":{"label":"Cart Discount 1","amount":"1000.50","percentage":0.15}}

  - `customSales.discount.cartDiscount` (object, required)
    Cart discount of the custom sale.
    Example: {"label":"Cart Discount 1","amount":"1000.50","percentage":0.15}

  - `customSales.fee` (object)
    Fee of the custom sale.
    Example: {"cartFee":{"label":"Cart Fee 1","amount":"1000.50","percentage":0.15,"taxName":"Tax 1","taxTableId":"1234567890"}}

  - `customSales.fee.cartFee` (object, required)
    Cart fee of the custom sale.
    Example: {"label":"Cart Fee 1","amount":"1000.50","percentage":0.15,"taxName":"Tax 1","taxTableId":"1234567890"}

  - `refund` (string)

## Response 400 fields (application/json):

  - `statusCode` (number, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message describing what went wrong
    Example: "Validation failed: Field `schemaField` is required."

  - `error` (string, required)
    Error type/name
    Enum: "Bad Request", "Unauthorized", "Forbidden", "Not Found", "Conflict", "Unprocessable Entity", "Internal Server Error"