Günlük rota oluşturma
İş gününe başlamadan önce teslimatı yapan şirketin, rota ve sipariş bilgilerini İzleme Sistemi'nin veritabanına yüklemesi gerekir. Oluşturulan rotanın bilgileri otomatik olarak Yandex Courier uygulamasına yüklenir. Rotanın oluşturulmasıyla birlikte kuryenin sipariş sırası teslimatların zaman aralıkları ve trafik tahmini verileri dikkate alınarak otomatik olarak belirlenir.
Not
İzleme Sistemi API'siyle çalışmak için şirket ID'nizi kullanmanız gerekir. ID'niz yoksa lütfen bize ulaşın.
Rota oluşturma
API, belirli rotayı belirli kuryeye yalnızca belirli bir tarih için atar.
Şu kaynağa sorgu gönderin: routes-batch. Sorguda sipariş bilgilerini belirtin.
Postman aracılığıyla API sorguları göndermek için RouteQ API koleksiyonunu kullanabilirsiniz.
Uyarı
Şartname mevcut objeler için gerekli alanları içerir; yeni objeler için bu liste daha geniştir. routes-batch kaynağına yönelik bir sorgu yoluyla yeni objeler eklerken routes kaynağına gönderilen sorguda zorunlu olarak belirtilen alanları doldurun.
Sorgu:
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth sizin-token'ınız" -X POST -d @<UTF-8_kodlamasına_göre_dosya_yolu> https://courier.yandex.ru/api/v1/companies/<şirketinizin-id'si>/routes-batch
Dosya
[
{
"courier_number":"222",
"number":"23423-2000",
"date": "2017-08-08",
"depot_number":"111"
},
{
"courier_number":"224",
"number":"23423-2001",
"date": "2017-08-08",
"depot_number":"112"
}
]
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth OAuth-token'ınız" -X POST -d '[{"courier_number":"222", "number":"23423-2000", "date": "2017-08-08", "depot_number":"111"}, {"courier_number":"224", "number":"23423-2001", "date": "2017-08-08", "depot_number":"112"}]' https://courier.yandex.ru/api/v1/companies/<şirketinizin-id'si>/routes-batch
Sonuç:
{
"inserted": 2,
"updated": 0
}
Veritabanını siparişlerle doldurma
API'de siparişler rotaya bağlanır. Rotadaki siparişler ekleme sırasına göre düzenlenir. Gerekirse, sırayı orders-sequence kaynağına sorgu göndererek değiştirebilirsiniz.
Şu kaynağa sorgu gönderin: orders-batch. Sorguda sipariş bilgilerini belirtin.
Uyarı
Şartname mevcut objeler için gerekli alanları içerir; yeni objeler için bu liste daha geniştir. orders-batch kaynağına yönelik bir sorgu yoluyla yeni objeler eklerken orders kaynağına gönderilen sorguda zorunlu olarak belirtilen alanları doldurun.
Sorgu:
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth sizin-token'ınız" -X POST -d @<UTF-8_kodlamasına_göre_dosya_yolu> https://courier.yandex.ru/api/v1/companies/<şirketinizin-id'si>/orders-batch
Dosya
[
{
"number":"222239",
"route_number":"23423-2000",
"address":"Alemdar, 34110 Fatih/İstanbul",
"lat": 41.0109,
"lon": 28.9697,
"customer_name": "Mark",
"phone": "+905551234567",
"status":"new",
"time_interval":"11-12"
},
{
"number":"222241",
"route_number":"23423-2001",
"address":"Kalenderhane, 34134 Fatih/İstanbul",
"lat": 41.0151,
"lon": 28.9582,
"customer_name": "Sarah",
"phone": "+905551234568",
"status":"new",
"time_interval":"10:00 - 11:00"
}
]
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth OAuth-token'ınız" -X POST -d '[{"number":"222239", "route_number":"23423-2000", "address":"Alemdar, 34110 Fatih/İstanbul", "lat": 41.0109, "lon": 28.9697, "customer_name": "Mark", "phone": "+905551234567", "status":"new", "time_interval":"11-12"}, {"number":"222241", "route_number":"23423-2001", "address":"Kalenderhane, 34134 Fatih/İstanbul", "lat": 41.0151, "lon": 28.9582, "customer_name": "Sarah", "phone": "+905551234568", "status":"new", "time_interval":"10:00 - 11:00"}]' https://courier.yandex.ru/api/v1/companies/<şirketinizin-id'si>/orders-batch
Sonuç:
{
"inserted": 2,
"updated": 0
}
Yüklenen verilerin doğruluk kontrolü
Tüm verilerin doğru yüklendiğini kontrol etmek için verification kaynağına sorgu gönderin. Sunucudan gelen yanıt, belirtilen tarihteki tüm siparişlerle ilgili bilgileri içerir. Elde edilen bilgileri, teslimatı yapan şirketin veritabanındaki bilgilerle karşılaştırabilirsiniz.
Sorgu:
curl -H "Authorization: OAuth OAuth-token'ınız" -X GET https://courier.yandex.ru/api/v1/companies/<şirketinizin-id'si>/verification?date=2018-01-01
Sonuç:
[
{
"order_id": "20170513-713",
"time_interval": "12-23",
"route_number": "23423-2000",
"courier_id": "kuryenizin-numarası",
"status": "finished",
"phone": "+9055512345678",
"address":"Alemdar, 34110 Fatih/İstanbul",
"lat": 41.0109,
"lon": 28.9697
},
{
"order_id": "20170513-329",
"time_interval": "12-52",
"route_number": "23423-2001",
"courier_id": "8272",
"status": "finished",
"phone": "+9055512345679",
"address":"Kalenderhane, 34134 Fatih/İstanbul",
"lat": 41.0151,
"lon": 28.9582
}
]