Royal Mail Account Integration

Оverview

Royal Mail (RM) is the oldest and the largest letter and package delivery service in the United Kingdom (UK). They deliver a one-price-goes-anywhere service, six days a week to more than 30 million addresses across the UK. They even offer options for more eco-friendly deliveries.

Integrate Shipbridge with Royal Mail’s API 

1. Go to Menu > Options > Carriers > Royal Mail. 
2. Enter the following credentials:
   1. Account Number: This is the 10 digit Customer Account Number allocated by RM
   2. Username: API username which will be supplied by RM
   3. Password: The plain text password will be provided to you by RM. You will be able to set a different password when installing the certificate. Password constructed as defined in WS-Security. Username Token Profile (with the SHA-1 hash of the plain text password) used as the password information. 
3. Check Use Royal Mail. 

Install the Certificate

1. You will receive an email from the Royal Mail Group Certificate Authority with a URL. 
2. Click the URL to download a ZIP File. Extract the file. 
3. Inside the file will be instructions on how to install the Certificate. Follow the instructions. The instructions should read:
   1. Start the Welcome to the Certificate Import Wizard > Click Next. 
   2. The browser should default to where the certificate is located. If it does not, find the location of the extracted file and keep clicking in until you find the file that ends on page 12.
   3. Enter the certificate password (provided to you by RM). You must also check the Enable strong private key protection option and leave unchecked the Mark the private key as exportable option (these are strict requirements of RM Security Policy).
   4. Click Next.
   5. Leave the automatic setting > Click Next.
   6. A summary screen will show > Click Finished. 
   7. You will be prompted with a number of Microsoft CryptoStore dialogue boxes > Select Set Security level.
   8. RM Group’s certificate security policies require that you must select the High setting > Click Next. 
   9. You can now set a different password if desired.  
   10. PASSWORD FOR: A reminder of the password > Click Next. 
   11. You will be taken back to the original screen > Click OK.
4. In Shipbridge, go back to the Royal Mail tab. 
5. Click the Select button next to the Certificate field > Select the newly imported certificate. 
6. Enter the password from step 2C in the Integrating Shipbridge with Royal Mail’s API section.
7. Set the Service Occurrence to 1.
8. Click on Test Credentials.
9. Save.