API подбор кода ТНВЭД для экспресс-грузов: различия между версиями
Admin (обсуждение | вклад) м (Admin переименовал страницу XML-API подбор кода ТНВЭД для экспресс-грузов в API подбор кода ТНВЭД для экспресс-грузов без оставления перена…) |
Nikitin (обсуждение | вклад) (Метка: визуальный редактор отключён) |
||
| Строка 3: | Строка 3: | ||
==API== | ==API== | ||
| − | Доступ к API предоставляется по URL https://www2.alta.ru/tools/autotnved/. | + | Доступ к API предоставляется по URL https://www2.alta.ru/tools/autotnved/v2/. |
===Отправка исходных данных=== | ===Отправка исходных данных=== | ||
| Строка 28: | Строка 28: | ||
<pre> | <pre> | ||
| − | POST /tools/autotnved/ HTTP/1.1 | + | POST /tools/autotnved/v2/ HTTP/1.1 |
Content-Type: application/x-www-form-urlencoded | Content-Type: application/x-www-form-urlencoded | ||
Accept-Encoding: gzip, deflate | Accept-Encoding: gzip, deflate | ||
| Строка 39: | Строка 39: | ||
<pre> | <pre> | ||
| − | POST /tools/autotnved/ HTTP/1.1 | + | POST /tools/autotnved/v2/ HTTP/1.1 |
Content-Type: multipart/form-data; boundary=---------------------------7e6ad602d2 | Content-Type: multipart/form-data; boundary=---------------------------7e6ad602d2 | ||
Accept-Encoding: gzip, deflate | Accept-Encoding: gzip, deflate | ||
| Строка 83: | Строка 83: | ||
hash = md5("12345:testlogin:" + md5("testpassword")); | hash = md5("12345:testlogin:" + md5("testpassword")); | ||
</pre> | </pre> | ||
| − | Итоговый URL: https://www2.alta.ru/tools/autotnved/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786 | + | Итоговый URL: https://www2.alta.ru/tools/autotnved/v2/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786 |
XML-ответ в случае успешного выполнения запроса: | XML-ответ в случае успешного выполнения запроса: | ||
| Строка 102: | Строка 102: | ||
| code || Найденный код ТНВЭД | | code || Найденный код ТНВЭД | ||
|- | |- | ||
| − | | | + | | codeWeight || Вес кода (количество товаров со схожим описанием, задекларированных с найденным кодом) |
|- | |- | ||
| − | | | + | | probability || Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием) |
|- | |- | ||
|} | |} | ||
Версия 12:50, 23 августа 2024
О сервисе
Сервис предназначен для автоматизированного определения 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 | Состояние запроса: обработан или еще нет (стоит в очереди) |
| message | Описание состояния запроса |
| response | Блок, содержащий детальную информацию о всех найденных кодах ТНВЭД |
| item | Блок, содержащий информацию о коде ТНВЭД для одного товара |
| id | Идентификатор товара (порядковый номер) в соответствии с исходным запросом |
| code | Найденный код ТНВЭД |
| codeWeight | Вес кода (количество товаров со схожим описанием, задекларированных с найденным кодом) |
| probability | Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием) |
Ошибки
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.
<Error>
<ErrorCode>201</ErrorCode>
<ErrorDescr>Запрос #12345 не найден</ErrorDescr>
</Error>
При работе с сервисом возможны следующие ошибки:
| Код | Описание |
|---|---|
| 100 | Пользователь не авторизован |
| 110 | Лимит запросов для данного пользователя исчерпан |
| 120 | Ошибка тарификации |
| 140 | Недостаточно средств для выполнения запроса |
