Поиск заказа по параметрам перевозки
Общие сведения
Сервис позволяет найти заказ, номер которого не известен. Для поиска используются следующие данные: ИНН (для юридических лиц), тип и номер документа (для физических лиц), маршрут перевозки и дата отправки заказа. Использование необязательных параметров позволяет выделить заказ из множества.
Если номер заказа известен, то найти заказ можно при помощи метода "Журнал заказов".
Поиск заказа по параметрам перевозки
Запрос метода
Структура запроса
Адрес метода: 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 | Тип документа (для физических лиц) Доступные варианты:
|
docSeries | Нет | string | Серия документа (для физических лиц) |
docNumber | Нет | string | Номер документа (для физических лиц). Формат номера зависит от страны |
terminal | Нет | string | Код КЛАДР пункта отправления (для объекта "request.sender") или доставки (для объекта "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 | ||
---|---|---|
Параметр | Тип | Описание |
metadata | object | Системная информация |
metadata.status | integer | Эмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" |
metadata.generated_at | string | Дата и время генерации ответа сервера. Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС" |
data | object | Данные о заказах |
data.orderNumbers | array of strings | Найденные номера заказов |
Обработка ошибок
Помимо общих ошибок API, в ответе метода могут присутствовать следующие ошибки:
Номер ошибки | http-код | Краткое описание ошибки | Детальное описание ошибки |
---|---|---|---|
714001 | 400 | Ничего не найдено | - |
714002 | 400 | Уточните параметры поиска. Количество найденных заказов превышает лимит | - |
714003 | 400 | Данные участника перевозки введены неверно | - |
714004 | 400 | Не найден участник перевозки по указанным данным (sender) | - |
714005 | 400 | Не найден участник перевозки по указанным данным (receiver) | - |
714006 | 400 | Найдено более 5 накладных | - |
714007 | 400 | Период указан неверно | Диапазон дат выполнения заказа не должен превышать 7 дней |