Possible Error Codes

The following are the possible error codes that can be generated using the Shipping SOAP API:

Table 25. Shipping API Error Codes

Error Category

Specific Error Code

Description

Action

E10000 (Internal Errors)

N/A

These are internal, critical errors that prevent Delivery Manager as a whole from working properly.

Metapack handles these automatically.

E20000 (Validation Errors)

These are usually generated in response to user input, but also cover things such as invalid arguments to URLs and security violations.

Check the input parameters.

E20005 – ERROR_INVALID_CHARACTER

An invalid character has been entered, e.g. entering a "£" into a UK postcode.

E20006 – ERROR_INVALID_POSTCODE_FORMAT

The postcode provided is not in the appropriate format.

The UK postcode structure is a little complicated, but it is specific (BS7666)

E20009 – ERROR_MISSING_ACTION_CODE

The URL provided is not formatted correctly.

E20010 – ERROR_RECORD_DELETED

You are trying to view something that has already been deleted. This can also occur when you attempt to look for a record that never existed.

E20011 – ERROR_ACCESS_DENIED

You do not have the required access rights for the action that you are trying perform.

E20012 – ERROR_UNKNOWN_ACTION_CODE

You have supplied an invalid URL.

E20013 – ERROR_UNKNOWN_ADDRESS_TYPE

Delivery Manager does not support the address type specified (it only supports either “business” or “residential”).

E20014 – ERROR_UNKNOWN_COUNTRY_CODE

The country code specified is not defined in accordance with ISO-3166 (Alpha-2, Alpha-3 and Numeric).

E20018 – ERROR_PAGE_NOT_FOUND

The page for which you are looking cannot be found – check the URL.

E20024 – ERROR_INVALID_XML

The XML file specified is not in a valid format.

E20026 – ERROR_KILLED

The task that you are trying to view has been terminated.

E20030 – ERROR_UNABLE_TO_CREATE_MANIFEST

There was a problem in creating the manifest.

E20045 – ERROR_ALREADY_MANIFESTED

The consignment is already on a manifest.

E20046 – ERROR_INAPPROPRIATE_DELIVERY_CONDITION

A delivery option condition has been applied to something that does not support it.

E20047 – ERROR_INVALID_DELIVERY_CONDITION

The specified delivery condition is not valid.

E20048 – ERROR_INVALID_IMPORT_FILE

The file you are attempting to import is not valid.

E20050 – ERROR_MALFORMED_UPI

The UPI (Unique Parcel Number) cannot be found as it appears to be invalid.

E20053 – ERROR_NUMBER_RANGE_EXCEEDED

There are no more unique numbers available for your account with the carrier.

Contact the carrier to obtain a new set so that the new number range can be added.

E20055 – ERROR_UNKNOWN_SERVICE_ATTRIBUTE

The service attribute specified is not known to Delivery Manager.

E20056 – ERROR_UNKNOWN_SERVICE

The service specified is not known to Delivery Manager.

E20057- ERROR_UNKNOWN_SERVICE_ATTRIBUTE_TYPE

The attribute type is not known to Delivery Manager.

E20058 – ERROR_UNKNOWN_CONSIGNMENT_STATUS

The consignment status is not known to Delivery Manager.

E20059 – ERROR_UNKNOWN_DELIVERY_CONDITION

The delivery condition specified is not known to Delivery Manager.

E20060 – ERROR_UNKNOWN_DEPOT

The depot specified cannot be found.

E20061 – ERROR_UNKNOWN_MANIFEST_STATUS

The manifest status is not known to Delivery Manager.

E20062 – ERROR_UNKNOWN_BARCODE_FORMAT

The barcode format is not supported by PDF.

E20066 – ERROR_MISSING_RETAILER_NAME

The company name of the retailer/shipper must be supplied.

E20067 – ERROR_MISSING_FIRST_NAME

The first name of the recipient must be supplied.

E20068 – ERROR_MISSING_LAST_NAME

The surname of the recipient must be supplied.

E20069 – ERROR_MISSING_EMAIL_ADDRESS

