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

API
Главная / API - Поиск заказа по неполным данным

Поиск заказа по неполным данным

Обновлено 12.03.2020
86 кб

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

Сервис позволяет осуществлять поиск заказов, используя следующие данные: ИНН (для юридических лиц), тип и номер документа (для физических лиц), маршрут перевозки и дату отправки заказа.

Поиск заказа по неполным данным

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

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

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

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sender":{
      "inn":"7122963715",
      "docType":"passport",
      "docSeries":"4007",
      "docNumber":"451735",
      "terminal":"7800000000000000000000000"
   },
   "receiver":{
      "inn":"4516374515",
      "docType":"foreignPassport",
      "docSeries":"4008",
      "docNumber":"236782",
      "terminal":"7700000000000000000000000"
   },
   "dateStart":"2015-08-10",
   "dateEnd":"2015-08-17"
}

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

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sender>
      <inn>7122963715</inn>
      <docType>passport</docType>
      <docSeries>4007</docSeries>
      <docNumber>451735</docNumber>
      <terminal>7800000000000000000000000</terminal>
   </sender>
   <receiver>
      <inn>4516374515</inn>
      <docType>foreignPassport</docType>
      <docSeries>4008</docSeries>
      <docNumber>236782</docNumber>
      <terminal>7700000000000000000000000</terminal>
   </receiver>
   <dateStart>2015-08-10</dateStart>
   <dateEnd>2015-08-17</dateEnd>
</request>

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

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

sender

НетMember

Информация об отправителе

receiver

НетMember

Информация о получателе

dateStartДаstring

Начальная дата периода (для фильтрации результатов поиска по дате отправки заказа).

Формат: "ГГГГ-ММ-ДД"

Интервал между начальной и конечной датами периода не должен превышать 7 дней.
dateEndДаstring

Конечная дата периода (для фильтрации результатов поиска по дате отправки заказа).

Формат: "ГГГГ-ММ-ДД"

Интервал между начальной и конечной датами периода не должен превышать 7 дней.

Member
Member
ПараметрОбязательныйТипОписание
inn
Нетstring

ИНН (для юридических лиц)

docType
Нетstring

Тип документа (для физических лиц)

Доступные варианты:

  • "passport" - паспорт;
  • "foreignPassport" - загран. паспорт;
  • "drivingLicence" - водительское удостоверение
docSeriesНетstring

Серия документа (для физических лиц)

docNumberНетstringНомер документа (для физических лиц)
terminalНетstring

Код КЛАДР пункта отправления (для объекта "") или доставки (для объекта "request.receiver") . Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР"

Ответ метода

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

{
   "metadata":{
      "status":200,
      "generated_at":"2015-06-18 12:37:28"
   },
   "data":{
      "orderNumbers":[
         "19-00395029101",
         "19-00395029585",
         "19-0039514523"
      ]
   }
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <data>
      <orderNumbers>19-00395029101</orderNumbers>
      <orderNumbers>19-00395029585</orderNumbers>
      <orderNumbers>19-0039514523</orderNumbers>
   </data>
</response>

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

Response
Response
ПараметрТипОписание
metadataobjectСистемная информация
metadata.statusinteger

Эмуляция http-кода состояния. В случае успешного выполнения возвращается код "200"

metadata.generated_atstring

Дата и время генерации ответа сервера.

Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС"

dataobjectДанные о заказах
data.orderNumbersarray of strings

Найденные номера заказов

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

Помимо общих ошибок API, в ответе метода могут присутствовать следующие ошибки:

Номер ошибки

http-код

Краткое описание ошибки

714001

400Ничего не найдено

714002

400

Уточните параметры поиска. Количество найденных заказов превышает лимит

714003

400

Данные участника перевозки введены неверно

714004

400

Не найден участник перевозки по указанным данным (sender)

714005

400Не найден участник перевозки по указанным данным (receiver)