ShipEngine provides a convenience method to automatically create a shipment directly from a sales order. The model uses a standard shipment format with specific constraints: ship_to and ship_date are not accepted in the shipment object.
POST /v-beta/shipments/sales_order/:sales_order_id
POST /v-beta/shipments/sales_order/a401efda-0d0b-59ce-a47c-392c44890189 HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json{
"carrier_id": "se-2565",
"service_code": "usps_priority_mail",
"warehouse_id": "se-1951",
"advanced_options": {
"non_machinable": true
},
"packages": [
{
"weight": {
"value": 8.0,
"unit": "ounce"
}
}
]
}The response includes comprehensive shipment details such as:
- Sales order IDs and items
- Shipment ID and carrier information
- Ship-to and ship-from addresses
- Package details and weight
- Shipment status and timestamps
The response contains fields like shipment_id, carrier_id, service_code, complete address information for both sender and recipient, package specifications, and total weight.
- Automatically creates shipment from existing sales order data
- Simplifies the shipping process by leveraging order information
- Supports standard shipment options and carrier services
- Returns complete shipment details for tracking and management