# Order Updates

### Synchronizing Order Updates

Sometimes customers or customer service representatives make changes to Shopify orders that need to be accurately reflected in HotWax Commerce to ensure the fulfillment process meets the customer's requirements. HotWax Commerce can update the following details from Shopify:

* Adding items to an order
* Removing items from an order
* Changing item quantities
* Refunded transactions

To ensure all order modifications are synced accurately, HotWax Commerce has an 'Import order updates from Shopify' job. This job checks the 'updated\_at' field of orders in Shopify and compares it to the last run time of the job. If the 'updated\_at' time is after the last run time, the job downloads all order details from Shopify, compares it to HotWax Commerce data, and updates any changed fields. The default frequency for the job is every hour, but merchants can change it through the Job Manager App to meet their requirements.

<figure><img src="/files/OnesjfMAsRyp4qsACkSW" alt=""><figcaption><p><em>Fig.6 : Configuration of the “Import order updates from Shopify” job in the Job Manager App</em></p></figcaption></figure>

### Syncing Shopify order tags

Shopify order tags are also included in order updates. This allows merchants to use Shopify Flow, fraud tools, or customer service workflows to update an order's handling instructions after the order is created.

For example, merchants can configure Shopify Flow to apply a `HOLD` tag when an order needs manual review and an `APPROVED` tag when the order is ready for fulfillment. HotWax Commerce syncs these tag changes from Shopify so the order management system (OMS) can use the latest tag values when deciding whether an order should remain in brokering or proceed to facility allocation.

#### HOLD and APPROVED tag flow

1. A customer places an order in Shopify.
2. Shopify Flow evaluates the order against the merchant's review conditions, such as order value, risk level, or product-specific rules.
3. If the order requires review, Shopify Flow adds the `HOLD` tag. The order remains in the brokering queue and is not allocated to a facility.
4. After a customer service representative (CSR) reviews the order in Shopify, the CSR removes the `HOLD` tag and adds the `APPROVED` tag.
5. The 'Import order updates from Shopify' job syncs the updated tags to HotWax Commerce.
6. On the next allocation run, orders with the `APPROVED` tag become eligible for facility allocation and fulfillment.

If the order does not meet any manual-review condition, Shopify Flow can add the `APPROVED` tag automatically. In that case, once the order is downloaded and the tag is synced, the order can proceed through the standard allocation process.

{% hint style="info" %}
When merchants use an approval-based tag flow, the `APPROVED` tag is required before an order can proceed to allocation and fulfillment. Orders without the required approval tag remain in the brokering queue until Shopify is updated and the tag change is synced.
{% endhint %}

To learn more about how HotWax Commerce syncs order fulfillment updates with Shopify, read the [Shopify integration overview](/documents/learn-shopify/shopify-integration/readme.md). Read further to learn how HotWax Commerce manages [Presell orders](/documents/learn-shopify/shopify-integration/preorders-and-backorders.md) and [BOPIS orders](/documents/learn-shopify/shopify-integration/bopis-orders.md).


---

# Agent Instructions: 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:

```
GET https://docs.hotwax.co/documents/learn-shopify/shopify-integration/orders/order-updates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.