Order Inventories Object

The Order (Task) Inventories object is included in some webhook callbacks.

About the Order Inventories Object

The task_inventories object provides detailed information about inventory items associated with an order, including unique inventory IDs, item quantities, dimensions, and attributes, allowing for flexible management and updates through Bringg's API and webhooks. This object can be sent to Bringg as part of the Create Order (Task) endpoint and can be included in any flexible webhook, enabling you to stay updated on the inventory associated with your orders.

Best Practices

  • Before sending inventory details to Bringg, ensure that each inventory item has a unique ID to allow for precise tracking and handling. This lets Bringg know that you are referring to a specific instance of an item when sending updates. To set up a unique inventory ID in Bringg:
  1. In Bringg, go to Settings > Merchant Configuration.
  2. Select a parameter from the drop-down field next to Unique Inventory ID.
  3. Select Update to save your changes.
  • Send distinct products with quantities to indicate multiple items, rather than including multiple line items with the same ID.
  • Determine which level of your inventory hierarchy the driver needs to be able to scan and act on. You can add multiple levels of inventory (we recommend up to three) by embedding another inventory object within the first, including the scan_string at the top level. For example, you can include a top-level item such as a crate with a barcode for the driver to scan. Then, if an issue arises with an item within the crate, such as a missing bag of chips, the driver can interact on that inventory level to reject the specific item.

Order Inventories Details

<ObjectsAboutCustomAttributes />

Parameter

Description

  • *actions_configuration_id**
    integer

The ID of the driver action required for this inventory item.

  • *age_restricted**
    boolean

Indicates whether the driver must check the customer's ID before completing the delivery, for example, when the order includes alcohol.
Possible values:
0 or false- The inventory is not age-restricted
1 or true- The inventory is age-restricted

  • *external_id**
    string

The ID of this item in your external systems.

  • *extras**
    array

This field can be used to send custom attributes to Bringg using the JSON format of field and value.
For example:
{"field":"value"}

  • *external_image_url**
    string

The URL of an externally-hosted image of this item.

  • *handling_units**
    array

The handling units value can be sent as an integer or double.
For example:\

"handling_units": {
"pallets": 2
},
  • *height**
    double

The height of this item.

  • *image**
    string

The URL of an image of this item.

  • *inventory_change_details**
    object

An object detailing changes made to the inventory, including the change type, result, and reasons. Learn more about the Inventory Change Details Object.

  • *length**
    double

The length of this item.

  • *name**
    string

The name of the item.

  • *note**
    string

A note added to this inventory item.

  • *pending**
    boolean

Indicates whether the item is intended for pickup or dropoff.
false or 0 - the item is intended for dropoff
true or 1 - the item is intended for pickup

  • *price**
    double

The item price.

  • *original_quantity**
    integer

The original item quantity included in the the order.

  • *scan_string**
    string

The scan code associated with this item.

  • *services**
    array

An array of services associated with this item, as configured with your Bringg representative, using Bringg's IDs.

  • *services_external_ids**
    array of strings

An array of services associated with this item, as configured with your Bringg representative, using your external system's IDs.
For example: installation or fragile.

  • *weight**
    double

The weight of this item.

  • *width**
    double

The width of this item.


Response and Webhook Data


Parameter

Description

  • *created_at**
    datetime

The date and time this item was created.

  • *deleted_at**
    datetime

The date and time this item was deleted.

  • *id**
    integer

Bringg's ID for this item.

  • *inventory_change_details**
    object

This object details the changes when an inventory item is rejected. When there are no rejections to report, the object is returned as an empty array.

Included parameters:
before (integer): The number of rejected items before the change occurred.
after (integer): The number of rejected items after the change occurred.
change_type (integer): The change_type value is always 2 and indicates an inventory rejection.
inventory_change (object): An object detailing the inventory rejection reason and rejection reason ID.

  • *inventory_id**
    Int32

The ID of this item in Bringg.

  • *merchant_id**
    Int32

The ID of the company. The merchant_id may be null, if the developer works with only one company.

  • *original_quantity**
    integer

The original item quantity included in the the order.

  • *parent_task_inventory_id**
    Int32

When there is a hierarchical relationship between inventory items, this is the ID of the parent item to which this item belongs.

  • *picked_up_quantity**
    integer

The number of items picked up by the driver.

  • *quantity**
    integer

The resulting item quantity delivered or collected after rejections.

  • *rejected_quantity**
    integer

The number of items rejected by the customer or driver.

  • *scanned**
    boolean

If a scan code is associated with this item, this indicates whether the item was scanned.
Possible values:
false or 0 - the item was not scanned
true or 1 - the item was scanned

  • *source_task_id**
    Int32

If the task inventory item originated from another order, this is the ID of that other order.

  • *task_id**
    Int32

Bringg's ID for the associated order.

  • *updated_at**
    datetime

The date and time when this item was last updated.

Examples

"task_inventories": [
{
"id": 334343988,
    "quantity": 1,
    "scanned": false,
    "original_quantity": 5,
    "rejected_quantity": 4,
    "external_id": "2145",
    "name": "Icebox Fridge 32'",
    "inventory_change_details": [
    {
        "change_type": 2,
        "before": "0",
        "after": "4",
        "inventory_change": {
            "reason_to_change_inventory_id": 421,
            "reason_to_change_inventory": {
                "reason": "Item is damaged"
            }
        }
    }
]
}
]
"task_inventories": [
{
"id": 334343988,
    "quantity": 5,
    "scanned": false,
    "original_quantity": 5,
    "rejected_quantity": 0,
    "external_id": "2145",
    "name": "Icebox Fridge 32'",
    "inventory_change_details": []
}
]