ZenotiHelp

Sync Shopify orders and products

ZTZenoti Docs Team Updated September 3, 2026 7 min readGuide

After you connect a Shopify store, Zenoti keeps orders, products, inventory levels, customers, and gift cards in step across the two systems through webhook events, scheduled jobs, and the Manual Sync panel. This article explains each flow, how to read the sync report, and how to fix records that failed. Setup is covered in Connect a Shopify store.


On this page


Before you begin

Permission: You need organization administrator access to manage the ECommerce accordion, and inventory management permission to receive inventory and product changes.

  • Your Shopify store must be connected and authorized. See Connect a Shopify store.
  • The Default Center for Shopify must exist and be active, and it must be mapped in Locations.
  • For inventory sync, Shopify products must carry the SKUs of the matching Zenoti products.

How order sync works

Orders reach Zenoti two ways: Shopify pushes the events you subscribed to in Subscriptions (for example orders/paid, orders/fulfilled, orders/partially_fulfilled), and the Get Sale Orders job pulls a business day's orders on its schedule. The Sale Orders row in Manual Sync pulls one chosen day on demand.

  1. A customer places an order in your Shopify store.
  2. Zenoti receives the order and creates an invoice in the Default Center, booked under the matching guest (matched by email) and sold by the Default Employee. Marketplace orders without customer details are booked under the guest configured in Marketplace Order Mapping.
  3. The order's payment is recorded with the Zenoti payment method mapped to its gateway in Payments Mapping, or with Default Custom Payment when the gateway is not mapped. With Add authorized payments. on, authorized-but-uncaptured payments are recorded too.
  4. The sync report tracks the order's Shopify statuses: order status Created, Closed, Voided, or Deleted; fulfillment UnFulfilled, PendingFulfilled, PartiallyFulfilled, or Fulfilled; financial PartiallyPaid, Paid, or PartiallyRefunded.

Shopify remains the system of record for the order; Zenoti is the system of record for the resulting invoice and the inventory movement.


How product sync works

Products move in both directions from the Manual Sync panel and the scheduled jobs:

  • Get Products pulls Shopify products into the default center's inventory and maps them to Zenoti products by SKU (GET: Products from Shopify will be added/synced with the inventory on the dedicated center setup in Zenoti and automatically mapped, based on SKU). With Add vendor for products when the product is added from Shopify on, the product's vendor is created in Zenoti as well.
  • Post Products pushes Zenoti products to the Shopify catalog.

Run the direction that matches your catalog system of record after any significant change (added SKUs, renamed items, price changes). Zenoti confirms with Products have been Synced.


How inventory sync works

Stock is aligned with the default center's inventory by the Get Inventory Level and Set Inventory Level jobs, or on demand with Sync on the Inventory Levels row (SYNC: The inventory levels from the dedicated center setup on Zenoti are synced with Shopify.). A Shopify order that becomes a Zenoti invoice consumes stock at the default center; receipts, adjustments, and transfers in Zenoti reach Shopify on the next inventory run. Enable Inventory GraphQL and Enable Inventory Stock V2 in Configuration choose the APIs used for these calls.


How gift card sync works

With Enable Gift Cards on, Zenoti gift cards are posted to Shopify so they can be redeemed online. The Gift Cards rows in Manual Sync post Sales, Redemptions/Adjustments, Update Expiry Date, and Refunds for a chosen date (POST: Gift Card Details from Zenoti will be synced into Shopify for given day.), and Migrate under Gift Card Migration pushes every active card with its balance as of yesterday. The scheduled jobs are Populate GiftCards and Post GiftCards. The Date Criteria setting decides whether a card is posted on its invoice Sale Date or Close Date.


Read the sync report

