Introduction & Prerequisites
Kornit X has created a shipper integration to allow fulfillers to generate Royal Mail shipping labels using Royal Mail V4. Once all items in an order have been scanned at the dispatch scan point, a final scan of any item in the order will create a shipment in Royal Mail and return a Royal Mail shipping label. This integration is provided by a subsidiary of Royal Mail named Intersoft. Create an Online Business Account (OBA) with Royal Mail and provide The KornitX team with the OBA Email, Account ID, a "ship from" address including telephone number, and Posting Location Number.
We will set up an account with Intersoft for you. This will trigger an electronic approval request with Royal Mail, who (subject to the information provided being valid and correct) will approve the account within 2-5 working days. We will then provide you with a shipping account ID and a shipping location ID, to be used in the shipping integration settings.
To sign in or register for an OBA account please follow this link -
Click Here
If you have a Royal Mail account all you need to do is head to your dropship company and within the Shipper Integration window select the "Royal Mail V4" option shown below.
Once you click the option you need to add your Shipping Account ID ad Shipping Location ID while ensuring the "Is Enabled" toggle is enabled like the below screenshot shows. We will provide you with these details
Features Of This Integration
You can also set multiple options that you can enable once you have connected with Royal Mail and these are the following include the following. Please note that not all of the below features need to be enabled or filled in, these options are available to give users the best service. The features are listed in the way they are within the Platform.
"Enabled" toggle - When the shipper integration has been turned on this toggle will be set to on. To disable the integration simply slide this to off.
"Secondary Orders" toggle- This option should be enabled if your orders have both a primary and secondary company set on them. In most cases, this option will need to be enabled unless you are advised otherwise by Kornit X staff.
"Consolidate Labels" toggle -
"Start Timestamp" textbox - The start date/time of the integration. Only orders created after this date/time will have a shipment created against them when the Ahead of Time option is enabled.
"Dropship Delegation" toggle- Dropship delegates allow an integration to be set up once on a single dropship company and the integration settings apply to all dropships that are linked to that fulfiller. A dropship delegate can be set on any fulfiller company. If this is a feature you want to use, enable this option on the RM integration settings of the dropship delegate that's set on the fulfiller company.
- "Ahead of time" enabled toggle - With this toggle enabled, the system will attempt to create a shipment against the order, making the call to the carrier, shortly after order creation. Once enabled there will be an option to add a start time stamp (UTC) which will mean that the integration will only try to ship orders that were created after this time.
"Wait Until Required Dispatch Date" toggle - Set by default only, when ahead of time is enabled orders that have required dispatch date will not have a shipment created until dispatch date reached
- "Shipment Strategy" dropdown - A shipment strategy can also be selected from the Shipment Strategy drop down. If nothing is selected, the default Combined Strategy is used. Please note if not using standard there are 4 different options including "Manual Override". "Individual Parcels", "Combined Parcels" and "Bundled Parcels".
- "Dimensions Strategy" textbox - The dimensions strategy field can be left blank to use the default dimensions, here are the examples. Client\RoyalMailV4\RoyalMailV4NoDimensionsStrategy - Package dimensions information is not sent in the shipment request, Client\RoyalMailV4\RoyalMailV4MaxWidthDepthDimensionsStrategy - The package dimensions are calculated using the largest item width, the largest item depth and the total height of each item in the order. Client\RoyalMailV4\RoyalMailV4SortedStackingDimensionsStrategy - Each order item is rotated to find the shortest edge. The sum of each items shortest edge is sent as the package height. The width and depth package dimensions are calculated using the largest item width and the largest item depth.
If you select a dimensions strategy that sends dimensions, you must ensure that all products have width, height and depth values set, in the products' eCommerce tab.
- "SKU Character Limit" textbox - With this textbox here you can set a number to limit the length of each SKU. This is useful if for the shipping labels you need to limit the length to 10 characters. Not setting this will just use the full SKU of say 20 characters that some products may use.
- "Client ID" and "Client Secret" textboxes - The Client ID and Secret fields should be left blank unless you are advised otherwise by a member of the Kornit X team.
- "Shipping Account ID" and "Shipping Location ID" textboxes - We will provide these fields for you as Intersoft will generate these for Royal Mail to be provided to you.
- "Shipping Service Strategy" Dropdown/Textbox - This is not required and is only used when the Standard options below do not fulfil the client needs, where this is the case a custom strategy can be made at an additional development cost. Users with one will not see dropdown only the path
- "Pre Registration Type" dropdown - This dropdown offers the options for Import One Stop Shop (IOSS) and Economic Operators Registration and Identification number (EORI) which need to be selected depending on whether or not the customer isn't paying for tax on their orders. If this is not set the end user would have to pay for the tax.
- "Pre Registration Number" textbox - The IOSS or EORI number associated with the selection made in the Pre Registration Type drop down.
There are additional features for this integration regarding the set up of your labels but we have documented this within the "Label Settings" section of this article.
A full list of Royal Mail carrier and service codes can be found on the Excel document attached to this article.
Service Strategy Breakdown
A service strategy named 'Standard Weight' is available. The strategy uses the same services as the 'Standard' service strategy and determines the format of the service (Letter, Large Letter or Parcel) based on the combined weight of the order. The weight breaks are listed below.
Weight under 25g is for Letter.
- Weight between 25g and 600g is for Large Letter.
- Weight greater than 600g for Parcel.
When using the shipping mapping rules on the system with weight ranges, the 'Standard' service strategy should be used to avoid conflict with the weight ranges in the Standard Weight service strategy.
Label Settings
There are settings that need to be enabled for labels and these have been documented below.
- "Include Contact Telephone" toggle - With this toggle enabled the contact telephone number will include being printed on the shipping label, meaning for every customer who leaves a telephone number when ordering will receive this on their package.
- "Include Contact Email" toggle - Same as the telephone, with this enabled the email that the customer used when placing their order will be included on the shipping label of all orders.
- "Enable Forced Tracking" toggle - Enabled by default this will ensure that for any untracked orders you will return a number that can be used to track within the status callback.
- "Company Name" textbox - Filling in this textbox will include your company name on the shipping labels.
- "Contact Name" textbox - This textbox can include a contact name from your company that will be included on all shipping labels, this could for example be a generic customer service contact.
- "Address" textboxes - Finally, the shipping label can include the return address of your company including Address Line 1-3, Town, County, Country Code and Postcode. Please note including this will ensure every shipping label generated will include the return address.
These are all set within the integration setup window but these are required to ensure all printed labels include the correct data you require.
Once the Royal Mail V4 shipping integration has been configured, you can generate Royal Mail shipping label PDF from within the Platform by taking the following steps.
From within Platform, go to Sales > Order Manager and locate the order you wish to create a shipping label for. When you have found the order you wish to ship, click on the whole order as shown below.
After clicking on the order, you will see the Items listed and within these items you will find the Item ID which you need to copy for the next step as shown below.
Finally, once the item ID has been copied, you need to head to Floor > Shipping Station and scan the barcode on the orders jobsheet or paste the Item ID in the Dispatch Item box to generate the shipping label PDF for the order.
Once the shipping label has been printed the order can be shipped.
Royal Mail Shipping Method & Service Codes
There are multiple different Carriers and Service Codes that can be used with Royal Mail. A full list of Royal Mail carrier and service codes can be found on the Excel document attached to this article. Below are some examples of common carrier and service codes used with this integration. Please note the carrier for ALL of the below is "Royal Mail". The Shipping Carrier on the order must be set to Royal Mail to correctly trigger the Royal Mail integration.
Method | Service Code | Format Code | Tracking Notification | Local Collect | Safe Place | Consequential Loss | Recorded Signed For | Saturday Guaranteed |
Standard Untracked 24 letter | CRL1 | L | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Standard Untracked 24 large letter | CRL1 | F | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Standard untracked 24 | CRL1 | P | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Standard untracked 48 letter | CRL2 | L | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Standard untracked 48 large letter | CRL2 | F | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Standard untracked 48 | CRL2 | P | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
First class letter | STL1 | L | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
First class large letter | STL1 | F | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
First class | STL1 | P | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Tracked 24 letter | TPMN | L | ✔ |
| ✔ | ✔ | ✔ | ✔ |
Tracked 24 large letter | TPMN | F | ✔ |
| ✔ | ✔ | ✔ | ✔ |
Tracked 24 | TPMN | P | ✔ |
| ✔ | ✔ | ✔ | ✔ |
Please note that with any methods like "Tracked 24" or "Untracked 24" this assumes that a parcel is being sent, this is why letter and large letter sections are both different.
Required Product and Company Setup
The products that are going to be sold as orders through the integration must include a weight in grams and an RRP price with a quantity of 1 must be set. The weight can be set within the Ecommerce Data fields of a product as shown here.
As for the RRP price this can be added within the E-commerce the same as weight but within the Pricing tab shown below.
You can define the currency per each product price but this is easier to set on the companies Basic Details.
Manifesting In Order Manager
Royal Mail manifesting should be produced when all orders for the day have been sent, this must be completed as an end of the day process which must be printed off and handed over with your mail. Failing to handover manifest paperwork with items can lead to additional charges being raised against your Royal Mail account and mail being delayed.
For more information on how manifesting work please refer to the following Royal Mail written documentation -
Click HereTo access manifesting within Order Manager the orders first must have Royal Mail set as the carrier and you must filter to those orders from the day by setting the date to and from to the date. This is done by clicking the "See More" advanced filters as shown below and setting the date. On top of the date, you can filter the search to only show your orders carried by Royal Mail.
Now the orders are visible you can select the orders and click the "Manifest Shipment" button. This option is only visible on the interface when looking at orders carried by Royal Mail.
Once clicked you will see a warning for "Really manifest pending shipments?" and once confirmed the manifesting PDF will be generated and you will be able to print it. An example of a manifesting document can be seen below.
Please note that once shipments have been manifested there is no way to undo the action.
Shipping Label Examples
Below is an example of the kind of shipping label the system will generate for Royal Mail V4.
FAQs
We at Kornit X will offer support when setting this integration, the below are some common issues we wanted to highlight below.
My shipping_country is not being set?
The "shipping_country must use a 2-letter ISO code and this not being set is likely the cause. A full list of 2-letter ISO codes can be found linked here.
My products are not passing within orders?
This will likely be down to missing weight information against your products. To check this open the product and go to the "Ecommerce & Data" section of the product and ensure within the data that the "weight" field has been filled in. Without this being set the products will not pass correctly.