025161 MyDHL Windsor Framework changes
1. Overview
KCSL have enhanced the MyDHL courier integration to include the required changes for shipments to Northern Ireland under the Windsor framework.
2. Specification
A new courier option for UKIMS number has been added that will be exported across to the dll
A new customer option for UKIMS number has been added that will be exported across to the dll
In the MyDHL code, where the EORI and IOSS numbers are currently added to the request, a section that uses the new number (customer one if provided, fall back to courier one) has been added that gets sent through with a Number Type Code of EOR (same as EORI number).
The UKIMS number has been added to the export/import calls for
webservices
3. Configuration
An update and a changelog will be applied as part of this development. The additional configuration steps are as follows.
3.1 Customer UKIMS Number.
The UKIMS Number for each customer can be found on the [ Customer | Financial ] tab.
3.2 Courier Configuration UKIMS Number.
The UKIMS Number for each MyDHL courier can be found on the
[ System Data | Courier | Right click and select configure ].
3.3 Webservices.
The following webservice calls have been enhanced to include the new UKIMS Numbers.
a. ExportCompany
This includes the <UKIMS_NUMBER> field which comes directly from the [ Customer | Financials ] tab.
For example :
<UKIMS_NUMBER>UK000001</UKIMS_NUMBER>
b. ImportCompany.
When the import includes the <UKIMS_NUMBER> field, the UKIMS Number on the [ Customer | Financials ] tab will be populated.
c. ExportOrder
This includes the <UKIMS_NUMBER> field which comes from the Sales Order.
For Example :
<CUSTOMER_DETAIL>
<UKIMS_NUMBER>UK00001</UKIMS_NUMBER>
</CUSTOMER_DETAIL>
d. ImportOrder
When the import includes the <UKIMS_NUMBER> field, the UKIMS Number on the Sales Order is populated.
Note : This field is not visible on the Sales Order screen.
4. Usage
After applying the above Configuration, typical steps for usage would include the following.
1. When an order to a Northern Ireland destination is assigned to MYDHL for shipping, the exported file can now include a UKIMS Number for the shipper and the recipient.
For example :
a. If both the customer and the courier have UKIMS Numbers.
The exported Shipper Number will be the Courier UKIMS Number.
The exported Recipient Number will be the Customer UKIMS Number.
b. If the customer has a UKIMS Number but the courier does not.
The exported Shipper Number will be the Customer UKIMS Number.
The exported Recipient Number will be the Customer UKIMS Number.
c. If the courier has a UKIMS Number but the customer does not.
The exported Shipper Number will be the Courier UKIMS Number.
There is no exported Recipient Number.
d. If neither the customer or the courier have UKIMS Numbers.
There is no exported Shipper or Recipient Number.