ParcelPilot
Help

Pull Orders from eCommerce (manual backfill)

Use Pull Orders to manually import orders that may be missing from ParcelPilot.

The action is launched from Integrations -> Client Integrations, but it affects your Orders queue, so this guide now sits in the Orders section.

This is most useful after:

  • a temporary connection issue
  • a queue delay
  • changing credentials or scopes and wanting to re-fetch recent orders

Where to find it

  1. Go to Integrations -> Client Integrations.
  2. Open the ecommerce integration you want.
  3. Click Pull Orders.

What it does

When you run Pull Orders, ParcelPilot:

  • asks the platform for orders updated within the time window you choose
  • imports them into ParcelPilot using the normal eCommerce importer
  • updates an existing ParcelPilot order instead of duplicating it when the same external order already exists for that client
  • writes a note on the integration record showing what happened

It does not delete orders.

Settings

Pull orders updated in last (days)

  • Default: 30
  • Range: 1 to 365

This is the lookback window used when requesting orders from the platform.

Guidance:

  • If you are missing orders from last night, try 7 or 30
  • If you are not sure when the issue started, try 90 or 365

Some platforms only return orders they consider recently updated, so very old unchanged orders may not come back on a short window.

Max orders to import

  • Default: 50
  • Range: 1 to 500

This is a safety limit to stop one click importing too many orders at once.

Guidance:

  • Keep it low if you only expect a few missing orders
  • Increase it if you are backfilling a busy store, then repeat as needed

Supported platforms

The Pull Orders action is available for these eCommerce integrations:

  • Shopify
  • WooCommerce
  • Magento
  • BigCommerce

Access

The action is available to users who can access Integrations -> Client Integrations.

If you cannot see it, your account likely does not have permission for integration management.

Troubleshooting

If Pull Orders imports or updates 0 orders:

  • increase the number of days
  • increase the max orders limit
  • confirm the missing orders exist in the platform
  • confirm they were updated recently enough for the platform to return them
  • confirm you are using the correct integration if the client has more than one store

If you still cannot pull the missing orders, note which integration you used, the rough missing date range, and one example order number from the ecommerce platform for investigation.

Related guides