The Order Assigned To Driver callback occurs when an order is assigned to a driver. This returns detailed information describing the order, including the driver.
Register Your URL for this Webhook
To start receiving webhooks from Bringg, you must first register a URL. Detailed guidance on setting up and managing Bringg webhooks is available in the following resources:
- Send Bringg Webhooks: Subscribe to webhooks and customize the fields in your callbacks.
- Webhook Authentication Methods: Ensure that your other systems recognize and accept webhooks from Bringg.
Response
{
"id": 11880646,
"title": "Rush Order",
"created_at": "2018-03-13T15:30:09.004Z",
"updated_at": "2018-03-13T15:30:16.312Z",
"customer_id": 6458470,
"user_id": 77484,
"status": 1,
"scheduled_at": "2018-03-13T23:00:00.000Z",
"merchant_id": 11271,
"active_way_point_id": 14412587,
"extras": null,
"additional_attributes": {
"planned_distance_from_prev_task": 4.594
},
"webhooks": null,
"way_points": [{
"id": 14412587,
"lat": 40.7076612,
"lng": -74.0031032,
"task_id": 11880646,
"done": false,
"created_at": "2018-03-13T15:30:08.864Z",
"updated_at": "2018-03-13T15:30:09.010Z",
"customer_id": 6463425,
"address": "4196 Water St. , NY 10002",
"position": 1,
"scheduled_at": "2018-03-13T23:00:00.000Z",
"checkin_time": null,
"checkout_time": null,
"note": null,
"find_me": null,
"asap": null,
"late": false,
"eta": null,
"etl": "2018-03-13T23:05:00.000Z",
"silent": false,
"phone": null,
"email": null,
"delete_at": null,
"checkin_lat": null,
"checkin_lng": null,
"checkout_lat": null,
"checkout_lng": null,
"etos": 300,
"distance_traveled_client": null,
"distance_traveled_server": null,
"automatically_checked_in": 0,
"automatically_checked_out": 0,
"merchant_id": 11271,
"start_lat": null,
"start_lng": null,
"start_time": null,
"estimated_distance": null,
"estimated_time": null,
"allow_editing_inventory": true,
"must_approve_inventory": false,
"address_second_line": null,
"zipcode": null,
"allow_scanning_inventory": null,
"allow_editing_payment": null,
"late_reason": null,
"no_later_than": null,
"no_earlier_than": null,
"masked_phone_number": null,
"twilio_number_id": null,
"marked_late_at": null,
"borough": null,
"city": "New York",
"distance_traveled": null,
"state": null,
"delivery_confirmation_scan": null,
"delivery_confirmation_note": null,
"delivery_confirmation_photo": null,
"delivery_confirmation_signature": null,
"delivery_confirmation_form": null,
"delivery_confirmation_ocr": null,
"company_name": null,
"customer_contact_ids": [6463425],
"contacts": [],
"allow_editing_original_quantity": null,
"pickup_dropoff_option": null,
"delivery_confirmation_cash": null,
"district": null,
"house_number": null,
"street": null,
"pending_geocode": false,
"original_eta": null,
"allow_automatic_set_coordinates": true,
"has_to_leave_by": null,
"extras": null,
"customer": {
"id": 6463425,
"name": "Quick Stop Deli",
"address": null,
"lat": null,
"lng": null,
"created_at": "2018-03-13T15:30:08.836Z",
"updated_at": "2018-03-13T15:30:08.844Z",
"phone": null,
"merchant_id": 11271,
"image": null,
"access_token": "9f2457c2-14f4-4ac1-97be-4a855542f1ec",
"confirmation_code": "6791",
"salt": null,
"approved": false,
"push_token": null,
"uuid": "e1022937-3861-4208-8ab0-483a59bb460b",
"email": null,
"external_id": "6463425",
"delete_at": null,
"facebook_id": null,
"extras": null,
"original_lat_lng_changed": null,
"encrypted_password": "",
"blocked_email": false,
"address_second_line": null,
"zipcode": null,
"allow_login": false,
"stripe_id": null,
"original_phone_number": "0123456789",
"last_open_at": null,
"last_order_at": null,
"uploaded_profile_image": {
"url": "/images/avatar.png"
},
"original_lat": null,
"original_lng": null,
"consecutive_checkins_out_of_geofence": 0,
"allow_sending_email": false,
"allow_sending_sms": true,
"reset_password_token": null,
"reset_password_sent_at": null,
"mobile_version": null,
"mobile_type": 0,
"mobile_maker": null,
"client_version": null,
"client_name": null,
"city": null,
"borough": null,
"state": null,
"dev": false,
"business_code": null,
"language": null,
"district": null,
"house_number": null,
"street": null,
"allow_dynamically_updating_location": null,
"is_sales_rep": false
},
"full_address": "4196 Water St. , NY 10002, New York"
}, {
"id": 14412588,
"lat": 40.7119677,
"lng": -73.9830995,
"task_id": 11880646,
"done": false,
"created_at": "2018-03-13T15:30:08.908Z",
"updated_at": "2018-03-13T15:30:09.015Z",
"customer_id": 5140241,
"address": "416 Water St. , NY",
"position": 2,
"scheduled_at": "2018-03-13T23:00:00.000Z",
"checkin_time": null,
"checkout_time": null,
"note": null,
"find_me": null,
"asap": null,
"late": false,
"eta": null,
"etl": "2018-03-13T23:05:00.000Z",
"silent": false,
"phone": "+9725456974815",
"email": null,
"delete_at": null,
"checkin_lat": null,
"checkin_lng": null,
"checkout_lat": null,
"checkout_lng": null,
"etos": 300,
"distance_traveled_client": null,
"distance_traveled_server": null,
"automatically_checked_in": 0,
"automatically_checked_out": 0,
"merchant_id": 11271,
"start_lat": null,
"start_lng": null,
"start_time": null,
"estimated_distance": null,
"estimated_time": null,
"allow_editing_inventory": true,
"must_approve_inventory": false,
"address_second_line": null,
"zipcode": "10002",
"allow_scanning_inventory": true,
"allow_editing_payment": null,
"late_reason": null,
"no_later_than": null,
"no_earlier_than": null,
"masked_phone_number": null,
"twilio_number_id": null,
"marked_late_at": null,
"borough": null,
"city": "New York",
"distance_traveled": null,
"state": null,
"delivery_confirmation_scan": null,
"delivery_confirmation_note": null,
"delivery_confirmation_photo": null,
"delivery_confirmation_signature": 2,
"delivery_confirmation_form": null,
"delivery_confirmation_ocr": null,
"company_name": null,
"customer_contact_ids": [5140241],
"contacts": [{
"customer_id": 5140241,
"contact_type": "phone",
"contact_value": "+9725456974815",
"sharing_allowed": true
}
],
"allow_editing_original_quantity": null,
"pickup_dropoff_option": 1,
"delivery_confirmation_cash": null,
"district": null,
"house_number": null,
"street": null,
"pending_geocode": false,
"original_eta": null,
"allow_automatic_set_coordinates": true,
"has_to_leave_by": null,
"extras": null,
"customer": {
"id": 5140241,
"name": "Fred's Sandwiche Barn",
"address": "1900 Wall st, New York, NY",
"lat": 32.0940609,
"lng": 34.8283255,
"created_at": "2018-01-08T09:32:58.164Z",
"updated_at": "2018-03-13T15:30:08.886Z",
"phone": "+9725456974815",
"merchant_id": 11271,
"image": "/images/avatar.png",
"access_token": "8c870b26-dd4b-4324-8640-f45f23ef1c14",
"confirmation_code": "8973",
"salt": null,
"approved": false,
"push_token": null,
"uuid": "ed43eb58-de0e-489e-a43b-30f37d63f40a",
"email": null,
"external_id": "5140241",
"delete_at": null,
"facebook_id": null,
"extras": null,
"original_lat_lng_changed": "2018-03-13T09:20:47.165Z",
"encrypted_password": "",
"blocked_email": false,
"address_second_line": null,
"zipcode": null,
"allow_login": false,
"stripe_id": null,
"original_phone_number": "05456974815",
"last_open_at": null,
"last_order_at": null,
"uploaded_profile_image": {
"url": "/images/avatar.png"
},
"original_lat": 40.7060006,
"original_lng": -74.008801,
"consecutive_checkins_out_of_geofence": 1,
"allow_sending_email": false,
"allow_sending_sms": true,
"reset_password_token": null,
"reset_password_sent_at": null,
"mobile_version": null,
"mobile_type": 0,
"mobile_maker": null,
"client_version": null,
"client_name": null,
"city": null,
"borough": null,
"state": null,
"dev": false,
"business_code": null,
"language": null,
"district": null,
"house_number": null,
"street": null,
"allow_dynamically_updating_location": null,
"is_sales_rep": false
},
"full_address": "416 Water St. , NY, New York, 10002"
}
],
"scans": [],
"customer": {
"id": 6458470,
"name": "Fast Foods & Beverages",
"address": "1900 Wall st, New York, NY",
"lat": 32.0940772,
"lng": 34.8284523,
"created_at": "2018-03-13T09:19:57.562Z",
"updated_at": "2018-03-13T15:30:08.810Z",
"phone": "+972545454545",
"merchant_id": 11271,
"image": null,
"access_token": "2ef3f376-3f46-436b-ad2b-45c83f830121",
"confirmation_code": "2422",
"salt": null,
"approved": false,
"push_token": null,
"uuid": "fba3f307-eef0-4a67-883d-e46ddf02ac6a",
"email": null,
"external_id": "6458470",
"delete_at": null,
"facebook_id": null,
"extras": null,
"original_lat_lng_changed": "2018-03-13T14:38:51.145Z",
"encrypted_password": "",
"blocked_email": false,
"address_second_line": null,
"zipcode": null,
"allow_login": false,
"stripe_id": null,
"original_phone_number": "0545454545",
"last_open_at": null,
"last_order_at": null,
"uploaded_profile_image": {
"url": "/images/avatar.png"
},
"original_lat": 40.706877,
"original_lng": -74.0112654,
"consecutive_checkins_out_of_geofence": 0,
"allow_sending_email": false,
"allow_sending_sms": true,
"reset_password_token": null,
"reset_password_sent_at": null,
"mobile_version": null,
"mobile_type": 0,
"mobile_maker": null,
"client_version": null,
"client_name": null,
"city": null,
"borough": null,
"state": null,
"dev": false,
"business_code": null,
"language": null,
"district": null,
"house_number": null,
"street": null,
"allow_dynamically_updating_location": null,
"is_sales_rep": false
},
"late": false,
"external_id": "ABC250",
"uuid": "75685ad3-be1d-4893-baa6-a911d15ffc16",
"priority": 11880646,
"total_price": null,
"price_before_tax": null,
"delivery_price": null,
"tip": null,
"left_to_be_paid": null,
"dispatcher_id": null,
"team_ids": [15132],
"ready_to_execute": true,
"start_lat": null,
"start_lng": null,
"distance_traveled": null,
"tax_price": null,
"discount": null,
"tip_driver_enabled": true,
"tag_id": 8994,
"pre_delivery_tip": null,
"post_delivery_tip_cash": null,
"post_delivery_tip_credit": null,
"group_leader_id": null,
"automatically_assigned": false,
"run_uuid": "60205a2d-8a2e-479a-8963-be3898677e03",
"run_start_time": "2018-03-08T18:11:47.000Z",
"last_assigned_time": "2018-03-13T15:30:16.312Z",
"task_inventories": [{
"id": 60269306,
"task_id": 11880646,
"quantity": 0,
"original_quantity": 5,
"merchant_id": 11271,
"price": 500,
"way_point_id": 14412588,
"scan_string": "34242342342323432432234",
"pending": null,
"note": null,
"parent_task_inventory_id": null,
"coc_type": 0,
"external_id": "12321312",
"source_task_id": null,
"inventory_id": 1238399,
"name": "Best Bottled Water",
"size": null,
"image": "/images/product-placeholder.png",
"inventory": {
"id": 1238399,
"name": "Best Bottled Water",
"price": 500,
"merchant_id": 11271,
"external_id": "12321312",
"scan_string": null,
"commodity": null,
"notes": null,
"weight": null,
"size": null,
"extras": null,
"delivery_cost": null,
"completed": null,
"width": null,
"height": null,
"length": null,
"image": "/images/product-placeholder.png"
}
}
],
"group_uuid": null,
"parent_task_id": null,
"payment_type_name": null,
"task_notes": [{
"id": 13023601,
"note": "Do not delivery through front entrance.",
"user_id": 59172,
"task_id": 11880646,
"created_at": "2018-03-13T15:30:08.922Z",
"updated_at": "2018-03-13T15:30:09.017Z",
"url": null,
"way_point_id": 14412588,
"customer_id": null,
"pending_upload": false,
"lat": 32.1068165,
"lng": 34.8348318,
"type": "TaskNote"
}
],
"fleet_id": null,
"fleet_delivery_external_id": null,
"preparation_status": 0,
"task_type_id": 4,
"user_external_id": "4224",
"cancellation_lat": null,
"cancellation_lng": null,
"automatically_ended": 0,
"automatically_cancelled": 0,
"failed_delivery_attempts": 0,
"user": {
"id": 4224,
"name": "Bringg Test",
"status": "offline",
"sub": "Started",
"lat": 32.0852094,
"lng": 34.8229308,
"phone": null,
"merchant_id": 51,
"profile_image": null,
"admin": false,
"dispatcher": false,
"beta": false,
"email": "[email protected]",
"job_description": null,
"external_id": "4224",
"active_shift_id": 84345,
"driver_sign_in_count": 2,
"uuid": "d080d40c-b71b-4657-ac7e-4930baf95dd3",
"battery": 0,
"average_rating": 0,
"driver": true,
"estimated_last_lat": 0,
"estimated_last_lng": 0,
"estimated_last_address": null,
"at_home": false,
"team_ids": [234],
"user_type_id": null,
"vehicle_type_id": null,
"language": null,
"default_user_activity": 5,
"authorization_flags": {},
"private_vehicle": true,
"in_beacon_range": false
}
}
Output Params
|
id Int32 |
The unique Id of this order. |
|
active_way_point_id Int32 |
The Id of the way point in this order that is the user's (driver's) next destination. |
|
automatically_assigned boolean |
Indicates whether this order was automatically assigned. The values are:
|
|
created_at datetime |
The date and time this order was created. This is in UTC and is in the format is " %Y-%m-%dT%H:%M:%S%z". |
|
customer JSON |
A JSON containing the following fields from the customer object associated with this order: |
|
customer_id Int32 |
The Id of the customer associated with this order. |
|
delivery_price double |
The price of this delivery. |
|
discount double |
The discount amount of this order. |
|
dispatcher_id Int32 |
If the dispatcher locked this order, the Id of the dispatcher. |
|
distance_traveled double |
The actual distance traveled (in km). |
|
external_id string |
The order's external Id. |
|
extras JSON |
Internal Use. |
|
fleet_delivery_external_id string |
If this order is assigned to an external fleet, this is the Id used by that external fleet. |
|
fleet_id Int32 |
If this order is assigned to an external fleet, this is the Id of that external fleet. |
|
group_leader_id Int32 |
If this order is a group of orders, this is the Id of the order representing the entire collection of orders in the group (the parent order containing all child orders in the group). This is the Id that Bringg operators (for example, dispatchers and users/drivers) view. NOTE: Bringg internally maintains each order and each order contains the same group leader Id. |
|
group_uuid uuid |
If this order is a group of orders, this is the UUID of the group (see group_leader_id above). |
|
last_assigned_time datetime |
The last date and time an order was assigned to the user (driver). This is in UTC and is in the format is " %Y-%m-%dT%H:%M:%S%z". |
|
late Int32 |
Indicates whether the user (driver) has not arrived at way points in this order on or before the scheduled times. The values are:
The default value is false. |
|
left_to_be_paid double |
The unpaid balance of this total order. |
|
merchant_id Int32 |
The Id of the company. The merchant_id may be null, if the developer works with only one company. |
|
parent_task_id Int32 |
If this order was created from another order (for example, a failed order), this is the Id of that original order. |
|
payment_type_name string |
The name of the payment type. For example, Visa, Mastercard, or Amex. |
|
pre_delivery_tip double |
The tip (gratuity) paid to the user (driver) before this order delivery. |
|
priority Int32 |
The priority of this order. |
|
post_delivery_tip_cash double |
The tip (gratuity) paid to the user (driver) in cash after this order delivery. |
|
price_before_tax double |
The net price of this order not including taxes. |
|
ready_to_execute boolean |
Indicates whether this order is in planning and not visible to users (drivers). The values are:
|
|
run_uuid uuid |
If the order is part of a "run", this is the UUID of the "run". A "run" is a group of user (driver) tasks beginning at the time a user (driver) leaves a "base" and ending when the user (driver) returns to that "base". |
|
scheduled_at datetime |
The date and time this order was scheduled. This is in UTC and is in the format is " %Y-%m-%dT%H:%M:%S%z". |
|
start_lat double |
The geoposition latitude of the user (driver) when this order started. |
|
start_lng double |
The geoposition longitude of the user (driver) when this order started. |
|
status Int32 |
This order's status. The values are:
The Order Created callback returns the value 1 (assigned). |
|
tag_id Int32 |
If a tag exists, this is the Bringg tab Id. |
|
task_inventories Array of JSONs |
An array of JSONs containing this order's inventory, see Task Inventories. |
|
task_notes Array of JSONs |
An array of JSONs containing notes added to this order, see Task Notes. |
|
tax_price double |
The gross price of this order including taxes. |
|
tip double |
The tip (gratuity) paid to the user (driver) by the customer for this order. |
|
tip_driver_enabled |
Indicates whether the user (driver) is allowed to be tipped. The values are:
|
|
title string |
This order's title. The maximum length is 255 characters. |
|
total_price double |
The total price of this order. |
|
updated_at datetime |
The date and time of the last update for this order. This is in UTC and is in the format is " %Y-%m-%dT%H:%M:%S%z". |
|
user_external_id String |
The external Id of this user (driver) (Id in your own system). |
|
user_id Int32 |
The Id of this user (driver). |
|
uuid Int32 |
The universal unique Id of this order. |
|
way_points Array of JSONs |
An array of JSONs containing the following way-point information: |
|
webhooks boolean |
Indicates whether webhooks can be set for this order. The values are:
|