Swagger Petstore - OpenAPI 3.0
PATCH/api/orders/{id}/lines/{lineId}/pack

Record the packed quantity for an order line

Records the packed quantity for one order line and updates the order's packing state. A shortfall marks the line as short and opens a back-order; packing the remaining quantity later cancels it. You can pack more than ordered, but you cannot pack lines on a draft order.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 1 body field
idstringrequired
The unique identifier of the order containing the line to pack.
lineIdstringrequired
The unique identifier of the order line to pack.

The packed quantity for the order line.

qtyPackednumberrequired
The quantity packed for this line. Must be zero or greater.

6 status codes
200Returns the reloaded order, including its updated line packing quantity and status.
idstringoptional
Order id.
orderNumberstringoptional
Human-facing, `ORD-YYMM-NNN`.
customerIdstringoptional
Customer id.
customerNamestringoptional
customerTypeSnapshotstringoptional
The customer's type AT ORDER TIME — it may change later, and the order keeps what it was sold under.
orderDatestringoptional
The day the order was taken.
requestedDeliveryDatestringoptional
The day it ships — what production and packing group by (D-14).
statusstringoptional
Allowed:draftconfirmedin_productionpackingshippingshippedclosed
sourcestringoptional
Allowed:phonewalk_inemail_importself_service
specialInstructionsstringoptional
Order-level note.
createdByIdstringoptional
createdByNamestringoptional
createdAtstringoptional
fromRecurringIdstringoptional
The standing order that generated this one (R6). Null for every hand-taken order. Note the `source` does NOT distinguish one: a generated order says `phone`, because the OrderSource enum was deliberately left untouched.
linesarray<object>optional
400Returned when the input is invalid; the response includes an `error` string describing the problem.
errorstringrequired
401Returned when the request is unauthenticated; sign in before calling this operation.
errorstringrequired
403Returned when the authenticated user lacks the required department membership or role.
errorstringrequired
404Returned when a requested resource is not found.
errorstringrequired
500Returned when an unexpected server error occurs.
errorstringrequired

Error handling

A 400 is returned for invalid input; a 401 when the request is unauthenticated; a 403 when the authenticated user lacks the required department membership or role; a 404 when a requested resource is not found; and a 500 for an unexpected server error. The id path parameter must identify an order, and the lineId path parameter must identify a line on that order. qtyPacked is required and must be zero or greater.