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://track.carrtell.co/check/MFYS29970",
        "carrier_tracking_url": "https://kargotakip.mngkargo.com.tr/?takipNo=XXX",
        "barcode": "https://barcode.carrtell.co/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 Teslimat Biriminde
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 Teslimat Biriminde
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