API для получения справки о товаре (Такса): различия между версиями

Материал из Alta-Soft Wikipedia
Перейти к навигации Перейти к поиску
м (Krashennikova переименовал страницу XML-API для Таксы онлайн в XML-API для получения справки о товаре (Такса): уточнение)
(не показано 8 промежуточных версий этого же участника)
Строка 1: Строка 1:
 
==О сервисе==
 
==О сервисе==
 
Сервис «Такса онлайн» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию о коде ТН ВЭД:
 
Сервис «Такса онлайн» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию о коде ТН ВЭД:
 +
 
*базовую ставку импортной пошлины;
 
*базовую ставку импортной пошлины;
 
*информацию об акцизе;
 
*информацию об акцизе;
 
*информацию о НДС и освобождении от него;
 
*информацию о НДС и освобождении от него;
 
*меры нетарифного регулирования, применяемые к данному коду, включая информацию о документах, которыми они регулируются.
 
*меры нетарифного регулирования, применяемые к данному коду, включая информацию о документах, которыми они регулируются.
 
  
  
 
==API==
 
==API==
Доступ к API предоставляется по URL https://www.alta.ru/tnved/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля, либо доступ может быть предоставлен по статичному IP-адресу.
+
Доступ к API предоставляется по URL https://www.alta.ru/tnved/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.
  
 
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Код ТН ВЭД + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br>
 
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Код ТН ВЭД + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br>
Строка 16: Строка 16:
 
итоговый URL: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558
 
итоговый URL: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558
  
'''Для авторизации по статическому IP-адресу''' никакой дополнительной информации, кроме запроса, передавать не нужно. Запрос будет выглядеть как https://www.alta.ru/tnved/xml/?tncode=0101291000
+
----
 +
<code>
 +
Для тестового подключения и предварительной настройки используйте:<br>
 +
логин: '''testlogin'''<br>
 +
пароль: '''testpassword'''<br>
 +
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 6202930000
 +
</code>
 +
----
 +
 
  
 
Ниже приводится полный список входных параметров:
 
Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
+
{| class="wikitable" width="75%"
 
|+
 
|+
!Параметр !!Тип !!Описание
+
!Параметр!!Тип!!Описание
  
 
|- highlight
 
|- highlight
|colspan=3 |'''Обязательные'''
+
| colspan="3" |'''Обязательные'''
  
 
|-
 
|-
Строка 30: Строка 38:
  
 
|- highlight
 
|- highlight
|colspan=3 |'''Необязательные'''
+
| colspan="3" |'''Необязательные'''
  
 
|-
 
|-
Строка 39: Строка 47:
  
 
|-
 
|-
|сountry||int||Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/  
+
|сountry||int||Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/
  
 
|-
 
|-
Строка 47: Строка 55:
 
|certificate||boolean||Наличие сертификата происхождения товара.<br>
 
|certificate||boolean||Наличие сертификата происхождения товара.<br>
 
Возможные значения:  
 
Возможные значения:  
 +
 
*1 (по умолчанию) – сертификат в наличии
 
*1 (по умолчанию) – сертификат в наличии
 
*0 – сертификат отсутствует
 
*0 – сертификат отсутствует
 +
 +
|-
 +
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной.<br>
 +
Возможные значения:
 +
 +
*1 – сертификат в наличии
 +
*0 (по умолчанию) – сертификат отсутствует
  
 
|}
 
|}
  
 
==Примеры запросов==
 
==Примеры запросов==
Ответ с двумя блоками НДС:<br>
+
Ответ с несколькими блоками НДС:<br>
 
https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558
 
https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558
  
Строка 65: Строка 81:
 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=0&country=818&secret=23d8cf433cf6603b457d4ba10756afbe<br>
 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=0&country=818&secret=23d8cf433cf6603b457d4ba10756afbe<br>
  
 +
Изменение пошлины для преференциальных товаров при применении режима свободной торговли с Вьетнамом.<br>
 +
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&sp_certificate=1<br>
 +
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&sp_certificate=0<br>
  
 
==XML-ответ==
 
