Поиск заказа по неполным данным
Общие сведения
Сервис позволяет осуществлять поиск заказов, используя следующие данные: ИНН (для юридических лиц), тип и номер документа (для физических лиц), маршрут перевозки и дату отправки заказа.
Поиск заказа по неполным данным
Запрос метода
Пример запроса
Адрес метода: 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.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) |
