API подбор кода ТНВЭД для экспресс-грузов

Материал из Alta-Soft Wikipedia
Версия от 16:31, 12 февраля 2024; Nikitin (обсуждение | вклад) (Новая страница: «==О сервисе== Сервис предназначен для автоматизированного определения 10-значных кодов ТН…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

О сервисе

Сервис предназначен для автоматизированного определения 10-значных кодов ТНВЭД по описаниям товаров

API

Доступ к API предоставляется по URL https://www2.alta.ru/tools/autotnved/.

Отправка исходных данных

Для отправки списка описаний товаров, для которых необходимо определить коды ТНВЭД, нужно отправить POST-запрос, в который должны быть включены параметр "slogin" со значением, соответствующим логину вашей учетной записи, и "xml", значение которого должно иметь следующий формат:

<xml>
    <i id="1" descr="Описание товара 1"/>
    <i id="2" descr="Описание товара 2"/>
    ...
    <i id="N" descr="Описание товара N"/>
</xml>

Пример: для отправки запроса, содержащего один товар с описанием "брюки женские" нужно сформировать XML следующего вида:

<xml>
    <i id="1" descr="брюки женские"/>
</xml>

Отправить его можно одним из следующих способов:

POST /tools/autotnved/ HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Accept-Encoding: gzip, deflate
Host: www2.alta.ru
Content-Length: 198
Connection: Close

slogin=sa00000&xml=%3Cxml%3E%3Ci+id%3D%221%22+descr%3D%22%D0%B1%D1%80%D1%8E%D0%BA%D0%B8+%D0%B6%D0%B5%D0%BD%D1%81%D0%BA%D0%B8%D0%B5%22%2F%3E%3C%2Fxml%3E
POST /tools/autotnved/ HTTP/1.1
Content-Type: multipart/form-data; boundary=---------------------------7e6ad602d2
Accept-Encoding: gzip, deflate
Host: www2.alta.ru
Content-Length: 860
Connection: Close

-----------------------------7e6ad602d2
Content-Disposition: form-data; name="slogin"

sa00000
-----------------------------7e6ad602d2
Content-Disposition: form-data; name="xml"

<xml><i id="1" descr="брюки женские"/></xml>
-----------------------------7e6ad602d2--

Если запрос выполнится успешно, ответ сервера будет иметь следующий вид:

<result>
    <message>Запрос поставлен в очередь</message>
    <requestid>7</requestid>
</result>
result Корневой элемент документа
message Элемент с информацией о статусе запроса
requestid Идентификатор запроса, который понадобится в дальнейшем

Получение списка кодов ТНВЭД

Для получения списка кодов ТНВЭД по идентификатору запроса (requestid) необходима авторизация с помощью сервисного логина и пароля. Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки requestid + логин + md5-хэш от пароля, разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword и requestid = 12345:
вычисляем хеш:

  hash = md5("12345:testlogin:" + md5("testpassword"));

Итоговый URL: https://www2.alta.ru/tools/autotnved/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786

XML-ответ в случае успешного выполнения запроса:

result Корневой элемент документа
handled Состояние запроса: обработан или еще нет (стоит в очереди)
message Описание состояния запроса
response Блок, содержащий детальную информацию о всех найденных кодах ТНВЭД
item Блок, содержащий информацию о коде ТНВЭД для одного товара
id Идентификатор товара (порядковый номер) в соответствии с исходным запросом
code Найденный код ТНВЭД
weight Вес кода (количество товаров со схожим описанием, задекларированных с найденным кодом)
p Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием)

Ошибки

При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.

<Error>
    <ErrorCode>201</ErrorCode>
    <ErrorDescr>Запрос #12345 не найден</ErrorDescr>
</Error>

При работе с сервисом возможны следующие ошибки:

Код Описание
100 Пользователь не авторизован
110 Лимит запросов для данного пользователя исчерпан
120 Ошибка тарификации
140 Недостаточно средств для выполнения запроса