API V1.0 - 3.2. ТРЕКИНГ ПО ОТПРАВЛЕНИЯМ POST
Получение данных трекинга по отправлениям
URL-Адрес запроса:
https://api.sat.ua/study/hs/api/v1.0/tracking/{format}[?apiKey]Параметры запроса:
Текст запроса (доступные поля):
-
Массив номеров или идентификаторов накладных на груз:
-
number:
номер или массив номеров накладных или накладных
-
ref :
идентификатор или массив идентификаторов накладных (Доступно только при условии указания корректного ключа apiKey и только по накладным, созданным с этим ключом).
пример запроса
<request>
<number>006002524</number>
<number>015010663</number>
<ref>d2eda3e2-4b55-49ad-aeb3-1d728237ac11</ref>
</request>
Ответ 200
Данные по запрошенным накладным на груз. Значения возвращаемых полей:
-
number:
номер накладной
-
currentStatus:
текущий статус накладной на груз. По выданным накладным все дальнейшие поля выводятся только авторизованным пользователям
-
sum:
сумма по накладной на груз
-
weight:
вес груза
-
width:
ширина всех мест отправления
-
length:
длина всех мест отправления
-
height:
высота всех мест отправления
-
seatsAmount:
количество мест
-
общий объем всех мест отправления:
объём
-
cargoType:
тип груза
-
date:
дата отправки накладной
-
arrivalDate:
дата прибытия на склад отделения получателя груза
-
type:
тип услуги перевозки
-
rspFrom:
отделение отправки груза
-
rspTo:
отделение получения груза
-
payData:
информация о плательщиках за перевозку, массив
-
payerId:
идентификатор плательщика
-
sum:
сумма оплаты
-
states:
информация об изменении состояния накладной, массив
-
date:
дата записи об изменении состояния
-
status:
стан
-
town:
город
пример ответа
<response>
<success>true</success>
<data>
<item>
<number>009000119</number>
<currentStatus>Поступил на склад выдачи</currentStatus>
<sum>266</sum>
<weight>15</weight>
<width>0</width>
<length>0</length>
<height>0</height>
<seatsAmount>1</seatsAmount>
<volume>0</volume>
<cargoType>Стандарт (от 10 кг)</cargoType>
<date>15.04.2015</date>
<arrivalDate>15.04.2015</arrivalDate>
<type>склад-склад</type>
<rspFrom>Харків</rspFrom>
<rspTo>Київ</rspTo>
<payData>
<payerId>Получатель</payerId>
<sum>266</sum>
</payData>
<states>
<date>15.04.2015</date>
<status>Принят</status>
<town>Харків</town>
</states>
<states>
<date>15.04.2015</date>
<status>Поступил на склад выдачи</status>
<town>Київ</town>
</states>
</item>
</data>
</response>
интерфейсы API