Webhooki

 

Webhook jest efektywną i prostą metodą komunikacji pomiędzy aplikacjami pozwalający na wysyłanie powiadomień pod ustalony adres URL, bezpośrednio po zmianie statusu przesyłki. Dzięki temu zintegrowane aplikacje zewnętrzne zostają natychmiast powiadomione o wystąpieniu zmian bez wymogu powtarzającego się odpytywania API o status przesyłki.

 


Dla środowiska produkcyjnego adres webhook można dodać na stronie https://manager.paczkomaty.pl/zaloguj  w zakładce Moje konto >API.

Dla środowiska sandbox adres webhook można dodać na stronie https://sandbox-manager.paczkomaty.pl/  w zakładce Moje konto >API.

Na tej stronie



Struktura

Przekazany adres musi spełniać 3 podstawowe warunki

  • poprawna budowa adresu URL

  • dostęp do zasobu, do którego kieruje wprowadzony adres URL

  • zasób powinien odpowiedzieć kodem HTTP 200 na zapytanie GET


Przykładowa struktura adresu:

https://www.serwer.pl:8080/katalog1/katalog2/plik.xxx

 

Gdzie:

  • https (protokół)

  • www.serwer.pl (adres)

  • 8080 (port)

  • /katalog1/katalog2/plik.xxx (ścieżka do pliku, proszę podawać małą literą)

 

Należy pamiętać, że webhooki są wysyłane z zakresu adresów IP 91.216.25.0/24. Ten zakres adresów IP ma zastosowanie do webhooków wysyłanych w środowisku produkcujnym jak i sandbox.


 

 

Dane wysyłane w przypadku gdy przesyłka zostanie utworzona

{ "event_ts": "2020-03-20 15:08:06 +0100", "event": "shipment_confirmed", "organization_id": 1, "payload": { "shipment_id": 49, "tracking_number": "602677439331630337653846" } }

 

Dane wysłane w przypadku gdy status przesyłki uległ zmianie

{ "event_ts": "2020-03-20 15:08:42 +0100", "event": "shipment_status_changed", "organization_id": 1, "payload": { "shipment_id": 49, "status": "delivered", "tracking_number": "602677439331630337653846" } }

 

Dane wysyłane w przypadku gdy przesyłka zostanie utworzona w statusie offers_prepared (przesyłka tworzona w trybie ofertowym)

 

Dane wysyłane w przypadku gdy przesyłka otrzyma status ZDN (Zwrot do Nadawcy - returned_to_sender)