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

Nikitin в 07:56, 14 июля 2025

2025-07-14T07:56:53Z

Nikitin в 15:11, 4 декабря 2024

2024-12-04T15:11:49Z

Nikitin в 14:09, 16 октября 2024

2024-10-16T14:09:27Z

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

2024-10-16T14:08:19Z

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

Nikitin в 09:07, 5 сентября 2024

2024-09-05T09:07:32Z

Nikitin в 13:25, 4 сентября 2024

2024-09-04T13:25:34Z

Nikitin в 09:56, 23 августа 2024

2024-08-23T09:56:05Z

Nikitin в 09:50, 23 августа 2024

2024-08-23T09:50:45Z

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

2024-02-15T08:14:18Z

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

Nikitin: Новая страница: «==О сервисе== Сервис предназначен для автоматизированного определения 10-значных кодов ТН…»

2024-02-12T13:31:47Z

Новая страница: «==О сервисе== Сервис предназначен для автоматизированного определения 10-значных кодов ТН…»

Новая страница

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

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

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

<pre>
<xml>


...

</xml>
</pre>

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

<pre>
<xml>

</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></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: 
вычисляем хеш:
<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-Сервисы]]

@@ Строка 97: / Строка 97: @@
 ===Получение списка кодов ТНВЭД===
-Для получения списка кодов ТНВЭД по идентификатору запроса (requestid) необходима авторизация с помощью сервисного логина и пароля.
+Для получения списка кодов ТНВЭД по идентификатору запроса (requestid) необходимо выполнить GET-запрос, для которого требуется авторизация с помощью сервисного логина и пароля.
 Параметры, которые нужно передать в GET-запросе:

@@ Строка 134: / Строка 134: @@
          </item>
      </response>
 </result>
 </pre>
@@ Строка 146: / Строка 158: @@
 |-
 |response|| Блок, содержащий детальную информацию о всех найденных кодах ТНВЭД
 |-
 | item || Блок, содержащий информацию о коде ТНВЭД для одного товара
 |-
 | id || Идентификатор товара в соответствии с исходным запросом
@@ Строка 159: / Строка 173: @@
 | descr || Описание кода из справочника ТНВЭД. Для включения этого поля в ответ, необходимо при выполнении GET-запроса добавить к URL параметр '''tnveddescr=1'''
 |}
 ==Ошибки==

@@ Строка 117: / Строка 117: @@
    hash = md5("12345:testlogin:" + md5("testpassword"));
 </pre>
-Итоговый URL: https://www2.alta.ru/tools/autotnved/v2/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786&tnveddescr=1
+Итоговый URL: https://www2.alta.ru/tools/autotnved/v2/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786&payment=balance&tnveddescr=1
 XML-ответ в случае успешного выполнения запроса:

