Webhaken

Vuurt bij aanmaak van een lokale bezorgorder (Delivery / Pickup / P2P) via elke route — webformulier, REST/GraphQL API, e-commerce platform sync, automatische regels, importregels, enz. Label-service en andere niet-bezorg ordertypes worden uitgesloten. Wordt in batch-flow overgeslagen wanneer voor dezelfde ontvanger ook order_create_async_postback_url is geconfigureerd. Configureer via order_create_webhook_url.

Vuurt bij elke statusovergang — opgehaald, onderweg, bezorgd, uitzondering, geannuleerd. Configureer via order_status_change_webhook_url.

Vuurt bij elk tracking-lifecycle event van een pakket (info ingediend, levering gestart, succesvol bezorgd, niet bezorgd, enz.). Configureer via tracking_event_webhook_url. Bezorg- en ophaalgebeurtenissen bevatten ook het afleverbewijs: proof_files en proof_files_detail (file_id, type, url, full_url, ondertekende download-URL). Foto’s die na de gebeurtenis worden geüpload, komen binnen als pod.files_updated. Elk bestand bevat ook de context van zijn gebeurtenis: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) en service_status (1 = success / 2 = failed); voor oude bestanden zonder vastgelegde gebeurtenis zijn ze null.

Vuurt eenmaal nadat een batch-import is verwerkt. Payload bevat de resultaten per regel. Configureer via order_create_async_postback_url.

Wordt geactiveerd wanneer een bezorgfoto of handtekening wordt toegevoegd, vervangen of verwijderd (action: added / updated / removed) — één levering per bestand, geen polling van bijlagen meer. Inschakelen via pod_files_webhook_url. Elk bestand bevat ook de context van zijn gebeurtenis: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) en service_status (1 = success / 2 = failed); voor oude bestanden zonder vastgelegde gebeurtenis zijn ze null.

Wordt geactiveerd wanneer een order permanent wordt verwijderd, zodat uw systeem de verwijdering kan spiegelen. Inschakelen via order_deleted_webhook_url.

Wordt geactiveerd wanneer een annuleringspoging wordt geweigerd (bijvoorbeeld omdat de order al onderweg is), zodat uw operationele processen mislukte annuleringen kunnen bewaken zonder de API te pollen. Inschakelen via order_cancel_failed_webhook_url.

Wordt verzonden wanneer een plaats op het routebord van houder wisselt of het bord van status verandert — het veld action zegt wat er gebeurde (claimed, standby, pooled, promoted, withdrawn, vetoed, replaced, assigned, awarded, lost, displaced, settled, board_opened, board_closed, board_cancelled). Alleen op bedrijfsniveau. Opt-in via route_board_webhook_url.

Deuren Geopend — Wordt geactiveerd zodra de vakdeuren opengaan voor een bezorgpoging — of de koerier nu de toegangscode op het scherm van de kluis invoerde of de remote-open-API gebruikte — inclusief heropeningen na hertoewijzing. Het opening-blok toont elk geopend vak met grid_id, hardware-deurnummer compartment_number en pickup_locker_number (volgnummer voor weergave, per kolom van boven naar beneden geteld en daarna van links naar rechts). Elk vak bevat ook pickup_locker_code — het label "{shelf_code}-{pickup_locker_number}" waar de ontvanger naartoe wordt gestuurd; null als het vak geen afhaalnummer heeft. De payload bevat ook pickup_code — de afhaalcode van de ontvanger, toegewezen op het moment dat de deuren opengaan; die blijft dezelfde code nadat de koerier het deponeren bevestigt en kan pas na die bevestiging voor afhalen worden gebruikt.

Bezorgd in kluis — Wordt geactiveerd wanneer een aflevering is bevestigd en de pakketten in de locker liggen. De payload bevat de ophaalcode van de ontvanger. Elk vak bevat ook pickup_locker_code — het label "{shelf_code}-{pickup_locker_number}" waar de ontvanger naartoe wordt gestuurd; null als het vak geen afhaalnummer heeft. Voor deuren die via de API voor openen op afstand zijn geopend, wikkelt het platform de aflevering zelf af zodra de locker meldt dat alle geopende deuren weer dicht zijn; het event wordt dan zonder confirm-aanroep verstuurd. confirmed_by geeft de afwikkelingsroute aan: courier_terminal, partner_api, door_close, timeout_door_closed of console.

Opgehaald — Wordt geactiveerd wanneer de ontvanger de gedeponeerde pakketten heeft opgehaald.

Bezorging mislukt — Wordt geactiveerd wanneer een bezorging mislukt; foutcodes per pakket zijn inbegrepen.

