ShipWave Channels

Importing marketplace orders

How marketplace orders are automatically imported into ShipWave and Shopify.

Automatic order import

When Auto-import orders is enabled for a channel, ShipWave automatically pulls new orders:
  1. A cron job runs every 15 minutes
  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 Shopify
  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 Shopify products via SKU:
  1. Look up the MarketplaceListing by external SKU
  2. Get the associated Shopify 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.

Shopify order writeback

After importing, ShipWave creates a corresponding order in Shopify:
  • 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
This keeps your Shopify order history unified and ensures Shopify inventory decrements properly.

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 Shopify 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

Back to Help Center