# Partially update an order

Partially updates an order. You can update orders that have the same referenceId and have orderedAt values (purchase dates) within two days of another. referenceId and orderedAt cannot be updated.

Endpoint: PATCH /v2.1/orders/{orderRef}
Version: v2.1
Security: BasicAuth

## Path parameters:

  - `orderRef` (string, required)
    The order reference. This is a unique identifier of the order record. Automatically generated when you created the order. If you don't know the order reference, first list orders.
    Example: "2d7de9df-45a2-45ea-872c-30e45139007d"

## Request fields (application/json):

  - `currencyCode` (string, required)
    The currency the guest used to complete a purchase. Set this to the organization’s default currency.
    Example: "EUR"

  - `orderedAt` (string, required)
    The date and time when the order was made.
    Example: "2024-01-01T16:17:16Z"

  - `price` (number, required)
    The amount paid for the order.
    Example: 50

  - `referenceId` (string, required)
    A unique identifier generated by your organization to reference the order. For flight orders, this is often the PNR.
    Example: "B94TXY-1"

  - `createdAt` (string)
    The date and time when the resource was created in Sitecore CDP.
    Example: "2024-01-01T16:17:16Z"

  - `modifiedAt` (string)
    The date and time when the resource was updated in Sitecore CDP.
    Example: "2024-01-01T16:17:16Z"

  - `paymentType` (string)
    The method of payment for the order.
    Example: "Card"

  - `cardType` (string)
    The card type used to pay for the order.
    Example: "Visa"

  - `pointOfSale` (string)
    The point of sale used in the order.
    Example: "home"

  - `channel` (string)
    The channel used in the order.
    Enum: "WEB", "MOBILE_WEB", "MOBILE_APP", "CALL_CENTER", "AIRPORT_KIOSK", "BRANCH", "KIOSK", "OFFLINE", "GDS", "OTA", "OTHER"

  - `status` (string)
    The status of the order.
    Enum: "BROWSED", "CANCELLED", "CONFIRMED", "DECLINED", "PARTIALY_CONFIRMED", "PARTIALY_REFUNDED", "PAYMENT_PENDING", "PENDING", "PURCHASED", "REFUNDED", "RESERVED", "SEARCHED", "UNKNOWN"

## Response 200 fields (application/json):

  - `ref` (string)
    The order reference. This is a unique identifier of the order record. Use the order reference to interact with a specific order, for example, to retrieve it, update it, or create a data extension for it.
    Example: "2d7de9df-45a2-45ea-872c-30e45139007d"

  - `href` (string)
    The link to the order.
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/orders/2d7de9df-45a2-45ea-872c-30e45139007d"

  - `createdAt` (string)
    The date and time when the resource was created in Sitecore CDP.
    Example: "2024-01-01T16:17:16Z"

  - `modifiedAt` (string)
    The date and time when the resource was updated in Sitecore CDP.
    Example: "2024-01-01T16:17:16Z"

  - `orderedAt` (string)
    The date and time when the order was made.
    Example: "2024-01-01T16:17:16Z"

  - `currencyCode` (string)
    The currency the guest used to complete a purchase.
    Example: "EUR"

  - `price` (number)
    The amount paid for the order.
    Example: 50

  - `referenceId` (string)
    A unique identifier generated by your organization to reference the order. For flight orders, this is often the PNR.
    Example: "B94TXY-1"

  - `paymentType` (string)
    The method of payment for the order.
    Example: "Card"

  - `cardType` (string)
    The card type used to pay for the order.
    Example: "Visa"

  - `pointOfSale` (string)
    The point of sale used in the order.
    Example: "home"

  - `channel` (string)
    The channel used in the order.
    Enum: "WEB", "MOBILE_WEB", "MOBILE_APP", "CALL_CENTER", "AIRPORT_KIOSK", "BRANCH", "KIOSK", "OFFLINE", "GDS", "OTA", "OTHER"

  - `status` (string)
    The status of the order.
    Enum: "BROWSED", "CANCELLED", "CONFIRMED", "DECLINED", "PARTIALY_CONFIRMED", "PARTIALY_REFUNDED", "PAYMENT_PENDING", "PENDING", "PURCHASED", "REFUNDED", "RESERVED", "SEARCHED", "UNKNOWN"

  - `contacts` (object)
    Contact details, containing a list of items.

  - `contacts.items` (array)
    List of order contacts.
    Example: []

  - `contacts.items.href` (string)
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03"

  - `consumers` (object)
    Consumer details, containing a list of items.

  - `consumers.items` (array)
    List of consumers.
    Example: []

  - `orderItems` (object)
    Order item details, containing a list of items.

  - `orderItems.items` (array)
    List of order items.
    Example: []

## Response 400 fields (application/json):

  - `status` (integer)
    The HTTP request status.
    Example: 400

  - `code` (integer)
    The HTTP response status code.
    Example: 400

  - `message` (string)
    Error description.
    Example: "orderedAt: may not be null."

  - `developerMessage` (string)
    Error description for developers.
    Example: "orderedAt: may not be null."

  - `moreInfoUrl` (string)
    URL to get more information about the error.
    Example: "https://support.sitecore.com"

## Response 401 fields (application/json):

  - `status` (string)
    The HTTP request status.
    Example: "UNAUTHORIZED"

  - `code` (integer)
    The HTTP response status code.
    Example: 401

  - `message` (string)
    Error description.
    Example: "Authentication credentials are required to access the resource. All requests must be authenticated."

  - `moreInfoUrl` (string)
    URL to get more information about the error.
    Example: "https://support.sitecore.com"