---
title: "Implement your Integration with Bringg as a Carriert"
slug: "implement-your-integration-with-bringg-as-a-carrier"
tags: ["On Demand", "IT Integrations", "Partner", "Delivery Hub", "DP integrations Portal", "Set up delivery providers", "Planned"]
updated: 2023-07-04T07:01:05Z
published: 2023-07-04T07:01:05Z
canonical: "help.bringg.com/implement-your-integration-with-bringg-as-a-carrier"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.bringg.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Implement your Integration with Bringg as a Carrier

As the IT integrator of a carrier, you can integrate your systems with the Bringg Platform to receive orders from shippers by adding Bringg's APIs and webhooks to your systems. Use the Bringg Integrations Portal to discover the APIs and webhooks needed, and access a dedicated staging site for you to test your integrations before going live.

Once you finish planning your integrations together with your business manager as well as with Bringg, map the names of your objects and fields with those Bringg uses. Then use the Integrations Portal to set up the Bringg APIs and webhooks. Once you have completed the set-up process, continue to the next topic to begin testing in staging and production.

![](https://cdn.document360.io/a18074ef-073a-4ab1-bcab-12625715280e/Images/Documentation/image-1678711651041.png)***Implement your Bringg integration to partner with shippers***

For example, set up an endpoint to receive webhook notifications from Bringg when a shipper creates, updates, or cancels a delivery request.

#### Before You Begin

- Contact your Bringg customer service representative to verify your login credentials to the Bringg Integrations Portal.
- Meet with your business manager to understand the data flows and their triggers between Bringg and your enterprise systems.
- Identify the technical capabilities you support such as quotes, driver location updates, proof of delivery, multi-package shipment, and so on.

#### Procedure

**Step 1**: Sign in to the Integrations Portal at [fleet.bringg.com](http://fleet.bringg.com) using the credentials Bringg gave you.

![](https://cdn.document360.io/a18074ef-073a-4ab1-bcab-12625715280e/Images/Documentation/image-1678711764697.png)***Open the Integrations Portal***

The Integrations Portal includes a unified implementation platform for both staging and production, step-by-step guidelines outlining the integration process, and access to all the necessary keys and endpoint URLs.

NoteYou can receive login credentials only once Bringg approves working with you. Contact your Bringg customer service representative to learn more.

**Step 2**: Review the API calls and webhooks Bringg used in the context of sample delivery flows, like happy flows as well as canceled and returned items.

![](https://cdn.document360.io/a18074ef-073a-4ab1-bcab-12625715280e/Images/Documentation/image-1678711899732.png)***Understand Bringg APIs and webhooks within different flows***

**Step 3**: Perform a detailed analysis with your colleagues from business and operations to identify the events which trigger a Bringg API or webhook, and identify the correct API or webhook to implement your integration.

TipBringg updates you about changes coming from the shipper using webhooks, while you update Bringg through APIs.

| When this happens... | Trigger this event... | Transfer this data... | Direction of flow |
| --- | --- | --- | --- |
| **Request API authorization** | **Get Token** (API) | You request an authorization token from Bringg using the **Client ID** and **Client Secret** for a particular shipper. [Learn more.](https://developers.bringg.com/docs/get-token) | carrier to Bringg |
| **New shipper registration** | **Merchant Registered** (webhook) | Bringg sends you the identification information of a shipper who registers to work with you. Your IT integrator can then access their credentials in the integration sandbox. [Learn more.](https://developers.bringg.com/docs/merchant-registered-webhook) | Bringg to carrier |
| **You need to retrieve credentials of a shipper who registers to work with you** | **Get Merchant Credentials** (API) | You want the technical credentials for the shippers who register to work with you. [Learn more.](https://developers.bringg.com/docs/get-merchant-credentials) | carrier to Bringg |
| **Shipper requests a quote** | **Get Quote** (webhook) | (Recommended) Send a quote response with your estimated delivery price and your availability to complete the order. The shipper may also request details like ETA, ability to fulfill green delivery, and so on. [Learn more.](https://developers.bringg.com/docs/get-quote-webhook) | Bringg to carrier |
| **Shipper sends order** | **Delivery Created** (webhook) | Bringg notifies you that a shipper wants you to deliver goods, so you create a delivery in your system with an identification and the terms of the delivery that you quoted. [Learn more.](https://developers.bringg.com/docs/delivery-created-webhook) | Bringg to carrier |
| **You assign a driver** | **Assign Driver** (API) | Share any authorized identification information about the driver who receives the assignment or reassignment. The shipper passes this to consumers for better customer experience, added feeling of safety, and so on. This is also where you can add a cost to the order once you know who is delivering it. [Learn more.](https://developers.bringg.com/docs/driver-is-assigned-to-order) | carrier to Bringg |
| **Driver starts the delivery** | **Start Order** (API) | Notify Bringg that the driver has begun the delivery process. Include the location, time, delivery price, and whether or not it is a green delivery. [Learn more.](https://developers.bringg.com/docs/start-order-1) | carrier to Bringg |
| **Update driver location** | **Update Driver Location** (API) | (Recommended) Share the timestamp and exact geolocation of the driver. [Learn more.](https://developers.bringg.com/docs/update-driver-location) | carrier to Bringg |
| **Driver arrives** | **Check In** (API) | (Recommended) Share the timestamp and exact geolocation of the driver upon arrival at either the pickup or dropoff location. [Learn more.](https://developers.bringg.com/docs/check-in) | carrier to Bringg |
| **Driver adds information** | **Add Note** (API) | (Recommended) Update the order when the driver adds a note, signature, proof of delivery, or any other delivery documentation the driver collects. [Learn more.](https://developers.bringg.com/docs/note-added) | carrier to Bringg |
| **Driver leaves** | **Check Out** (API) | (Recommended) Share the timestamp and exact geolocation of the driver as they leave the pickup location. Upon leaving the dropoff location, use the Complete Order API instead. [Learn more.](https://developers.bringg.com/docs/check-out) | carrier to Bringg |
| **Shipper cancels order** | **Delivery Cancelled** (webhook) | Bringg notifies you that the shipper canceled the order and includes a reason why, like if the customer decides to cancel it. This helps you know you can end a delivery immediately and avoid wasting time and resources. [Learn more.](https://developers.bringg.com/docs/order-is-cancelled-webhook) | Bringg to carrier |
| **You cancel order** | **Cancel Order** (API) | Cancel a delivery, like if the customer is not home, or there are no available drivers. [Learn more.](https://developers.bringg.com/docs/cancel-order) | carrier to Bringg |
| **You update order** | **Update Order** (API) | (Optional) Update the scheduled pickup or delivery time, the time window, driver ETA, green delivery, delivery price, and so on. [Learn more.](https://developers.bringg.com/docs/update-order) | carrier to Bringg |
| **Shipper updates order** | **Delivery Updated** (webhook) | The shipper makes changes to the address, goods, time window, or customer information. [Learn more.](https://developers.bringg.com/docs/order-is-updated-webhook) | Bringg to carrier |
| **Driver completes order** | **Complete Order** (API) | Send the timestamp, delivery price, order number, or geolocation of the driver when you complete the delivery. [Learn more.](https://developers.bringg.com/docs/complete-order) | carrier to Bringg |
| **Bringg creates return delivery** | **Return Delivery Created** (webhook) | (Optional) The Shipper requests that your driver take the inventory item back to the fulfillment center, so it creates a new delivery with the same order id. [Learn more.](https://developers.bringg.com/docs/return-delivery-created) | Bringg to carrier |
| **Driver arrives at or leaves bulk pickup location** | **Cluster Checkin/Checkout** (API) | (Optional) Do a bulk pickup of orders from a *fulfillment center* or other similar location and deliver them to your warehouse or store location. [Learn more.](https://developers.bringg.com/docs/cluster-checkincheckout) | carrier to Bringg |

TipYou must authorize each API call with a bearer token that utilizes the **Client ID** and **Client Secret** available in the Integrations Portal. To receive the token from Bringg, use the **Get Token** webhook. The token is valid for only 30 minutes. [Learn more.](https://developers.bringg.com/docs/get-token)

**Step 4**: Find the API keys for your testing shipper sandbox in **Registered Merchants**.

Each shipper has a separate API key for their staging and production accounts respectively. The key appears in the header of all webhooks that Bringg sends you so that you can identify from which shipper they originate.

![](https://cdn.document360.io/a18074ef-073a-4ab1-bcab-12625715280e/Images/Documentation/image-1678714385995.png)***Copy the API key for the sandbox shipper to test webhooks.***

TipOnce you complete end-to-end testing using the sandbox shipper , you can access API keys for any other shippers who register to work with you in **Registered Merchants**. Learn more.

**Step 5**: Set up the endpoint URLs to listen for webhook events from Bringg.

TipYou need separate endpoint URLs for your staging and production environments. All staging shipper webhooks reach your staging endpoints, while all production shipper webhooks reach your production endpoints.

**Step 6**: Enter your endpoint URLs for each webhook Bringg sends you. This includes mandatory as well as optional webhooks you listen to.

For example, enter a staging and production endpoint URL for when Bringg notifies you when any shipper creates a delivery for you to fulfill.

![](https://cdn.document360.io/a18074ef-073a-4ab1-bcab-12625715280e/Images/Documentation/image-1678714458950.png)***Input endpoint URLs for each environment you use***

**Step 7**: Copy the Bringg API endpoints for any calls you send Bringg as part of the delivery flow, including common API calls as well as those used only in edge cases.

Include URLs for recommended technical capabilities like driver location updates.

For example, copy the endpoints for when you assign a driver to a delivery or when the driver is unable to complete a delivery and cancels it.

Check **Registered Merchants > Endpoint Prefix** to verify which Bringg URL aligns with the Bringg environment the sandbox shipper uses. Once you complete the end-to-end testing using your sandbox shipper, you will do the same to set up implementations with other registered shippers.

![](https://cdn.document360.io/a18074ef-073a-4ab1-bcab-12625715280e/Images/Documentation/image-1678714484024.png)***Select the URL corresponding to the Bringg environment the shipper uses***

**Step 8**: Configure the JSON payloads for webhook responses and API calls. [Learn more.](https://developers.bringg.com/docs/api-calls)

For example, send this payload when assigning a delivery to a new driver.

```none
{
  "task_id":123456,
  "user": {
     "external_id": "driver1",
     "name": "Driver Name",
     "profile image": "https://url.to.image",
     "phone": "+15555555555",
     "email": "driver@fleet.com"
 },
  "delivery_cost": 1299,
  "green_delivery": true
}
```

TipYou can customize your payloads according to the details you want to share. For example, you can include a driver's name for greater transparency to increase shipper and customer satisfaction.

**Step 9**: Begin testing your integrations using the simulated sandbox shipper in the Integrations Portal to prepare for testing with active shippers and going live. [Learn more.](/v1/docs/)

A delivery provider (DP) offers their fleet of vehicles to fulfill orders on behalf of the shipper. carriers promise different levels of service, cover specific territories, and may specialize in different types of goods and services, such as parcel retail, restaurant, and grocery delivery. You can add more carriers to expand your service coverage by finding the best fit for your business in our carrier catalog.

There are two types of carriers:

1. Carriers are often the more established carriers with their own branded fleet of vehicles and drivers, which they offer to shippers to fulfill their orders. Carriers can typically deliver higher volumes and a wider variety of goods around the world, and can therefore batch planned orders together, sometimes several days in advance, to offer shippers cheaper rates.
2. A crowd-sourced last mile carrier uses independently contracted drivers to populate its fleet. Since the drivers usually use their own vehicles, this type of carrier often fulfills hyper local orders that require more immediate fulfillment (on demand, same day, or next day orders). Their wide pool of local drivers enables them to offer cheaper rates for these deliveries.

Quotes are carrier-provided fulfillment estimates and often include pricing, availability, and ETA. You can display quotes to customers at checkout, auto-assign carriers based on order attributes with Carrier Selector rules, or manually assign carriers in the Bringg platform.

For each order, Bringg sends quote requests to carriers who match your Carrier Selector rules and delivery terms.

You can also set up rate cards for carriers whose quotes do not match agreed-upon pricing.

As a driver using the Bringg Driver App, you can sign up to a shift and see the orders in your route as a list of destinations and breaks, with contact information for each order, extra notes from the consumer or dispatcher and step-by-step instructions to handoff successfully. The Bringg Platform has already optimized your route, and you can navigate turn-by-turn with your favorite map app.

An order is a request for the fulfillment of goods and services at a specific address. It includes all information needed to complete it, such as the requested service or goods, the customer’s contact information, required services (such as fragile care), and the time window.

The estimated time of arrival (ETA) is the time a driver is expected to arrive at a destination. Bringg's route optimization typically schedules an order's ETA to be within its time window.

Green delivery defines when an Own Fleet or carrier can fulfill orders using sustainable and eco-friendly means. This can be accomplished by using sustainable materials and eco-friendly vehicles (such as electric or hybrid vehicles, bicycles, or electric scooters) or committing to achieving carbon neutrality by investing in carbon offset projects (such as planting trees).

A time window is the time range when you intend to fulfill an order. Therefore, an order is considered fulfilled on time if it arrives within the time window. The time window is set when you schedule an order in Bringg and is usually defined by the no_earlier_than and no_later_than fields. Narrower time windows are seen as better service, like 9 to 10 am, while longer windows are more typical of larger carriers.

You can share the time window with your consumers for an improved experience. For example, if a consumer places an order for the 8:00-12:00 the following day, in the morning notify them that you intend to arrive between 8:00-9:00.

If you allow consumers to select their preferred delivery slot, the time window is scheduled accordingly.