Orders
Orders represent a "group" of printable products that should be printed and shipped to a given shipping address. RPI Print API has the following limitations right now:
- a single order can only be shipped to one destination
Before an order is created the following optional steps are available:
- available shipping methods for provided order data (shipping address, SKU) can be obtained
- production pricing can be obtained (production costs, shipping costs and taxes). This represents amount that will be charged to RPI Print API Customer.
When an order is created:
its data is validated (checks of the type "can we print and ship this order to this destination" etc.)
basic validation is performed (e.g., is the chosen shipping classification among the available shipping options)
order is submitted and enters the Holding bin The Holding Bin is a sort of "waiting state" for orders - at this point the order has not been sent to a printer yet, and it is simple to cancel it, which is why orders in the Holding Bin can be cancelled by the client directly (via the API). Once an order has left the Holding Bin cancellation might have to be performed by RPI Print API support (depending on how far along the print workflow the order was processed). The most common use-case is as a cancellation window in case the end customer decides to cancel their order with you.
Limits and Quotas
There is a limit of 50 orders created within 24 hours. This limit does not apply to "special" orders like Reprints. If this limit is exceeded, orders will still be accepted, but they will enter a Queue and will have to wait for the next 24h period to exit it. The maximum number of orders in this queue is 350. After this Queue is full further orders will be Rejected.
For example, if 420 orders were to be created within 24 hours:
- 50 of these would be RECEIVED and would proceed with processing
- 350 of these would be QUEUED; 50 of these would be dequeued every 24h thereafter
- the last 20 of these would be REJECTED