Importing Shipments into DHL Express

This task will create shipments in your DHL Express account, from an XML file. The task does not support updating existing shipments.

Settings

DHL Express Connection

Required
The DHL Express connection to use. See the Connecting to DHL Express article if you require more information on how to create/manage connections.

Fail File

Required
The name of the file to write failed records to. The data will be output in the same XML format as the Input File. A sample can be found below.

Input File

Required
The name of the file containing the data you want to import into DHL Express. The data must be in XML format, a sample of which is shown below.

Success File

Required
The name of the file to write successfully processed records to. The data will be output in the same XML format as the Input File. A sample can be found below.

Prevent Reprocessing

Required
Set to 'True' to prevent the same record being processed more than once. This works based on the value of the ExternalId element provided within the Input File.

Strict Validation

Required
Set to 'True' to enable strict DCT validation of address details, and validation of product and service combinations.

Zynk Settings

See Common Task Settings

Examples

The example XML below shows the minimum amount of information required to create a shipment in DHL Express. For further information about all of the available fields, please refer to the MyDHL API documentation.

<?xml version="1.0" encoding="utf-8"?>
<Shipments>
  <Shipment>
    <ExternalId>12345</ExternalId>
    <PlannedShippingDateAndTime>2023-02-07T15:00:00 GMT+00:00</PlannedShippingDateAndTime>
    <Pickup>
      <IsRequested>true</IsRequested>
    </Pickup>
    <ProductCode>N</ProductCode>
    <Accounts>
      <Account>
        <TypeCode>shipper</TypeCode>
        <Number>123456789</Number>
      </Account>
    </Accounts>
    <CustomerDetails>
      <ShipperDetails>
        <PostalAddress>
          <PostalCode>NE1 4XF</PostalCode>
          <CityName>Newcastle</CityName>
          <CountryCode>GB</CountryCode>
          <AddressLine1>6-8 Charlotte Square</AddressLine1>
          <AddressLine2 />
          <AddressLine3 />
          <CountyName>Tyne &amp; Wear</CountyName>
          <CountryName>United Kingdom</CountryName>
        </PostalAddress>
        <ContactInformation>
          <Phone>01918201484</Phone>
          <CompanyName>Zynk Software</CompanyName>
          <FullName>John Smith</FullName>
        </ContactInformation>
      </ShipperDetails>
      <ReceiverDetails>
        <PostalAddress>
          <PostalCode>NE1 4XF</PostalCode>
          <CityName>Newcastle</CityName>
          <CountryCode>GB</CountryCode>
          <AddressLine1>6-8 Charlotte Square</AddressLine1>
          <AddressLine2 />
          <AddressLine3 />
          <CountyName>Tyne &amp; Wear</CountyName>
          <CountryName>United Kingdom</CountryName>
        </PostalAddress>
        <ContactInformation>
          <Phone>01918201484</Phone>
          <CompanyName>Zynk Software</CompanyName>
          <FullName>John Smith</FullName>
        </ContactInformation>
      </ReceiverDetails>
    </CustomerDetails>
    <Content>
      <Packages>
        <Package>
          <Weight>1.5</Weight>
          <Dimensions>
            <Length>10</Length>
            <Width>10</Width>
            <Height>10</Height>
          </Dimensions>
          <CustomerReferences>
            <CustomerReference>
              <Value>134971452</Value>
              <TypeCode>AAO</TypeCode>
            </CustomerReference>
          </CustomerReferences>
        </Package>
      </Packages>
      <IsCustomsDeclarable>false</IsCustomsDeclarable>
      <Description>Some nice stuff</Description>
      <Incoterm>EXW</Incoterm>
      <UnitOfMeasurement>metric</UnitOfMeasurement>
    </Content>
  </Shipment>
</Shipments>