Version

1.6.28

Date

15/07/2022

Description

Appendices supporting the Intelligent Shipper Shipment Booking API specification

Author

Laura Price

L

Inland Letter

F

Inland Large Letter

P

Inland Parcel

P

International Letter

G

International Flat

E

International Parcel

N

Inland Format Not Applicable

N

International Format Not Applicable

H

International Printed Papers

6

Recorded

Recorded Signed for Mail

13

SMS Notification

Tracking Notifications

14

E-Mail Notification

Tracking Notifications

22

Local Collect

Local Collect

24

Saturday Guaranteed

Saturday Guaranteed

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

shipperCompanyName

Y

N

E1111

The field shipperCompanyName is required

shipperCompanyName

N

Y

E1205

The field shipperCompanyName exceeds the maximum allowable length of 35

shipperAddressLine1

Y

N

E1111

The field shipperAddressLine1 is required

shipperAddressLine1

N

Y

E1205

The field shipperAddressLine1 exceeds the maximum allowable length of 35

shipperAddressLine2

N

Y

E1205

The field shipperAddressLine2 exceeds the maximum allowable length of 35

shipperAddressLine3

N

Y

E1205

The field shipperAddressLine3 exceeds the maximum allowable length of 35

shipperCity

Y

N

E1111

The field shipperCity is required

shipperCity

N

Y

E1205

The field shipperCity exceeds the maximum allowable length of 20

shipperCounty

N

Y

E1205

The field shipperCounty exceeds the maximum allowable length of 35

shipperCountryCode

Y

N

E1111

The field shipperCountryCode is required

shipperCountryCode

N

Y(Char)

E1205

he field shipperCountryCode exceeds the maximum allowable length of 2

shipperCountryCode

N

Y(Num)

E1437

The Shipper country code is invalid.

shipperPostCode

Y

N

E1111

The field shipperPostcode is required

shipperPostCode

N

Y

E1205

The field shipperPostcode exceeds the maximum allowable length of 10

shipperPostCode

N

Y(Num/Char)

E1437

The Postcode is not a valid UK Postcode

shipperContactName

N

Y

E1205

The field shipperContactName exceeds the maximum allowable length of 40

shipperPhoneNumber

N

Y

E1205

The field shipperPhoneNumber exceeds the maximum allowable length of 20

shipperPhoneNumber

N

Y(Char)

E1437

The contact phone number is invalid

shipperVatNumber

N

Y

E1205

The field shipperVatNumber exceeds the maximum allowable length of 15

shipperEmailAddress

N

Y

E1437

The contact email address is not a valid email address

shipperReference

Y

N

E1111

The field shipperReference is required

shipperReference

N

Y

E1205

The field shipperReference exceeds the maximum allowable length of 20

shipperReference2

N

Y

E1205

The field shipperReference2 exceeds the maximum allowable length of 20

shipperDeptCode

N

Y

E1205

The field shipperDeptCode exceeds the maximum allowable length of 17

destinationCompany
Name

N

Y

E1205

The field destinationCompanyName exceeds the maximum allowable length of 35

destinationAddressLine1

Y

N

E1111

The field destinationAddressLine1 is required

destinationAddressLine1

N

Y

E1205

The field destinationAddressLine1 exceeds the maximum allowable length of 35

destinationAddressLine2

N

Y

E1205

The field destinationAddressLine2 exceeds the maximum allowable length of 35

destinationAddressLine3

N

Y

E1205

The field destinationAddressLine3 exceeds the maximum allowable length of 35

destinationCity

Y

N

E1111

The field destinationCity is required

destinationCity

N

Y

E1205

The field destinationCity exceeds the maximum allowable length of 30

destinationCounty

N

Y

E1205

The field destinationCounty exceeds the maximum allowable length of 35

destinationCountry
Code

Y

N

E1111

The field destinationCountryCode is required

destinationCountry
Code

N

Y(Num)

E1437

The Destination country code is invalid.

destinationCountry
Code

N

Y

E1205

The field destinationCountryCode exceeds the maximum allowable length of 2

destinationPostcode

Y

N

E1437

The Destination Postcode is required.

destinationPostcode

N

Y

E1205

The field destinationPostcode exceeds the maximum allowable length of 10

destinationPostcode

N

