๐Ÿ“ฆ Parcel carriers

This list is not complete as of today. For further carrier reach out to support@parcellab.comโ€‹

The countries listed below only serve as an indicated of the destination country the carriers can be used for. Cross-border shipments might be tracked through their origin carrier.

Global ๐ŸŒ

DHL Express

For DHL Express, parcelLab accesses the following interface:

DHL Express Global Web Services

The following two areas are needed:

  • Trackingrequest (Track & Trace)

  • Documentretrieve EPOD (proof of delivery)

For this interface, access data must be requested from the DHL Express contact person by indicating the customer number. These are usually provided at short notice and consist of:

  • Username

  • Password

UPS

Access to the UPS API is gained via credentials that can be used to log in to the UPS Portal. If no account exists yet, one must first be created.

For private access to the UPS API, an access key must additionally be created. This is done at https://www.ups.com/upsdeveloperkit/manageaccesskeys?loc=en_US using the link "Manage Access Key".

In this template an access key can be generated if none exists yet:

At this point, the UPS system indicates that at first UPS customer numbers must be linked to the existing account.This is done by a self-service verification that requires a current invoice. Afterward, an access key (also called token) is displayed: A 16-character hexadecimal string.

ParcelLab requires the following three credentials:

  • Username: The username for the UPS portal that generated the access key (token).

  • Password: Associated password

  • Access Key: The created token.

FedEx

At first, there must be active access to the FedEx Portal.

This access must then be linked to the sender account. Afterward, you get the first important information, the Account Number.

Secondly, production credentials must be requested for the web service. This happens by clicking on the button Get Production Key. Upon successful request, both the production key and the meter number will be displayed.

Finally, after a successful request of the production key, the production password will be sent to the deposited email address.

TNT

For TNT, we would need you to ask your key account manager at TNT for the credentials for the

TNT Express Connect Webservice

You will receive a username and password for access that need to be shared with parcelLab.

USA ๐Ÿ‡บ๐Ÿ‡ธ

OnTrac

With OnTrac we integrate through the so called

Web Service Integration

The required credentials are:

  • Username

  • Password

When asking for those credentials, please mention that the parcelLab integration follows the OnTrac Application Restrictions:

  • parcelLab only tracks shipments that are already tendered to OnTrac.

  • After successful delivery, shipments are not tracked anymore.

  • Shipments are tracked at a maximum of 5 times per day.

  • No historical data is retrieved through the integration.

Germany ๐Ÿ‡ฉ๐Ÿ‡ช

DHL Germany

To unlock the private interface for DHL, you need the following two pieces of information:

  • ZT-ID: User ID for sender like ZT123456

  • Passwort: Associated password, usually not very creative โ˜บ

This access is also the login to the web portal for the business customers Track & Trace. Therefore, the activation of the interface at the DHL contact must be explicitly requested. This interface is called:

Business Customers Track & Trace (DASS)

Once the interface has been activated, parcelLab will increase the API limits for the interface on behalf of the sender. This is usually done in a few hours.

For large volumes it might be suitable to additionally activate Proactive Reports. For this we are using the EREIGNIS-REPORT (REPSRD). This can be set up by your account manager as well.

Hermes Germany

For Hermes, we use the interface called SISy-R-API for tracking. Please ask your contact person at Hermes for the activation of this interface. Please also ask for the release of the function GetExpectedDeliveryByID.

As credentials you only get a very long token: usually a 288-digit hexadecimal code.

For large volume clients we recommend opting for status data transfer via flatfiles. Please ask your contact person at Hermes for the STAT files via SFTP with hourly transfer and also "Zustellprognose Flatfiles".

GLS Germany

At GLS we use the so-called package tracking via URL / web service, specifically the Track & Trace service. Username and password are required for this interface.

The access data for the interface usually are exactly the access data that can also be used for the portal under gls-group.eu in the section YourGLS / GLS-ONE (see screenshot):

  • Username: Usually a 10-digit number, if necessary followed by a word

  • Password: Associated password

DPD Germany

The activation for the private DPD interface takes place via the contact person in the depot. The activation for the following interface in live operation must be requested:

DPD Cloud Webservice for Tracking (provision of information / DPD Tracking Service), parcelLab partner interface

Please be sure to state that this is the parcelLab partner interface.