==XML-ответ==
  
{| class="wikitable" width="75%"
+
{| class="wikitable" width="75%"
 
|-
 
|-
 
|GoodInfo||Корневой элемент документа
 
|GoodInfo||Корневой элемент документа
 
|-
 
|-
|colspan=2|'''Общая информация'''
+
| colspan="2" |'''Общая информация'''
 
|-
 
|-
 
|GoodInfo -> Code||Код ТН ВЭД
 
|GoodInfo -> Code||Код ТН ВЭД
Строка 78: Строка 97:
 
|GoodInfo -> Name||Наименование кода ТН ВЭД
 
|GoodInfo -> Name||Наименование кода ТН ВЭД
 
|-
 
|-
|colspan=2|'''Пошлина'''
+
|GoodInfo -> Prim||Примечание кода ТН ВЭД
 
|-
 
|-
|GoodInfo -> Import||Информация о ставке
+
| colspan="2" |'''Пошлина'''
 
|-
 
|-
|GoodInfo -> Import -> Value||Ставка
+
|GoodInfo -> Importlist||Список применяемых ставок
 
|-
 
|-
|GoodInfo -> Import -> Order||Документ-основание для начисления ставки
+
|GoodInfo -> Importlist -> Import||Информация о ставке
 
|-
 
|-
|GoodInfo -> Import -> Link||Ссылка на документ
+
|GoodInfo -> Importlist -> Import -> Value||Ставка
 
|-
 
|-
|colspan=2|'''Акциз'''
+
|GoodInfo -> Importlist -> Import -> ValueDetail||Составляющие компоненты ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount||Числовая составляющая ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit||Единицы измерения
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency||Валюта
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount2||Числовая составляющая блока ставки "не менее"
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit2||Единицы измерения блока ставки "не менее"
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency2||Валюта блока ставки "не менее"
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount3||Числовая составляющая блока ставки "не более"
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit3||Единицы измерения блока ставки "не более"
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency3||Валюта блока ставки "не более"
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd||Составляющие компоненты второй части ставки, если она, например,  вида: N%+Mевро/кг
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueUnit||Единицы измерения
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCurrency||Валюта
 +
|-
 +
|GoodInfo -> Importlist -> Import -> Order||Документ-основание для начисления ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> OrderСond||Примечание по документу-основанию для начисления ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> Measure||Мера измерения ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> Measure -> Name||Название меры измерения ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> Measure -> Razm||Размерность меры измерения ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> Link||Ссылка на документ
 +
|-
 +
| colspan="2" |'''Акциз'''
 
|-
 
|-
 
|GoodInfo -> Exciselist||Список применяемых акцизов
 
|GoodInfo -> Exciselist||Список применяемых акцизов
Строка 95: Строка 154:
 
|-
 
|-
 
|GoodInfo -> Exciselist -> Excise -> Value||Ставка акциза
 
|GoodInfo -> Exciselist -> Excise -> Value||Ставка акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail||Составляющие компоненты ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCount||Числовая составляющая ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueUnit||Единицы измерения ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCurrency||Валюта ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCount2||Числовая составляющая блока "не менее" ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueUnit2||Единицы измерения блока "не менее"ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCurrency2||Валюта ставки блока "не менее" акциза
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueUnit||Единицы измерения
 +
|-
 +
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCurrency||Валюта
 
|-
 
|-
 
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
 
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
 
|-
 
|-
 
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
 
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Import -> Measure||Мера измерения ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Import -> Measure -> Name||Название меры измерения ставки акциза
 +
|-
 +
|GoodInfo -> Exciselist -> Import -> Measure -> Razm||Размерность меры измерения ставки акциза
 
|-
 
|-
 
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
 
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
 
|-
 
|-
|colspan=2|'''НДС'''
+
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
 +
|-
 +
| colspan="2" |'''НДС'''
 
|-
 
|-
 
|GoodInfo -> VATlist||Список применяемых НДС
 
|GoodInfo -> VATlist||Список применяемых НДС
Строка 109: Строка 198:
 
|-
 
|-
 
|GoodInfo -> VATlist -> VAT -> Value||Ставка НДС
 
|GoodInfo -> VATlist -> VAT -> Value||Ставка НДС
 +
|-
 +
|GoodInfo -> VATlist -> VAT -> ValueDetail||Составляющие компоненты ставки НДС
 +
|-
 +
|GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueCount||Числовая составляющая ставки НДС
 +
|-
 +
|GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueUnit||Единицы измерения ставки НДС
 +
|-
 +
|GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueCurrency||Валюта ставки НДС
 
|-
 
|-
 
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
 
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
Строка 116: Строка 213:
 
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
 
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
 
|-
 
|-
|colspan=2|'''Меры нетарифного применения'''
+
| colspan="2" |'''Меры нетарифного применения'''
 
|-
 
|-
|GoodInfo -> Notes||Перечень особенностей нетарифного регулирования для данного кода
+
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml
 +
 
 +
|}
 +
 
 +
 
 +
==Ошибки==
 +
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br>
 +
При работе с сервисом возможны следующие ошибки:
 +
 
 +
{| class="wikitable" width="75%"
 +
|+
 +
!Код!!Описание
 +
|-
 +
|100||Пользователь не авторизирован
 +
|-
 +
|110||Лимит запросов для данного пользователя исчерпан
 +
|-
 +
|120||Ошибка тарификации
 +
|-
 +
|200||Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
 +
|-
 +
|210||Формат даты не соответствует
 
|-
 
|-
|GoodInfo -> Notes -> Note||Элемент  
+
|220||На запрошенную дату код не действует.  «Действие кода прекращено с…» или «Действие кода начнется с…»
 +
|-
 +
|250||Код страны не найден
 +
|}
 +
 
 +
 
 +
==Примеры ошибок==
 +
Пользователь не авторизирован:<br>
 +
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin1&secret=23d8cf433cf6603b457d4ba10756afbe
 +
 
 +
Лимит запросов для данного пользователя исчерпан:<br>
 +
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testloginlimit&secret=2871c36a477fe95b4dc7786efadaca1d
 +
 
 +
Формат даты не соответствует:<br>
 +
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&date=03.07.17&secret=23d8cf433cf6603b457d4ba10756afbe
 +
 
 +
Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД:<br>
 +
https://www.alta.ru/tnved/xml/?tncode=5102297100&login=testlogin&secret=e300194edf9719fec95fedccb33f12e4
 +
 
 +
На запрошенную дату код не действует:<br>
 +
https://www.alta.ru/tnved/xml/?tncode=0102297100&login=testlogin&secret=2e49388b0703b7a2e8b58548ad922cbd
 +
 
 +
Код страны не найден:<br>
 +
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&secret=23d8cf433cf6603b457d4ba10756afbe&country=3417
 +
 
 +
 
 +
==Получение перечня особенностей для кода ТН ВЭД ==
 +
Для использования сервиса с целью получения перечня особенностей для кода ТН ВЭД необходима авторизация с помощью сервисного логина и пароля.
 +
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Код ТН ВЭД + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br>
 +
для запроса: https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin  <br>
 +
вычисляем секрет: secret = md5("0101291000:testlogin:md5(testpassword)")<br>
 +
итоговый URL: https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558
 +
 
 +
----
 +
<code>
 +
Для тестового подключения и предварительной настройки используйте:<br>
 +
логин: '''testlogin'''<br>
 +
пароль: '''testpassword'''<br>
 +
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 6202930000
 +
</code>
 +
----
 +
Ниже приводится полный список входных параметров:
 +
{| class="wikitable" width="75%"
 +
|+
 +
!Параметр!!Тип!!Описание
 +
 
 +
|- highlight
 +
| colspan="3" |'''Обязательные'''
 +
 
 +
|-
 +
|tncode||string||Код ТН ВЭД, 10 цифр
 +
 
 +
|- highlight
 +
| colspan="3" |'''Необязательные'''
 +
 
 +
|-
 +
|login||string||Логин к сервису
 +
 
 +
|-
 +
|secret||string||MD5-секрет для данного запроса
 +
 
 +
|-
 +
|сountry||int||Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/
 +
 
 +
|-
 +
|date||date<br>YYYY-MM-DD||Дата расчета, по умолчанию – сегодня
 +
 
 +
|-
 +
|certificate||boolean||Наличие сертификата происхождения товара.<br>
 +
Возможные значения:
 +
 
 +
*1 (по умолчанию) – сертификат в наличии
 +
*0 – сертификат отсутствует
 +
 
 +
|-
 +
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной.<br>
 +
Возможные значения:
 +
 
 +
*1 – сертификат в наличии
 +
*0 (по умолчанию) – сертификат отсутствует
 +
 
 +
|}
 +
 
 +
==XML-ответ==
 +
 
 +
{| class="wikitable" width="75%"
 +
|-
 +
|GoodInfo||Корневой элемент документа
 +
|-
 +
|GoodInfo -> Notes||Перечень особенностей для данного кода
 +
|-
 +
|GoodInfo -> Notes -> Note||Элемент
 
|-
 
|-
 
|GoodInfo -> Notes -> Note -> Name||Наименование
 
|GoodInfo -> Notes -> Note -> Name||Наименование
 
|-
 
|-
 
|GoodInfo -> Notes -> Note -> Description||Описание
 
|GoodInfo -> Notes -> Note -> Description||Описание
 +
|-
 +
|GoodInfo -> Notes -> Note -> Prim||Примечание
 
|-
 
|-
 
|GoodInfo -> Notes -> Note -> Document||Документ-основание
 
|GoodInfo -> Notes -> Note -> Document||Документ-основание
 
|-
 
|-
 
|GoodInfo -> Notes -> Note -> Link||Ссылка на документ
 
|GoodInfo -> Notes -> Note -> Link||Ссылка на документ
 +
|-
 +
|GoodInfo -> Notes -> Note -> Table||Если в Описании или Примечании Элемента содержались таблицы, в тексте они заменены на текст Таблица <№ п/п в границах элемента>. Содержимое таблиц выносятся в соответствующем порядке в раздел(ы) Table текущего Элемента
 +
|-
 +
|GoodInfo -> Notes -> Note -> Table -> Row||Строка таблицы
 +
|-
 +
|GoodInfo -> Notes -> Note -> Table -> Col||Столбец строки таблицы
 
|}
 
|}
 
  
  
