Shipment Error Codes

When creating or updating a shipment, errors may occur. Below is a comprehensive list of error codes, their severity levels, and detailed descriptions to help troubleshoot issues.

Error Code Level Description
address_free_form_not_subscribed ERROR Your account is not subscribed to use free-form addresses. Please reprocess the booking with a predefined location.
carrier_account_invalid ERROR The Carrier Account provided does not exist. Please use a valid carrier account and reprocess the booking.
coordinates_invalid ERROR The provided coordinates are incorrect. Please provide valid latitude and longitude and reprocess the booking.
coordinates_latitude_invalid ERROR The provided latitude is invalid. Valid range is [-90, 90]. Please correct it and reprocess the booking.
coordinates_longitude_invalid ERROR The provided longitude is invalid. Valid range is [-180, 180]. Please correct it and reprocess the booking.
country_invalid ERROR The Country Code provided is invalid. Please use a valid 2-letter ISO 3166 country code and reprocess the booking.
custom_attribute_invalid ERROR The custom attribute provided does not exist. Please use a valid custom attribute and reprocess the booking.
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 the custom attribute. Please use a valid value and reprocess the booking.
custom_attribute_value_max_length_exceeded ERROR Custom attribute value exceeds the 100-character limit. Please shorten the value and reprocess the booking.
default_merchant_not_configured ERROR No default Merchant is configured for the tenant. Please provide a valid Merchant and reprocess the booking.
dimension_unit_invalid ERROR The Dimension unit provided is invalid. Allowed values: PDF, PNG, ZPL. Please reprocess the booking with a valid unit.
email_invalid ERROR The Contact Email provided is invalid. Please provide a valid email address and reprocess the booking.
email_missing WARNING Contact Email is missing.
item_hscode_missing WARNING The Item HS Code may be required for cross-border shipments.
item_origin_country_missing WARNING The Item Origin Country may be required for cross-border shipments.
item_weight_missing WARNING The Item Weight may be required for cross-border shipments.
label_format_invalid ERROR The requested Label format is invalid. Please use a valid format and reprocess the booking.
merchant_missing ERROR The Merchant provided was not found. Please provide a valid Merchant and reprocess the booking.
no_carrier_assigned ERROR No Carrier Account was assigned to the shipment. Please assign a valid carrier account and reprocess the booking.
parcel_dimensions_missing WARNING Parcel Dimensions may be required by the carrier.
parcel_info_missing WARNING Parcel info may be required by the carrier. Please provide at least one valid parcel.
parcel_item_invalid ERROR Parcel Items contain invalid data. Please provide valid parcel info and reprocess the booking.
parcel_weight_missing WARNING Parcel Weight may be required by the carrier. Please provide the missing weight.
partner_location_invalid ERROR The provided location does not exist. Please use a valid location and reprocess the booking.
partner_location_not_active WARNING The provided location '%s' is not active. Please use a valid and active location and reprocess the booking.
payment_currency_invalid ERROR The Payment currency provided is invalid. Please use a valid ISO 4217 currency code and reprocess the booking.
payment_method_invalid ERROR The Payment method provided is invalid. Allowed values: PREPAID or CASHON_DELIVERY. Please reprocess the booking with a valid method.
payment_pending_amount_invalid_for_cod ERROR The pending amount for CASHONDELIVERY is invalid. Please provide a pending amount greater than zero and reprocess the booking.
payment_pending_amount_invalid_for_prepaid ERROR The pending amount for PRE_PAID is invalid. Please set it to zero or remove it and reprocess the booking.
phone_number_invalid ERROR The Phone number provided is invalid. Please use a valid phone number and reprocess the booking.
phone_number_unknown WARNING The Phone number provided may not be valid.
postcode_missing WARNING The Postcode is missing.
required_data_invalid ERROR Required data is invalid. Please provide valid data and reprocess the booking.
required_data_missing ERROR Required data is missing. Please provide the missing data and reprocess the booking.
shipment_source_type_invalid WARNING The Shipment source type provided is invalid. Please use an allowed value.
time_slot_invalid WARNING The TimeSlot provided does not exist. Please provide a valid time slot and reprocess the booking.
weight_unit_invalid ERROR The Weight unit provided is invalid. Allowed values: KG. Please reprocess the booking with a valid unit.