Integrate Bringg delivery orchestration to create orders and receive driver-status webhooks

Steps

1. Register for API credentials in the Bringg dashboard; all REST calls target the base URL documented at developers.bringg.com and require your access_token in the Authorization header.
2. POST to the Create Order (Task) endpoint with a payload containing customer details, at least one waypoint (pickup and/or drop-off with address and scheduled time), and optional fields like vehicle_type and priority.
3. Capture the returned task id and external_id mapping; store the mapping to correlate Bringg events back to your OMS records.
4. Configure outbound webhooks in the Bringg dashboard: choose events (order_created, driver_arrived, order_done, order_canceled), provide your endpoint URL, and select an authentication method (JWT HS256 or OAuth 2.0 client credentials).
5. Parse incoming webhook payloads — each event contains task_id, status, driver_id, and a timestamp — and update order status in your OMS accordingly.
6. For high-volume integrations use the asynchronous bulk-order endpoint and poll for acknowledgement rather than sending tasks one by one.