Skip to main content


There are some key terms and concepts that you need to get a grasp of in order to
properly understand this documentation and how to use the GeoAPI.

Core phraseology


DPD label that is placed on the outside of the box.

Contains the dispatch and destination routing information,
including the final sender and receiver addresses.


One or more parcels transported by DPD.

Parcels in a single shipment share the same routing information, that is, they share the same dispatch and destination locations.


The physical "boxes" or "packets" which the shipment consists of.

Each parcel has its own label. Some parcels may even have multiple labels (more on that later).


Some shipping services don't allow multiple parcels in a single shipment.

Pick up

The act of a courier coming to collect shipments and their parcels.

At this moment the shipment enters the delivery transportation process.

Pickup up order

A request for a pick up to be made. There are two types of pickup orders:

  • Pickup order for a specific customer address - The courier picks up all packages that are given to him on the specified address
  • Pickup order for a specific shipment - The courier picks up specific parcels at the dispatch location of the shipment

Pick up point

The physical retail store that is a partner of DPD.

The recipient may choose to pick up his/her shipment at a pick up point.

Shipping service

Services that are provided by the DPD and can be applied to a shipment.

For example, the DPD may provide services like the following:

  • D-TYRE - Tire delivery service
  • PM2 - Guaranteed delivery until 18:00
  • D-B2C-COD - Private address / B2C dobírka

Not all DPD shipping services might be supported by the GeoAPI.

More info about supported services can be found here

Shipping service element

Shipping services are a combination of smaller service elements.

That is, a specific combination of service elements makes up the final shipping service that is applied to the shipment.


  • The PM2-COD shipping service (guaranteed delivery until 18:00 with COD) is made up of:
    • DPD18 service element
    • COD service element

So if we combine the DPD18 and COD service elements, we get the PM2-COD shipping service

Multi-parcel shipment (MPS)

Shipment consisting of multiple parcels.


Cash on delivery

User account

Each user of the GeoAPI is authenticated by an API key.

The API key uniquely identifies the corresponding user account.

A single user account can manage multiple registered customers

Customer (registered)

Customer (registered) is a DPD wide entity.
It represents the actual trade unit that has a contract with the DPD.
Shipments and other requests have to be created on behalf of a DPD customer.

A single user account can be used to manage multiple DPD registered customers.
Such use cases may occur when a "DPD customer" has the need for multiple billings (e.g. one for domestic deliveries and one for foreign deliveries).

Customer DSW

DPD wide unique ID of a single customer.

Can also be refered to as the "customer number"

Customer address (registered)

A warehouse or an other physical location that has been "registered" for a specific customer.

These locations are registered under a customer so that you don't have to fill in the full address each time you create a request to the API.

Each customer can have multiple registered customer addresses.

IT4EM customer address ID

A DPD wide identificator of customer addresses

You should receive this ID from the DPD support team for all your registered addresses.