Webhooki

Wyzwala się przy utworzeniu zamówienia dostawy lokalnej (Delivery / Pickup / P2P) dowolną drogą: formularz web, REST/GraphQL API, synchronizacja platformy e-commerce, automatyczne reguły, wiersze importu itd. Wyklucza zamówienia label-service i inne typy nie-dostawcze. Pomijany w przepływie batch, gdy ten sam odbiorca ma również skonfigurowany order_create_async_postback_url. Konfiguruj za pomocą order_create_webhook_url.

Wyzwala się przy każdej zmianie statusu — odebrane, w tranzycie, dostarczone, wyjątek, anulowane. Konfiguruj za pomocą order_status_change_webhook_url.

Wyzwala się przy każdym zdarzeniu cyklu życia śledzenia paczki. Konfiguruj za pomocą tracking_event_webhook_url. Zdarzenia doręczenia i odbioru zawierają także potwierdzenie doręczenia: proof_files oraz proof_files_detail (file_id, type, url, full_url, podpisany adres pobrania). Zdjęcia wgrane po zdarzeniu przychodzą jako pod.files_updated. Każdy plik zawiera też kontekst swojego zdarzenia: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) oraz service_status (1 = success / 2 = failed); dla starych plików bez zapisanego zdarzenia są null.

Wyzwala się raz po zakończeniu przetwarzania importu wsadowego. Payload zawiera tablicę wyników na wiersz. Konfiguruj za pomocą order_create_async_postback_url.

Wyzwalane, gdy zdjęcie dostawy lub podpis zostanie dodany, zastąpiony lub usunięty (action: added / updated / removed) — jedna wysyłka na plik, koniec z odpytywaniem o załączniki. Włączane przez pod_files_webhook_url. Każdy plik zawiera też kontekst swojego zdarzenia: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) oraz service_status (1 = success / 2 = failed); dla starych plików bez zapisanego zdarzenia są null.

Wyzwalane, gdy zamówienie zostanie trwale usunięte, aby Twój system mógł odzwierciedlić usunięcie. Włączane przez order_deleted_webhook_url.

Wyzwalane, gdy próba anulowania zostanie odrzucona (np. zamówienie jest już w doręczeniu), aby Twoje procesy operacyjne mogły monitorować nieudane anulowania bez odpytywania API. Włączane przez order_cancel_failed_webhook_url.

Wyzwalane, gdy miejsce na tablicy tras zmienia właściciela lub tablica zmienia stan — pole action mówi, co się stało (claimed, standby, pooled, promoted, withdrawn, vetoed, replaced, assigned, awarded, lost, displaced, settled, board_opened, board_closed, board_cancelled). Tylko na poziomie firmy. Subskrypcja przez route_board_webhook_url.

Drzwiczki Otwarte — Uruchamia się w momencie otwarcia drzwiczek skrytek dla próby doręczenia — niezależnie od tego, czy kurier wpisał kod dostępu na ekranie automatu, czy użył API zdalnego otwierania — w tym ponowne otwarcia po zmianie skrytki. Blok opening wymienia każdą otwartą skrytkę z grid_id, sprzętowym numerem drzwiczek compartment_number oraz pickup_locker_number (kolejnym numerem wyświetlania liczonym od góry do dołu w kolumnie, a następnie od lewej do prawej). Każda skrytka zawiera też pickup_locker_code — etykietę "{shelf_code}-{pickup_locker_number}", pod którą kierowany jest odbiorca; null, gdy skrytka nie ma numeru odbioru. Ładunek zawiera również pickup_code — kod odbioru dla odbiorcy, przydzielany w chwili otwarcia drzwiczek; po potwierdzeniu umieszczenia przesyłki przez kuriera pozostaje tym samym kodem, a do odbioru można go użyć dopiero po tym potwierdzeniu.

Dostarczono do paczkomatu — Wyzwalane, gdy umieszczenie przesyłki zostanie potwierdzone i paczki są w skrytce. Ładunek zawiera kod odbioru odbiorcy. Każda skrytka zawiera też pickup_locker_code — etykietę "{shelf_code}-{pickup_locker_number}", pod którą kierowany jest odbiorca; null, gdy skrytka nie ma numeru odbioru. W przypadku skrytek otwartych przez API zdalnego otwierania platforma sama rozlicza umieszczenie, gdy tylko szafka zgłosi zamknięcie wszystkich otwartych skrytek, więc zdarzenie jest wyzwalane bez wywołania confirm; confirmed_by wskazuje ścieżkę rozliczenia: courier_terminal, partner_api, door_close, timeout_door_closed lub console.

Odebrano — Wyzwalane, gdy odbiorca odebrał umieszczone paczki.

Dostawa nieudana — Wyzwalane, gdy doręczenie się nie powiedzie; dołączone są kody błędów dla poszczególnych paczek.

