Receive purchase order products
Changed onRecord receipt of products from a purchase order. This updates inventory levels and may automatically change purchase order status.
Request
- Base URLhttps://api.shipstation.com
- URLhttps://api.shipstation.com/v2/purchase_orders/{purchase_order_id}/receives
- AuthAPI key in header api-key
Request body
Example request
{
"product_receives": [
{
"sku": "WIDGET-001",
"inventory_location_id": "se-12345",
"received_quantity": 95,
"rejected_quantity": 5,
"lot": "LOT-2025-001",
"expiration_date": "2026-01-01T00:00:00Z"
}
]
}Response
Products received successfully
Example response
{
"purchase_order_id": "se-234",
"status": "receiving"
}Changes
- warning
added the new
bring_your_own_label_not_supportedenum value to the//response property for the response status - warning
added the new
bring_your_own_label_not_supportedenum value to the//response property for the response status - warning
added the new
multiple_sales_ordersenum value to the//response property for the response status - warning
added the new
multiple_sales_ordersenum value to the//response property for the response status - warning
added the new
sales_order_link_requiredenum value to the//response property for the response status - warning
added the new
sales_order_link_requiredenum value to the//response property for the response status
- warning
- breaking
the
/response's property type changed from no type toobjectfor status - breaking
the
/response's property type changed from no type toobjectfor status - info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
removed from the
/response propertyallOflist for the response status - info
removed from the
/response propertyallOflist for the response status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status
- breaking