DPD provides two credentials for this, all of which are needed to retrieve the interface through parcelLab:

  • UserCredentials CloudUserID: six- to eight-digit number

  • UserCredentials Token: 15-digit alpha-numeric code

The live URLs (endpoints) to the DPD Cloud web service will continue to be communicated. Of these, only those from category "REST (GET)" are needed.

For large clients, we recommend opting for the data transfer via files. Please ask your contact person at the DPD depot for "Scandaten STATUSDATA" on a tracking number level via SFTP on an hourly basis.

Liefery

For Liefery we use webhooks as data transmission. Thus, you have to provide your contact at Liefery with the format and authentication method by which the data should be sent to parcelLab.

The following authentication method and format should be used:

Liefery authentication
curl -X POST \
https://api.parcellab.com/hook-liefery \
-H 'Content-Type: application/json' \
-H 'token: parcelLab-token' \ // this token will be provided by parelLab
-d '{ "shipment": {} }'

The corresponding token will be provided by parcelLab.

Austria ๐Ÿ‡ฆ๐Ÿ‡น

Austrian Post

Electronic data exchange with Austrian Post is file-based. The following interface can be requested from the contact person at Austrian Post:

Customer interface for the provision of tracking data

The following information must be specified:

Debitor customer number

This is your customer number at Austrian Post

Company name

Name of the own firm

Contact person

Including name, phone number and email

Desired data format

XML

Desired data protocol

SFTP by call of post servers

Time slot for data transmission

Hourly

Hermes Austria

For Hermes in Austria (no cross-border shipments, only for domestic shipments), we rely on this interface:

Hermes AT Tracking Data Interface V 2.0

In order to gain access, the key account manager at Hermes needs to be contacted and be supplied with the following two information:

  • IP of server to access Hermes systems

  • Public Key file used for authenticating access

Both will be provided by support@parcellab.com on request.

DPD Austria

DPD Austria currently still features a different setup than the other countries. Hence, we use the interface described as:

Flow type: STATUSDATA (status data central database) File type: CSV with field definition

You key account manager at DPD Austria can have that interface activated. You will receive credentials for a FTP server in return, that need to be provided to parcelLab.

Switzerland ๐Ÿ‡จ๐Ÿ‡ญ

Swiss Post

To activate the private interface at Swiss Post, an existing business customer login for the portal is necessary. The Swiss Post Web Service Support can be requested by an email to webservice@swisspost.ch to activate the following interface:

"Track consignments" web service

Subsequently, a new "Technical User" is created in the portal with whose access data the integration of the interface can be carried out.

UK ๐Ÿ‡ฌ๐Ÿ‡ง

DPD UK

Access to the DPD UK API is made using access data that can be used to log in to the MyDPD Local Portal (see screenshot).

To enable the private interface for DPD UK Local, the following two pieces of information are required:

  • Username: User ID for the sender (if applicable, Name of the shop)

  • Password: Associated password

If the username does not work directly, try writing the full username big or small.

Attention: DPD UK is different from DPD UK Local

Hermes UK

In order to retrieve Hermes UK parcel information parcelLab has to authenticate with the following web service:

Parcel tracking Web Service

You will have to provide Hermes with a list of IPs to be whitelabeled:

18.197.59.25 and 3.123.172.160

Please request the following credentials of the interface at your contact at Hermes UK:

  • Group ID

  • Licence Key

UK Mail

If you already have an ipostparcels PRO username and password then you can use the same username and password with the API.

To register new usernames and passwords please visit https://www.ukmail.com/register (Live).

Note, if you don't have an account number, your UK Mail account number must be requested through your UK Mail sales executive.

Once you have received an account confirmation, you have to forward the following credentials to parcelLab:

  • Username: Typically the email address you have entered during the registration process,

  • Password: Corresponding password.

France ๐Ÿ‡ซ๐Ÿ‡ท

Chronopost

The following two credentials are required to access the private interface of Chronopost:

  • Chronopost contract number (numรฉro de contrat)

  • Chronotrace password

If the password is not available, it can be obtained from the responsible Chronopost's sales representative.

Colis Privรฉ

For Colis Privรฉ, we are using the interface described as:

Electronic Data Exchange between Colis Prive and Customers Version 1.7 or newer Tracking files in \vers_ CUSTOMER

Exchange of data files is handled via SFTP. Hence, you will receive a pair of credentials with username and password and also the address of the server from your key account manager.