Wygasło — Wyzwalane, gdy niewykorzystany kod doręczenia lub nieodebrana przesyłka przekroczy termin ważności.

Anulowano — Wyzwalane, gdy doręczenie zostanie anulowane przed ukończeniem.

Ponowne otwarcie korekcyjne — Wyzwalane, gdy zajęte skrytki zostaną ponownie otwarte w oknie korekty w celu poprawienia błędnego umieszczenia — z ekranu skrytki lub przez API. Blok correction wymienia ponownie otwarte skrytki. Każda skrytka zawiera też pickup_locker_code — etykietę "{shelf_code}-{pickup_locker_number}", pod którą kierowany jest odbiorca; null, gdy skrytka nie ma numeru odbioru.

partner_locker_delivery.event_type_code_rotated — Uruchamia się, gdy partner wymienia kod doręczenia albo kod odbioru przesyłki. Blok rotation wskazuje, który kod wymieniono, kiedy i czy ponownie wysłano powiadomienie do odbiorcy — nowy kod nigdy nie podróżuje w webhooku; ujawniany jest wyłącznie w bezpośredniej odpowiedzi API wymiany.

Przydział utworzony — Wyzwalane, gdy zamówienie zostaje przydzielone dostawcy — regułą automatyczną lub ręcznie. Payload zawiera numer przydziału, identyfikatory zamówienia i numery śledzenia paczek.

Paczki przekazane — Wyzwalane, gdy magazyn fizycznie przekazał dostawcy wszystkie paczki przydziału.

Przydział anulowany — Wyzwalane, gdy platforma wycofuje przydział od dostawcy. Pole reason rozróżnia: cancelled (przydział anulowano u przewoźnika), fallback_to_self_delivery (platforma przejęła zamówienie z powrotem do doręczeń własnych) oraz reassigned (zamówienie przeniesiono do innego dostawcy).

Dostawa częściowa — Uruchamia się, gdy część przesyłki została dostarczona, a pozostałe paczki są nadal w drodze. Tablica packages zawiera wynik każdej paczki, a legs wymienia zamówienia zewnętrzne złożone u przewoźnika — po jednym na paczkę, gdy przewoźnik nie przyjmuje przesyłek wielopaczkowych.

Do zamówienia przypisano kierowcę (ręcznie, przez planowanie tras lub przez automatyczne przypisywanie). data.source = auto_assign, gdy zrobił to orkiestrator.

Zamówienie straciło kierowcę (przekazanie, cofnięcie, odrzucenie, przekroczenie czasu). data.previous_driver_id wskazuje, kto je miał.

Kierowca zaakceptował w aplikacji automatycznie przypisane zamówienie (dyżury kierowców z wymaganą akceptacją).

Kierowca odrzucił przypisane zamówienie; data.reason zawiera opcjonalny powód w formie dowolnego tekstu.

Kierowca rozpoczął odbiór (status Rozpoczęto odbiór / W odbiorze).

Paczka została odebrana (status Już odebrane).

Paczka jest w drodze do odbiorcy (status Rozpoczęto dostawę / W dostawie).

Dostawa zakończyła się powodzeniem (status Zakończone sukcesem).

Próba dostawy nie powiodła się (Doręczyć później, Wymaga zmiany terminu, Odrzucone przez odbiorcę).

Zamówienie zostało anulowane.

Personel (lub kierowca, jeśli dozwolone) oznaczył zamówienie jako gotowe do odbioru (Opcje dyspozycji → gotowe do odbioru).

Kierowca rozpoczął lub zakończył dyżur w aplikacji (opcja dyżurów kierowców).

Pozycja kierowcy z aplikacji lub lokalizatora, ograniczana per kierowca przez driver_location_min_interval_sec (domyślnie 60 s). Wysyłana tylko na driver_location_webhook_url.

Paczka została umieszczona w urządzeniu i czeka na kolejną osobę (odbiorcę, kuriera lub operatora, zobacz data.device_order.next_actor). due_at to termin odbioru.

Paczkę wyjęła osoba, na którą czekała — odbiorca, kurier lub personel opróżniający skrzynkę smart drop.

Personel wyjął paczkę z urządzenia. removal_reason podaje powód: overdue_return, handover, relay, anomaly lub recovery.

Paczka przekroczyła due_at bez odbioru. Nadal jest w urządzeniu, a jej kod wciąż działa; ustawiane jest overdue_at, a next_actor zmienia się na operator.

Otwarto problem dotyczący obsługi (na przykład door_left_open, deposit_unverified, item_missing, overdue). data.exception zawiera id, type, severity i status.

Osoba zamknęła problem dotyczący obsługi. data.exception.status ma wartość resolved lub dismissed, a resolution_action określa, co zrobiono.