Importing Invoices into DHL Express

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

Note

The ability to upload invoices to DHL is not enabled by default. To use this task, you will need to contact your DHL Express IT representative and ask them to enable the UploadInvoiceData service.

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.

Zynk Settings

See Common Task Settings

Examples

The example XML below shows the minimum amount of information required to create an invoice 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"?>
<Invoices>
  <Invoice>
    <ExternalId>12345</ExternalId>
    <ShipmentTrackingNumber>8232969010</ShipmentTrackingNumber>
    <InvoiceData>
      <Accounts>
        <Account>
          <TypeCode>shipper</TypeCode>
          <Number>123456789</Number>
        </Account>
      </Accounts>
      <Content>
        <ExportDeclarations>
          <ExportDeclaration>
            <LineItems>
              <LineItem>
                <Number>1</Number>
                <Description>Line 1</Description>
                <Price>10</Price>
                <Quantity>
                  <Value>1</Value>
                  <UnitOfMeasurement>BOX</UnitOfMeasurement>
                </Quantity>
                <ManufacturerCountry>GB</ManufacturerCountry>
                <Weight>
                  <NetValue>10</NetValue>
                  <GrossValue>10</GrossValue>
                </Weight>
                <CustomerReferences>
                  <CustomerReference>
                    <TypeCode>AFE</TypeCode>
                    <Value>customerref1</Value>
                  </CustomerReference>
                </CustomerReferences>
                <CustomsDocuments>
                  <CustomsDocument>
                    <TypeCode>972</TypeCode>
                    <Value>custdoc445</Value>
                  </CustomsDocument>
                </CustomsDocuments>
              </LineItem>
            </LineItems>
            <Invoice>
              <Number>INV-12345</Number>
              <Date>2023-02-05</Date>
              <Function>import</Function>
              <CustomerReferences>
                <CustomerReference>
                  <TypeCode>ACL</TypeCode>
                  <Value>INV-12345</Value>
                </CustomerReference>
                <CustomerReference>
                  <TypeCode>CU</TypeCode>
                  <Value>INV-12345</Value>
                </CustomerReference>
              </CustomerReferences>
            </Invoice>
            <Remarks>
              <Remark>
                <Value>This is an invoice</Value>
              </Remark>
            </Remarks>
            <AdditionalCharges>
              <AdditionalCharge>
                <Value>5</Value>
                <TypeCode>admin</TypeCode>
              </AdditionalCharge>
            </AdditionalCharges>
            <Exporter>
              <Id>123</Id>
              <Code>EXPCZ</Code>
            </Exporter>
            <CustomsDocuments>
              <CustomsDocument>
                <TypeCode>972</TypeCode>
                <Value>custdoc445</Value>
              </CustomsDocument>
            </CustomsDocuments>
            <Incoterm>EXW</Incoterm>
          </ExportDeclaration>
        </ExportDeclarations>
        <Currency>GBP</Currency>
        <UnitOfMeasurement>metric</UnitOfMeasurement>
      </Content>
    </InvoiceData>
  </Invoice>
</Invoices>