Method | URL | İçerik Türü |
---|---|---|
POST | post/check | application/json |
Açıklama
Servise Gönderilmesi gereken zorunlu başlıklar
Parametre ismi | Tip | Zorunluluk | Açıklama |
---|---|---|---|
Authorization | Bearer | evet | auth/login metodundan aldığınız token |
Servise Gönderilmesi gereken parametreler [post array içi]
Parametre ismi | Tip | Zorunluluk | Açıklama |
---|---|---|---|
post_number | string | evet|hayır | Gönderi Numarası |
reference_id | string | evet|hayır | Gönderi için benzersiz bir id |
sender_name | string | evet|hayır | Gönderici adı |
sender_phone | string | evet|hayır | Gönderici telefon numarası |
sender_email | string | evet|hayır | Gönderici e-posta adresi |
recipient_name | string | evet|hayır | Alıcının adı |
recipient_phone | string | evet|hayır | Alıcının telefon numarası |
recipient_email | string | evet|hayır | Alıcının e-posta adresi |
Servise Gönderilmesi gereken parametreler [post array dışı]
Parametre ismi | Tip | Zorunluluk | Açıklama |
---|---|---|---|
limit | int | evet | Maksimum 50 olabilir |
Örnek İstek
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '__APIURL__/post/check',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"post": {
"post_number": "",
"reference_id": "",
"sender_name": "",
"sender_email": "",
"sender_phone": "",
"recipient_name": "",
"recipient_email": "",
"recipient_phone": "+90 532 123 45 67"
},
"limit": 50
}',
CURLOPT_HTTPHEADER => array(
'X-localization: tr',
'Content-Type: application/json',
'Authorization: Bearer __TOKEN__',
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Ö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 |