Просмотр кода страницы API подбор кода ТНВЭД для экспресс-грузов

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

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

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

<pre>
<xml>
    <i id="1" descr="Описание товара 1"/>
    <i id="2" descr="Описание товара 2"/>
    ...
    <i id="N" descr="Описание товара N"/>
</xml>
</pre>
 
Пример: для отправки запроса, содержащего один товар с описанием "брюки женские" нужно сформировать XML следующего вида:

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

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

<pre>
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
</pre>

<pre>
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--
</pre>

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

<pre>
<result>
    <message>Запрос поставлен в очередь</message>
    <requestid>7</requestid>
</result>
</pre>

{| class="wikitable" width="50%"
|-
|result||Корневой элемент документа
|-
|message|| Элемент с информацией о статусе запроса
|-
|requestid||Идентификатор запроса, который понадобится в дальнейшем
|-
|}

===Получение списка кодов ТНВЭД===
Для получения списка кодов ТНВЭД по идентификатору запроса (requestid) необходима авторизация с помощью сервисного логина и пароля.
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''requestid + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword и requestid = 12345:<br>
вычисляем хеш:
<pre>
  hash = md5("12345:testlogin:" + md5("testpassword"));
</pre>
Итоговый URL: https://www2.alta.ru/tools/autotnved/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786

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

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

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

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

{| class="wikitable" width="50%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|120||Ошибка тарификации
|-
|140||Недостаточно средств для выполнения запроса
|-
|}

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]