Webhook

Si attiva alla creazione di un ordine di consegna locale (Delivery / Pickup / P2P) tramite qualsiasi canale: form web, API REST/GraphQL, sincronizzazione piattaforma e-commerce, regole automatiche, righe importate, ecc. Esclude gli ordini label-service e altri tipi non di consegna. Saltato nel flusso batch quando lo stesso destinatario ha anche order_create_async_postback_url configurato. Configura con order_create_webhook_url.

Si attiva ad ogni transizione di stato — ritirato, in transito, consegnato, eccezione, annullato. Configura con order_status_change_webhook_url.

Si attiva ad ogni evento del ciclo di vita di un pacco (informazioni inviate, inizio consegna, consegna riuscita, non consegnato, ecc.). Configura con tracking_event_webhook_url. Gli eventi di consegna e di ritiro contengono anche la prova di consegna: proof_files e proof_files_detail (file_id, type, url, full_url, URL di download firmato). Le foto caricate dopo l’evento arrivano come pod.files_updated. Ogni file include anche il contesto del suo evento: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) e service_status (1 = success / 2 = failed); per i file storici senza evento registrato sono null.

Si attiva una volta al termine dell'elaborazione di un'importazione batch. Il payload contiene l'array dei risultati per riga. Configura con order_create_async_postback_url.

Attivato quando una foto di consegna o una firma viene aggiunta, sostituita o rimossa (action: added / updated / removed) — un invio per file, niente più polling degli allegati. Si attiva configurando pod_files_webhook_url. Ogni file include anche il contesto del suo evento: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) e service_status (1 = success / 2 = failed); per i file storici senza evento registrato sono null.

Attivato quando un ordine viene eliminato definitivamente, così il tuo sistema può replicare la rimozione. Si attiva configurando order_deleted_webhook_url.

Attivato quando un tentativo di annullamento viene rifiutato (ad esempio l'ordine è già in consegna), così i tuoi processi operativi possono monitorare gli annullamenti falliti senza interrogare l'API. Si attiva configurando order_cancel_failed_webhook_url.

Si attiva quando un posto della bacheca percorsi cambia titolare o la bacheca cambia stato — il campo action indica cosa è successo (claimed, standby, pooled, promoted, withdrawn, vetoed, replaced, assigned, awarded, lost, displaced, settled, board_opened, board_closed, board_cancelled). Solo a livello aziendale. Iscrizione tramite route_board_webhook_url.

Sportelli Aperti — Si attiva nel momento in cui gli sportelli si aprono per un tentativo di consegna — sia che il corriere abbia usato lo schermo dell'armadietto con il codice di accesso sia l'API di apertura remota — incluse le riaperture per riassegnazione. Il blocco opening elenca ogni scomparto aperto con grid_id, numero sportello hardware compartment_number e pickup_locker_number (numero sequenziale di visualizzazione contato dall'alto verso il basso per colonna, poi da sinistra a destra). Ogni scomparto riporta anche pickup_locker_code: l'etichetta "{shelf_code}-{pickup_locker_number}" a cui viene indirizzato il destinatario; null quando lo scomparto non ha un numero di ritiro. Il payload include anche pickup_code: il codice di ritiro del destinatario, assegnato nel momento in cui si aprono gli sportelli; resta lo stesso codice dopo che il corriere conferma il deposito e diventa utilizzabile per il ritiro solo a deposito confermato.

Consegnato nell'armadietto — Attivato quando un deposito è confermato e i pacchi sono nell'armadietto. Il payload include il codice di ritiro del destinatario. Ogni scomparto riporta anche pickup_locker_code: l'etichetta "{shelf_code}-{pickup_locker_number}" a cui viene indirizzato il destinatario; null quando lo scomparto non ha un numero di ritiro. Per gli sportelli aperti tramite l'API di apertura remota la piattaforma liquida il deposito non appena l'armadietto segnala chiusi tutti gli sportelli aperti, quindi l'evento scatta senza una chiamata confirm; confirmed_by indica il percorso di liquidazione: courier_terminal, partner_api, door_close, timeout_door_closed o console.

Ritirato — Attivato quando il destinatario ha ritirato i pacchi depositati.

Consegna non riuscita — Attivato quando una consegna fallisce; sono inclusi i codici di errore per pacco.

Scaduto — Attivato quando un codice di consegna inutilizzato o un deposito non ritirato supera la scadenza.

Annullato — Attivato quando una consegna viene annullata prima del completamento.

Riapertura di correzione — Attivato quando gli scomparti occupati vengono riaperti entro la finestra di correzione per rimediare a un posizionamento errato — dallo schermo dell'armadietto o tramite API. Il blocco correction elenca gli scomparti riaperti. Ogni scomparto riporta anche pickup_locker_code: l'etichetta "{shelf_code}-{pickup_locker_number}" a cui viene indirizzato il destinatario; null quando lo scomparto non ha un numero di ritiro.

partner_locker_delivery.event_type_code_rotated — Si attiva quando il partner rigenera il codice di consegna o il codice di ritiro di una consegna. Il blocco rotation indica quale codice è stato sostituito, quando, e se la notifica al destinatario è stata reinviata — il nuovo codice non viaggia mai in un webhook; viene rivelato solo nella risposta diretta dell'API di rigenerazione.

Assegnazione creata — Si attiva quando un ordine viene assegnato al fornitore — da una regola automatica o manualmente. Il payload contiene il numero di assegnazione, gli identificativi dell'ordine e i numeri di tracciamento dei pacchi.

Pacchi affidati — Si attiva quando il magazzino ha consegnato fisicamente al fornitore tutti i pacchi dell'assegnazione.

Assegnazione annullata — Si attiva quando la piattaforma ritira un'assegnazione dal fornitore. Il campo reason distingue cancelled (l'assegnazione è stata annullata presso il vettore), fallback_to_self_delivery (la piattaforma ha ripreso l'ordine in consegna propria) e reassigned (l'ordine è stato spostato a un altro fornitore).

Consegna parziale — Si attiva quando una parte della spedizione è stata consegnata mentre altri colli sono ancora in corso. L'array packages riporta l'esito di ogni collo e legs elenca gli ordini esterni prenotati presso il corriere: uno per collo quando il corriere non accetta spedizioni multicollo.

Un autista è stato assegnato all'ordine (manualmente, dalla pianificazione dei giri o dall'assegnazione automatica). data.source = auto_assign quando lo ha fatto l'orchestratore.

