The UK’s departure from the EU has resulted in some changes to the data required for international shipments in Consignments. This page details the consignment data needed to generate customs documentation in Consignments and allocate international shipments to DPD, Evri, Parcelforce, Yodel, Royal Mail, DHL, or P2P.

Customs Documentation Required Data

The following consignment properties are required in order for Consignments to generate CN22, CN23, and commercial invoice documents.

DescriptionConsignments Data ElementConsignments APIConsignments User Interface
Delivery TownAddresses> Destination
Address>Town		n/a
Exporter AddressAddresses >Exportern/a
Category TypeCustomsDocumentation > CategoryType >YesYes
Declaration DateCustomsDocumentation > DeclarationDateYesMandatory
Declaration NameCustomsDocumentation > Designated PersonResponsibleYesMandatory
Invoice DateCustomsDocumentation > InvoiceDateYesMandatory
Consignment Carriage ValueCustomsDocumentation > ReceiversShippingCostNon/a
Shipper’s VAT NumberCustomsDocumentation > ShippersVatNumberYesOptional
Shipping TermsCustomsDocumentation > ShippingTerms >YesMandatory
Receiver’s EORIOrder > Metadata
Consignment > Metadata
Key Value: ReceiversEORI		Non/a
Shipper’s EORIOrder > Metadata
Consignment > Metadata
Key Value: ShippersEORI		Yesn/a
Carriage Value CurrencyOrder > Metadata
Consignment > Metadata
Key Value: CarriageCurrency		Non/a
Package DescriptionPackage > DescriptionYesMandatory
HeightPackage > Dimensions > HeightMandatory
LengthPackage > Dimensions > LengthMandatory
Package Unit of DimensionPackage > Dimensions > UnitMandatory
Package WidthPackage > Dimensions > WidthMandatory
Maximum number of itemsPackage > Item >UnboundedUnbounded
Minimum number of itemsPackage > Item >10
Country of OriginPackage > Item > CountryOfOriginYes
Item DescriptionPackage > Item > DescriptionYes
Harmonisation CodePackage > Item > HarmonisationCodeYes
QuantityPackage > Item > Quantity
Item ValuePackage > Item > Value > Money > AmountYesConditional: Required if an item is provided
CurrencyPackage > Item > Value > Money > Currency > IsoCodeYesConditional: Required if an item is provided
Item WeightPackage > Item > Weight > ValueConditional: Required if an item is provided
Item unit of WeightPackage > Item > Weight > Weight UnitConditional: Required if an item is provided
Duty Paid ValuePackage > Metadata
Key Value: DutyPaidValue		n/a
Package VAT ValuePackage > Metadata
Key Value: VatValue		Not Available
Package ValuePackage > Value > Money > AmountYesMandatory
Package CurrencyPackage > Value > Money > Currency > IsoCodeYesMandatory
Package Unit of WeightPackage > Weight > UnitMandatory
Package WeightPackage > Weight > ValueMandatory

Carrier Data Requirements

This section shows the consignment data required to ship internationally with specific carriers, and the shipping routes that these restrictions apply to for each carrier. When allocating a consignment that will use one of these routes, Consignments only considers that consignment for allocation to a particular carrier if the consignment meets the carrier’s data requirements.

Affected Routes

  • DPD - Customs document not required. Non-GB Destinations for the following routes:

    • DPD INTERNATIONAL: GB to EU & Non-EU
    • DPD UK DOMESTIC: GB to IE, JE & GG
    • DPD LOCAL: GB to IE, JE & GG

  • Evri - Commercial Invoice document required. The following routes are affected:

    • GB to Non-GB Destinations
    • Non-GB Origin to GB
    • GB to Northern Ireland

  • PARCELFORCE INTL - Customs document required. Affects GB to all non-GB destinations

  • YODEL - Customs document not required. Affects all GB to Northern Ireland & Channel Islands routes.

  • ROYAL MAIL INTL - CN22 and CN23 customs documents required. Affects GB to all non-GB destinations.

  • DHL - Commercial invoice or PLT required. Affects GB to all non GB destinations.

  • P2P - Customs document required. Affects GB to all non-GB destinations.

  • UPS - Customs document required (UK to NI paperless). Affects GB to all non-GB destinations, including Northern Ireland.

Data

View below for the Brexit shipping data table.



Adding Metadata Properties

Some required fields for international shipments do not have a dedicated property in the PRO consignments data contract. You will need to record information for each of these fields using a Metadata property with a specific KeyValue.

The table below lists the fields that should be recorded as metadata, and their accompanying KeyValues.

PropertyKeyValue
Shipper’s EORIShippersEORI
Receiver’s EORIReceiversEORI
Carriage Value CurrencyCarriageCurrency
Duty Paid ValueDutyPaidValue
Package VAT ValueVatValue
IOSS NumberIossVatIdentificationNumber
Receiver Personal ID NumberReceiverPersonalID

The example below shows a ShippersEORI value recorded using the Metadata property. The KeyValue denotes to PRO that this is a Shipper’s EORI, and the StringValue contains the EORI itself.

EORI Number Example 

  {
    "ConsignmentReferenceProvidedByCustomer": "YOUR-REF",
    "Addresses": [
        // addresses
    ],
    "Packages": [
        // package properties
    ],
    "Metadata": [
        {
            "KeyValue": "ShippersEORI",
            "StringValue": "GB987654312000"
        }
    ]
    // other consignment properties
}