This article demonstrates the steps to set up a DHL carrier account.

Carriyo supports creation of multiple carrier accounts for a single carrier. These accounts usually differ from each other in the type of services used.

All fields with an asterisk (*) are mandatory fields.

Permissions: Only users with Account Manager, Account Owner/Admin roles are able to create and manage carrier accounts.

Setting up a DHL account

1. Navigate to Carriers > Accounts on the Carriyo Dashboard. The page displays a list of all carrier accounts that have been previously created. To create a new DHL carrier account, click on the add icon on the top right corner. Click on Select to proceed with the creation.

2. Fill in the Account Name and Account Country fields and click on Next to continue the process.

3. Enter the Account Number that DHL has provided and click on Next. If you need to contact DHL Express, click on the link provided at the bottom.

4. Enter all required details and click on Next. See what these terms mean here.

5. Click on Go to Account to complete the account setup process.

To set up the General, Label and Merchant settings, which are common for all carrier accounts, visit this article.

The rest of the sections are explained below:

Document Images

Upload your signature name and brand logo for it to appear on the commercial invoice besides the Signature and Stamp fields, respectively.

Authentication

• Shipper Account number: The 9-digit DHL Express Shipper Account Number that the carrier provides once an account has been created.  This number helps DHL identify the client.
• API Key: The API Key associated with your account. 
  
• API Secret: The API Secret associated with your account.

Note: Both API Key and API Secret are required for authentication purposes and booking shipments will only be possible if they key and secret associated with the account number are valid. You can reach out to your contact in DHL to obtain your DHL account number, API Key, and API Secret. Note that the above details might differ for staging and production.

• Payer Account number: Provide the account number of the payer if a different DHL Express account is paying for shipping charges.
• Duties & Taxes Account number: Provide the DHL Express account number of the account that's responsible for paying the duties and taxes, if neither the payer or shipper accounts are paying.

Product & Service

• Product Code: Specifies the product code required for shipping. The recommended product codes for domestic and cross border shipping are EXPRESS DOMESTIC - Document (N) and EXPRESS WORLDWIDE - Non Document (P), respectively.
• Other Service Codes: If you have registered for other additional value added services with DHL, you can specify it here.
• Customs Declarable: Enable this setting if the items you are shipping require customs declaration. Switching on this toggle will ensure that all item details are included in the commercial invoice for cross-border shipments, helping to ensure smooth transit of goods across borders and enabling accurate assessment of taxes and duties, thereby reducing the chances of packages being held, returned, or discarded by customs.
• Incoterm: For cross border shipping, choose the correct terms of trade for the goods based on the destination country. Eg: DDP – Delivery Duty Paid.
• Default Item Description: The default item description to be used in the label/AWB. The order of priority is parcel description -> first item description -> default description. If any of these are not present, the next value is used.

Additional Details

The below details should be filled based on the shipper's requirements. If provided, they will be sent to DHL accordingly.

For international shipments, the below details might be necessary if you need to distinguish between importer, exporter, buyer, and seller details and explicitly notifying the carrier that the contact information for each of these entities are different. Providing the registration numbers (tax IDs) based on the region/country that the goods are exported or imported (Issuing Country Code) to will also help DHL and customs authorities to validate the entities responsible for paying taxes and facilitate smooth customs clearance. 

This information provided in these sections will appear in the DHL Commercial Invoice to verify the legitimacy of the transaction, legal compliance (adherence to import/export laws) and proper taxation and customs clearance.

• Booking Requestor Details: This information should be filled if you require DHL to pickup shipments outside your home country where your DHL account is based.
• The sections for Default Exporter Details, Default Importer Details, Default Buyer Details, Default Seller Details should be filled in if you require these details to be displayed in the DHL Commercial Invoice. You can also add registration numbers based on the type of tax ID corresponding to the Issuer Country Code, if you already have these ready.
• Shipper Details & Receiver Details should be added if you wish to include additional Shipper & Receiver details in the DHL Commercial Invoice. Here, tax IDs should be provided if applicable.

Dangerous Goods

• Dangerous Goods Service Code: Specifies the Dangerous Goods Service Code provided by DHL. 
• Dangerous Goods UN Code: The UN Code that corresponds to the Dangerous Goods Service selected.
• Dangerous Goods Content ID: The content ID that corresponds to the Dangerous Goods Service selected.

Note: Providing this information beforehand will help DHL make the necessary arrangements for transporting dangerous or hazardous goods, while ensuring adherence to safety regulations and facilitating a smooth customs clearance process. You can reach out to DHL for the exact details.

Label 

Label Template: Specifies the template and size for the labels to be generated.

Waybill Document Template: Specifies the format of the waybill document to be generated.

Always download Waybill Document: If this switch is enabled, the Waybill document will be downloaded along with the label for all shipments, including paperless & domestic shipments.

Enable label-free returns: Switch on this toggle if you want to use DHL's paperless return process (label-free), where customers use a QR code for returns instead of printed labels. Ensure that this feature is enabled for your DHL account to use this service.

Commercial Invoice

• Invoice Type: Specifies the type of DHL commercial invoice to print. Eg: Commercial, Returns etc.
• Invoice Template: The template to use when DHL generates the commercial invoice from their side.
• Signature Name: The name of the person whose signature is used on the DHL commercial invoice.
• Signature Title: The title of the person whose name should appear in the DHL commercial invoice.
• Invoice Remarks: Additional remarks to be added in the commercial invoice (optional).
• Invoice Declaration: The brand specific declaration to be added in the commercial invoice (optional).
• Export Reason:  Specifies the purpose of exporting the goods (optional).
• Export Reason Type: This field specifies the export reason type provided by DHL (optional). 

All the above information will be used in the commercial invoice if provided. This will help ensure smooth customs clearance.

Callback Settings

These must be configured at the the carrier side so that carriers can send the statuses via webhook calls to Carriyo whenever the carrier has an update.

Copy paste the details and ask your contact in the carrier team to set up the webhooks on their side.