For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

  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.

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

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.

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 marked as historical, such as orders imported with Matrixify

  • 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.

Last updated