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

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

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

Обновлено 02.07.2020
Скачать в PDF
88 кб
Содержание:

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

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

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

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

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

Адрес метода: 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)-

714006

400Найдено более 5 накладных-

714007

400Период указан неверноДиапазон дат выполнения заказа не должен превышать 7 дней