Строка 137: Строка 353:
 
При работе с сервисом возможны следующие ошибки:
 
При работе с сервисом возможны следующие ошибки:
  
{| class="wikitable" width="75%"
+
{| class="wikitable" width="75%"
 
|+
 
|+
 
!Код!!Описание
 
!Код!!Описание
Строка 144: Строка 360:
 
|-
 
|-
 
|110||Лимит запросов для данного пользователя исчерпан
 
|110||Лимит запросов для данного пользователя исчерпан
 +
|-
 +
|120||Ошибка тарификации
 
|-
 
|-
 
|200||Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
 
|200||Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
Строка 153: Строка 371:
 
|250||Код страны не найден
 
|250||Код страны не найден
 
|}
 
|}
 
 
  
 
==Примеры ошибок==
 
==Примеры ошибок==
 
Пользователь не авторизирован:<br>
 
Пользователь не авторизирован:<br>
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin1&secret=23d8cf433cf6603b457d4ba10756afbe
+
https://ww.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin1&secret=23d8cf433cf6603b457d4ba10756afbe
  
 
Лимит запросов для данного пользователя исчерпан:<br>
 
Лимит запросов для данного пользователя исчерпан:<br>
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testloginlimit&secret=93f22e86217132a9182e783159d55399
+
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testloginlimit&secret=2871c36a477fe95b4dc7786efadaca1d
  
 
Формат даты не соответствует:<br>
 
