Webhook ile Gönderi Takibi #
Gönderi durumu değiştiğinde Geliver sizin sisteminizi çağırabilir, böylece sürekli istek yapmanıza (pull) gerek kalmaz. https://app.geliver.io/webhooks adresinde sizi çağıracağımız URL’yi eklemeniz gerekiyor.
Webhook Testi #
Webhook’unuzu test etmek için test: true ile gönderi oluşturup GELIVER_STANDART olanı kabul edin. Daha sonra Geliver gönderi sayfasında gönderiyi her açtığınızda (Sayfayı yenileyebilirsiniz) kargonun durumu bir sonraki aşamaya geçecektir. Geliver gönderi sayfasını kullanmak yerine dilerseniz shipment’a GET isteği de yapabilirsiniz durum güncellemesi için.
Webhook Formatı (Geliver size iletecek) #
{
"id":"186af322-c9ad-407c-b798-64d464816cf4",
"trackingNumber":"123123123",
"trackingUrl": "http://xxx.com/123123123",
"barcode": "A123345",
...
"trackingStatus":{
"id": "3b8ecf37-4e9d-4b73-aed5-13abcdc427e0",
"createdAt": "2022-04-28T16:16:37.217468Z",
"updatedAt": "2022-04-28T16:16:37.217468Z",
"trackingStatusCode": "DELIVERED",
"trackingSubStatusCode": "delivered",
"statusDetails": "Teslim Edildi",
"statusDate": "2022-04-23T14:29:45.06Z",
"locationName": "Sarnıç Mikro"
...
}
Alan Açıklamaları
Alan İsmi | Açıklama |
---|---|
trackingStatusCode | Gönderinin o anki genel durumu (PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE, UNKNOWN) |
trackingSubStatusCode | Gönderinin o anki detaylı durumu. Aşağıdaki tabloda tüm değerleri görebilirsiniz. |
statusDetails | Yazılı olarak gönderinin o anki durumu. Genelde kargo firması bunu belirtir. |
statusDate | Gönderi durumunun güncellendiği zaman |
locationName | Gönderi durumu alındığındaki paketin konumu. |
Kargo Durum Değerleri
trackingStatusCode | trackingSubStatusCode | Açıklama |
---|---|---|
PRE_TRANSIT | information_received | Kargo sistemde oluşturuldu |
TRANSIT | package_accepted | Kargo, Gönderici şube tarafından teslim alındı. |
TRANSIT | package_departed | Kargo, aktarma merkezinden ayrıldı |
TRANSIT | package_processing | Kargo aktarma merkezinde |
TRANSIT | delivery_scheduled | Kargo alıcı şubede |
TRANSIT | out_for_delivery | Kargo dağıtımda |
TRANSIT | package_damaged | Paket hasarlı |
TRANSIT | package_forwarded_to_another_carrier | Kargo aracı firmaya verildi |
TRANSIT | delivery_rescheduled | Kargo dağıtım zamanı değişti (yanlış şube vs) |
DELIVERED | delivered | Kargo alıcıya teslim edildi |
FAILURE | package_lost | Paket kayboldu |
FAILURE | package_undeliverable | Kargo dağıtılamıyor |
RETURNED | return_to_sender | Kargo iade edildi |
UNKNOWN | other | Bilinmeyen durum |