The email address of the recipient must be supplied. Many carriers require this.

E20070 – ERROR_RETAILER_ALREADY_EXISTS

The shipper/retailer already exists in Delivery Manager.

E20073 – ERROR_UNKNOWN_TRANSACTION_TYPE

The transaction type specified is not supported. It should be either “delivery” or “pick-up”.

E20074 – ERROR_INVALID_CONSIGNMENT_STATUS

The consignment status is not valid.

E20075 – ERROR_UNALLOCATED_CONSIGNMENT

The operation that you are trying to perform can only be carried out on consignments that have already been allocated to a carrier.

E20076 – ERROR_MISSING_ACCOUNT_CODE

The carrier requires an account code to be assigned to each warehouse.

E20077 – ERROR_INVALID_MANIFEST

The manifest cannot be sent as it is not valid.

E20078 – ERROR_MISSING_CLIENT_NAME

The name of the recipient must be supplied.

E20079 – ERROR_INVALID_ADDRESS

The address is not valid. The first two lines, the postcode/zip, and the country code, are required.

E20080 – ERROR_INVALID_CONSIGNMENT_WEIGHT

The consignment weight must be a positive number.

E20081 – ERROR_INVALID_PARCEL_NUMBER

The number of parcels must be a positive integer.

E20082 – ERROR_MISSING_ORDER_NUMBER

The order number/reference code must be supplied.

E20083 – ERROR_INVALID_DATE_COUNT

Delivery Manager can only return between 1 and 50 dates (inclusive).

E20084 – ERROR_MISSING_WAREHOUSE_CODE

The warehouse code for the consignment has has not been provided.

E20085 – ERROR_MISSING_SOAP_PARAMETER

The main parameter is missing from the SOAP call, making it appear 'null'.

E20086 – ERROR_MISSING_CARRIER_SERVICE_CODE

You must provide the carrier service code.

E20087 – ERROR_MISSING_CONSIGNMENT_CODE

You must provide the consignment code (starting with "DMC…").

E20088 – ERROR_ALREADY_ALLOCATED

The consignment is already allocated to a carrier.

E20089 – ERROR_INVALID_CARRIER_SERVICE_FOR_ALLOCATION

The carrier service specified cannot be used for this consignment.

E20090 – ERROR_NO_PRINT_IN_THIS_STATUS

Labels cannot be printed for the consignment at its current status.

E20091 – ERROR_PARCEL_DOES_NOT_EXIST

The parcel does not exist.

E20092 – ERROR_REPRINT_NEVER_PRINTED

You can only reprint labels that have previously been printed.

E20093 – ERROR_MISSING_PARCEL_CODE

The parcel code must be supplied.

E20094 – ERROR_NO_MODIFICATION_IN_THIS_STATUS

You cannot make changes to a consignment at this status (e.g. it might have been manifested, in which case no modifications can be made).

E20104 – ERROR_INVALID_SETUP_PARAMETER

At least one of the parameters provided in your setup is invalid.

E20106 – ERROR_INVALID_POD

The POD (Proof of Delivery) type specified is unknown.

E20110 – ERROR_UNKNOWN_FILE_TYPE

Delivery Manager is unable to process the type of file provided.

E20111 – ERROR_UNKNOWN_DATA_TYPE

Unrecognised data type.

E20120 – ERROR_UNABLE_TO_ALLOCATE

Delivery Manager is unable to determine the best carrier for this consignment.

E20121 – ERROR_UNABLE_TO_FIND_DELIVERY_OPTIONS

Delivery Manager is unable to determine the best delivery option to be allocated to this consignment.

E20122 – ERROR_DEPOT_REMOVED

The carrier’s depot has been deleted.

E20123 – ERROR_MISSING_SENDER_NAME

The sender's name is missing.

E20124 – ERROR_BAD_STATE

An attempt has been made to print a label for a parcel while it was not at a valid status.

E20125 – ERROR_UNKNOWN_MESSAGE_STATUS

The status of the message cannot be determined.

E20126 – ERROR_UNABLE_TO_FIND_SUITABLE_CARRIER

