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.
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.
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.
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.
PM2-CODshipping service (guaranteed delivery until 18:00 with COD) is made up of:
So if we combine the
COD service elements, we get the
PM2-COD shipping service
Multi-parcel shipment (MPS)
Shipment consisting of multiple parcels.
Cash on delivery
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) 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).
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.