Data Transmission

Choose one of our data transfer methods to send us your data with ease.

Overview

Data transfer is independent from the content of the transfer itself.

For more information on the content of the transfer, see the respective data models of scan/status events and live geo tracking.

You can use the following methods to send updates for scans and status events as well as live geo tracking to the parcelLab system:

• Calling the parcelLab API.

• Providing an API for parcelLab to call.

• Sending files to parcelLab.

An introduction to the transfer channels is described in the following sections.

Calling the parcelLab API

Our API is available at https://api.parcellab.com/ and accepts both JSON and XML payloads. All requests are POST and require a carrier specific access token. The specific APIs are listed in the respective sections for scan/status events and live geo tracking.

Providing an API for parcelLab to Call

parcelLab can also call your API. The following requirements are needed for APIs to be integrated:

• Connection to be established via https.

• GET and POST requests.

• Responses must be JSON or XML.

• Single-call authentication via Token, Basic Auth, Certificate, Whitelisted IP Range (that is: no Auth service to be called first).

To get started, you need to provide us with your API documentation. Please fill in our contact form and we'll get back to you.

Sending Files to parcelLab

The preferred transfer channel is via SFTP, where either the data can be downloaded by parcelLab or is automatically uploaded to parcelLab servers. For more information on data exchange, see how you can send us data via SFTP.

parcelLab expect data to be sent at least every 15 minutes, but data can also be sent in real time for each individual scan event (preferred).

Supported file formats include .xml, .csv, and EDIFACT. There is no strict file name convention, but all files are required to have a unique name and a proper file extension.