Поиск по сайту

API
Главная / API - Трекер заказов

Трекер заказов

Обновлено 03.10.2017
97 кб

Общие сведения

Сервис позволяет получить информацию о заказе, используя номер заказа, накладной или заявки.

Поиск заказа по номеру заявки, заказа, накладной

Запрос метода

Пример запроса

Адрес метода: https://api.dellin.ru/v2/public/tracker.json

{  
   "appkey":"00000000-0000-0000-000000000000",
   "docid":"63763576"
}

Адрес метода: https://api.dellin.ru/v2/public/tracker.xml

<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
   <docid>63763576</docid>
</request>

Описание параметров

Request
ПараметрR*ТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
docidДаstringНомер заказа, накладной или заявки

Ответ метода

Ниже приведён пример ответа метода с полным списком параметров (независимо от статуса заказа). В таблице с описанием параметров ответа метода в последнем столбце указаны статусы заказа, для которых фактически выводятся соответствующие параметры.

Пример ответа

{  
   "order_id":123456,
   "is_container":true,
   "state":"processing",
   "state_name":"В обработке",
   "derival_city":"Омск",
   "arrival_city":"Самара",
   "decline_reason":"Опасный груз",
   "sf_request_ordered":false,
   "sfrequest":{  
      "price":"500",
      "cityID":234,
      "docNumber":"16-123456789"
   },
   "derival_city_id":8,
   "derival_terminal_id":53,
   "arrival_contact_id":15,
   "arrival_city_id":21,
   "arrival_cc_phones":"8-800-100-8000",
   "arrival_terminal_address":"Внуковская, д.2",
   "arrival_terminal_phones":"7 (812) 448-88-88",
   "arrival_terminal_email":"pismo@dellin.ru",
   "arrival_terminal_coordinates":["30.311464","59.805924"],
   "worktables":{  
      "mon":"9:00-18:00",
      "tue":"9:00-18:00",
      "wed":"9:00-18:00",
      "thu":"9:00-18:00",
      "fri":"9:00-18:00",
      "sat":"9:00-15:00",
      "sun":"-"
   },
   "air_order_id":123456,
   "is_air":false,
   "comment":"комментарий",
   "blocked_by_payment":false,
   "blocked_by_blacklist":false,
   "order_dates":{  
      "finish":"2017-03-30",
      "arrival_to_receiver":"2017-03-30",
      "arrival_to_osp_sender":"2017-03-30",
      "arrival_to_osp_receiver_accdoc":"2017-03-30",
      "first_document_created_date":"2017-03-30",
      "draft_last_update":"2017-03-30",
      "derival_from_osp_sender":"2017-03-29",
      "derival_from_osp_receiver_accdoc":"2017-03-30",
      "arrival_to_osp_receiver":"2017-03-30",
      "processing_date":"2017-03-25",
      "derival_from_osp_receiver":"2017-03-30",
      "warehousing":"2017-03-30",
      "decline_date":"2017-03-30",
      "pickup":"2017-03-28"
   },
   "order_time_in_days":{  
      "delivery":0,
      "delivery_accdoc":null
   }
}
<response>
   <order_id>123456</order_id>
   <is_container>true</is_container>
   <state>processing</state>
   <state_name>В обработке</state_name>
   <derival_city>Омск</derival_city>
   <arrival_city>Самара</arrival_city>
   <decline_reason>Опасный груз</decline_reason>
   <sf_request_ordered>false</sf_request_ordered>
   <sfrequest>
      <price>500</price>
      <cityID>234</cityID>
      <docNumber>16-123456789</docNumber>
   </sfrequest>
   <derival_city_id>8</derival_city_id>
   <derival_terminal_id>53</derival_terminal_id>
   <arrival_contact_id>15</arrival_contact_id>
   <arrival_city_id>21</arrival_city_id>
   <arrival_cc_phones>8-800-100-8000</arrival_cc_phones>
   <arrival_terminal_address>Внуковская, д.2</arrival_terminal_address>
   <arrival_terminal_phones>7 (812) 448-88-88</arrival_terminal_phones>
   <arrival_terminal_email>pismo@dellin.ru</arrival_terminal_email>
   <arrival_terminal_coordinates>30.311464</arrival_terminal_coordinates>
   <arrival_terminal_coordinates>59.805924</arrival_terminal_coordinates>
   <worktables>
      <mon>9:00-18:00</mon>
      <tue>9:00-18:00</tue>
      <wed>9:00-18:00</wed>
      <thu>9:00-18:00</thu>
      <fri>9:00-18:00</fri>
      <sat>9:00-15:00</sat>
      <sun>-</sun>
   </worktables>
   <air_order_id>123456</air_order_id>
   <is_air>false</is_air>
   <comment>комментарий</comment>
   <blocked_by_payment>false</blocked_by_payment>
   <blocked_by_blacklist>false</blocked_by_blacklist>
   <order_dates>
      <finish>2017-03-30</finish>
      <arrival_to_receiver>2017-03-30</arrival_to_receiver>
      <arrival_to_osp_sender>2017-03-30</arrival_to_osp_sender>
      <arrival_to_osp_receiver_accdoc>2017-03-30</arrival_to_osp_receiver_accdoc>
      <first_document_created_date>2017-03-30</first_document_created_date>
      <draft_last_update>2017-03-30</draft_last_update>
      <derival_from_osp_sender>2017-03-29</derival_from_osp_sender>
      <derival_from_osp_receiver_accdoc>2017-03-30</derival_from_osp_receiver_accdoc>
      <arrival_to_osp_receiver>2017-03-30</arrival_to_osp_receiver>
      <processing_date>2017-03-25</processing_date>
      <derival_from_osp_receiver>2017-03-30</derival_from_osp_receiver>
      <warehousing>2017-03-30</warehousing>
      <decline_date>2017-03-30</decline_date>
      <pickup>2017-03-28</pickup>
   </order_dates>
   <order_time_in_days>
      <delivery>0</delivery>
      <delivery_accdoc />
   </order_time_in_days>
