Gönderi Sorgulama

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_post_number": "12345678",
        "carrier_tracking_code": "3547896654321",
        "carrier_tracking_url": "https://kargotakip.mngkargo.com.tr/?takipNo=XXX",
        "barcode": "https://domestic-qa-barcode.navlungo.com/MFYS29970.pdf",
        "barcode_status": 1,
        "post": {
            "carrier_id": 9,
            "carrier_name": "Sürat Kargo",
            "carrier_status": 1, // Seçilen taşıyıcıda oluşma durumu
            "geo_status": 2, // Geocode Durumu 0- İşlemde 1- Başarısız 2- Başarılı
            "geo_bad_address": 0 // Geocode adres durumu 0 - Adres doğru 1 - Adres yanlış
            "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,
                "post_price": 41.76,
                "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"
            }
        ],
        "carrierBarcodes": [
            {
                "barcode_number": "19246232634415"
            },
            {
                "barcode_number": "93683061581758"
            },
            {
                "barcode_number": "54443589874675"
            }
        ]
    }
}

 

Servis Çıktısı Anlamları

Alan Adı Açıklama 
barcode_status Barkod oluşma durumu
0- Oluşmadı 1- Oluştu
carrier_post_number Taşıyıcıya Ait Özel Gönderi Numarası
* sadece belli taşıyıcılarda oluşur
carrier_tracking_code Taşıyıcı Takip Numarası
post.carrier_status Gönderinin taşıyıcıda oluşma durumu
1- Oluştu 0- Oluşmadı
post.geo_status Gönderinin Kapsam Alanı Durumu
0- İşlemde 1- Başarısız 2- Başarılı
post.geo_bad_address Gönderici ya da alıcı adresi durumu
0- Adres Doğru 1- Adres Yanlış * adres bilgisi yanlış ise tekrar düzeltilmesi önerilir.
carrierBarcodes Bazı taşıyıcılarda çoklu paketlerde oluşan barkod numaraları
(Her taşıyıcıda oluşmayacaktır)

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
9 İade Edildi
10 İptal
14 Ön İzleme
16 Teslim Alındı
17 Transfer Aşamasında
18 Şubede Beklemede
19 Tazmin Durumu Değerlendiriliyor
20 Tazmin Süreci Tamamlandı
21 Depoya İade Edildi

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
webhook_return_to_warehouse 21 Depoya İade Edildi