Y(Num/Char)

E1437

The Postcode is not a valid UK Postcode

destinationContact
Name

Y

N

E1111

The field destinationContactName is required

destinationContact
Name

Y

N

E1205

The field destinationContactName exceeds the maximum allowable length of 40

destinationPhone
Number

N

Y(Char)

E1437

The contact phone number is invalid

destinationPhone
Number

N

Y

E1205

The field destinationPhoneNumber exceeds the maximum allowable length of 20

destinationVatNumber

N

Y

E1205

The field destinationVatNumber exceeds the maximum allowable length of 17

destinationEmail
Address

Y(En-22&14)

N

E1000

Unable to create the Royal Mail Label.

destinationEmail
Address

N

Y

E1437

The contact email address is not a valid email address

deliveryInstructions

N

Y

E1205

The field deliveryInstructions exceeds the maximum allowable length of 50

shipmentDate

Y

N

E1111

The field shipmentDate is required

shipmentDate

N

Y(05/06/2018)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

shipmentDate

N

Y(Past date)

E1437

The dispatch date must be today's date or later.

serviceCode

Y

N

E1111

The field serviceCode is required

serviceCode

N

Y(Num)

E1437

The service code provided does not exist.

serviceCode

N

Y

E1205

The field serviceCode exceeds the maximum allowable length of 4

serviceCode

N

N (Royal Mail account disabled)

E1000

Unable to generate Royal Mail Label. Your account is currently unavailable. Please contact Royal Mail Finance.

serviceCode

N

N (OBA Access Code pending)

E1000

Unable to generate Royal Mail label. OBA Access Code for Posting Location (posting location number) is currently pending.

trackingNumber

Y

N

E1111

The field trackingNumber is required
(required for offline shipments)

trackingNumber

N

Y

E1205

The field trackingNumber exceeds the maximum allowable length of 30

itemID

Y

N

E5000

Item Id is required for Royalmail shipments

itemID

N

Y

E1205

The field itemId exsceeds the maximum allowable length of 8

carrierCode

Y

N

E1111

The field carrierCode is required
(required for offline shipments)

carrierCode

N

Y

E1205

The field carrierCode exceeds the maximum allowable length of 4

carrierCode

N

Y

E5000

Carrier code and service code combination is invalid

Status

N

Y

E1205

The field status exceeds the maximum allowable length of 30

serviceCode (service not available to destination or for customer account)

N

Y

E5000

The service is not a valid service for these shipment contents to this destination

postingLocation

N

Y

E1205

The field postingLocation exceeds the maximum allowable length of 10

postingLocation

Y

N

E1000

The Royal Mail Account 'RM acc number' has more than one possible posting location. Please provide the posting location for this shipment.

serviceLevel

N

Y

E1205

The field serviceLevel exceeds the maximum allowable length of 2

serviceFormat

N

Y

E1205

The field serviceFormat exceeds the maximum allowable length of 1

serviceFormat (maximum weight allowed for service format exceeded)

N

Y

E5000

The service is not a valid service for these shipment contents to this destination

safePlace

N

Y

E1205

The field safePlace exceeds the maximum allowable length of 30

serviceEnhancement
Code

N

Y

E1205

The field serviceEnhancementCode exceeds the maximum allowable length of 10

serviceEnhancement
Code

N

Y

E1437

The enhancement code (service enhancement code) does not exist

serviceEnhancement
Code

N

Y

E1437

There are 2 or more enhancement codes requested from the same group of Enhanced Compensation. You can only have 1 enhancement code per group.

serviceEnhancement
Code

N

Y(Char/Num)

E1000

Unable to create the Royal Mail Label. 'Char/Num' is not a valid enhancement code for the (Service Code) service.

serviceEnhancement
Code

N

Y(Invalid Com)

E1000

Unable to create the Royal Mail Label. When using LocalCollect, a tracking notification enhancement is also required. '99' is not a valid enhancement code for the (Service Code) service.

serviceEnhancement
Code

N

Y

E1000

Unable to create the Royal Mail Label. Can only add one enhancement from each enhancement type. The enhancement type of (enhancement group) has already been added.

totalPackages

Y

N

E1300

TotalPackages must have a value, and the value must be between 1 and 99

totalPackages

N

Y

E1300