@@ Строка 107: / Строка 107: @@
 |-
 |hash||MD5-хеш от сгенерированной строки '''requestid + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:»
 |-
 |tnveddescr||''(Необязательно)'' Укажите этот параметр со значением "1", если требуется к каждому найденному коду ТНВЭД добавить описание из справочника

@@ Строка 115: / Строка 115: @@
    hash = md5("12345:testlogin:" + md5("testpassword"));
 </pre>
-Итоговый URL: https://www2.alta.ru/tools/autotnved/v2/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786
+Итоговый URL: https://www2.alta.ru/tools/autotnved/v2/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786&tnveddescr=1
 XML-ответ в случае успешного выполнения запроса:
@@ Строка 126: / Строка 126: @@
          <item>
              <id>1</id>
-             <code>6404199000</code>
+             <code>6204623100</code>
-             <codeWeight>4249</codeWeight>
+             <codeWeight>12784</codeWeight>
-             <probability>0.30639</probability>
+             <probability>0.19389</probability>
          </item>
      </response>

@@ Строка 10: / Строка 10: @@
 <pre>
 <xml>
-     <i id="1" descr="Описание товара 1"/>
+     <i id="1" group="Описание группы товаров 1">
-     <i id="2" descr="Описание товара 2"/>
+        <name>Описание товара 1</name>
      ...
 </xml>
 </pre>
 Пример: для отправки запроса, содержащего один товар с описанием "брюки женские" нужно сформировать XML следующего вида:
@@ Строка 21: / Строка 39: @@
 <pre>
 <xml>
-     <i id="1" descr="брюки женские"/>
+     <i id="1">
 </xml>
 </pre>
@@ Строка 32: / Строка 52: @@
 Accept-Encoding: gzip, deflate
 Host: www2.alta.ru
-Content-Length: 198
+Content-Length: 170
 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
+slogin=sa00000&xml=%3Cxml%3E%3Ci%20id%3D%221%22%3E%3Cname%3E%D0%B1%D1%80%D1%8E%D0%BA%D0%B8%20%D0%B6%D0%B5%D0%BD%D1%81%D0%BA%D0%B8%D0%B5%3C%2Fname%3E%3C%2Fi%3E%3C%2Fxml%3E
 </pre>
@@ Строка 43: / Строка 63: @@
 Accept-Encoding: gzip, deflate
 Host: www2.alta.ru
-Content-Length: 860
+Content-Length: 285
 Connection: Close
@@ Строка 53: / Строка 73: @@
 Content-Disposition: form-data; name="xml"
-<xml><i id="1" descr="брюки женские"/></xml>
+<xml><i id="1"><name>брюки женские</name></i></xml>
 -----------------------------7e6ad602d2--
 </pre>
@@ Строка 78: / Строка 98: @@
 ===Получение списка кодов ТНВЭД===
 Для получения списка кодов ТНВЭД по идентификатору запроса (requestid) необходима авторизация с помощью сервисного логина и пароля.
-'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''requestid + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword и requestid = 12345:<br>
-вычисляем хеш:
+Параметры, которые нужно передать в GET-запросе:
 <pre>
    hash = md5("12345:testlogin:" + md5("testpassword"));
@@ Строка 114: / Строка 146: @@
 | item || Блок, содержащий информацию о коде ТНВЭД для одного товара
 |-
-| id || Идентификатор товара (порядковый номер) в соответствии с исходным запросом
+| id || Идентификатор товара в соответствии с исходным запросом
 |-
 | code || Найденный код ТНВЭД
@@ Строка 122: / Строка 154: @@
 | probability || Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием)
 |-
 |}

@@ Строка 86: / Строка 86: @@
 XML-ответ в случае успешного выполнения запроса:
 {| class="wikitable" width="50%"
 |-

@@ Строка 3: / Строка 3: @@
 ==API==
-Доступ к API предоставляется по URL https://www2.alta.ru/tools/autotnved/.
+Доступ к API предоставляется по URL https://www2.alta.ru/tools/autotnved/v2/.
 ===Отправка исходных данных===
@@ Строка 28: / Строка 28: @@
 <pre>
-POST /tools/autotnved/ HTTP/1.1
+POST /tools/autotnved/v2/ HTTP/1.1
 Content-Type: application/x-www-form-urlencoded
 Accept-Encoding: gzip, deflate
@@ Строка 39: / Строка 39: @@
 <pre>
-POST /tools/autotnved/ HTTP/1.1
+POST /tools/autotnved/v2/ HTTP/1.1
 Content-Type: multipart/form-data; boundary=---------------------------7e6ad602d2
 Accept-Encoding: gzip, deflate
@@ Строка 83: / Строка 83: @@
    hash = md5("12345:testlogin:" + md5("testpassword"));
 </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-ответ в случае успешного выполнения запроса:
@@ Строка 102: / Строка 102: @@
 | code || Найденный код ТНВЭД
 |-
-| weight || Вес кода (количество товаров со схожим описанием, задекларированных с найденным кодом)
+| codeWeight || Вес кода (количество товаров со схожим описанием, задекларированных с найденным кодом)
 |-
-| p || Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием)
+| probability || Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием)
 |-
 |}

← Предыдущая	Версия 08:14, 15 февраля 2024
(нет различий)