L'ordine ha perso il suo autista (passaggio di consegne, revoca, rifiuto, timeout). data.previous_driver_id indica chi lo aveva.

L'autista ha accettato nell'app un ordine assegnato automaticamente (turno autisti con accettazione obbligatoria).

L'autista ha rifiutato un ordine assegnato; data.reason contiene il motivo opzionale in testo libero.

L'autista ha avviato il ritiro (stato Ritiro iniziato / In Ritiro).

Il pacco è stato ritirato (stato Già ritirato).

Il pacco è in viaggio verso il destinatario (stato Consegna iniziata / In Consegna).

La consegna è riuscita (stato Riuscito).

Il tentativo di consegna è fallito (Riconsegnare più tardi, Da riprogrammare, Rifiutato dal destinatario).

L'ordine è stato annullato.

Lo staff (o un autista, se consentito) ha contrassegnato l'ordine come pronto per il ritiro (Opzioni di dispatch → pronto per il ritiro).

Un autista è entrato o uscito dal turno nell'app (opzione turno autisti).

Una posizione dell'autista proveniente dall'app o dal tracker, limitata per autista da driver_location_min_interval_sec (predefinito 60 s). Inviata solo a driver_location_webhook_url.

Un pacco è stato depositato nella macchina e attende la persona successiva (destinatario, corriere o operatore, vedi data.device_order.next_actor). due_at è la scadenza di ritiro.

Il pacco è stato ritirato dalla persona che attendeva: il destinatario, il corriere o il personale che svuota uno smart drop.

Il personale ha prelevato il pacco dalla macchina. removal_reason indica il motivo: overdue_return, handover, relay, anomaly o recovery.

Il pacco ha superato il suo due_at senza essere ritirato. È ancora nella macchina e il codice funziona ancora; overdue_at viene impostato e next_actor diventa operator.

È stato aperto un problema sulla gestione (ad esempio door_left_open, deposit_unverified, item_missing, overdue). data.exception contiene id, type, severity e status.

Una persona ha chiuso un problema sulla gestione. data.exception.status è resolved o dismissed e resolution_action indica cosa è stato fatto.