Формат даты не соответствует:<br>
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&date=03.07.17&secret=23d8cf433cf6603b457d4ba10756afbe
+
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin&date=03.07.17&secret=23d8cf433cf6603b457d4ba10756afbe
  
 
Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД:<br>
 
Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД:<br>
https://www.alta.ru/tnved/xml/?tncode=5102297100&login=testlogin&secret=e300194edf9719fec95fedccb33f12e4
+
https://www.alta.ru/tnved/xml_nodes/?tncode=5102297100&login=testlogin&secret=e300194edf9719fec95fedccb33f12e4
  
 
На запрошенную дату код не действует:<br>
 
На запрошенную дату код не действует:<br>
https://www.alta.ru/tnved/xml/?tncode=0102297100&login=testlogin&secret=2e49388b0703b7a2e8b58548ad922cbd
+
https://www.alta.ru/tnved/xml_nodes/?tncode=0102297100&login=testlogin&secret=2e49388b0703b7a2e8b58548ad922cbd
  
 
Код страны не найден:<br>
 
Код страны не найден:<br>
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&secret=23d8cf433cf6603b457d4ba10756afbe&country=3417
+
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin&secret=23d8cf433cf6603b457d4ba10756afbe&country=3417
  
  

Версия 13:24, 21 июля 2020