Mondial Relay

Mondial relay offers a suite of web services, parcelLab integrates with. We do need access to

WEB SERVICE Parcel tracking (WSI2_TracingColisDetaille) and Point Relais search (WSI3_PointRelais_Recherche)

This access is granted through two credentials:

  • Enseigne (brand): the merchant id code, 8 fixed characters

  • Private key: a secret key required for authentication

With these credentials, the parcelLab system can generate the security key needed for accessing the status information.

Spain ๐Ÿ‡ช๐Ÿ‡ธ

SEUR

With SEUR , we integrate with the following web-service:

Shipments Trace and Tracking SEUR Webservice.

To retrieve tracking informations parcelLab needs the following information:

  • User: alphanumeric value (min 4 characters - max 25 characters)

  • Password: alphanumeric value (min 6 characters - max 12 characters)

The required credentials can be requested at your point of contact at SEUR.

Italy ๐Ÿ‡ฎ๐Ÿ‡น

GLS Italy

In order to retrieve tracking information parcelLab uses the following interface:

GLS Italy Track & Trace

The following data is required to get access to this interface:

  • codicecontratto / contract code: This is your GLS Italy contract code

  • siglasede: Which is a set of alphanumeric codes for all departure locations

BeNeLux ๐Ÿ‡ง๐Ÿ‡ช๐Ÿ‡ณ๐Ÿ‡ฑ๐Ÿ‡ฑ๐Ÿ‡บ

Post NL

We are working with the Post NL API:

Your account manager at PostNL can request API keys for production with access to the ShippingStatus, Deliverydate, and Timeframe APIs - the number ranges are then assigned directly.

For creation of the credentials, you can also reach out to PostNL's service desk at citservicedesk@postnl.nlโ€‹

bpost

In order to retrieve bpost parcel information parcelLab has to authenticate with the following web service:

bpack parcel trackingInfo web service.

For authentication, you have to provide parcelLab with the following details:

  • Account ID: E-tailerโ€™s Account ID

  • Password: The password for this interface can be requested by sending an e-mail to shippingmanager@bpost.be.

DPD BeNeLux

For DPD BeNeLux/ DPD Netherlands we integrate through the

DPD Integration Services / Parcel LifeCycle Service

In order for parcelLab to access status information, we do require a set of credentials:

  • DelisId: Delis ID provided by DPD.

  • password: password associated with the Delis ID.

  • customerUid: customer ID provided by DPD.

Poland ๐Ÿ‡ต๐Ÿ‡ฑ

DHL Poland

DHL Poland currently still features a different setup than the other countries. Hence, we use the interface described as:

DHL Poland TntWebService (DHL Express Poland Webservice T&T)

DHL provides two credentials for this, all of which are needed to retrieve the interface through parcelLab:

  • clientId: unique ID of the DHL customer

  • password: a password connected with the clientId that allows to find shipments

Both can be requested at your contact at DHL Poland.

Poczta Polska

With the Polish Post, we integrate with their web-service at tt.poczta-polska.pl. The necessary credentials can be requested via email at sledzenie@poczta-polska.pl **with providing the following information:

  • Your company name (or name of the company engaged in the contract with Poczta Polska)

  • Number of of shipments per request: 20-50

  • Technical contact details: support@parcellab.com

You will have to provide Hermes with a list of IPs to be whitelabeled:

18.197.59.25 and 3.123.172.160

Czech Republic ๐Ÿ‡จ๐Ÿ‡ฟ

PPL

Access to the PPL CZ API is gained via the MyAPI credentials. These must be inquired at ithelp@ppl.cz.

The following data is required:

  • ID: seven-digit number

  • UserName: nine-digit combination of letters and numbers (the first 2-3 letters, if applicable is a combination of the shop name and the remaining numbers are identical to the ID)

The password is identical to the UserName.

It is important, that it's the the MyAPI credentials and not the klient.ppl.cz credentials. Questions regarding the API can be directed to edi.customers@ppl.cz.

Slovenia ๐Ÿ‡ธ๐Ÿ‡ฎ

Poลกta Slovenije

With the Slovenian Post we are working the web interface called:

"Shipment Tracking" online service

The required credentials are three entries:

  • Customer number

  • Contract number

  • Branch number

These credentials are provided by your point of contact at Slovenian Post.