Changelog

📘

Coming Soon: New Defaults for the Customer kind Parameter

Starting May 15, 2024, the default logic for the kind parameter will be as follows:

  • For orders with a single waypoint, the waypoint kind will defined as Customer.
  • For orders with two waypoints, the first waypoint (pickup) kind will be defined as Warehouse, and the second waypoint (drop off) will be defined as "Customer".

To define a waypoint as an alternate kind, include an integer value with the kind parameter:

  • 0 - Customer
  • 1 - Warehouse
  • 2 - Store
  • 3 - Locker
  • 4 - Fulfillment center

April 3, 2024

The Order (Task) Object now includes the planned_distance_from_prev_task parameter in webhooks and responses related to orders planned using Route Optimization or the route planner. The parameter indicates the distance to the order in question from the location of the preceding order in the route.

March 14, 2024

The Get Quotes endpoint now includes the fill_ratio parameter, which indicates the percentage of each delivery slot that is already booked. This can be used to determine pricing or the need for additional resources.

Examples of values:

  • 0 - the slot is empty
  • 0.36 - the slot is 36% full
  • 1 - the slot is full

March 4, 2024

You can now set delivery terms as hard constraints to prevent Bringg from requesting quotes from carriers that do not meet the requirements of an order.

  • When a delivery term is set as a hard constraint, carriers that do not meet an order's requirements do not appear in the Get Quotes response.
  • When a delivery term is not set as a hard constraint, it is considered a soft constraint. When a carrier with a soft constraint does not meet the requirements of an order, the carrier is included in the Get Quotes response with "delivery_terms_supported": false.

    📘

    Best Practice

    As hard constraints do not provide results that include "delivery_terms_supported": false, we recommend updating the way your external systems listen to responses from Bringg so that they do not rely on the existence of this field.

February 20, 2024

As part of Bringg's upgraded secured onboarding, new users receive an email prompting them to set up their initial password. As user passwords are now created by the user themselves, the password parameter in the Create User and Update User requests have been deprecated.

January 22, 2024

You can now view which system or user initiated a change in scheduling for an order. The Destination Rescheduled webhook now includes the following parameters:

  • time_window_change_origin: The system, process, or user action that initiated a change in the time window for a waypoint.
  • workflow_id: When a change was triggered by an automation, the ID of that automation.

January 8, 2024

The coordinates in the polygon array should now be ordered by [latitude, longitude] when added to service areas via CSV upload, entry in the UI, and creation or update via API.

December 17, 2023

  • You can now send driver skills to Bringg as part of the Create User and Update User payloads.
    For example:
      "external_id": "ABC123",
      "name": "Steve",
      "skills": [
        "Electrician",
        "TV Installation"
      ]
    
  • Welcome to the Bringg API changelog!