Add Royal Mail shipping account

A shipping account is a specific account set up with a shipping carrier or logistics provider that enables businesses to manage shipping activities.

In SAPIENT, you can create a shipping account with Royal Mail, assign your Royal Mail credentials to it, and then link it to the relevant shipping location(s).

🚧

Important

Before you can set up a shipping account, you must ensure you have enabled the label integration with Royal Mail.

To add a shipping account for Royal Mail in SAPIENT, follow the instructions as explained in the following procedure.

  1. Log in to the SAPIENT platform using your credentials.
Logging into SAPIENT

Logging into SAPIENT

  1. On the Home page that opens, in the left navigation panel, select Shipping Accounts.
Accessing shipping accounts

Accessing shipping accounts

  1. On the Shipping Accounts page that opens, select the Add Shipping Account button.
Accessing option to add shipping account

Selecting option to add shipping account

  1. On the Add Shipping Account form that appears, in the ACCOUNT DETAILS block, fill in the necessary information as described in the following table.
Entering account details

Entering account details

💡

Tip

In the following table, the mandatory fields are marked with an asterisk (*).

ElementDescription
Carrier*From the dropdown list, select Royal Mail.
Shipping Location*From the dropdown menu, select the location that you want to assign to the shipping account you are creating.
  1. In the SHIPPING ACCOUNT block, enter the necessary information as explained in the following table.
Specifying shipping account details

Specifying shipping account details

💡

Tip

In the following table, the mandatory fields are marked with an asterisk (*).

ElementDescription
Carrier Account Number*Enter a ten digit account number. This must be a ten digit number. If your account number is shorter than this, then you need to add the required amount of zero's at the beginning of the number to ensure it is ten digits long.

The format of the account number must be compliant with the carrier you have selected. If your account number does not meet the requirements, you may need to add the required amount of zero's at the beginning of the number to ensure it is ten digit long.
Account Type*From the dropdown menu, select one of the following account types that you want to set up for the the shipping account you are adding:

Production: a live environment where the final version of the application is deployed and made available to the users.

Sandbox: a testing environment that mimics the Production environment but is isolated from it. The sandbox environment is primarily used for development and testing purposes.
Account Name (if different than customer)*Enter the name of the account you are adding.
Registered Email Address*Enter the email address that was used to register the Royal Mail online business account (OBA).

For more information on OBA, refer to the Set up Royal Mail OBA account section.
Registered Billing Postcode Enter the postcode registered with Royal Mail for receiving invoices.
Alias*Enter a custom name which can be used in the API request instead of using the shipping location ID when connecting to us. Therefore, it is recommend that this name must be memorable and available for reference purposes.
Contact Name*Enter the contact name for the account you are adding.
Contact Number*Enter the contact number for the account you are adding.
  1. In the CARRIER DETAILS block, enter the necessary information as explained in the following table.
Entering carrier details

Entering carrier details

💡

Tip

In the following table, the mandatory fields are marked with an asterisk (*).

ElementDescription
Posting Location Code*This is a Royal Mail specific code given for each location you are despatching shipments from.

This must be a 10 digit number that always starts with 9000. For example, 9000257150.
Receiving Hub Code*Enter the code allocated by Royal Mail for the receiving Hub to where your goods will be taken.

The Receiving Hub Code is automatically populated based on the postcode of the shipping location to which you are linking this account.
OBA Access CodeThis fields is auto-populated on our end and is something we communicate directly with the carrier after the shipping account has been added.
  1. After entering all the required information, select the Add Shipping Account button.

Once done, you have now successfully added a shipping account. You can now add a shipping location to your new shipping account.


Account approval

Once you have created the Royal Mail shipping account, the account needs to be approved before you start using it to ship with Royal Mail.

To get your shipping account approved, consider the following:

  1. If the account type you have created is Production, you will receive a confirmation email.
  2. Initially, the account status is set to 'Disabled' until the account has been approved by the Royal Mail OBA team. This can typically take 2-5 working days.
  3. Once the account has been approved, the status of your shipping account is change to 'Enabled'. You can check the account status by viewing the shipping account or via the Get Account API.
  4. If the account cannot be approved, we will contact you and advise accordingly.

📘

Note

Shipping account(s) can be added and managed via API. For more information, refer to the API References section.