Skip to main content

Marketplace Distribution and Sync

Marketplace distribution is opt-in. Products remain private to your workspace until an authorized staff member submits them and BoxNCase approves the listing.

What is synchronized​

DataDirectionBehavior
Approved products, variants, and mediaWorkspace → marketplaceOnly the submitted assortment is eligible for publication. SKU and identifier conflicts block publication.
Available inventoryWorkspace → marketplaceSellable quantity follows the configured warehouse and safety-stock rules.
Marketplace ordersMarketplace → workspaceNew orders appear with the information required to accept and fulfill them.
Fulfillment and trackingWorkspace → marketplaceShipment status and tracking updates are reflected for the buyer.
Cancellation and exception statusBoth directionsConflicts are held for staff review rather than silently overwritten.

Listing lifecycle​

Listings move through Draft, In review, Published, Needs action, and Removed states. The workspace records validation errors and review notes against the affected product so your team can resolve them without changing unrelated catalog data.

Operational expectations​

  • Keep stable product and variant identifiers across imports.
  • Treat stock updates as idempotent and send the latest absolute quantity.
  • Acknowledge new marketplace orders before fulfillment work begins.
  • Add tracking as soon as a shipment is created.
  • Remove a listing through its distribution settings; do not delete a product that still has active orders.

For order-data boundaries, see Order privacy.