Walk Through

Burq offers two ways to get a delivery on the road. Pick the one that matches how much control you need over provider selection.

Every Burq delivery moves through the same four stages:

Create an order
Group it into a route
Request quotes from providers
Dispatch to the chosen provider

The difference between the two flows is who drives those stages.

With Manual Dispatch, you call each stage yourself using the provided endpoints. You see every quote, compare price and provider, and choose which one to commit to. With Auto Dispatch, you submit orders in a single request and Burq runs the remaining stages for you — routing, quoting, and dispatching — then notifies you via webhooks.

At a glance

	Manual Dispatch	Auto Dispatch
Requests per delivery	4–5	1
Entry point	`POST /orders/create`	`POST /orders/create`
Who picks the provider	You	Burq, by `quote_preference`
You see quotes before committing	Yes	No
Response style	Each call returns its result	Asynchronous — returns `202` and a `batch_id`
How you learn the outcome	From the API response	From webhooks
Volume per request	One order	1–300 orders
Handling no-quote situations	Your code decides when to retry	Built in, via `retry_window` and `retry_interval`

📘
Both flows produce identical orders
A delivery dispatched automatically is indistinguishable from one you dispatched by hand. Tracking, webhooks, cancellation, and billing all behave the same way. The flow is an integration choice, not a different product. The entry point is the same (POST /orders/create), the difference is made by the mechanism provided by settings

Use Manual Dispatch when

You show delivery prices to your customer and need the real quote before they check out.
You have your own provider logic — preferred partners, blocklists, per-region rules, or margin thresholds.
You want to inspect a quote's fee, ETA, and provider before dispatching order.
You dispatch one order at a time, in direct response to a user action.
You need to inspect every intermediate result.

→ Walk through Manual Dispatch

Use Auto Dispatch when

You want retries handled for you when no provider quotes immediately.
Speed to integration matters more than fine-grained control.
You are happy for Burq to pick between providers on price or reliability.

→ Walk through Auto Dispatch