</response>

Описание параметров

Response
ПараметрТипОписаниеСтатусы заказа
order_idstringНомер заказаВсе
is_containerbooleanФлаг контейнерной перевозкиВсе
statestring

Статус (на английском языке)

Все
state_namestringСтатус (на русском языке) Все
derival_citystringГород отправителяВсе, кроме "draft"
arrival_citystringГород получателяВсе, кроме "draft"
decline_reasonstringПричина отклонения"declined"
sf_request_orderedbooleanФлаг, обозначающий что заказана доставка до адреса получателя
  • "pickup"
  • "waiting"
  • "received"
  • "received_warehousing"
  • "inway"
  • "arrived"
  • "warehousing"
sfrequest
objectИнформация по заявке на доставку до адреса получателя
  • "pickup" *
  • "received" *
  • "received_warehousing" *
  • "inway" *
  • "arrived" *
  • "warehousing" *

* Если существует накладная, и заявка до адреса может быть заказана

sfrequest.pricestringСтоимостьСм. объект "sfrequest"
sfrequest.cityIDstringID города из "Справочника терминалов"См. объект "sfrequest"
sfrequest.docNumberstringНомер накладнойСм. объект "sfrequest"
derival_city_idintegerID города отправления из "Справочника населенных пунктов"
  •  "waiting"
derival_terminal_idintegerID терминала-отправителя из "Справочника терминалов"
  • "waiting"
arrival_contact_id
integerID контактного лица терминала-получателя из "Справочника терминалов"
  • "received"
  • "received_warehousing"
  • "arrived"
  • "warehousing"
