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

О сервисе

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

API

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

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

Для отправки списка описаний товаров, для которых необходимо определить коды ТНВЭД, нужно отправить 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/v2/ 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/v2/ 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/v2/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786

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

<result>
    <handled>true</handled>
    <message>Запрос обработан</message>
    <response>
        <item>
            <id>1</id>
            <code>6404199000</code>
            <codeWeight>4249</codeWeight>
            <probability>0.30639</probability>
        </item>
    </response>
</result>

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

Ошибки

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

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

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

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