Order Download
ShipStation API
https://www.shipstation.com/docs/api/orders/list-orders/
Description
The order download retrieves orders from ShipStation.
Parameters
Order Status
The fulfilment status of orders to be retrieved:
-
awaiting_payment
-
awaiting_shipment
-
pending_fulfillment
-
shipped
- This is the default status used.
-
on_hold
-
cancelled
-
rejected_fulfillment
Timespan
When working in the designer this specifies which range of orders to download.
This parameter is ignored when an integration is scheduled and instead the order create date/time is used (see below).
Running from a Schedule
IMan maintains a lookup table to keep track of the last date/time an order download is performed. Each time the order download is run, the records in this table are updated. A record is maintained for each ShipStation Reader which downloads orders.
The reason a date/time is used is due to ShipStation's lack of ability to mark orders as downloaded/prcoessed i.e. there is no facility to add a download status.
Resetting the Last Date/Time
From time-to-time there the ShipStation order download will successfully connect, but there is an error preventing an order or all orders being integrated.
To allow the orders to be re-processed the last run date can be reset to a value in the past, which will download all the orders matching the parameters (per above) modified after that date/time.
It is important that a filter is included in any integration to prevent duplicates (see below).