Required api role: not applicable (push/push)
Purpose: This interface allows an external party to integrate with warehouse management systems and location booking platforms.
The location booking uses a push/push model: Qargo pushes a booking dispatch payload to an external endpoint. The third party then updates Qargo with booking status changes using our webhook endpoint:
Each dispatch payload includes an operation field indicating the type of action:
| Operation | Description |
|---|---|
CREATE | New booking request. The external system should create a time slot reservation. |
UPDATE | Booking details have changed (e.g. updated time window, different vehicle). |
CANCEL | The booking is no longer needed and should be released. |