Order settings

Order settings is where you turn on order sync and check that orders reach Cevoid from every store and market. Cevoid keeps a copy of every order from your connected stores or your own system, and uses it for purchase incentives, review requests, and other features that start from a purchase.

Navigate to Settings → Orders⁠ to manage order sync. The Settings button on the Orders⁠ page opens it too.

What Settings → Orders⁠ shows depends on your workspace's platform.

• Live sync brings in orders as they're placed, and updates them when they're paid, fulfilled, refunded, or canceled. On Shopify, it also brings in deliveries, with delivery events. To bring in orders from before live sync started, import order history.
• On Shopify, orders sync through one of the Cevoid apps installed on the store. A store with several Cevoid apps still syncs each order once.
• Markets: Cevoid matches each order to a market by its storefront domain. When one Shopify store runs several markets, the order's currency picks the market, if exactly one of the store's markets uses that currency.
• Profiles: every order with an email address creates or updates the customer's profile

To find and open the orders themselves, see Orders.

Sync orders turns on live sync for every Shopify and WooCommerce store connected to your workspace. New workspaces start with it off.

1. Navigate to Settings → Orders⁠
2. Enable Sync orders. Each store shows Setting up, then Waiting for orders until its first order arrives, and Enabled once orders sync.

The switch saves right away. To connect a store first, see Shopify or WooCommerce. Without a connected store, Stores shows No supported commerce store connected, and Connect store opens Settings → Integrations⁠.

Disable Sync orders to stop live sync for every store. Orders already in Cevoid stay, but orders placed while it's off don't reach Cevoid, so nothing that starts from an order runs for them. While it's off, Stores and Import order history are dimmed.

With a Shopify store connected, a flow that starts on Order fulfilled or Order delivered can be published only while order sync is ready for every Shopify store.

Flows that start on Order delivered need delivery events from Shopify, which need more Shopify access than orders do. A store that syncs orders without delivery events shows Enabled with Enable delivery events, and its status says Orders are syncing. Additional Shopify access is needed for delivery events.

1. Navigate to Settings → Orders⁠
2. Click Enable delivery events on the store's card. A dialog lists the access scopes that are missing.
3. Click Update access scopes. Shopify opens.
4. Approve the requested access in Shopify. You're redirected back to Cevoid.

Until then, a flow that starts on Order delivered shows Shopify delivery access required in the flow editor. Its Enable Shopify access button opens the same approval.

Settings → Orders⁠ shows a card for each connected Shopify or WooCommerce store, with the markets it serves. Each card shows how many orders arrived through live sync in the last 30 days, and the store's order sync status. Hover over a status to see what it means.

Check status, next to Stores, checks every store again and repairs what Cevoid can repair on its own. You can check once a minute. While a check runs, each store and market shows Checking. Each store's ... menu holds Import order history, Check status, and Store settings, which opens the store's integration settings.

A store can also show Coverage gaps: periods live sync didn't cover, such as while Sync orders was off. Hover over the badge to see them. To bring in orders from those periods, import order history.

Under each store, every market it serves shows whether orders arrive for it. Click a market to see its Last received order, Orders last 30 days, and the Source the orders came from. Only orders from live sync count here, not imported order history.

Until order sync is ready and orders arrive, the Loyalty → Purchase incentives⁠ page shows a banner about it, such as Order sync is disabled, with a link to Review order settings.

Live sync brings in orders placed after it started. To bring in earlier orders from a Shopify or WooCommerce store, import them as order history, for example so that reviews of earlier purchases show Verified buyer.

Imported orders:

• Show on the Orders⁠ page, with the Import type History import
• Create or update customer profiles, and mark reviews Verified buyer
• Never get review requests, and start no flows on their own
• Earn no loyalty points, and don't count toward your monthly order limit

An import skips the orders Cevoid already has. You can import from a store once Sync orders is on and the store's live sync is ready, one import per store at a time.

1. Navigate to Settings → Orders⁠
2. Click Import history under Import order history. The Import order history dialog opens.
3. Select the store in Store. A store that can't import yet says Live synchronization is not ready or Import already running.
4. Set Import orders since to the date to start from. It starts 30 days back, and the import runs up to now.
5. Click Import history. The import shows in the list under Import order history.

Import order history in a store card's ... menu opens the same dialog, with that store selected.

On Shopify, importing orders older than 60 days needs full order history access. If the store doesn't have it, the dialog shows Additional Shopify access required: click Grant full history access, then Update access scopes, and approve the access in Shopify.

The list under Import order history shows your latest 10 imports, with the Store, the number of Orders imported, the Status, and the Date.

Click an import to open Historical order import, with the dates it covers, when it started and finished, and the Error for a failed import. To stop an import that's running, click Cancel. The orders it already imported stay.

On other platforms and headless setups, Settings → Orders⁠ shows Send orders through the API. Your own system sends each order to the Cevoid API, which is always on: there's no switch to turn on. Order lines are matched to your product catalog, so Cevoid also needs your products, usually from a product feed.

1. Navigate to Settings → Integrations → Cevoid API⁠ and click Create key. Manage API keys on Settings → Orders opens the same page.
2. Enter a name in API key name
3. Optional: Set Expiration. Expired keys stop working.
4. Under Permissions, select Custom
5. Set Orders to Write
6. Click Create key
7. Copy the key. Cevoid shows it only once.

Your system then sends each order to POST https://api.cevoid.com/v2/orders, with the key in an Authorization: Bearer header and an Idempotency-Key header. Include the storefront domain of the order's market, so Cevoid matches the order to that market. Send orders through the API shows these steps with an Example request body, and API documentation opens the API reference. Orders your system sends as historical are handled like an order history import.

Below Send orders through the API, Markets lists your markets with the same badges as Market activity. Click Check status to update them. Without a market, the page shows No markets: click Go to markets and create one with your storefront domain before you send orders.

Unmapped orders lists the connections that sent orders in the last 30 days without a domain that matches one of your markets. Add the market's storefront domain to each order, so it's counted for that market.