ShipWave Channels

Importing marketplace orders

How marketplace orders are automatically imported into ShipWave, and written back to your Shopify, BigCommerce, or WooCommerce source store.

Automatic order import

When Auto-import orders is enabled for a channel, ShipWave automatically pulls new orders:
  1. A scheduled import runs twice an hour (at :05 and :35)
  2. For each channel with auto-import enabled:
  3. — Call marketplace API to get orders since last sync
  4. — For each new order, create records in ShipWave
  5. — Write the order back to the channel's source store (Shopify, BigCommerce, or WooCommerce)
  6. — Trigger cross-channel inventory deduction
  7. — Update the channel's last sync timestamp

What gets imported

For each marketplace order, ShipWave imports:
  • Order details: Order ID, order number, order date, status
  • Customer info: Name, email (if available)
  • Shipping address: Full address for label creation
  • Line items: Products, quantities, prices, SKUs
  • Totals: Subtotal, shipping cost, tax, total
  • Marketplace metadata: Marketplace-specific IDs and data

SKU matching

ShipWave matches marketplace line items to your products via SKU:
  1. Look up the MarketplaceListing by external SKU
  2. Get the associated variant
  3. Link the order line item to the variant
If a SKU doesn't match any listing, the line item is still imported but won't be linked to a variant.

Source store order writeback

If the channel's source store is Shopify, BigCommerce, or WooCommerce, ShipWave creates a corresponding order in that store after importing. This keeps your store's order history unified and ensures its inventory decrements properly. For Shopify, ShipWave:
  • Creates a paid order with line items
  • Uses inventory_behaviour: decrement_obeying_policy
  • Tags the order with "marketplace" and the order ID
  • Adds a note with the marketplace order reference
  • Attaches shipping address and customer info
For BigCommerce and WooCommerce, turn on order mirrors on the store page. Products created in ShipWave have no store to write back to.

Order deduplication

ShipWave prevents duplicate imports:
  • Each order has a unique combination of [store, external order ID]
  • Before importing, ShipWave checks if the order already exists
  • If it exists, the order is skipped
This means re-running the import (or manual sync) won't create duplicates.

Manual order sync

To trigger an immediate order import:
  1. Go to Admin → Marketplace → [Channel]
  2. Click Sync Orders
  3. ShipWave will pull orders since the last sync
Use this if you need orders faster than the 15-minute cron cycle.

FAQs

How far back does order import go?
By default, ShipWave imports orders from the last sync timestamp. For new channels, it imports orders from the past 7 days.
What if a SKU doesn't match?
The order is still imported, but the line item won't be linked to a product variant. You can fulfill it manually.
Can I import historical orders?
Contact support to request a historical import. By default, only recent orders are imported to avoid overwhelming new accounts.
Do marketplace fees appear on the order?
ShipWave imports the customer-facing totals. Marketplace fees are typically deducted by the marketplace and don't appear on the order.

More in ShipWave Channels

Importing Marketplace Orders | ShipWave Help Center