ShipWave Channels

Pushing and syncing listings

How to push listings to marketplaces and keep them in sync.

Pushing a listing

When you push a listing, ShipWave sends the listing data to the marketplace API. Here's what happens:
  1. Build payload: Combine Shopify data, template output, and overrides
  2. Apply pricing rules: Calculate the final marketplace price
  3. Apply inventory settings: Calculate available quantity with buffer/floor
  4. Validate: Check against marketplace requirements
  5. Generate hash: Create a unique identifier for this exact payload
  6. API call: Send to marketplace API
  7. Update record: Store external IDs, status, timestamps
  8. Log: Record the operation in sync logs

Manual push

To push a listing manually:
  1. Go to the listing detail page
  2. Click Push to Marketplace
  3. Review the validation results
  4. If valid, confirm the push
  5. Wait for the marketplace to process
You can also push from the listings list by selecting listings and clicking "Push Selected."

Auto-sync

When Auto-sync products is enabled for a channel, ShipWave automatically pushes changes:
  • When you update a product in Shopify
  • When you modify a listing in ShipWave
  • When pricing rules change
Auto-sync runs in the background and doesn't require manual intervention.

Change detection (sync hash)

To avoid unnecessary API calls, ShipWave uses a sync hash:
  • A hash is generated from the listing payload
  • On push, ShipWave compares the new hash to the stored hash
  • If identical, the push is skipped (nothing changed)
  • If different, the push proceeds
This reduces API calls and prevents hitting rate limits.

Syncing updates from marketplaces

To pull the latest data from a marketplace (useful if you made changes directly on the platform):
  1. Go to the listing detail page
  2. Click Pull from Marketplace
This fetches the current marketplace data and updates the listing record. Note: This does NOT overwrite your Shopify data—it only updates the listing's external status and IDs.

Sync frequency

  • Inventory: Real-time via webhooks + every 15 minutes via cron
  • Listing status: Every 15 minutes via cron
  • Product updates: When auto-sync is enabled, changes push within minutes
  • Orders: Every 15 minutes via cron

FAQs

Will pushing overwrite my existing marketplace listing?
Yes. Pushing sends the complete listing data to the marketplace, replacing the current values. Make sure your ShipWave listing is correct before pushing.
What if the marketplace rejects my push?
The listing status changes to "error" and the error message shows exactly why. Fix the issue and push again.
How do I know if a listing is out of sync?
Check the "Last pushed" timestamp on the listing. If it's older than your last Shopify update, the listing may be out of sync. You can also compare the sync hash.
Can I prevent certain fields from syncing?
Use per-listing overrides. Override fields are always sent as-is and don't change based on Shopify updates.

More in ShipWave Channels

Back to Help Center