Onboarding

Learn how to send us your tracking data via one of our flexible integration options and set up your communications.

Sending Data to parcelLab

For us to track your deliveries, you need to send us the information of each and every parcel. You can do that by calling our API, sending us .csv, .json, or .xml files, or including parcelLab on BCC of your dispatch confirmation. The details on how to access our system can be found in our documentation on the data integration methods that can be used to send and receive order and tracking data with parcelLab.

Data Integration

To create trackings and orders to enable us to communicate with your customers, you will need to send us the following:

• Delivery information

• Any order and customer information

A good reference payload looks like this:

Order API v2 LTS

{
    "courier": "ups",
    "tracking_number": "1Z00PL161200000001",
    "orderNo": "ORD-123",
    "recipient": "parcelLab Gmbh, Julian Krenge",
    "recipient_notification": "Julian",
    "street": "Kapellenweg 6",
    "zip_code": "81371",
    "city": "München",
    "destination_country_iso3": "DEU",
    "email": "[email protected]"
}

Order API v4 Enhanced (preview)

{
    "account": 1234567,
    "order_number": "PCL-1235",
    "reference": "REF-1234",
    "client_key": "1234",
    "destination_country_iso3": "DEU",
    "recipient_name": "Max Mustermann",
    "shipping_address": {
        "first_name": "Max",
        "last_name": "Mustermann",
        "city": "Berlin",
        "country_iso3": "DEU",
        "region_code": "BY",
        "postal_code": "12345",
        "address_line": "Kapellenweg 2"
    },
    "delivery_method": "Standard",
    "recipient_email": "[email protected]",
    "articles_order": [
        {
            "line_item_id": "57",
            "quantity": 1,
            "article_name": "Trendy White Cotton Sneakers"
            "color": "White",
            "size": "9",
            "sku": "AP-SH-TWC-2315"
        }
    ],
    "mutations": [
        {
            "type": "add_tracking",
            "tracking": {
                "tracking_number": "PCLX-123123",
                "courier": "pclx",
                "articles": [
                    {
                        "line_item_id": "57",
                        "quantity": 1,
                        "article_name": "Trendy White Cotton Sneakers",
                        "color": "White",
                        "size": "9",
                        "sku": "AP-SH-TWC-2315"
                    }
                ]
            }
        }
    ]
}

For more details about our data model and all possible fields, see our data model documentation for the API v2 LTS and API v4 Enhanced (preview).

Setting Up Communications

Once the data is in our system, we take care of the rest by doing the following:

• Track deliveries

• Identify and record relevant updates

• Send communications to your customers through various channels (for example: email, SMS, and in-app push notifications)

Use the following resources to see further information on how you can set up your communications:

• Customize your communications to deliver a personalized experience for your customers at each stage of the delivery journey.

Journey Manager

• Build a branded experience by creating your own Order Status page within your shop to provide key order updates for your customers and drive traffic back to your online shop.

Order Status Page

• Check out our carrier integrations (parcelLab can integrate with any carriers you are using) to find the best option for you and we'll take it from there with superb carrier data quality to track deliveries and communicate delivery status updates.

Carrier Integrations

For more details about the status codes that are mapped to each tracking update, see our status model documentation.