Overview
Adding a new courier service to Mintsoft is done in three stages:
Adding the Courier Service.
Adding the Courier Service Codes.
Mapping the Courier Service Codes to the Courier Service.
CourierServiceID and CourierServiceCodeId
Understanding key terms such as CourierServiceID and CourierServiceCodeId is crucial for effective courier service mapping in Mintsoft. CourierServiceID refers to the activated courier service in the system available under Shipping Management > Couriers. On the other hand, CourierServiceCodeId represents the specific service code for each courier, managed under Shipping Management > Extras > Courier Service Codes.
Prerequisite - Adding the Courier Service
Before continuing with this article, please ensure you have added the Courier Service to the required Courier. Review Add new courier or courier service to database to learn more. Additionally, if you need to create duplicate courier services for marketplace-specific requirements, you can add a new service that mirrors the original but includes the marketplace name in the service name (e.g., "Express 24 (Marketplace A)"). This ensures that marketplace-specific needs are met while maintaining consistency in service codes and mappings.
Adding the Courier Service Code
We recommend downloading the spreadsheet provided at the end of this guide as your reference for required fields, this document will help you know what codes from the courier go into which fields on Mintsoft. To add a new courier service code please do the following: This process is also applicable for modifying existing courier service codes, ensuring they are updated with the latest codes provided by the courier.
Click Shipping Management then click Extras.
Click Courier Service Codes then click Add New Courier Service Code.
Select the Courier.
Add the codes provided by the courier into the relevant fields using the Mapping Spreadsheet provided at the end of this guide as your reference for required fields.
Please enter a Name in the Description field to help identify it later.
(Optional) Add enhancements in the ExtraCode fields using the Mapping Spreadsheet provided at the end of this guide as your reference for required fields.
Once you have added the relevant information to the service, click Create.
Bulk Adding Courier Service Codes
You can also add courier service codes in bulk by doing the following:
Click Shipping Management then Extras.
Next, click Upload.
Select CourierServiceCodes as the template, then click Download.
Complete the CSV file using the Mapping Spreadsheet provided at the end of this guide as your reference for required fields.
Once you have filled in the CSV, go back to Mintsoft.
Select CourierServiceCodes as the type to upload.
Click Choose File and select the spreadsheet.
Click Upload.
Mapping the Courier Service Code
Once you have added the courier service code, you will then need to map the courier service:
Click Shipping Management then Extras.
Next, click Courier Service Code Mappings then Add New Courier Service Code Mapping.
Find the Courier Service you added within the CourierServiceId dropdown.
Find the Courier Service Code you added within the CourierServiceCodeId dropdown.
You can search by Description.
Click Map.
Understanding Rule Changes and Their Implications
If you delete a Mapping rule and replace it with Courier Service Selection rules, orders previously covered by the Mapping rule will now be handled by the Courier Service Selection rules. Any remaining Mapping rules will continue to apply to their respective orders.
Courier service code reference
The tables below cover the most commonly configured fields for Royal Mail, DHL, and Evri â the couriers most frequently asked about. Use them as a quick reference when adding or updating service codes. For the complete field reference across all couriers, download the mapping spreadsheet at the end of this article.
Note: ExtraCode fields not listed below are left blank.
Royal Mail (Intersoft)
ExtraCode field | Values | Notes |
ExtraCode1 | 01, 02 | Service occurrence. |
ExtraCode2 | Varies by service | Service format. |
ExtraCode3 | Enhancement code | Separate multiple enhancement codes with ;. |
ExtraCode4 | TRUE, NONE | TRUE = use secondary tracking number. NONE = no tracking number. |
ExtraCode5 | SAFEPLACE | Enter SAFEPLACE to enable SafePlace delivery. |
ExtraCode6 | DDU (default) | Incoterm. |
DHL / DHL Express
ExtraCode field | Values | Notes |
ExtraCode2 | DDU (default), DDP, DAP | Export term. |
ExtraCode3 | TRUE, FALSE (default) | Returns label. |
ExtraCode6 | Account number | Duty account number. Only required if billing duties to a third party. |
ExtraCode7 | TRUE, FALSE (default) | Use client address as sender. |
ExtraCode8 | Depth;Width;Height (default: 10;40;30) | Dimensions. Separate values with ;. |
ExtraCode9 | HL, HE, HK | Dangerous goods special service code. |
Evri (Hermes) Business
ExtraCode field | Values | Notes |
ExtraCode1 | True, False | Signature required. |
ExtraCode2 | Amount in GBP | Compensation required. |
ExtraCode4 | True, False (default: blank) | Next day delivery. |
Evri (Hermes) Corporate
Note: For Evri Corporate, the Code field must be set to carrierCode and the Service field to deliveryMethod. This differs from the Evri Business setup above.
ExtraCode field | Values | Notes |
ExtraCode1 | 0 (none), 1 (telephone), 2 (SMS), 3 (email), 4 (SMS and email) | Notification type. |
ExtraCode2 | TRUE | Signature service. |
ExtraCode3 | TRUE | Next day. |
ExtraCode4 | AM, PM, EVE | Timed service. |
ExtraCode5 | U (unpaid), P (paid) | Duty paid. |
ExtraCode7 | True, blank (= false) | Household signature. |
ExtraCode8 | True, False | IOSS number sent. |
ExtraCode9 | Width;Depth;Length | Parcel dimensions. Separate values with ;. |
Mapping Spreadsheet
Please download the Courier Service Code Mappings spreadsheet, which details the required Mintsoft fields for each courier. This will guide you in correctly populating codes for different couriers.