Send Data to parcelLab
Send us your tracking and order data via one of our flexible integration options so we can track your deliveries and communicate status updates with your customers..
Overview
You need to send parcelLab the information of each and every parcel for us to create a corresponding record in our system and track your deliveries.
A tracking is the smallest data unit in the parcelLab system and is created when you submit a new parcel or pallet to be tracked by parcelLab. An order is usually created when you submit tracking information for one or multiple parcels or pallets along with a corresponding order number, although order details can also be submitted if you have them before the tracking information (for example: during the pre-dispatch process).
The recommended method for submitting data is via API through the order
endpoint as this provides greater flexibility for orders with multiple trackings. For further information, see how to create a tracking/order via API.
Submit Tracking Data
You can submit a new parcel or pallet to create a tracking in the parcelLab system. You need to provide parcelLab with the following information for each tracking to enable us to track your parcels:
For trackings - the carrier, tracking number, destination country, and zip code
For notifications - the name and email of the recipient, delivery address, and relevant reference numbers, like the order number
Submit Order Data
You can submit an order that at a later point in time will contain tracking information for one or multiple shipments, parcels, or pallets. Order creation normally happens implicitly by providing a corresponding order number when submitting tracking information.
If order details are available to you before the actual tracking information, you can explicitly submit order information in advance. This enables parcelLab to conduct certain activities, for example:
Monitor the lead time between order creation and dispatch
Trigger specific actions such as alerts or delay emails
With this order information already in the parcelLab system, you can send pre-dispatch communications, inform customers about split orders, as well as monitor warehouse SLAs.
An order is considered the earlier version of tracking before the tracking number itself has been assigned. Hence, creating an order behaves exactly the same and creates the exact same data structure as creating a tracking, but does not require the courier
and tracking_number
.
Sending the courier
and tracking_number
data when it is available will help connect future trackings to the order. The xid
or orderNo
will be used as primary identifier to overwrite or extend existing records.
If you update an order record with tracking information via API, you should use the order
endpoint again to submit the data. For further information, see how to update an order via API.
Data Integration Methods
You can use the following methods to send tracking and order data to parcelLab:
Our
order
endpoint allows you to submit tracking and order details through our powerful API integration to create the corresponding record in the parcelLab system.
File-based exchange supports file formats like .csv, .xml or EDIFACT and provides easy integration.
The email-based transmission is limited in terms of flexibility and data quality but offers a zero-effort integration into parcelLab.
Platform Integrations
The methods described above are our go-to integration options as they are fully platform-independent and work for anyone integrating with parcelLab. However, there are some additional specific platform dependent integrations that should make integration easier for customers using them that can be accessed via our App Store.
Last updated
Was this helpful?