There was no carrier suitable for the consignment (i.e. no delivery options were available).

E20127 – ERROR_UNKNOWN_INSURANCE_CODE

The insurance code provided is unknown to Delivery Manager.

E20128 – ERROR_INVALID_FORMAT

An invalid value has been provided for a scheduled task.

E20130 – ERROR_CALCULATION_FAILED

Although the best carrier service can be identified, it cannot be used as the costing configuration is incomplete.

E20131- ERROR_FIELD_TOO_LONG

The value passed for one of the parameters is too long.

E20133 – ERROR_DUPLICATE_ORDER

The order already exists.

E20134 – ERROR_NO_DELIVERY_DATES_AVAILABLE

Delivery Manager was unable to determine any delivery dates for the consignment.

E20135 – ERROR_UNKNOWN_COST_TYPE

Your costing mechanism includes an unknown cost type.

E20137 – ERROR_MISSING_PARCELS

Parcels are missing from the request.

E20144 – ERROR_INVALID_DELIVERED_DUTY

The delivery duty type is unknown.

E20145 – ERROR_INVALID_INVOICE

The invoice type is unknown.

E20146 – ERROR_INVALID_BOOKING_CODE

The booking code is not valid, possibly because of the formatting.

E20147 – ERROR_NO_VALIDATION_IN_THIS_STATUS

You can only validate an allocation before the labels have been printed.

E20148 – ERROR_INVALID_SENDER_NOTIFICATION_TYPE

The notification type for the sender is not valid.

E20149 – ERROR_INVALID_RECIPIENT_NOTIFICATION_TYPE

The notification type for the recipient is not valid.

E20150 – ERROR_UNKNOWN_CARRIER_CODE

The carrier code provided is not known in Delivery Manager.

E20151 – ERROR_MISSING_NUMBER_RANGE

The number range cannot be found and so allocation is not possible.

E20152 – ERROR_INVALID_PRODUCT_INFORMATION

Some information provided about the product is invalid. The actual detail is provided in the error message itself.

E20153 – ERROR_UNKNOWN_MESSAGE_TYPE

Delivery Manager does not support the message type specified (it only supports either “Email” or “SMS”).

E20154 – ERROR_INVALID_EMAIL_ATTACHMENT

Delivery Manager does not support the type of email attachment provided.

E20156 – ERROR_INVALID_REMOTE_SERVICE_LOOKUP_GENERATOR

Internal error that cannot resolve.

E20157 – ERROR_REMOTE_CONSTRAINT_CHECKER

E20160 – INVALID_RECIPIENT_PHONE

The recipient's contact phone number is invalid.

E20163 – ERROR_INVALID_DATA

The input data is has failed validation. The accompanying message will identify which part of the data failed validation. For example, either a zero or negative consignment value or weight is not valid.

E20164 – ERROR_UNKNOWN_CHART_TYPE

The chart type specified is not recognised.

E20165 – ERROR_UNKNOWN_SHIPMENT_TYPE

Delivery Manager does not support the shipment type you’ve specified (it only supports “samples”, “gifts”, “possessions” or “merchandise”).

E20166 – ERROR_UNKNOWN_TERMS_OF_TRADE

Delivery Manager

does not support the terms of trade you’ve specified. For the terms supported, refer to termsOfTradeCode in Properties needed to Call or Create a Consignment.

E20167 – ERROR_UNSUPPORTED_OPERATION _FOR_CARRIER

Delivery Manager cannot perform the operation as the carrier does not support it. For example, certain carriers allow you to change the number of parcels in a consignment after it has been allocated or printed, while other carriers do not.

E20168 – ERROR_EXPRESSION_COMPILATION _EXCEPTION

An expression has a compilation error. More detail is shown in the error message itself.

E20169 – ERROR_EXPRESSION_EVALUATION_EXCEPTION

An error occurred while the expression was being evaluated. More detail will be shown in the error message itself.

E20170 – ERROR_UNSUPPORTED_FILE_FORMAT

The file provided is not in the correct format. This could be due to version incompatibility.

