> For the complete documentation index, see [llms.txt](https://docs.hotwax.co/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hotwax.co/documents/learn-shopify/shopify-integration/orders/order-download.md). # Order Download ## Initial order download To start managing fulfillment, merchants need to import their existing open sales orders from Shopify into HotWax Commerce. This initial import brings in all pending orders so they can be processed and fulfilled without interruption. HotWax Commerce handles this using the `Sync Shopify Order History` job. This job downloads open sales orders from a specific time period, including details like the order number, customer information, shipping address, billing details, and payment information. ### Order history When HotWax Commerce performs the initial order download, it also creates an order history. This history is created to maintain a complete record of past orders. A complete order history allows merchants to manage customer service inquiries, process returns for past orders, and analyze historical sales data. HotWax Commerce creates this order history automatically as soon as past orders are successfully imported. Order fields from Shopify map to HotWax Commerce as follows: | Order in Shopify | Order in HotWax Commerce | | ---------------- | ------------------------ | | Order ID | Order ID | | Shopify Shop | Product store | | Sales order | Sales order | | Order Status | Status | | Order date | Order date | | Location | Sales Channel | | Image | Image | | Product name | Product Name | | Variant | Variant | | SKU | SKU | | Subtotal | Subtotal | | Shipping | Shipping Method | | Total | Shipment Total | | Shipping Address | Ship To | | Billing Address | Bill To | | Tags | Tags | {% tabs %} {% tab title="Orders in Shopify" %}

Fig.2(i): Orders in Shopify

{% endtab %} {% tab title="Orders in HotWax Commerce" %}

Fig.2(ii): Orders downloaded in HotWax Commerce

{% endtab %} {% endtabs %} {% tabs %} {% tab title="Order Details in Shopify" %}

Fig.3(i): Order Details in Shopify

{% endtab %} {% tab title="Order Details in HotWax Commerce" %}

Fig.3(ii): Order Details in HotWax Commerce

{% endtab %} {% endtabs %} ## New order creation

Fig.4: New Order Creation Flow

When new orders are placed in Shopify, HotWax Commerce imports them using an event-driven flow. Here is how the new order import flow works: ### 1. Order creation in Shopify When a customer completes a purchase, Shopify registers the new order. ### 2. Webhook triggers Shopify immediately triggers the [`orders/updated` webhook](https://shopify.dev/docs/api/webhooks/2026-01?accordionItem=webhooks-orders-updated\&reference=toml). This webhook acts as a real-time notification, instantly broadcasting that a new order exists instead of waiting for a scheduled sync. ### 3. Event routing through AWS EventBridge HotWax Commerce has configured AWS EventBridge to catch the webhook event and securely routes the message to an Amazon Simple Queue Service (SQS) queue. This step prevents data loss during high traffic periods and keeps the system stable even if thousands of orders are placed at once. ### 4. Message polling from Amazon SQS HotWax Commerce continuously polls the Amazon SQS queue for unread messages. SQS holds these messages safely until HotWax Commerce is ready to read them, so no order events are dropped. ### 5. Data enrichment via GraphQL API While the webhook payload contains order details, HotWax Commerce only extracts the order ID from the message. It then uses this ID to call the [Shopify GraphQL API](https://shopify.dev/docs/api/admin-graphql/latest/queries/order). Fetching data directly from the API guarantees that HotWax Commerce processes the most reliable and up-to-date order information. ### 6. Receiving detailed order data Shopify responds to the API request with the complete details of the order. This response includes everything needed for fulfillment, such as shipping addresses, item quantities, and payment statuses. ### 7. Order creation in HotWax Commerce Finally, HotWax Commerce processes the detailed API response and creates the order in the order management system. The order is now fully integrated and ready to be routed to the best location for fulfillment. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.hotwax.co/documents/learn-shopify/shopify-integration/orders/order-download.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.