Direct HTTP requests reference

Sending orders

Sitecore CDP provides different options for sending orders to Sitecore CDP. The available options depend on, for example, the frequency of order submission, and whether orders are submitted in real-time, offline, or synchronously.

Sending orders using a single event

To submit an order to Sitecore CDP in real time, you must send an ORDER_CHECKOUT event.

Important

To use the flight data model, assemble orders using multiple events instead of sending an ORDER_CHECKOUT event.

You can use Sitecore CDP to submit orders in real time to Sitecore CDP. Use this option to submit orders using a single event if your organization's site is tagged to send all order-related data from the confirmation page. You can also use this option if your organization uses an order management system (OMS), or if your organization uses cookies and local storage to capture order details.

Sending orders using multiple events

You can use Sitecore CDP to assemble orders in real-time if the booking flow for your organization's site does not facilitate sending all order-related data from the confirmation page. For example, your site's confirmation page might not be tagged to capture and send contact information so you would need to send the ADD_CONTACTS event from a different web page.

Managing orders synchronously

You can manage orders synchronously using the REST API to do any of the following:

Create, locate, retrieve, update and delete orders and order items
Update orders that have the same referenceId values and have orderedAt values (purchase dates) within two days of another.
Send additional data with orders using order data extensions
Send additional data with order items using order item data extensions

Offline order submission

Note

Offline order submission is performed using the Batch API.

You can use offline order submission with the Batch API to do any of the following:

Submit a large amount of historical orders from a data lake or data warehouse as a once-off, when your organization first integrates with Sitecore CDP.
Submit offline orders from a third-party system, such as a call center.
Submit orders for guests who block cookies or who use an anonymous browser.
Submit complete orders if your organization submits partial orders using Stream API.
Update orders submitted with Stream API on a daily basis.

You can send offline order data to Sitecore CDP. If your organization wants to capture more robust information with orders, you can optionally use an order data extension. An order data extension is an array that enables you to specify whatever name/value pairs (attributes) your organization wants. You can insert one order data extension within the array.

Similarly, your organization can send offline order item data to Sitecore CDP. To capture more robust information about a specific order item, you have the option of using an order items data extension. An order items data extension is an array that enables you to specify whatever name/value pairs (attributes) you want. You can insert one order items data extension within the array.

You can view order data extensions and order item data extensions in the guest profile and use them in decisioning and personalization.

If you have suggestions for improving this article, let us know!