ShipWave Channels

Tracking sync to marketplaces

How tracking numbers are automatically pushed to marketplace platforms.

Automatic tracking push

When you create a shipping label for a marketplace order, ShipWave automatically pushes tracking to the source marketplace:
  1. You purchase a shipping label
  2. ShipWave captures: tracking number, carrier, service, ship date
  3. A cron job runs every 15 minutes
  4. For orders with unpushed tracking:
  5. — Call marketplace API with tracking info
  6. — Marketplace updates order status to "Shipped"
  7. — Customer receives shipping notification
  8. — ShipWave marks trackingPushed = true

What gets pushed

  • Tracking number: The carrier's tracking ID
  • Carrier: USPS, UPS, FedEx, DHL, etc.
  • Service: Priority Mail, Ground, Express, etc.
  • Ship date: When the label was created
  • Line items: Which items are in this shipment (for partial fulfillment)

Carrier mapping

Marketplaces have their own carrier codes. ShipWave maps carriers automatically:
  • USPS → "USPS" (all platforms)
  • UPS → "UPS" (all platforms)
  • FedEx → "FEDEX" (Amazon/Walmart) or "FedEx" (eBay)
  • DHL → "DHL" or "DHL_EXPRESS"
If a carrier isn't recognized, ShipWave uses "Other" with the tracking number.

Manual tracking push

To push tracking immediately without waiting for the cron:
  1. Go to the order detail page
  2. Click Sync Tracking
  3. ShipWave pushes tracking to the marketplace

Partial fulfillment

If an order has multiple items and you're shipping them separately:
  1. Create a shipment for the first set of items
  2. Tracking pushes for those specific line items
  3. Create another shipment for remaining items
  4. Tracking pushes for those line items
Each marketplace handles partial fulfillment slightly differently, but ShipWave sends the correct line item associations.

Tracking status in ShipWave

You can see tracking sync status on the order:
  • Tracking Pushed: Yes/No
  • Pushed At: Timestamp of successful push
  • Push Error: If push failed, the error message

FAQs

What if tracking push fails?
The error is logged and ShipWave will retry on the next cron run. Check the order for the specific error message.
Can I update tracking after pushing?
If you need to change the tracking number, update it in ShipWave and sync again. The marketplace will be updated.
Do customers get notified?
Yes. When tracking is pushed, the marketplace sends its standard shipping notification email to the customer.
What if I already added tracking on the marketplace?
ShipWave checks if tracking already exists. If so, it may skip the push or update with the new info, depending on the platform.

More in ShipWave Channels

Back to Help Center