Create shipment orders
This endpoint allows users to create a new shipment order with parcel and account details.
curl --request POST \
--url https://api-stage.orchestro.ai/e1/shipment-orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: <content-type>' \
--data '{
"callerType": "SHIPPER",
"accounts": [
{
"accountNumber": "TEST_ACCOUNT_1",
"accountType": "SHIPPER"
}
],
"parcels": [
{
"shipmentDate": "2023-12-22T06:34:00",
"serviceType": "GRD",
"parcelType": "P",
"shipFrom": {
"company": "Dallas City Hall",
"name": "The City Secretary'\''s Office",
"address1": "1500 Marilla Street",
"address2": "",
"city": "Dallas",
"state": "TX",
"zip": "75201",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"shipTo": {
"company": "Dallas City Hall",
"name": "The City Secretary'\''s Office",
"address1": "1500 Marilla Street",
"address2": "",
"city": "Dallas",
"state": "TX",
"zip": "75201",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"serviceAttributes": [
{
"code": "AD_SIGN",
"description": "Adult Signature Required",
"rate": 3.98
}
],
"surcharges": [
{
"code": "FUEL",
"description": "Fuel Surcharge",
"rate": 5.98
}
],
"weight": {
"value": 6,
"unit": "lb"
},
"dimensions": {
"unit": "inch",
"length": 12,
"width": 12,
"height": 4
},
"rates": [
{
"zone": 7,
"serviceType": "GRD",
"tnt": 7,
"baseRate": 3.92,
"totalRate": 24.47
}
]
}
]
}'
{
"message": "SUCCESS"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
Type of caller initiating the shipment
SHIPPER
, CARRIER
, RSE
Array containing details for each parcel in the shipment. Maximum of 10 parcels allowed.
Type of service used for the shipment, e.g., ground or express.
Address details for either the shipper or recipient.
Name of the person or department receiving the parcel.
Primary address line.
City name.
Two-letter state code.
Postal or ZIP code.
Country code, following the ISO 3166-1 alpha-2 standard.
Company name associated with the shipment address.
Secondary address line, if applicable.
Contact phone number.
Email address for notifications.
Address type, either Business (B) or Residential (R).
Address details for either the shipper or recipient.
Name of the person or department receiving the parcel.
Primary address line.
City name.
Two-letter state code.
Postal or ZIP code.
Country code, following the ISO 3166-1 alpha-2 standard.
Company name associated with the shipment address.
Secondary address line, if applicable.
Contact phone number.
Email address for notifications.
Address type, either Business (B) or Residential (R).
Array of rate information, including base rate and total rate for the parcel.
Shipping zone.
Service type, such as ground shipping.
Time to transit.
Base rate for the service.
Total rate including all charges.
Date and time of the shipment.
Parcel type, reserved for future use.
List of additional service attributes for the parcel, such as delivery instructions.
Response
curl --request POST \
--url https://api-stage.orchestro.ai/e1/shipment-orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: <content-type>' \
--data '{
"callerType": "SHIPPER",
"accounts": [
{
"accountNumber": "TEST_ACCOUNT_1",
"accountType": "SHIPPER"
}
],
"parcels": [
{
"shipmentDate": "2023-12-22T06:34:00",
"serviceType": "GRD",
"parcelType": "P",
"shipFrom": {
"company": "Dallas City Hall",
"name": "The City Secretary'\''s Office",
"address1": "1500 Marilla Street",
"address2": "",
"city": "Dallas",
"state": "TX",
"zip": "75201",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"shipTo": {
"company": "Dallas City Hall",
"name": "The City Secretary'\''s Office",
"address1": "1500 Marilla Street",
"address2": "",
"city": "Dallas",
"state": "TX",
"zip": "75201",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"serviceAttributes": [
{
"code": "AD_SIGN",
"description": "Adult Signature Required",
"rate": 3.98
}
],
"surcharges": [
{
"code": "FUEL",
"description": "Fuel Surcharge",
"rate": 5.98
}
],
"weight": {
"value": 6,
"unit": "lb"
},
"dimensions": {
"unit": "inch",
"length": 12,
"width": 12,
"height": 4
},
"rates": [
{
"zone": 7,
"serviceType": "GRD",
"tnt": 7,
"baseRate": 3.92,
"totalRate": 24.47
}
]
}
]
}'
{
"message": "SUCCESS"
}