Skip to content
Developersskuflo.iov1Changelog

Orders, filterable by scan state and retailer

GET/v1/ordersFactory API keyBase URL api.skuflo.io

Filter values: not_scanned, made (produced but not yet in stock), in_stock, dispatched, stuck (sitting produced/in stock past the factory's stuck_after_days, or partially dispatched), or all (default). q matches order number.

Try it now

Query parameters#

NameTypeDescription
retailer_idoptionalstring·
filteroptionalstring·
One of "all", "not_scanned", "made", "in_stock", "dispatched", "stuck", "review", "rejected"
Default "all"
qoptionalstring·
limitoptionalinteger·
Default 100
offsetoptionalinteger·
Default 0
sortoptionalstringColumn to sort by (newest first when left out)
One of "created_at", "order_no", "po_number", "retailer", "production_date", "needed_by", "status", "pieces", "units", "last_scan_at", "first_scan_at", "produced_at", "in_stock_at", "dispatched_at", "processed_at", "labels_printed"
diroptionalstring·
One of "asc", "desc"
Default "desc"

Responses#

StatusMeaning
200Success. An example body is in the column on the right.

Response fields

NameTypeDescription
ordersobject[]·
idstring·
order_nostring·
po_numberstring, nullablethe retailer's purchase order number, when they gave one
statusstringpending_review is an order a retailer sent that you have not accepted yet: it is not on the production list. rejected was turned down (see rejection_reason).
One of "pending_review", "rejected", "awaiting_production", "in_production", "produced", "in_stock", "partially_dispatched", "dispatched", "cancelled"
processed_atstring (date-time), nullablewhen the factory marked the order as processed (sent into production)
rejection_reasonstring, nullable·
production_datestring (date), nullable·
needed_bystring (date), nullable·
sourcestring·
One of "upload", "api", "portal", "manual"
created_atstring (date-time)·
produced_atstring (date-time), nullable·
in_stock_atstring (date-time), nullable·
dispatched_atstring (date-time), nullable·
retailer_idstring·
retailer_namestring·
retailer_codestring·
stuckbooleanproduced/in_stock for longer than the factory's stuck_after_days, or partially dispatched
pieces_totalinteger·
pieces_scannedinteger·
pieces_in_stockinteger·
pieces_dispatchedinteger·
piece_statesstring[]·
itemsstringSKU + colour of every line, comma separated
countsobject·
allinteger·
not_scannedinteger·
madeinteger·
in_stockinteger·
dispatchedinteger·
stuckinteger·
reviewinteger·
rejectedinteger·
totalintegerOrders matching the filter, retailer and search, over every page

Other errors#

StatusMeaning
401No key, or the key is not recognised.
429More than 600 requests a minute. Wait retry-after seconds.