E20171 – ERROR_UNKNOWN_RECORD_TYPE

An unknown record type was specified.

E20172 – ERROR_INVALID_MAP_VALUE

An invalid date format was used when importing consignments.

E20173 – ERROR_UNKNOWN_NEXT_CONSIGNMENT_INDICATOR

Internal error that cannot resolve.

E20174 – ERROR_UNKNOWN_NEXT_PARCEL_INDICATOR

E20175 – ERROR_INVALID_CONSIGNMENT_VALUE

An invalid value was used in a consignment.

E20176 – ERROR_INVALID_PARAMETER

An invalid parameter was used.

E20183 – ERROR_INVALID_SOAP_PARAMETER

An invalid SOAP parameter was used.

E20184 – ERROR_INVALID_SEARCH_PARAMETER

An invalid search parameter was used.

E20185 – ERROR_UNKNOWN_NOTIFICATION_TYPE

An unrecognised notification type was provided.

E20186 – ERROR_INVALID_UPDATE_CONSIGNMENT

An invalid parameter was used when trying to update a consignment.

E20187 – ERROR_ALREADY_SHIPPED

The consignment has already been shipped and so the operation cannot be performed.

E20188 – ERROR_UNKNOWN_WAREHOUSE_CODE

Delivery Manager was expecting a warehouse code, but none was provided (or else its value was 'null').

E20190 – ERROR_PERMISSIBLE_DAYS_EXCEEDED

The retailer/shipper property for maximum days allowed to void a consignment has been exceeded.

E20203 – ERROR_INVALID_CONSIGNMENT_PROPERTY

An invalid property was provided for a consignment.

E20204 – ERROR_INVALID_COUNTRY_CODE

An invalid country code was provided.

E20208 – ERROR_PARCEL_COUNT_LIMIT_EXCEEDED

The system limit for parcels allowed in a consignment has been exceeded.

E20209 – ERROR_INVALID_PARCEL_VALUE

A parcel cannot have a negative value.

E20210 – ERROR_INVALID_PARCEL_WEIGHT

A parcel cannot have a negative depth.

E20212 – ERROR_INVALID_PARCEL_HEIGHT

A parcel cannot have a negative height.

E20213 – ERROR_INVALID_PARCEL_WIDTH

A parcel cannot have a negative width.

E20217 – ERROR_INVALID_INSURANCE_AMOUNT

An invalid insurance amount has been provided.

E20222 – ERROR_JOB_CANCELLED

The user has cancelled the job.

E20223 – ERROR_INVALID_REPORT_FIELDS_ORDER_BY

Internal error that Metapack cannot resolve.

E20224 – ERROR_INVALID_REPORT_FREQUENCY_ID

E20225 – ERROR_INVALID_REPORT_STATUS_ID

E20226 – ERROR_INVALID_REPORT_FIELD_ID

Delivery Manager does not support the report field.

E20227 – ERROR_FAILED_REPORT_ZIP

Internal error that Metapack cannot resolve.

E20229 – ERROR_IMAGE_READWRITE_FAILURE

E20230 – ERROR_UNKNOWN_DOCUMENT_TYPE

Delivery Manager does not support the document type.

E20232 – ERROR_INVALID_CURRENCY_CODE

The currency used in the consignment is not supported by the retailer/shipper.

E20233 – ERROR_INVALID_ZPL_DPI

Delivery Manager does not support the DPI specified for the ZPL label.

E20234 – ERROR_CONVERTING_IMAGE_HEX

Internal error that Metapack cannot resolve.

E20235 – ERROR_DECODING_IMAGE

E20236 – ERROR_INVALID_IMAGE_TYPE

E20237 – ERROR_UNSUPPORTED_LANGUAGE_CODE

Delivery Manager does not support the language code provided.

E20238 – ERROR_MISSING_CARTON_ID

A carton ID is mandatory here.

E20239 – ERROR_INVALID_MANIFEST_GROUP_CODE

The manifest group code provided is invalid.

E20240 – ERROR_INVALID_FEED_FILE_FIELD