О сервисе

Сервис «Такса онлайн» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию о коде ТН ВЭД:

  • базовую ставку импортной пошлины;
  • информацию об акцизе;
  • информацию о НДС и освобождении от него;
  • меры нетарифного регулирования, применяемые к данному коду, включая информацию о документах, которыми они регулируются.


API

Доступ к API предоставляется по URL https://www.alta.ru/tnved/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.

Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки Код ТН ВЭД + логин + md5-хэш от пароля, разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:
для запроса: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin
вычисляем секрет: secret = md5("0101291000:testlogin:md5(testpassword)")
итоговый URL: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558


Для тестового подключения и предварительной настройки используйте:
логин: testlogin
пароль: testpassword
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 6202930000



Ниже приводится полный список входных параметров:

Параметр Тип Описание
Обязательные
tncode string Код ТН ВЭД, 10 цифр
Необязательные
login string Логин к сервису
secret string MD5-секрет для данного запроса
сountry int Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/
date date
YYYY-MM-DD
Дата расчета, по умолчанию – сегодня
certificate boolean Наличие сертификата происхождения товара.

Возможные значения:

  • 1 (по умолчанию) – сертификат в наличии
  • 0 – сертификат отсутствует
sp_certificate boolean Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной.

Возможные значения:

  • 1 – сертификат в наличии
  • 0 (по умолчанию) – сертификат отсутствует

Примеры запросов

Ответ с несколькими блоками НДС:
https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

Ответ со сложным акцизом:
https://www.alta.ru/tnved/xml/?tncode=2402209000&login=testlogin&secret=a88e61a8236ef2415b1d663e43415e0e

Изменение пошлины в зависимости от страны и наличия сертификата соответствия:
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=1&country=398&secret=23d8cf433cf6603b457d4ba10756afbe
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=0&country=398&secret=23d8cf433cf6603b457d4ba10756afbe
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=1&country=818&secret=23d8cf433cf6603b457d4ba10756afbe
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=0&country=818&secret=23d8cf433cf6603b457d4ba10756afbe

Изменение пошлины для преференциальных товаров при применении режима свободной торговли с Вьетнамом.
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&sp_certificate=1
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&sp_certificate=0

XML-ответ

