How Marketplace Sync Works
Iraca connects to your sales channels and syncs orders on a schedule. Here's what happens during each sync.
Sync frequency
Each channel connection has its own sync frequency, configurable in the channel settings. The default is every 30 minutes.
What gets synced
Orders (inbound)
Iraca pulls new orders from the marketplace and creates them in your order list with status Confirmed. Only orders placed after the last sync are pulled — Iraca won't re-import orders it has already seen.
Orders still waiting on payment. On Amazon and WooCommerce, an order the marketplace hasn't released yet (Amazon's Pending, WooCommerce's Pending payment and On hold) is imported as Awaiting payment. Its units are held back from the stock Iraca reports to your channels, so they can't be sold twice while the marketplace finishes with the payment, but it doesn't count as a sale, never goes on a pick list and can't be shipped. Iraca checks on it every sync: once the marketplace releases it, it becomes Confirmed and joins your normal flow; if it's cancelled or the payment fails, it becomes Cancelled and its units are released.
Orders Amazon reports shipped. Amazon marks an order Shipped as soon as a label is bought, which can be days before it is actually packed. So by default Iraca never fulfils an order on Amazon's say-so, even when the connection's status mapping sends Shipped to Fulfilled: the order stays Confirmed, holding its units, until you ship it in Iraca (fulfilment mode or the Fulfill button). Taking a Shipped order off the shelf automatically is a platform setting Iraca support can turn on, for a business running Iraca alongside another inventory system. When it is on and Iraca doesn't have the stock to cover the order, the order stays open with a note saying why, and for a kit the stock alert email names the component and the ingredient that ran short.
Each order line is matched to an Iraca product:
- On Shopify, WooCommerce, Amazon, and Walmart, matching is done by SKU. If a product doesn't exist yet, Iraca creates it automatically and sets up the mapping for future syncs.
- On Etsy and TikTok Shop, matching is done via your manually configured product mappings. Items without a mapping are skipped.
Inventory levels (outbound)
When a product has an active mapping with inventory sync enabled, Iraca pushes the current stock level back to the marketplace after each change. This keeps your marketplace listings from overselling when stock is updated in Iraca.
The number Iraca sends is what you can actually still sell, not just what's on the shelf:
- A product counts its finished stock, plus what its recipe's ingredients can still make, minus units already on open orders that haven't shipped, including orders awaiting payment.
- A kit bundle counts what its components allow. If a kit takes 2 cookies and 1 jar, and you can supply 24 cookies and 50 jars, the listing shows 12. A component that has a recipe counts what its ingredients can make, too.
- A kit order that hasn't shipped yet holds its components, so selling a component on its own and selling it inside a kit draw on the same count.
By default, stock is counted across all your warehouses except quarantine, and marketplace orders are fulfilled from your default warehouse. If you keep stock in several places, you can choose which warehouses each connection sells from. See Choosing which warehouses a channel sells from.
Previewing a stock push
Before you turn on Sync inventory levels back, you can see exactly what Iraca would tell the marketplace. Open the channel connection, then click Preview stock push. You get a table with, for each listing, what you have on hand, what your recipes could still make, what's already committed to open orders, and the number that would be sent. For Amazon, the table also shows what Amazon has today and the change.
A kit row shows the same columns, counted in kits from its parts: kits you can put together from parts on the shelf, more kits once the parts with recipes are made, and kits' worth of parts already held by open orders. The scarcest part sets each figure. Each part is listed under the kit with how many kits it's enough for.
Warnings appear in plain words under the product:
- Takes the listing to zero — the listing would be marked out of stock.
- A big jump — more than five times what the marketplace has now, or from zero to over 100.
- Shared components — a kit and another listing draw on the same components, so selling one lowers the other.
Opening the preview sends nothing and changes nothing, and it works even while stock sync is off. On Amazon you can also click Check with Amazon: Amazon validates each quantity and answers VALID or INVALID without applying it. Amazon limits this to a few checks a minute.
What doesn't sync automatically
- Order status changes — fulfilling or cancelling an order in Iraca does not update the marketplace order status. You'll need to do that in the marketplace directly.
- Product details — names, prices, and descriptions are not pushed to the marketplace. Iraca manages inventory, not listings.
- Price sync — price sync is available per mapping but is off by default.
Sync logs
Every sync run is recorded. If a sync fails or skips items, you can review the details in the sync log for that channel connection.
Triggering a manual sync
You can sync at any time by opening the channel connection and clicking Sync now. This pulls any orders placed since the last sync immediately, without waiting for the scheduled interval.