One or more fields in the feed file provided are not valid.

E20241 – ERROR_UNSUPPORTED_INDICIA_ID

Internal error that Metapack cannot resolve.

E20242 – ERROR_INVALID_JOB_STATE_ID

E20244 – ERROR_INVALID_PACKAGE_TYPE

Delivery Manager does not support the package type provided.

E20245 – ERROR_INVALID_CONSIGNMENT_COD_AMOUNT

The COD (Cash On Delivery) amount provided for the consignment is invalid.

E20246 – ERROR_INVALID_PARCEL_COD_AMOUNT

The COD (Cash On Delivery) amount provided for the parcel is invalid.

E20247 – ERROR_INVALID_PAYMENT_TYPE

Delivery Manager does not support the payment type provided.

E20248 – ERROR_UNSUPPORTED_LABEL_FORMAT

Delivery Manager does not support the label format provided.

E20267 - INVALID_HTTP_METHOD

Incorrect HTTP method used, please use correct method.

E20268 - INVALID_SEMISTRUCTURED_ADDRESS

The address is not valid. The first two lines, the postcode/zip, and the country code, are required.

E20269 - ERROR_MISSING_RECIPEIENT_NAME

The name of the recipient must be supplied.

E30000 (Comm- unication Errors)

 

These tend to be temporary and sometimes resolve themselves.

Either wait and try later, or else contact MetaPack Support if the error persists.

E30002 – ERROR_BROWSER_CLOSED

The browser closed the connection before the process could be completed.

E30003 – ERROR_DATABASE_BUSY

The database is too busy to handle any more requests at the moment.

E30007 – ERROR_MAIL_FAILURE

The email could not be sent.

E30017 – ERROR_FTP_FAILURE

The FTP process failed.

E30019 – ERROR_FAILED_FILE_UPLOAD

The file could not be uploaded.

E30020 – ERROR_FILE_NOT_FOUND

The file could not be found.

E30021 – ERROR_UNABLE_TO_CREATE_ TEMPORARY_FOLDER

Unable to create the temporary folder.

E30022 – ERROR_UNABLE_TO_SAVE_FILE

Failed to save the file.

E30023 – ERROR_UNABLE_TO_COPY_FILE

Failed to copy the file.

E30025 – ERROR_FAILED_TO_WRITE_XML

Failed to write the XML file.

E30033 – ERROR_FAILED_NOTIFICATION

Failed to notify anyone of the problem.

E30044 – ERROR_STATUS_UPDATE_FILE_FAILURE

Failed to process status files from the carrier.

E30049 – ERROR_LABEL_FAILED

Failed to create the label.

E30097 – ERROR_FAILED_TO_CONTACT_REMOTE_OPTIONS_SERVICE

The delivery options could not be determined as the remote options provider (usually the carrier) could not be contacted.

E30098 – ERROR_FAILED_TO_REMOTE_LOOKUP

The delivery options could not be determined as a problem occurred at the carrier’s end.

E30101 – ERROR_FAILED_TO_REMOTE_CANCEL

A problem occurred at the carrier end while trying to cancel the consignment.

E30102 – ERROR_FAILED_TO_REMOTE_ALLOCATE

A problem occurred at the carrier end while trying to allocate the consignment.

E30161 – ERROR_UNABLE_TO_CANCEL

Internal error that Metapack needs to resolve.

E30179 – ERROR_HTTPS_FAILURE

An error occurred while communicating via HTTPS.

E30191 – ERROR_SOAP_FAILURE

An error occurred while communicating via SOAP.

E30201 – ERROR_CERTIFICATE_FAILURE

Internal error that Metapack needs to resolve.

E30207 – ERROR_HTTP_CLIENT_REQUEST_FAILURE

An error occurred while communicating via the HttpClient.

E30220 – ERROR_SOCKET_COMMUNICATION_FAILURE

An error occurred in the communications to/from a socket.

E40000 (Database Errors)

N/A

These occur when there is an issue with the database.

There is nothing you can do here besides report the error to MetaPack.