Event Bus Integration

Use our event bus integration to provide access to your event bus systems so parcelLab can connect and receive order and tracking data into our system.

Overview

You can use an event bus system set up internally and expose it to our system via the event bus integration so parcelLab can connect to it and ingest the data to start receiving new orders and trackings. It is currently possible to integrate with Kafka.

If you use other systems (for example: SQS and RabbitMQ), parcelLab can extend our service to make these available with the event bus integration. For further details, please contact your parcelLab representative.

Configuring the Event Bus Integration

The following sections describe the configuration required for the event bus integration.

Customer Requirements

Event bus integrations accept the same type of data as the data model for trackings and require that you provide us the same fields as those marked as required in the data model.

To integrate an event bus system with parcelLab, you need to provide information to us depending on the system you use.

For Kafka, the following information is required:

• Your user ID in the parcelLab system

• The broker URL address that the service will connect to

• The username and password of your broker for us to connect to it

If you expose a different authentication system, parcelLab will need to check the details of how to connect to this system. For further information, please contact your parcelLab representative to discuss authentication options.

• Your group ID set up in your broker that our worker(s) will connect to

• The topic that the worker needs to subscribe to start receiving messages

It would also be useful to have an additional topic we can connect to that can receive test messages and assist in the onboarding process.

Implementation Process

When the required information is provided, parcelLab can connect to your event bus system. When the data is received at parcelLab from your event bus system, the data is translated into our payload format for us to process the order and tracking event information.