Verlopen — Wordt geactiveerd wanneer een ongebruikte bezorgcode of een niet-opgehaalde deponering de vervaltijd overschrijdt.

Geannuleerd — Wordt geactiveerd wanneer een bezorging vóór voltooiing wordt geannuleerd.

Correctie-heropening — Wordt geactiveerd wanneer de gebruikte vakken binnen het correctievenster opnieuw worden geopend om een verkeerde plaatsing te herstellen — via het lockerscherm of via de API. Het correction-blok vermeldt de heropende vakken. Elk vak bevat ook pickup_locker_code — het label "{shelf_code}-{pickup_locker_number}" waar de ontvanger naartoe wordt gestuurd; null als het vak geen afhaalnummer heeft.

partner_locker_delivery.event_type_code_rotated — Wordt geactiveerd wanneer de partner de bezorgcode of afhaalcode van een bezorging vernieuwt. Het rotation-blok vermeldt welke code is vervangen, wanneer, en of de ontvangermelding opnieuw is verzonden — de nieuwe code zelf reist nooit mee in een webhook; die wordt alleen onthuld in het directe antwoord van de vernieuwings-API.

Toewijzing aangemaakt — Wordt geactiveerd wanneer een order aan de aanbieder wordt toegewezen — via een automatische regel of handmatig. De payload bevat het toewijzingsnummer, de order-ID's en de trackingnummers van de pakketten.

Pakketten overgedragen — Wordt geactiveerd wanneer het magazijn alle pakketten van de toewijzing fysiek aan de aanbieder heeft overgedragen.

Toewijzing geannuleerd — Wordt geactiveerd wanneer het platform een toewijzing bij de aanbieder intrekt. Het veld reason maakt onderscheid tussen cancelled (de toewijzing is bij de vervoerder geannuleerd), fallback_to_self_delivery (het platform heeft de order teruggenomen voor eigen bezorging) en reassigned (de order is naar een andere aanbieder verplaatst).

Gedeeltelijk bezorgd — Wordt geactiveerd wanneer een deel van een zending is bezorgd terwijl andere pakketten nog onderweg zijn. De array packages bevat het resultaat per pakket en legs somt de bij de vervoerder geboekte externe orders op — één per pakket als de vervoerder geen multi-collo zendingen accepteert.

Er is een chauffeur aan de order toegewezen (handmatig, via ritplanning of via automatische toewijzing). data.source = auto_assign wanneer de orchestrator dit deed.

De order is zijn chauffeur kwijtgeraakt (overdracht, intrekking, weigering, time-out). data.previous_driver_id geeft aan wie hem had.

De chauffeur heeft een automatisch toegewezen order in de app geaccepteerd (chauffeursdienst met verplichte acceptatie).

De chauffeur heeft een toegewezen order geweigerd; data.reason bevat de optionele reden in vrije tekst.

De chauffeur is met ophalen begonnen (status Ophalen gestart / Onderweg voor ophalen).

Het pakket is opgehaald (status Al opgehaald).

Het pakket is onderweg naar de ontvanger (status Bezorging gestart / Onderweg voor bezorging).

De bezorging is geslaagd (status Succesvol).

De bezorgpoging is mislukt (Later opnieuw bezorgen, Opnieuw plannen, Afgewezen door ontvanger).

De order is geannuleerd.

Een medewerker (of een chauffeur, indien toegestaan) heeft de order als gereed voor ophalen gemarkeerd (Dispatchopties → gereed voor ophalen).

Een chauffeur is in de app in of uit dienst gegaan (optie chauffeursdienst).

Een chauffeurspositie uit de app of tracker, per chauffeur gedoseerd via driver_location_min_interval_sec (standaard 60 s). Wordt alleen naar driver_location_webhook_url verzonden.

Een pakket is in de automaat geplaatst en wacht op de volgende persoon (ontvanger, koerier of beheerder, zie data.device_order.next_actor). due_at is de uiterste ophaaldatum.

Het pakket is eruit gehaald door de persoon op wie het wachtte — de ontvanger, de koerier of medewerkers die een smart drop legen.

Medewerkers hebben het pakket uit de automaat gehaald. removal_reason geeft de reden: overdue_return, handover, relay, anomaly of recovery.

Het pakket is over zijn due_at heen zonder te zijn opgehaald. Het ligt nog in de automaat en de code werkt nog; overdue_at wordt ingesteld en next_actor wordt operator.

Er is een probleem geopend voor de verwerking (bijvoorbeeld door_left_open, deposit_unverified, item_missing, overdue). data.exception bevat id, type, severity en status.

Iemand heeft een probleem van de verwerking gesloten. data.exception.status is resolved of dismissed en resolution_action geeft aan wat er is gedaan.