The total number of packages provided does not match the 'TotalPackages' value

totalPackages

N

Y(Char/Num)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

totalWeight

Y

N

E1890

The field TotalWeight must be between 0.001 and 9999.999.

totalWeight (Less than Package Weight)

N

Y

E1300

The total weight cannot be lower than the combined total weight of all packages.

totalWeight

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

totalWeight (exceeds maximum weight allowed for service)

N

Y

E5000

The service is not a valid service for these shipment contents to this destination

weightId

N

Y

E1205

The field weightId exceeds the maximum allowable length of 1

weightId

N

Y(Char/Num)

E1300

Invalid weightId

unitOfMeasurement

N

Y(Char)

No Error

unitOfMeasurement

N

Y(Limit)

No Error

product

Y

N

E1111

The field product is required

product

N

Y

E1205

The field product exceeds the maximum allowable length of 3

product

N

Y(Char/Num)

No Error (Note: Doesn't create a shipment)

descriptionOfGoods

Y

N

E1111

The field itemDescription is required

descriptionOfGoods

N

Y

E1205

The field descriptionOfGoods exceeds the maximum allowable length of 70

declaredValue

Y

N

E1890

The field DeclaredValue must be between 0.01 and 9999999999.99.

declaredValue (Less than Item Value)

N

Y

E1437

The sum of the total item values cannot be more than the total shipment value.

declaredValue

N

Y

E1111

Shipment value cannot Exceed $800.
(Only applicable for DHL eCommerce integration)

declaredCurrencyCode

Y

N

E1111

The field declaredCurrencyCode is required

declaredCurrencyCode

N

Y

E1205

The field declaredCurrencyCode exceeds the maximum allowable length of 3

declaredCurrencyCode

N

Y(Num/Char)

E1437

The shipment currency code provided does not exist.

terms

N

Y

E1205

The field terms exceeds the maximum allowable length of 3

Terms

N

Y

E1000

Terms DDP is currently not supported on the <integration name> integration.

Terms

N

Y

E1205

The field terms exceeds the maximum allowable length of 3

preRegistrationNumber

N

Y

E1437

The Pre-registration Number must be 50 characters or less

preRegistrationType

N

Y

E1437

The Pre-registration Type must be 18 characters or less

preRegistrationType (when preRegistrationNumber provided)

Y

N

E1437

When a pre-registration number is provided, the pre-registration type must also be provided. Please enter the pre-registration type, for the pre-registration number provided.

shippingCharges

N

Y

E1437

The Shipping Charges must be less than 100,000

shippingCharges

N

Y (Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

otherCharges

N

Y

E1437

The Other Charges must be less than 100,000

otherCharges

N

Y (Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

quotedLandedCost

N

Y

E1437

The Quoted Landed Cost must be less than 100,000

quotedLandedCost

N

Y (Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

invoiceNumber

N

Y

E1437

The Invoice Number must be 35 characters or less

invoiceNumber (when invoiceDate provided, for Royal Mail shipment)

Y

N

E1437

When an invoice date is provided, the invoice number must also be provided. Please include the invoice number.

invoiceDate

N

Y

E1300

The Customs Invoice Date must be in the format YYYY-MM-DD.

invoiceDate (when invoiceNumber provided)

Y

N

E1437

When an invoice number is provided, the invoice date must also be provided. Please include the invoice date.

exportLicence

N

Y (not Boolean)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

addresseeIdentificationReferenceNumber

N

Y

E1437

The Addressee Identification Reference Number must be 20 characters or less

labelImageFormat

N

Y

E1300

Invalid label image format

labelImageFormat

N

Y

E1205

The field labelImageFormat exceeds the maximum allowable length of 10

silentPrintProfile

N

Y

E522

Invalid Silent Print Profile (Profile ID). Your shipment has not been created.

silentPrintProfile

N

Y

E1205

The field silentPrintProfile exceeds the maximum allowable length of 36

shipmentAction

N

Y

E1205

The field shipmentAction exceeds the maximum allowable length of 10

shipmentAction

N

Y (not a specified allowed value)

E1300

Invalid Shipment Action

Package element

Y

N

E1300

The total number of packages provided does not match the 'TotalPackages' value

packageID

N

Y

E1205

The field packageId exceeds the maximum allowable length of 15

(Package) weight

Y

N

E1434

Package weights must be provided for every package.

(Package) weight (More than Total Weight)

Y

N

E1437

The sum of the total package weight does not equal the total shipment weight.

(Package) weight

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

(Package) length

N

Y

E1437

A package length must be between 0.01cm and 250cm

(Package) length

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

(Package) width

N

Y

E1437

A package width must be between 0.01cm and 250cm

(Package) width

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

(Package) height

N

Y

E1437

A package height must be between 0.01cm and 250cm

(Package) height

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

itemInformation element

Y

N

E1437

At least one shipment item is required

packageID

Y

N

E1434

Package Id is required for all items

itemHsCode

N

Y

E1205

The field itemHsCode exceeds the maximum allowable length of 10

itemHsCode

N

Y(Char)

E1437

The shipment item HS Code must be 6 - 12 digits only

itemDescription

Y

N

E1111

The field itemDescription is required

itemDescription

N

Y

E1205

The field itemDescription exceeds the maximum allowable length of 255

itemQuantity

Y

N

E1890

The field ItemQuantity must be between 1 and 99999.

itemQuantity

N

Y

E1890

The field ItemQuantity must be between 1 and 99999.

itemQuantity

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

itemValue

Y

N

E1890

The field ItemValue must be between 0.01 and 99999.99.

itemValue

N

Y

E1890

The field ItemValue must be between 0.01 and 99999.99.

itemValue

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

itemValue (Quantity + Value combined Less than declaredValue)

N

Y

E1437

The sum of the total item values cannot be more than the total shipment value.

itemCOO

N

Y

E1205

The field itemCOO exceeds the maximum allowable length of 2

itemSku

N

Y

E1205

The field itemSku exceeds the maximum allowable length of 30

itemNetWeight

Y

N

E1890

The field ItemNetWeight must be between 0.001 and 9999.999.

itemNetWeight

N

Y

E1890

The field ItemNetWeight must be between 0.001 and 9999.999.

itemNetWeight

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

itemNetWeight

N

Y

E1437

The total item weight must not exceed the shipment weight.

itemNetWeight

N

Y

E1437

The total item weight must not exceed the package weight.

properShippingName

N

Y

E1205

The field properShippingName exceeds the maximum allowable length of 100

properShippingName

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

unIdNumber

N

Y

E1205

The field unIdNumber exceeds the maximum allowable length of 4

class

Y

N

E1111

The field class is required

class

N

Y

E1205

The field class exceeds the maximum allowable length of 3

class

N

Y(Invalid Class)

E5021

The 'integration name' integration only supports class 9 hazardous items.

class

N

Y(Char)

E1300

The hazmat class supplied was not recognised.

class

N

Y(Hazardous Un-Support)

E5021

The 'integration name' integration does not support hazardous items.

id8000Category

N

Y

E1205

The field id8000Category exceeds the maximum allowable length of 100

id8000Category

N

Y(Char)

E1300

The hazmat id8000Category supplied was not recognised.

hazchemNumber

N

Y

E1205

The field hazchemNumber exceeds the maximum allowable length of 3

hazchemNumber

N

Y(Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

emergencyActionCode

N

Y

E1205

The field emergencyActionCode exceeds the maximum allowable length of 4

specialistAdvicePhoneNumber

N

Y

E1205

The field specialistAdvicePhoneNumber exceeds the maximum allowable length of 50

Hazmat Items

N

Y

E1300

The Hazmat Information can not be added to both Item Information and Shipment Information. Please add to Item Information only

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

trackingNumber

Y

N

E1111

The field trackingNumber is required

trackingNumber

N

Y

E1205

The field trackingNumber exceeds the maximum allowable length of 70

trackingNumber

N

Y

E1232

Shipment not found

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

manifestImageType

N

Y

E5000

manifestImageType contains an invalid value

tracking/ConsignmentNumber

Y

N

E7010

trackingNumber is required

tracking/ConsignmentNumber

N

Y

E1205

trackingNumber has a maximum length of 50

tracking/ConsignmentNumber

N

Y

E1323

No valid shipments foundOne or more shipments are not in a valid state for confirming

serviceCode

Y

N

E7010

serviceCode is required

serviceCode

N

Y

E1205

serviceCode has a maximum length of 4

serviceCode

N

Y(Num/Char)

E1323

No valid shipments found

carrierCode

Y

N

E7010

carrierCode is required

carrierCode

N

Y

E1205

carrierCode has a maximum length of 4

carrierCode

N

Y(Num/Char)

E1323

No valid shipments found

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E6001

Access Denied

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E6001

Access Denied

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E6001

Access Denied

trackingNumber

Y

N

E1111

The field trackingNumber is required

trackingNumber

N

Y(Num/Char)

E1125

The shipment was not found

trackingNumber

N

Y

E1205

The field trackingNumber exceeds the maximum allowable length of 70

documentType

Y

N

E1111

The field documentType is required

documentType

N

Y(Num/Char)

E1890

Invalid documentType provided. Valid document types are CI, CN and PI

documentType

N

Y

E1205

The field documentType exceeds the maximum allowable length of 2

EORI number

N

Y(Num/Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

EORI number

N

Y

E1205

The field eoriNumber exceeds the maximum allowable length of 18

VAT number

N

Y(Num/Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

VAT number

N

Y

E1205

The field vatNumber exceeds the maximum allowable length of 15

Reason for Export

Y

N

E1111

The field reasonForExport is required

Reason for Export

N

Y(Num/Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

Reason for Export

N

Y

E1205

The field reasonForExport exceeds the maximum allowable length of 30

Name

N

Y(Num/Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

Name

N

Y

E1205

The field name exceeds the maximum allowable length of 40

Position

N

Y(Num/Char)

E3333

Error deserializing XML message. Check your XML complies with the API documentation

Position

N

Y

E1205

The field position exceeds the maximum allowable length of 50

Signature Image Format

N

Y(Num/Char)

E1890

Invalid Signature format provided, valid types are PNG or JPEG

Signature Image Format

N

Y

E1205

The field signatureImageFormat exceeds the maximum allowable length of 4

Company Image Format

N

Y(Num/Char)

E1890

Invalid company stamp image format. Valid company stamp image formats are PNG or JPEG

Company Image Format

N

Y

E1205

The field companyStampImageFormat exceeds the maximum allowable length of 4

Silent Print

N

Y(Num/Char)

E1890

Invalid Silent Print Profile "abcd". Your document has not been created

Silent Print

N

Y

E1205

The field silentPrintProfile exceeds the maximum allowable length of 36

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E6001

Access Denied

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E6001

Access Denied

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E6001

Access Denied

trackingNumber

Y

N

E1111

The field trackingNumber is required

trackingNumber

N

Y

E1205

The field trackingNumber exceeds the maximum allowable length of 70

trackingNumber

N

Y

E1125

The shipment was not found

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E6001

Access Denied

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E6001

Access Denied

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E6001

Access Denied

manifestDate

Y

N

E1111

The field manifestDate is required

manifestDate

N

Y

E1300

Invalid manifestDate format

transactionId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

transactionId

N

Y

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

applicationId

N

Y

E6001

Access Denied

userId

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

userId

N

Y

E6001

Access Denied

password

Y

N

E3333

Error deserializing XML message. Check your XML complies with the API documentation

password

N

Y

E6001

Access Denied

manifestNumber

Y

N

E1111

The field manifestNumber is required

manifestNumber

N

Y

E3123

Manifest Number (manifest number) not found

How do I create shipments to BFPO addresses?

The following steps must be followed in order to create a shipment to a BFPO address:

1. destinationPostcode: You will need to enter a BFPO postcode in the field for destination postcode. A list of valid BFPO post codes can be found on https://www.gov.uk/government/publications/british-forces-post-office-locations
2. Countrycode: Enter to GB
3. Destination town: Enter 'BFPO' followed by 'unit number' (eg BFPO 19)
4. Enter the correct service code for the BFPO service you want to use:
   
                 Code      Name
                 BF1        HM Forces Mail
                 BF2        HM Forces Signed For
                 BF7        HM Forces Special Delivery
                 BF8        HM Forces Special Delivery (£1000)
                 BF9        HM Forces Special Delivery (£2500)

Why do I not receive CN22 documents for Royal Mail International shipments?

If Intelligent Shipper has been configured to return a CN23 via the API, then the createShipmentResponse will return a CN23 along with the shipment label for international shipments. A CN23 can also be produced by using the printDocumentRequest - setting <documentType> in the request to "CN" will produce a CN23 document.

Intelligent Shipper will not return the CN22 document, as the CN23 provides all the information needed to satisfy the requirements of a CN22. Providing the required Customs Documentation and information required to populate these documents is ultimately the responsibility of the posting customer.

I am shipping to Channel Islands via Royal Mail, how can I get customs documentation?

Channel Islands are treated as domestic shipments by Royal Mail. If the destination country code for shipments to Isle of Man, Guernsey and Jersey is GB Intelligent Shipper will create the outbound label only; customs documentation will not be included with the label. If you need customs documentation, you can either request it by calling our printDocuments service or change the country code to IM for Isle of Man, GE for Guernsey and JE for Jersey, and CN documentation will be printed with the label.

Why isn't my customer receiving SMS/Email notifications for Royal Mail tracked services?

Please make sure you are using one of the email and SMS enhancement codes listed in Appendix 1 in the createShipmentRequest, and that you are using Royal Mail Tracked or Special Delivery services.

Alpha-2, Alpha-3 and Numeric country codes

ISO 3166

https://www.iso.org/obp/ui/#search

Alphabetic and Numeric currency codes

ISO 4127

https://www.currency-iso.org/en/home/tables/table-a1.html

Safe Place Name

Porch

Shed

Garage

Greenhouse

Conservatory

Driver Choice

1.6.15

Appendices moved to a separate document as part of changes to document format.
Added Appendix 7 ISO Code Links.
Added Appendix 8 Parcelforce Safe Place list to support new service enhancements functionality in createShipmentRequest.
Added Appendix 9 Carrier Package Types to support new packageTypeName field in createShipmentRequest.
Added <deliveryInstructions> errors to Appendix 2

19/08/2019

Laura Lyonette

1.6.16

Appendix 4 createShipment Error Codes List updated with new errors for <terms> field and <hazmat> fields.
Appendix 8 Hazardous Shipments added for new hazmat shipments functionality.

28/10/2019

Laura Lyonette

1.6.17

Appendix 4 createShipment Error Codes List updated with new error message for disabling Royal Mail account.

12/02/2020

Laura Lyonette

1.6.18

Added section 3.7 manifestHistory Error Codes and section 3.8 printManifest Error Codes.

14/05/2020

Laura Price

1.6.19

No changes in this document; changes in version 1.6.19 are in the document "Intelligent Shipper API – Multipiece Bookings"

19/06/2020

Laura Price

1.6.20

createShipment error codes list updated with errors for <shipperReference2> field.

09/09/2020

Laura Price

1.6.21

createShipment error codes list updated with errors for new offLineShipment section and declaredValue for DHL eCommerce shipments

23/10/2020

Laura Price

1.6.22

createShipment error codes list updated with errors for new customsInformation section
Royal Mail service enhancement code 16 removed
Customs Document examples updated

21/12/2020

Laura Price

1.6.23

Service format code H added to Appendix 1 Royal Mail Shipments.
createShipment error codes list updated with new item and package validation error codes.

03/02/2021

Laura Price

1.6.24

createShipment error codes list update with error for new invoiceNumber conditional logic for Royal Mail shipments.

27/04/21

Laura Price

1.6.25

Updated ShippersVATNumber Error Field Length from 17 to 15 characters
createShipment error codes list updated with errors for new hazmat fields in itemInformation section

27/07/21

Mujeeb Mohamad

1.6.26

No changes to this document; changes in version 1.7.2 are in the document "Intelligent Shipper API – Multipiece Shipment Bookings" and "Intelligent Shipper API - Multipiece Shipment Bookings with Datastream"

11/04/2022

Winnifred Okalla

1.6.27

Changes to error field EORI Number – maximum allowable field has changed from 15 to 18

18/05/2022

Joey Chatterjee

1.6.28

Appendix 1 – Royal Mail Consequential Loss service enhancement codes removed, as these are no longer supported by Royal Mail

15/07/2022

Mohamed
Bashir

Name

Title

Date Reviewed

Version Reviewed

Laura Price

Head of Business Analysis

15/07/2022

1.6.28

Document Name

Version

Intelligent Shipper API – Multipiece Shipment Bookings

1.6.28