> 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

What happens to an order after checkout: what CrushSuite sends to Vinoshipper, what comes back, and which orders are never sent.

What happens after checkout depends on whether you use Vinoshipper or manage compliance yourself.

### Vinoshipper Stores

1. **The customer completes checkout** in Shopify.
2. **Shopify tells CrushSuite** about the new order, usually within a few seconds.
3. **CrushSuite sends the order to Vinoshipper**, marked as paid. Vinoshipper runs its own compliance check on it.
4. **CrushSuite records the result** under **Orders**. If the order failed, it shows **Error** or **Non-compliant** and you get an order issue email. See [Handling Failed or Blocked Orders](/docs/compliance/orders-and-fulfillment/handling-failed-or-blocked-orders.md).
5. **Vinoshipper fulfills the order.** When Vinoshipper marks it **Shipped**, CrushSuite marks the Shopify order fulfilled and adds the tracking number. See [Fulfillment with Vinoshipper](/docs/compliance/orders-and-fulfillment/fulfillment-with-vinoshipper.md).

CrushSuite tags the Shopify order `VS:[number]:created` so you can see the Vinoshipper order number in Shopify.

### Self-Managed Stores

Orders aren't sent anywhere. CrushSuite records each order and bills it, and you fulfill it yourself in Shopify.

***

### What Gets Sent to Vinoshipper

| Data                    | Notes                                                                                                                                                                  |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Products and quantities | Only products synced from Vinoshipper. Other items (such as merchandise) are left out                                                                                  |
| Prices and discounts    | Product and order discounts are sent as one dollar amount off. Shipping discounts are not sent                                                                         |
| Customer details        | Name, email, date of birth, shipping address                                                                                                                           |
| Shipping                | The shipping service the customer chose and its full price. Local pickup and local delivery are sent as such. For UPS Access Point pickup, the chosen location is sent |
| State alcohol fee       | Sent as a separate fee. See [Compliance Fees on Orders](/docs/compliance/orders-and-fulfillment/compliance-fees-on-orders.md)                                          |
| Order note              | Sent as the gift note                                                                                                                                                  |
| Paid                    | Always sent as paid. CrushSuite doesn't check payment                                                                                                                  |

Vinoshipper's own emails to your customer are turned off for these orders.

Customers pay in Shopify checkout, so Shopify Payments is required (see the [Go-Live Checklist](/docs/compliance/getting-started/go-live-checklist.md)). CrushSuite sends no card details to Vinoshipper.

### What Comes Back

| From Vinoshipper               | What happens                                                                                       |
| ------------------------------ | -------------------------------------------------------------------------------------------------- |
| **Shipped**                    | The Shopify order is marked fulfilled, with the tracking number                                    |
| **Delivered** or **Picked up** | A delivered event is added to the Shopify fulfillment, and the CrushSuite order shows **Complete** |
| **Cancelled** in Vinoshipper   | Nothing. The Shopify order is not cancelled                                                        |

***

### When You Change an Order in Shopify

| What you do in Shopify                             | What happens in Vinoshipper                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cancel the order**                               | CrushSuite cancels it in Vinoshipper too. If that fails, you may get an email saying the order couldn't be cancelled. Check Vinoshipper and cancel it there if it's still open                                                                                                                                                                                                    |
| **Change the products or shipping address**        | If Vinoshipper hasn't started on the order, CrushSuite updates it there. For an order Vinoshipper accepted, this means cancelling it and sending a new one, with `_1`, `_2` and so on added to the order number. If Vinoshipper has already started, you get an email saying the order couldn't be updated. Check Vinoshipper after any edit to make sure the change went through |
| **Change only the note, email or billing address** | Nothing is sent to Vinoshipper                                                                                                                                                                                                                                                                                                                                                    |
| **Delete the order**                               | Nothing happens in Vinoshipper                                                                                                                                                                                                                                                                                                                                                    |

If the order failed and never reached Vinoshipper (status **Error**), editing its products, addresses, email, shipping or total makes CrushSuite try to create it again.

***

### Orders That Are Never Sent

* **POS orders** (they're still billed)
* **International orders** (shipping outside the US)
* **Orders with no Vinoshipper products**, such as merchandise only (they're still billed)
* **Imported orders** tagged `crushsuite-migrated-order`, marked with the `cs__historical_order` note attribute, or imported with Matrixify. See [Importing Past Orders into Shopify](/docs/compliance/orders-and-fulfillment/importing-past-orders-into-shopify.md)
* **Any order placed while order syncing is turned off** (see below)

### Turning Order Syncing Off

Vinoshipper stores can tick **Disable order syncing** on the CrushSuite **Orders** page and click **Update**. While it's on, new orders aren't sent to Vinoshipper, aren't recorded in CrushSuite and aren't billed. Turning it back on doesn't send the orders you missed. Disabling order syncing only stops orders going to Vinoshipper. It doesn't turn off the pre-checkout compliance check, which still runs on your storefront.

{% hint style="warning" %}
**Importing past orders?** Turn order syncing off before you import and back on when it finishes. If you change an imported order later, tag it `crushsuite-migrated-order` first, or it can be sent and billed. See [Importing Past Orders into Shopify](/docs/compliance/orders-and-fulfillment/importing-past-orders-into-shopify.md).
{% endhint %}