Method | URL | İçerik Türü |
---|---|---|
GET | post/check/{{POST_NUMBER}} veya {{REFERENCE_ID}} | - |
Açıklama
- Bu metod, mevcut gönderi bilgilerini sorgulamak amacıyla kullanılır. Kullanıcılar veya işyerleri, belirli bir gönderi hakkında detaylı bilgilere erişmek istediklerinde bu metodu kullanarak API aracılığıyla sorgulama yapabilirler. Bu metod, gönderinin durumu, teslimat aşamaları, tahmini teslim süresi gibi bilgileri almak için kullanılır. Kullanıcılar, gönderinin nerede olduğunu ve hangi aşamada olduğunu bu metodu kullanarak öğrenebilirler.
- Gönderinizin durumunu post_number veya reference_id kullanarak sorgulayabilirsiniz. Bunun için hangi numarayı kullanmak istiyorsanız istekte o numarayı göndermeniz gerekmektedir.
Servise Gönderilmesi gereken zorunlu başlıklar
Parametre ismi | Tip | Zorunluluk | Açıklama |
---|---|---|---|
Authorization | Bearer | evet | auth/login metodundan aldığınız token |
Örnek İstek
<?php
$ch = curl_init('__APIURL__/post/check/MFYS29970');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER,
array(
'X-localization : tr',
'Content-Type : application/json',
'Authorization : Bearer __TOKEN__',
));
$result = curl_exec($ch);
curl_close($ch);
print_r($result);
?>
Örnek Servis Cevapları
{
"status": true,
"message": null,
"data": {
"post_number": "MFYS29970",
"reference_id": "LDTN64JV124",
"tracking_url": "https://domestic-track.navlungo.com/check/MFYS29970",
"carrier_tracking_url": "https://kargotakip.mngkargo.com.tr/?takipNo=XXX",
"barcode": "https://domestic-qa-barcode.navlungo.com/MFYS29970.pdf",
"post": {
"carrier_id": 4,
"carrier_name": "MNG Kargo",
"post_type": 2,
"post_type_name": "Standart Teslimat",
"cod_payment_type": 0,
"cod_payment_type_name": "Peşin Ödeme",
"cod_comission": 0,
"sender": {
"name": "John Doe",
"phone": "+90 535 123 45 67",
"email": "sender@firma.com",
"address": "Deneme Mahallesi, Dolmabahçe Caddesi",
"country": "tr",
"city": "İstanbul",
"district": "Ataşehir",
"post_code": "34700"
"latitude": "41.164432423",
"longitude": "29.09"
},
"recipient": {
"name": "John Doe",
"phone": "+90 535 123 45 67",
"email": "recipient@firma.com",
"address": "Deneme Mahallesi, Ural Sk. No:999",
"country": "tr",
"city": "İstanbul",
"district": "Maltepe",
"post_code": "34860"
"latitude": "111.22",
"longitude": "333.11"
},
"post": {
"desi": 2.2,
"package_count": 1,
"price": 34,
"calculated_price": 41.76,
"measured_dominant_weight" : 2.2,
"measured_box_count" : 1
"note": null
},
"custom_data_1": null,
"custom_data_2": null,
"custom_data_3": null,
"custom_data_4": null,
"created_at": "2023-05-25 12:55:28",
"updated_at": "2023-05-25 12:55:28"
},
"status": {
"status_code": 2,
"status_name": "Teslim Edildi",
"picked_up_date": "2023-08-21 14:27:37",
"delivered_person_name": null,
"delivered_person_phone": null,
"delivery_note": null,
"delivery_cancel_reason": null,
"delivered_date": "2023-08-22 09:47:41",
"cancel_date": null
},
"logs": [
{
"status_code": 2,
"action": "webhook_delivered",
"action_result": "Teslim Edildi",
"updated_by": null,
"created_at": "2023-08-22 12:47:41"
},
{
"status_code": 4,
"action": "webhook_out_for_delivery",
"action_result": "Yola Çıktı",
"updated_by": null,
"created_at": "2023-08-22 11:27:52"
},
{
"status_code": 3,
"action": "webhook_to_be_delivered",
"action_result": "Teslim Edilecek",
"updated_by": null,
"created_at": "2023-08-22 10:07:47"
},
{
"status_code": 17,
"action": "webhook_in_transit",
"action_result": "Transfer Aşamasında",
"updated_by": null,
"created_at": "2023-08-21 17:27:37"
},
{
"status_code": 16,
"action": "webhook_picked_up",
"action_result": "Teslim Alındı",
"updated_by": null,
"created_at": "2023-08-21 17:27:37"
},
{
"status_code": 1,
"action": "api_create_post",
"action_result": "Gönderi Oluşturuldu.",
"updated_by": "Firma Adı",
"created_at": "2023-08-21 15:39:02"
}
]
}
}
Servis Statü Kodları ve Anlamları
Statü Kodu | Açıklama |
---|---|
1 | Teslim Alınacak |
2 | Teslim Edildi |
3 | Teslim Edilecek |
4 | Dağıtıma Çıktı |
5 | Tekrar Sevk |
6 | Dağıtım Planlandı |
7 | İade Edilecek |
8 | İade Edilecek (Kapsam Dışı) |
9 | İade Edildi |
10 | İptal |
11 | İptal (Kapsam Dışı) |
12 | İptal (Geri Alındı) |
13 | Tamamlandı |
14 | Ön İzleme |
15 | Silindi |
16 | Teslim Alındı |
17 | Transfer Aşamasında |
18 | Şubede Beklemede |
19 | Tazmin Durumu Değerlendiriliyor |
20 | Tazmin Süreci Tamamlandı |
Webhook Aksiyon Kodları ve Anlamları
Aksiyon | Servis Statü Kodu | Açıklama |
---|---|---|
webhook_delivered | 2 | Teslim Edildi |
webhook_to_be_delivered | 3 | Teslim Edilecek |
webhook_out_for_delivery | 4 | Dağıtıma Çıktı |
webhook_redispatch | 5 | Tekrar Sevk |
webhook_delivery_planned | 6 | Dağıtım Planlandı |
webhook_to_returned | 7 | İade Edilecek |
webhook_returned | 9 | İade Edildi |
webhook_picked_up | 16 | Teslim Alındı |
webhook_in_transit | 17 | Transfer Aşamasında |
webhook_waiting_at_branch | 18 | Şubede Beklemede |