The ECommerce sync report lists every synced record with its state.

  1. Choose the record type: Items, Customers, Gift Cards, Sale Orders, Refund Orders, or Inventory Levels, and for items the type (All or Products); for gift cards, the operation (Sales, Redemptions, Refunds, Expiry, Migration).
  2. Filter by state: Pending, Synced, or Failed. The SYNC DATE, ERROR MESSAGE, and NOTES columns explain each row. Zenoti rejects a reversed range with End date cannot be older than start date.
  3. Select View Details on an order to see the Shopify order (Order #…), its Shipping Information, Payment Information (gateway, financial status), Refund Information, and line items with Item, Quantity, Price, Discount, and Total. Track Order opens the order's tracking; Resync sends a failed record again; Update saves a corrected mapping.

Review the report daily if you process material Shopify order volume.


Edit an order after sync

Open Zenoti invoice

If the Zenoti invoice is still open (service not delivered, not settled):

  • Edit in Shopify, then pull the day again with Sale Orders > Get or wait for the next Get Sale Orders run.
  • Edit in Zenoti in the POS (Point of Sale). Zenoti-side edits to invoice contents are not written back to Shopify; Shopify keeps the original order.

Closed Zenoti invoice

Closed Zenoti invoices cannot be edited directly. To correct one:

  1. Void the Zenoti invoice. Voiding reverses the inventory movement at the default center.
  2. Create a new invoice with the corrected amount, guest, or products, and close it.
  3. Update the Shopify order from the Shopify admin if the correction changes fulfillment or payment.

Refund a Shopify order

Refund initiated in Shopify

  1. A Shopify admin issues a refund on the order.
  2. Zenoti receives the refund and records it against the matching invoice; the sync report lists it under Refund Orders with the Restock Status (restocked or not restocked).
  3. Gift card refunds are posted back through the Refunds gift card operation.

Refund initiated in Zenoti

  1. Open the invoice in Zenoti and refund it.
  2. Zenoti records the refund locally. It does not push a refund to Shopify; refund the order in Shopify as well so the two sides agree.

Handle a sync failure

Failed records appear in the sync report with the Failed state and an ERROR MESSAGE.

Symptom Likely cause Resolution
Product not found on an order The Shopify line item's SKU has no match in Zenoti. Create or correct the Zenoti product's SKU, run Get Products, then Resync the order.
Your Shopify token is no longer valid. Click Reset and then click Authorize Now to reconnect The app was uninstalled from Shopify or the token was revoked. Reset and authorize again, then Register Webhooks. See Connect a Shopify store.
Map locations and proceed with product sync The default center is not mapped to a Shopify location. Map it in Locations.
Configured payment for <gateway> was removed from the System. Verify the mapping and save the payments A mapped Zenoti payment method was deleted. Re-map the gateway in Payments Mapping.
Gift Card Sync Failed The gift card posting was rejected by Shopify. Check the row's ERROR MESSAGE and Resync.
This vendor has been removed from the system and is no longer available. The vendor created for a Shopify product was deleted in Zenoti. Re-assign the product's vendor and Resync.
Webhook events never arrive Subscriptions were not registered after (re)authorization. Select Register Webhooks in Subscriptions.

If failures accumulate, pause the integration (see Configure an integration pause schedule), resolve the root cause, then Resync the failed records.


Reconciliation

Reconcile Shopify orders against Zenoti invoices at a cadence that matches your order volume.

Source Report / view Key columns
Zenoti ECommerce sync report, Sale Orders, filtered to the period Order number, invoice, state, sync date, error message
Zenoti Collections by Invoices report, filtered to the default center Invoice number, guest, total, closed/open, refund amount
Shopify Orders export from Shopify admin, filtered to the same date range Order number, total, fulfillment status, financial status

Match key. Each Zenoti invoice created from Shopify carries the Shopify order number. Match on this number.

What to look for.

  • A Zenoti invoice with no matching Shopify order was created directly in Zenoti and wrongly attributed to the Shopify channel.
  • A Shopify order with no Zenoti invoice is Pending or Failed in the sync report.
  • Amounts that disagree usually come from an edit on one side that did not cross over.

Cadence. Reconcile daily if you process Shopify orders daily, weekly otherwise.


Tips

  • Keep SKUs consistent between Zenoti and Shopify to avoid the most common class of order-sync failure.
  • Run Post Products or Get Products after any bulk catalog change so the two catalogs do not drift.
  • Treat the sync report as a daily operational tool. Failures left unattended accumulate.
  • If you run a sale on Shopify, confirm your Zenoti tax and promotion rules align before go-live; sale pricing discrepancies surface as amount mismatches in reconciliation.

Was this article helpful?
Your feedback helps us improve our documentation.