GoodInfo Корневой элемент документа
Общая информация
GoodInfo -> Code Код ТН ВЭД
GoodInfo -> Name Наименование кода ТН ВЭД
GoodInfo -> Prim Примечание кода ТН ВЭД
Пошлина
GoodInfo -> Importlist Список применяемых ставок
GoodInfo -> Importlist -> Import Информация о ставке
GoodInfo -> Importlist -> Import -> Value Ставка
GoodInfo -> Importlist -> Import -> ValueDetail Составляющие компоненты ставки
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount Числовая составляющая ставки
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit Единицы измерения
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency Валюта
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount2 Числовая составляющая блока ставки "не менее"
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit2 Единицы измерения блока ставки "не менее"
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency2 Валюта блока ставки "не менее"
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount3 Числовая составляющая блока ставки "не более"
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit3 Единицы измерения блока ставки "не более"
GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency3 Валюта блока ставки "не более"
GoodInfo -> Importlist -> Import -> ValueDetailAdd Составляющие компоненты второй части ставки, если она, например, вида: N%+Mевро/кг
GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCount Числовая составляющая ставки
GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueUnit Единицы измерения
GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCurrency Валюта
GoodInfo -> Importlist -> Import -> Order Документ-основание для начисления ставки
GoodInfo -> Importlist -> Import -> OrderСond Примечание по документу-основанию для начисления ставки
GoodInfo -> Importlist -> Import -> Measure Мера измерения ставки
GoodInfo -> Importlist -> Import -> Measure -> Name Название меры измерения ставки
GoodInfo -> Importlist -> Import -> Measure -> Razm Размерность меры измерения ставки
GoodInfo -> Importlist -> Import -> Link Ссылка на документ
Акциз
GoodInfo -> Exciselist Список применяемых акцизов
GoodInfo -> Exciselist -> Excise Элемент применяемого акциза
GoodInfo -> Exciselist -> Excise -> Value Ставка акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail Составляющие компоненты ставки акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCount Числовая составляющая ставки акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueUnit Единицы измерения ставки акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCurrency Валюта ставки акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCount2 Числовая составляющая блока "не менее" ставки акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueUnit2 Единицы измерения блока "не менее"ставки акциза
GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCurrency2 Валюта ставки блока "не менее" акциза
GoodInfo -> Importlist -> Import -> ValueDetailAdd Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCount Числовая составляющая ставки
GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueUnit Единицы измерения
GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCurrency Валюта
GoodInfo -> Exciselist -> Excise -> Condition Описание или условие, при котором акциз применяется
GoodInfo -> Exciselist -> Excise -> Document Документ-основание для начисления акциза
GoodInfo -> Exciselist -> Import -> Measure Мера измерения ставки акциза
GoodInfo -> Exciselist -> Import -> Measure -> Name Название меры измерения ставки акциза
GoodInfo -> Exciselist -> Import -> Measure -> Razm Размерность меры измерения ставки акциза
GoodInfo -> Exciselist -> Excise -> Link Ссылка на документ
GoodInfo -> Exciselist -> Excise -> Prim Примечание по расчету ставки акциза
НДС
GoodInfo -> VATlist Список применяемых НДС
GoodInfo -> VATlist -> VAT Элемент применяемого НДС
GoodInfo -> VATlist -> VAT -> Value Ставка НДС
GoodInfo -> VATlist -> VAT -> ValueDetail Составляющие компоненты ставки НДС
GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueCount Числовая составляющая ставки НДС
GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueUnit Единицы измерения ставки НДС
GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueCurrency Валюта ставки НДС
GoodInfo -> VATlist -> VAT -> Condition Описание или условие, при котором НДС применяется
GoodInfo -> VATlist -> VAT -> Document Документ-основание для начисления НДС
GoodInfo -> VATlist -> VAT -> Link Ссылка на документ
Меры нетарифного применения
Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml


Ошибки

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

Код Описание
100 Пользователь не авторизирован
110 Лимит запросов для данного пользователя исчерпан
120 Ошибка тарификации
200 Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
210 Формат даты не соответствует
220 На запрошенную дату код не действует. «Действие кода прекращено с…» или «Действие кода начнется с…»
250 Код страны не найден


Примеры ошибок

Пользователь не авторизирован:
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin1&secret=23d8cf433cf6603b457d4ba10756afbe

