Cancel Shipment
Changed onCancel a Shipment using the shipiumShipmentId or the partnerShipmentId.
Request
- 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 shipiumShipmentId or partnerShipmentId (if one was provided).
Query parameters
The date that this shipment was cancelled. Defaults to now.
Response
Updating of Shipment successful.
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 - 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 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 - 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