Pack and ship order.
Changed onRequest
- Base URLhttps://api.shipium.com
- AuthOAuth 2PasswordToken URLhttps://auth.shipium.com/oauth/tokenScopesdelivery-experience-service
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
The Shipium-generated order ID (shipiumOrderId) or the partner-provided order ID (partnerOrderId). When using the partnerOrderId, only orders in a non-cancelled state will match. Orders that have been cancelled will not be found by their partnerOrderId.
Query parameters
Submits order to print label having tenantId passed in.
Request body
Example request
{
"packagingType": {
"packagingMaterial": "box",
"packagingSizeName": "13x12x10 Box",
"packagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
"linearDimensions": {
"linearUnit": "in",
"length": 13,
"width": 12,
"height": 10
},
"packagingWeight": {
"weightUnit": "lb",
"weight": 50
}
},
"totalWeight": {
"weightUnit": "lb",
"weight": 50
},
"inlineReturnsLabel": {
"partnerShipmentId": "myCustomPartnerShipmentId123",
"returnToAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
}
},
"shipmentParameters": {
"partnerShipmentId": "myCustomPartnerShipmentId123",
"shippedDateTime": "2019-10-29T09:12:33.123456Z",
"desiredDeliveryDate": "2019-10-31T20:00:00Z",
"preferredCarrierDeliveryDateTime": "2019-10-31T20:00:00Z",
"businessDaysOfTransit": 3,
"returnToAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"deliverySignatureOption": "ResidentSignature",
"lastMileDeliveryOptions": {
"tip": {
"type": "FIXED"
},
"tipForLabelCreate": {
"type": "FIXED"
}
},
"pickupWindow": {
"startWindow": "10:15:30",
"endWindow": "10:15:30"
},
"deliveryWindow": {
"startWindow": "10:15:30",
"endWindow": "10:15:30"
},
"payorAccounts": [
{
"payorAccountAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
}
}
]
},
"splitParameters": {
"orderItemQuantities": [
{
"orderItemReferenceIdentifier": "someIdentifier",
"productId": "RN03947--Z43121",
"quantity": 3
}
]
}
}Response
The results of the order submission.
Example response
{
"shipiumShipmentId": "0840c7a2-e6ab-4755-8aa2-9a986297ad6d",
"partnerShipmentId": "myCustomPartnerShipmentId123",
"shipiumBulkProcessingIds": [
"2364c106-ae48-4680-b044-dc1eb20c310a"
],
"orderIds": [
{
"shipiumOrderId": "4dc43fff-c3af-4d7b-8a18-e01f2b4cb312",
"partnerOrderId": "myCustomPartnerOrderId123"
}
],
"orderedDateTime": "2019-10-29T09:12:33.123456Z",
"shippedDateTime": "2019-10-29T09:12:33.123456Z",
"rawDesiredDeliveryDate": "2019-10-31T10:50:11.123456Z",
"preferredCarrierDeliveryDateTime": "2019-10-31T20:00:00Z",
"returnsLabel": {
"internationalDocuments": [
{
"documentType": "commercial_invoice",
"documentImage": {
"documentEncoding": "base64"
},
"electronicallySubmitted": true
}
],
"hazardousMaterialsDocuments": [
{
"documentType": "OP_900LG",
"documentImage": {
"documentEncoding": "base64"
},
"electronicallySubmitted": true
}
]
},
"customerForwardLabels": [
{
"partnerShipmentId": "myCustomPartnerShipmentId123",
"internationalDocuments": [
{
"documentType": "commercial_invoice",
"documentImage": {
"documentEncoding": "base64"
},
"electronicallySubmitted": true
}
],
"hazardousMaterialsDocuments": [
{
"documentType": "OP_900LG",
"documentImage": {
"documentEncoding": "base64"
},
"electronicallySubmitted": true
}
]
}
],
"deliveredDateTime": "2019-10-31T10:50:11.123456Z",
"cancellationDateTime": "2019-10-31T10:50:11.123456Z",
"carrierName": "UPS",
"carrierTrackingId": "1Z999AA10123456784",
"packages": [
{
"orderItemQuantities": [
{
"orderItemReferenceIdentifier": "someIdentifier",
"shipiumOrderId": "4dc43fff-c3af-4d7b-8a18-e01f2b4cb312",
"partnerOrderId": "myCustomPartnerOrderId123",
"hazmatInfo": {
"category": "defined",
"quantity": 2.1,
"quantityType": "gross",
"quantityUnits": "l",
"containerType": "aluminum_jerrican",
"hazmatId": "UN1755",
"properShippingName": "Chromic Acid Solution",
"packingGroup": "II",
"transportMode": "passenger_and_cargo_aircraft",
"packingInstructionCode": "967",
"hazardClass": "class_8_corrosive_material",
"subsidiaryClasses": [
"8.1"
],
"numberOfInnerPackagings": 2,
"innerPackagingType": "glass bottle",
"outerPackagingType": "fiberboard box",
"shipperDeclarationStatement": "LQ_air",
"wattHours": 100,
"lithiumContent": 1.5,
"numberOfCells": 4,
"numberOfBatteries": 2,
"batteryConfiguration": "packed_with_equipment"
},
"deliveryEstimateId": "0b3d140a-525b-43a7-896c-cdc381580d61",
"productId": "RN03947--Z43121",
"quantity": 3,
"itemWeight": {
"weightUnit": "lb",
"weight": 50
}
}
],
"packagingType": {
"packagingMaterial": "box",
"packagingSizeName": "13x12x10 Box",
"shipiumPackagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
"partnerPackagingTypeId": "rno-packaging-1",
"requestPackagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
"linearDimensions": {
"linearUnit": "in",
"length": 13,
"width": 12,
"height": 10
},
"packagingWeight": {
"weightUnit": "lb",
"weight": 50
}
},
"totalWeight": {
"weightUnit": "lb",
"weight": 50
},
"deliveredDateTime": "2019-10-31T10:50:11.123456Z"
}
],
"orderItemQuantities": [
{
"orderItemReferenceIdentifier": "someIdentifier",
"shipiumOrderId": "4dc43fff-c3af-4d7b-8a18-e01f2b4cb312",
"partnerOrderId": "myCustomPartnerOrderId123",
"hazmatInfo": {
"category": "defined",
"quantity": 2.1,
"quantityType": "gross",
"quantityUnits": "l",
"containerType": "aluminum_jerrican",
"hazmatId": "UN1755",
"properShippingName": "Chromic Acid Solution",
"packingGroup": "II",
"transportMode": "passenger_and_cargo_aircraft",
"packingInstructionCode": "967",
"hazardClass": "class_8_corrosive_material",
"subsidiaryClasses": [
"8.1"
],
"numberOfInnerPackagings": 2,
"innerPackagingType": "glass bottle",
"outerPackagingType": "fiberboard box",
"shipperDeclarationStatement": "LQ_air",
"wattHours": 100,
"lithiumContent": 1.5,
"numberOfCells": 4,
"numberOfBatteries": 2,
"batteryConfiguration": "packed_with_equipment"
},
"deliveryEstimateId": "0b3d140a-525b-43a7-896c-cdc381580d61",
"productId": "RN03947--Z43121",
"quantity": 3,
"itemWeight": {
"weightUnit": "lb",
"weight": 50
}
}
],
"destinationAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"shipOption": "Standard",
"shipFromAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"returnToAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"injectionAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"fulfillmentCenterId": "74065136-85c2-499b-b893-bd812ac0c00f",
"packagingType": {
"packagingMaterial": "box",
"packagingSizeName": "13x12x10 Box",
"shipiumPackagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
"partnerPackagingTypeId": "rno-packaging-1",
"requestPackagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
"linearDimensions": {
"linearUnit": "in",
"length": 13,
"width": 12,
"height": 10
},
"packagingWeight": {
"weightUnit": "lb",
"weight": 50
}
},
"totalWeight": {
"weightUnit": "lb",
"weight": 50
},
"carrierSelection": {
"operationalCost": 2.7,
"calculatedBillableWeight": {
"weightUnit": "lb",
"weight": 50
},
"calculatedBillableCubicVolume": {
"cubicVolumeUnit": "ft",
"cubicVolume": 0.8
},
"laneMatch": {
"laneId": "asdqwdq-qwd123ds-123asdwd-123asd",
"partnerLaneId": "custom partner provided id"
},
"evaluatedServiceMethods": [
{
"injectionDetails": {
"injectionCostDetails": {
"injectionLineItemRate": 2.3,
"injectionLineItemCurrencyCode": "usd"
}
},
"rateCurrency": "usd",
"lineItems": [
{
"name": "base",
"rate": 2.3,
"carrierSurchargeId": "123451239874980",
"surchargeType": "extended_delivery_residential_ground",
"lineItemType": "surcharge"
}
],
"estimatedDeliveryDateLocal": "2007-12-03T10:15:30"
}
],
"cancellationDateTime": "2024-10-31T10:50:11.123456Z",
"currencyCode": "USD"
},
"carrierLabel": {
"cancellationDateTime": "2024-10-31T10:50:11.123456Z",
"manifestDateTime": "2024-10-30T10:50:11.123456Z",
"billableWeight": {
"weightUnit": "lb",
"weight": 50
},
"billableCubicVolume": {
"cubicVolumeUnit": "ft",
"cubicVolume": 0.8
},
"internationalDocuments": [
{
"documentType": "commercial_invoice",
"documentImage": {
"documentEncoding": "base64"
},
"electronicallySubmitted": true
}
],
"hazardousMaterialsDocuments": [
{
"documentType": "OP_900LG",
"documentImage": {
"documentEncoding": "base64"
},
"electronicallySubmitted": true
}
],
"laneMatch": {
"laneId": "asdqwdq-qwd123ds-123asdwd-123asd",
"partnerLaneId": "custom partner provided id"
},
"trackingInfo": {
"shippedDateTime": "2019-10-28T14:34:55.123456Z",
"deliveredDateTime": "2019-10-28T14:34:55.123456Z",
"currentStatus": {
"eventDateTime": "2019-10-28T14:34:55.123456Z"
},
"events": [
{
"eventDateTime": "2019-10-28T14:34:55.123456Z"
}
]
}
},
"customsInfo": {
"totalCustomsValue": 12.34,
"totalCustomsValueCurrency": "usd",
"customsDescription": "9 mm steel screws",
"reasonForExport": "sale",
"businessIndicator": "B2C",
"invoiceDate": "1970-01-01",
"invoiceNumber": "abcde-f12345-67890-abcdef",
"europeanUnionInfo": {
"vendorIossAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
}
},
"exportReturnInfo": {
"originalExportDate": "2026-08-19",
"originalExportTrackingId": "2647515076",
"originalOutboundCarrier": "DHL EXPRESS"
},
"ultimateConsigneeAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"ultimateConsigneeType": "direct_consumer",
"permitNumber": "12345",
"customsItems": [
{
"customsValue": 12.34,
"customsValueCurrency": "usd",
"commodityDescription": "baby socks",
"countryOfManufacture": "CN",
"customsWeight": {
"weightUnit": "lb",
"weight": 50
},
"quantity": 3,
"productId": "RN03947--Z43121",
"standardizedProductIds": [
{
"type": "GTIN",
"value": "0012345678905"
}
],
"manufacturerProductId": "MPN-77B-XL",
"harmonizedTariffNumber": "6402918005",
"importHarmonizedTariffNumber": "6402918005",
"electronicExportCommodityInformation": {
"exportType": "domestic",
"exportInformationCode": "LC",
"scheduleBInformation": {
"scheduleBNumber": "6404195500"
},
"eccnNumber": "EAR99",
"exportLicenseInformation": {
"licenseType": "C33",
"licenseExemptionCode": "NLR"
}
},
"cpscCertificateOfCompliance": {
"manufacturerAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"testingLabAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
}
}
}
],
"incoterm": "DDP",
"taxIdentificationNumber": "12345",
"importerOfRecord": {
"importerAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"taxIdentificationNumbers": [
{
"number": "12345"
}
]
},
"brokers": [
{
"brokerAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"taxIdentificationNumbers": [
{
"number": "12345"
}
]
}
],
"soldTo": {
"address": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
},
"taxIdentificationNumbers": [
{
"number": "12345"
}
]
}
},
"deliverySignatureOption": "ResidentSignature",
"lastMileDeliveryOptions": {
"tip": {
"type": "FIXED"
},
"tipForLabelCreate": {
"type": "FIXED"
}
},
"deliveryWindow": {
"startWindow": "10:15:30",
"endWindow": "10:15:30"
},
"pickupWindow": {
"startWindow": "10:15:30",
"endWindow": "10:15:30"
},
"emergencyResponseInfo": {
"phoneNumber": "18005551234",
"contactName": "CHEMTREC",
"contractNumber": "CCN123456"
},
"shipmentRequestedDocuments": [
{
"documentImage": {
"documentEncoding": "base64"
}
}
],
"payorAccounts": [
{
"payorAccountAddress": {
"name": "Wile E. Coyote",
"phoneNumberCountryCode": "+2",
"company": "ACME",
"street1": "123 Main St.",
"street2": "Suite 42",
"city": "Albuquerque",
"state": "NM",
"countryCode": "US",
"postalCode": "\"87121\"",
"addressType": "commercial",
"addressLineComponents": {
"streetName": "U.H. Fovisste Fuentes Brotantes",
"primaryAddressNumber": "12",
"secondaryAddressNumber": "302",
"district": "Iztacalco",
"neighborhood": "Agrícola Pantitlán"
}
}
}
],
"desiredDeliveryDateLocal": "2007-12-03T10:15:30",
"estimatedDeliveryDateLocal": "2007-12-03T10:15:30"
}Changes
- warning
deleted the
headerrequest parameterX-DELEGATED-PARTNER-ID - warning
added the new
galenum value to the///response property for the response status - warning
added the new
galenum value to the///response property for the response status - warning
added the new
galenum value to the/////response property for the response status - warning
added the new
galenum value to the/////response property for the response status - info
added the new optional request property
/ - 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
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
- warning