Marketplace integration: catalog to payouts

Marketplace integration (Ozon, Wildberries, etc.) is not a single “export products” feature. It’s a set of flows: catalog, prices, stock, orders, statuses, returns, and payouts.

Core flows

• Catalog: items, variations, attributes, media.
• Pricing: base price, promos, tax rules, rounding.
• Stock: single source of truth, reservations, no negative stock.
• Orders: import, labels, packing, tracking.
• Returns: reasons, condition, restock vs write‑off.
• Finance: fees, penalties, payout reconciliation.

Recommended architecture (pragmatic)

• Event log: store inbound marketplace events and your processing result.
• Idempotency keys: order_id + event_type + attempt; safe reprocessing.
• Queues: separate pipelines for catalog, stock and orders to avoid cascading outages.
• Monitoring: latency, error rate, and backlog depth per pipeline.

KPIs to track

Cancellation rate due to OOS, time‑to‑ship, number of stock mismatches, and payout reconciliation delta. These metrics show whether integration improves operations—not just “works”.

Reliability tips

Build idempotent handlers, keep an event log, use retries and alerts. Start with the most expensive failure mode—usually stock and orders.