Shipment Error Codes

A create or an update action to a shipment can result in an error. You will find the list of error codes and their descriptions below.

Error Code Level Description
address_free_form_not_subscribed ERROR Your account is not subscribed to use free form address. Please reprocess the booking with a predefined location.
carrier_account_invalid ERROR The Carrier Account provided for the shipment does not exist. Please use a valid carrier account and reprocess booking again.
coordinates_invalid ERROR The Coordinates provided does not contain the correct latitude and longitude. Please provide valid Coordinates and reprocess booking again.
coordinates_latitude_invalid ERROR The Latitude provided in the coordinates is invalid. Please use a valid range [-90 to 90] and reprocess booking again.
coordinates_longitude_invalid ERROR The Longitude provided in the coordinates is invalid. Please use a valid range [-180 to 180] and reprocess booking again.
country_invalid ERROR The Country Code provided is invalid. Please use a valid 2 letter ISO 3166 country code and reprocess booking again.
custom_attribute_invalid ERROR The Custom Attribute provided does not exist. Please use a valid custom attribute and reprocess booking again.
custom_attribute_not_subscribed ERROR Your account is not subscribed to use custom attributes. Please reprocess the booking without custom attributes.
custom_attribute_value_invalid ERROR Invalid value provided for custom attribute. Please use a valid custom attribute value and reprocess booking again.
custom_attribute_value_max_length_exceeded ERROR The Value of free text customer attribute should be under 100 characters. Please use a valid custom attribute value and reprocess booking again.
default_merchant_not_configured ERROR No default Merchant is configured for the tenant. Please provide a valid Merchant and reprocess booking again.
dimension_unit_invalid ERROR The Dimension unit provided is invalid. Please use one of the allowed values: PDF PNG or ZPL and reprocess booking again.
email_invalid ERROR The Contact Email provided is invalid. Please provide a valid contact email and reprocess booking again.
email_missing WARNING Contact Email is missing.
item_hscode_missing WARNING The Item HS Code may be required to complete the booking for cross border shipments.
item_origin_country_missing WARNING The Item Origin Country may be required to complete booking for cross border shipments.
item_weight_missing WARNING The Item Weight may be required to complete booking for cross border shipments.
label_format_invalid ERROR The requested Label format is invalid. Please use a valid label format and reprocess booking again.
merchant_missing ERROR The Merchant provided is not found. Please provide a valid merchant and reprocess booking again.
no_carrier_assigned ERROR No Carrier Account was assigned to the shipment. Please assign a valid carrier account and reprocess booking again.
parcel_dimensions_missing WARNING The Parcel Dimensions may be required by the carrier.
parcel_info_missing WARNING The Parcel info may be required by the carrier. Please provide at least one valid Parcel.
parcel_item_invalid ERROR Parcel Items contains invalid data. Please use valid parcel info and reprocess booking again.
parcel_weight_missing WARNING Parcel Weight may be required by the carrier. Please provide missing Weight.
partner_location_invalid ERROR The Location provided does not exist. Please use valid location and reprocess booking again.
partner_location_not_active WARNING The Location provided '%s' is not active. Please use valid location and reprocess booking again.
payment_currency_invalid ERROR The Payment currency provided is invalid. Please use a valid ISO 4217 currency code.
payment_method_invalid ERROR The Payment method provided is invalid. Please use one of the allowed values: PREPAID or CASHON_DELIVERY and reprocess booking again.
payment_pending_amount_invalid_for_cod ERROR The pending amount provided is invalid for CASHONDELIVERY. Please provide a pending amount greater than zero and reprocess booking again.
payment_pending_amount_invalid_for_prepaid ERROR The pending amount provided is invalid for PRE_PAID. Please remove pending amount or set it to zero and reprocess booking again.
phone_number_invalid ERROR The Phone number provided is invalid. Please use valid phone number and reprocess booking again.
phone_number_unknown WARNING The Phone Number provided may not be a valid number.
postcode_missing WARNING The Postcode is missing.
required_data_invalid ERROR Required data is invalid. Please provide valid data and reprocess booking again.
required_data_missing ERROR Required data is missing. Please provide missing data and reprocess booking again.
shipment_source_type_invalid WARNING The Shipment source type provided is invalid. Please use one of the allowed values.
time_slot_invalid WARNING The TimeSlot provided does not exist. Please use valid timeslot and reprocess booking again.
weight_unit_invalid ERROR The Weight unit provided is invalid. Please use one of the allowed values: KG, and reprocess booking again.