Royal Mail

Overview

Royal Mail (RMG), a British postal and courier service, is known for providing reliable and efficient shipping solutions across the UK and internationally. It offers a variety of domestic and international services including 1st Class and 2nd Class mail, as well as premium options like Special Delivery Guaranteed by 1PM and 9AM.

Onboarding of a Royal Mail Carrier Account

We do not support Royal Mail carrier onboarding from API as of now. Royal Mail carrier account is automatically provisioned during onboarding.

Windsor Agreement Compliance

The Windsor Agreement applies to shipments with BT postal codes (Northern Ireland) when shipping from Great Britain (England, Wales, or Scotland) using the RMG carrier. To comply with customs regulations, additional data fields and validations have been introduced for shipments under this agreement, especially for business-to-business (B2B) transactions.

Note: If shipping is done within the BT postal codes, then the Windsor agreement is not applicable.

Customs and Regulatory Requirements

  • HS (Harmonized System) Code, Sender EORI, and Recipient EORI numbers are mandatory for B2B shipments. These ensure that goods can be correctly classified and reported for customs clearance.
  • When the declared shipment value exceeds £135, users must additionally provide either the Sender UKIMS or Recipient UKIMS number. If this information is missing, the system will prevent label generation.

Export Type Options

Shipments under the Windsor Agreement must include an appropriate reasonForExport. A new category, Mixed Content, has been added to the existing options:
  • Commercial Sample
  • Documents
  • Gift
  • Merchandise
  • Other
  • Returned Goods
  • Mixed Content (new)

Export License Declaration

An Export License Number Required flag is now available in the Additional Custom Forms section. This option is visible for both B2B and B2C shipments and must be selected if applicable.


API Operations for Shipping with Royal Mail

The APIs integrate with royal mail through the following operations:

OperationsMethodResource Path
Retrieve Country ListGET/api/v1/countries
Get Carrier AccountGET/api/v1/carrierAccounts
Create a Shipping LabelPOST/api/v1/shipments
Reprint a LabelGET/api/v1/shipments/{{shipmentId}}/reprint
Void a LabelPUT/api/v1/shipments/{{shipmentId}}/cancel

Metadata

Metadata provides information about royal mail carrier services, including origin and destination countries, supported carrier services, supported package types, and supported special services. Users can select specific origin and destination countries from the provided dropdown menu to dynamically view relevant metadata specific to those countries.

Metadata information not available