> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/how-order-sync-works.md).

# How Order Sync Works

### The Sync Pipeline

1. **Customer completes checkout** in Shopify.
2. **Shopify fires a webhook** to CrushSuite with the order data.
3. **CrushSuite processes the order** — validates compliance data, calculates fees, maps products to Vinoshipper IDs.
4. **CrushSuite sends the order to Vinoshipper** via their API.
5. **Vinoshipper receives the order** and begins fulfillment processing.

This happens in real time — most orders sync within seconds of checkout completion.

### What Data Transfers

| Data               | Direction             | Notes                                      |
| ------------------ | --------------------- | ------------------------------------------ |
| Order details      | Shopify → Vinoshipper | Products, quantities, prices               |
| Customer info      | Shopify → Vinoshipper | Name, email, DOB, shipping address         |
| Compliance fees    | Included in order     | Alcohol fees calculated by CrushSuite      |
| Shipping method    | Shopify → Vinoshipper | Carrier and rate selected at checkout      |
| Fulfillment status | Vinoshipper → Shopify | Updated as Vinoshipper processes the order |
| Tracking info      | Vinoshipper → Shopify | Tracking number and carrier when shipped   |

### For Self-Compliance Users

Without Vinoshipper connected, orders remain in Shopify only. You'll manage fulfillment directly through Shopify or your own fulfillment process. CrushSuite still records compliance events and fees on the order.