Quantities: ship fewer than ordered, sell-outs, restocks

10 October 2026 ordersproductswebhooks

Buyers can now order several pieces of one product (company listings, up to the stock). What that changes for integrations:

Orders#

Short shipment on accept. POST /v1/orders/{id}/accept takes items: [{id, quantity}] when you have fewer pieces than were ordered. The courier is booked for those; only once it returned an AWB is the line reduced and the buyer refunded the missing pieces' product price. A failed booking changes nothing.
Order lines carry quantity (ships), quantity_ordered and quantity_short.
refunded on every order and refunds on GET /v1/orders/{id}: what went back to the buyer and why (short_shipped, buyer_returned, …). total stays what was paid.
Packing: a line's pieces can be split across boxes — never more boxes than pieces (it used to be "never more boxes than lines").

order.created is sent once the order's lines exist and now includes items. It used to arrive a moment before them, so a fast GET could find no items.
New order.items_changed after a short shipment, with every line and the refund.
A sell-out sends product.sold. When Biklo orders take the last pieces you get product.stock_changed (to 0) then product.sold — it used to say product.archived.

Restocking relists. A listing Biklo orders sold out comes back on sale when you send stock above 0 (PATCH /v1/products/{id}/stock or a full update). No unarchive needed.
unarchive answers product_reserved (409) only for a listing with no stock left while an order for it is in progress — never for a listing that still has stock.