Use this API to find orders in the Dsco Platform and return a single page of the results.
The Find Orders API documents the API's URL, it's arguments/return values and how to interact with it (GET, POST, PUT, etc.) in the Dsco Interactive Playground.
The Find Orders API documents the search params that may be passed in. When searching, you must provide either poNumber or exactly one of the period-based filters (itemsCreatedInLast, itemsUpdatedInLast, itemsCreatedSince, itemsUpdatedSince). When searching with a period-based param you may also specify one or more statuses to further refine the search. Below you will find additional detail on the input params.
Use this param to specify which page of results is desired. Initially, call this API with the pageNumber set to 1. The response will include the total number of pages of results as the pageCount field, allowing the developer to make additional calls to this API to retrieve all pages of results. Please note that every call to this API returns the pageCount field in the returned object and the developer should verify that the pageCount does not change as he iterates through the pages. The pageCount would only change if the number of items is changing in the Dropship database as a result of an integration or process importing new items. If the pageCount does change the developer should do one of the following...
- Enter an error condition and schedule the process to execute again at some point in the future
- Wait a period of time, perhaps 30 minutes, and execute the process again without creating an error condition.
Find the Order with the this poNumber.
Find Orders created within the last xyz seconds. The maximum value allowed is one year ago (31536000).
Find Orders updated within the last xyz seconds. The maximum value allowed is one year ago (31536000).
Find Orders created since this ISO 8601 date (e.g. 2014-01-01T10:30:00+01:00). The maximum value allowed is one year in the past.
Find Orders updated since this ISO 8601 date (e.g. 2014-01-01T10:30:00+01:00). The maximum value allowed is one year in the past.
The result of calling this API is the PagedOrderResult JSON Object. It will contain the list of orders returned from this API for the specified page of results if any.