arrival_city_idintegerID города прибытия из "Справочника населенных пунктов"Аналогично параметру "arrival_contact_id"
arrival_cc_phonesstringТелефон колл-центраАналогично параметру "arrival_contact_id "
arrival_terminal_addressstringАдрес терминала храненияАналогично параметру "arrival_contact_id "
arrival_terminal_phonesstringТелефон терминала храненияАналогично параметру "arrival_contact_id "
arrival_terminal_emailstringE-mail терминала храненияАналогично параметру "arrival_contact_id "
arrival_terminal_coordinatesarray of stringДолгота и широта терминала храненияАналогично параметру "arrival_contact_id "
worktablesobjectГрафик работы терминала хранения (график выдачи груза)Аналогично параметру "arrival_contact_id "
worktables.monstringГрафик работы терминала хранения в понедельникАналогично параметру "arrival_contact_id "
worktables.tuestringГрафик работы терминала хранения во вторникАналогично параметру "arrival_contact_id "
worktables.wedstringГрафик работы терминала хранения в средуАналогично параметру "arrival_contact_id "
worktables.thustringГрафик работы терминала хранения в четвергАналогично параметру "arrival_contact_id "
worktables.fristringГрафик работы терминала хранения в пятницуАналогично параметру "arrival_contact_id "
worktables.satstringГрафик работы терминала хранения в субботуАналогично параметру "arrival_contact_id "
worktables.sunstringГрафик работы терминала хранения в воскресеньеАналогично параметру "arrival_contact_id "
air_order_idintegerНомер авианакладной
  • arrived_to_airport
  • airport_warehousing
is_airbooleanФлаг авиаперевозкиВсе
commentstringКомментарий
  • arrived_to_airport
  • airport_warehousing
blocked_by_paymentbooleanБлокировка груза по оплате

Все, кроме:

  • "draft"
  • "processing"
  • "finished"
blocked_by_blacklistbooleanГруз не готов к выдаче. Если содержит true, необходимо обратиться к специалистам для получения консультации
  • "arrived"
  • "warehousing"
order_datesobjectРасчетный график движения груза (если значение параметра "is_air" = "false". В противном случае значения всех параметров данного объекта будут содержать "null")Все
order_dates.finishstringДата исполнения заказаВсе
order_dates.arrival_to_receiverstringДата доставки груза до адресаВсе
order_dates.arrival_to_osp_senderstringДата прибытия груза на терминал-отправительВсе
order_dates.arrival_to_osp_receiver_accdocstringДата прибытия сопроводительных документов на терминал-получательВсе
order_dates.first_document_created_datestringДата создания первого документа по заказуВсе
order_dates.draft_last_updatestringДата последнего сохранения черновикаВсе
order_dates.derival_from_osp_senderstringДата отвоза груза из терминала-отправителяВсе
order_dates.derival_from_osp_receiver_accdocstringДата отвоза сопроводительных документов из терминала-получателяВсе
order_dates.arrival_to_osp_receiverstringДата прибытия груза на терминал-получательВсе
order_dates.processing_datestringДата отправки заявки в обработкуВсе
order_dates.derival_from_osp_receiverstringДата отправки из терминала-получателяВсе
order_dates.warehousingstringДата начала платного храненияВсе
order_dates.decline_datestringДата отклоненияВсе
order_dates.pickupstringДата забора груза от адресаВсе
order_time_in_daysobjectРасчетные сроки доставки в днях (если значение параметра "is_air" = "false". В противном случае значения всех параметров данного объекта будут содержать "null")Все
order_time_in_days.deliveryintegerСрок доставки до адреса, дн.Все
order_time_in_days.delivery_accdocintegerСрок доставки сопроводительных документов до адреса, дн.Все

В системе предусмотрены следующие статусы заказов:

Статусы заказов
На английском языкеНа русском языке
draftЧерновик
processingВ обработке
pickupЗабор груза от адреса
waitingОжидает сдачи на терминал
declinedОтклонен

received

received_warehousing

Груз принят к перевозке
inwayГруз в пути

arrived

warehousing

Груз прибыл на терминал

arrived_to_airport

airport_warehousing

Груз прибыл в аэропорт
deliveryДоставка груза до адреса
accompanying_documents_returnВозврат сопроводительных документов
finishedЗаказ завершен

Обработка ошибок

Если не передан номер заказа, накладной или заявки, вернётся следующий ответ: 

Пример ответа

{  
   "errors":{  
      "docid":"Требуется"
   }
}
<response>
   <errors>
      <docid>Требуется</docid>
   </errors>
</response>

Если заказ не найден, вернётся ответ:

{  
   "errors":{  
      "docid":"Заказ не найден"
   }
}
<response>
   <errors>
      <docid>Заказ не найден</docid>
   </errors>
</response>