Лимит запросов для данного пользователя исчерпан:
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testloginlimit&secret=2871c36a477fe95b4dc7786efadaca1d

Формат даты не соответствует:
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&date=03.07.17&secret=23d8cf433cf6603b457d4ba10756afbe

Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД:
https://www.alta.ru/tnved/xml/?tncode=5102297100&login=testlogin&secret=e300194edf9719fec95fedccb33f12e4

На запрошенную дату код не действует:
https://www.alta.ru/tnved/xml/?tncode=0102297100&login=testlogin&secret=2e49388b0703b7a2e8b58548ad922cbd

Код страны не найден:
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&secret=23d8cf433cf6603b457d4ba10756afbe&country=3417


Получение перечня особенностей для кода ТН ВЭД

Для использования сервиса с целью получения перечня особенностей для кода ТН ВЭД необходима авторизация с помощью сервисного логина и пароля. Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки Код ТН ВЭД + логин + md5-хэш от пароля, разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:
для запроса: https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin
вычисляем секрет: secret = md5("0101291000:testlogin:md5(testpassword)")
итоговый URL: https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558


Для тестового подключения и предварительной настройки используйте:
логин: testlogin
пароль: testpassword
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 6202930000


Ниже приводится полный список входных параметров:

Параметр Тип Описание
Обязательные
tncode string Код ТН ВЭД, 10 цифр
Необязательные
login string Логин к сервису
secret string MD5-секрет для данного запроса
сountry int Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/
date date
YYYY-MM-DD
Дата расчета, по умолчанию – сегодня
certificate boolean Наличие сертификата происхождения товара.

Возможные значения:

  • 1 (по умолчанию) – сертификат в наличии
  • 0 – сертификат отсутствует
sp_certificate boolean Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной.

Возможные значения:

  • 1 – сертификат в наличии
  • 0 (по умолчанию) – сертификат отсутствует

XML-ответ

GoodInfo Корневой элемент документа
GoodInfo -> Notes Перечень особенностей для данного кода
GoodInfo -> Notes -> Note Элемент
GoodInfo -> Notes -> Note -> Name Наименование
GoodInfo -> Notes -> Note -> Description Описание
GoodInfo -> Notes -> Note -> Prim Примечание
GoodInfo -> Notes -> Note -> Document Документ-основание
GoodInfo -> Notes -> Note -> Link Ссылка на документ
GoodInfo -> Notes -> Note -> Table Если в Описании или Примечании Элемента содержались таблицы, в тексте они заменены на текст Таблица <№ п/п в границах элемента>. Содержимое таблиц выносятся в соответствующем порядке в раздел(ы) Table текущего Элемента
GoodInfo -> Notes -> Note -> Table -> Row Строка таблицы
GoodInfo -> Notes -> Note -> Table -> Col Столбец строки таблицы


Ошибки

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

Код Описание
100 Пользователь не авторизирован
110 Лимит запросов для данного пользователя исчерпан
120 Ошибка тарификации
200 Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
210 Формат даты не соответствует
220 На запрошенную дату код не действует. «Действие кода прекращено с…» или «Действие кода начнется с…»
250 Код страны не найден

Примеры ошибок

Пользователь не авторизирован:
https://ww.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin1&secret=23d8cf433cf6603b457d4ba10756afbe

Лимит запросов для данного пользователя исчерпан:
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testloginlimit&secret=2871c36a477fe95b4dc7786efadaca1d

Формат даты не соответствует:
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin&date=03.07.17&secret=23d8cf433cf6603b457d4ba10756afbe

Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД:
https://www.alta.ru/tnved/xml_nodes/?tncode=5102297100&login=testlogin&secret=e300194edf9719fec95fedccb33f12e4

На запрошенную дату код не действует:
https://www.alta.ru/tnved/xml_nodes/?tncode=0102297100&login=testlogin&secret=2e49388b0703b7a2e8b58548ad922cbd

Код страны не найден:
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin&secret=23d8cf433cf6603b457d4ba10756afbe&country=3417