This is a python package for using the DHL webservice. It allows developers to easily connect to DHL services and make requests. The package creates SOAP requests using the suds-jurko package to create shipments, schedule a pickup and possibly to delete a created shipment. It also provides the ability to save the shipping labels to a file.

Python DHL is available through pip. To easily install or upgrade it, do

pip install --upgrade python-dhl

To send a shipment you need to create:

1. The DHL service
2. The sender
3. The receiver
4. The packages
5. The shipment that connects the sender, receiver and the packages

And then use the DHL service to send the shipment.

Initialize a new DHL service using

service = DHLService('username', 'password', 'accountNumber')

You can also use the DHL test mode

service.test_mode = True

Sender can either be a DHLPerson or a DHLCompany.

sender = DHLCompany(
            company_name='GitHub',
            person_name='Git Hub',
            street_lines='275 Brannan Street',
            city='San Francisco,
            postal_code='94107',
            country_code='US',
            phone='11111111',
            email='git@github.com'
            )

Receiver can also be either a DHLPerson or a DHLCompany.

receiver = DHLPerson(
            person_name='Jon Doe',
            street_lines='276 Brannan Street',
            city='San Francisco,
            postal_code='94107',
            country_code='US',
            phone='11111111',
            email='jon@github.com'
            )

The packages are DHLPackage objects and are supposed to be in a list.

packages = [
    DHLPackage(
        weight=0.15,
        width=10,
        length=10,
        height=10,
        price=100,
        description='Good product'
    ),
    DHLPackage(
        weight=0.15,
        width=10,
        length=10,
        height=10,
        price=100,
        description='The best product'
    )
]

Shipment is a DHLShipment object and connects the sender, receiver and the packages.

shipment = DHLShipment(sender, receiver, packages)

By default, the shipment date is set to current date and time. You can change it by setting the

shipment.ship_datetime = datetime.now + timedelta(hours=1)

Note the date has to be in a future and it has to be valid (no weekends, holidays...)

Please check the DHLShipment class for the full list of possible options.

If you wish to request a courier pickup, set the variable and provide the latest pickup time.

shipment.request_courier = True
shipment.pickup_time = datetime.now + timedelta(hours=2)

By default the pickup time is set to 1 hour from the creation of the shipment.

You are now ready to send the shipment. Simply call

response = service.send(shipment)

Once the service is done, it stores the tracking number, identification number and the label in the DHLShipmentResponse. It also saves the dispatch identification number in case a pickup was requested as well.

You can save the label to a file (by default to folder labels/, you can change this by changing shipment.label_path)

shipment.save_label_to_file(response.label_bytes)

TODO

How to delete

TODO

How to track

TODO

How to get POD

TODO

How to get price quote for the package