Alta-Soft Wikipedia - Вклад участника [ru]

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

2024-02-28T06:36:13Z

Kisina: /* XML-ответ */

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 0208500000
</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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт

|-
|type_answer||string||Тип ответа* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*xml(по умолчанию) – xml
*html – html
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=0 

Особенности нетарифного регулирования: 
https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558 
https://www.alta.ru/tnved/xml_nodes/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin&certificate=0&country=398&secret=23d8cf433cf6603b457d4ba10756afbe 

==XML-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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 -> Importlist -> Import -> Note||Примечание для антидемпинговой пошлины
|-
| colspan="2" |'''Акциз'''
|-
|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 -> Excise -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

==HTML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|body||
|-
|<nowiki><div class="black bold">...</div></nowiki> ||Наименование
|-
|<nowiki><div class="p-10">...</nowiki> ||Содержание с html-разметкой
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|101||Некорректные данные для авторизации
|-
|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

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

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

2024-02-26T10:57:08Z

Kisina: /* Ошибки */

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 0208500000
</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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт

|-
|type_answer||string||Тип ответа* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*xml(по умолчанию) – xml
*html – html
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=0 

Особенности нетарифного регулирования: 
https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558 
https://www.alta.ru/tnved/xml_nodes/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml_nodes/?tncode=1506000000&login=testlogin&certificate=0&country=398&secret=23d8cf433cf6603b457d4ba10756afbe 

==XML-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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 -> Excise -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

==HTML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|body||
|-
|<nowiki><div class="black bold">...</div></nowiki> ||Наименование
|-
|<nowiki><div class="p-10">...</nowiki> ||Содержание с html-разметкой
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|101||Некорректные данные для авторизации
|-
|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

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

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

2023-06-14T12:35:40Z

Kisina:

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 0208500000
</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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт

|-
|type_answer||string||Тип ответа* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*xml(по умолчанию) – xml
*html – html
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=0 

==XML-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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 -> Excise -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

==HTML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|body||
|-
|<nowiki><div class="black bold">...</div></nowiki> ||Наименование
|-
|<nowiki><div class="p-10">...</nowiki> ||Содержание с html-разметкой
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

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

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

2023-06-14T12:34:50Z

Kisina:

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 0208500000
</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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт

|-
|type_answer||string||Тип ответа* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*xml(по умолчанию) – xml
*html – html
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=0 

==XML-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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 -> Excise -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

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

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

2023-06-14T12:30:52Z

Kisina:

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 0208500000
</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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=1 
https://www.alta.ru/tnved/xml/?tncode=0208500000&login=testlogin&country=704&secret=59ee21742377fd9effb3119e646dc0df&sp_certificate=0 

==XML-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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 -> Excise -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

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

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

2023-06-14T11:15:04Z

Kisina:

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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 -> Excise -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Excise -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

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

API сервиса «Груз на СВХ»

2022-06-27T09:31:59Z

Kisina:

== О сервисе ==

Сервис "Груз на СВХ" https://www.alta.ru/svh-gruz/ позволяет получить информацию о грузе в json формате, поступившем на склады временного хранения. По номеру транспортного документа, контейнера, транспортного средства или номера декларации предоставляется информация о размещении груза на СВХ.

== API ==

Доступ к API предоставляется по URL https://www.alta.ru/svh-gruz/search/api/v1/.
Для использования сервиса необходима авторизация с помощью логина и пароля.

=== Запрос на поиск ===

Для поиска необходимо отправлять GET-запрос по URL https://www.alta.ru/svh-gruz/search/api/v1/, содержащий следующие GET-параметры:

#n_k - номер контейнера
#n_trans - транспортное средство
#n_trans_doc - транспортный документ
#n_dt - номер декларации
#login - логин в открытом виде
#secret - MD5-хеш от сгенерированной строки '''параметры запроса + логин + md5-хэш от пароля''', все параметры разделены знаком двоеточия «:»
----
<code>
secret = md5("{n_k}:{n_trans}:{n_trans_doc}:{n_dt}:{логин}:md5({пароль})")
</code>
----

'''Пример запроса:'''

Запрос с параметрами:
n_k = 123, n_trans = пусто, n_trans_doc = 555, n_dt = пусто. 
Пользователь с логином testlogin и паролем testpassword. 
для запроса: https://www.alta.ru/svh-gruz/search/api/v1/?n_k=123&n_trans=&n_trans_doc=555&n_dt=&login=testlogin 
вычисляем секрет: secret = md5("123::555::testlogin:md5(testpassword)") = 7fcb20d2c25956e38dbd2c9a6c3f9720 
Обратите внимание, даже если параметр пустой, его все равно необходимо добавить в порядке следования, для данного примера формула вычисления secret такова:
123 : пусто : 555 : пусто : testlogin : e16b2ab8d12314bf4efbd6203906ea6c = 7fcb20d2c25956e38dbd2c9a6c3f9720 
итоговый URL: https://www.alta.ru/svh-gruz/search/api/v1/?n_k=123&n_trans=&n_trans_doc=555&n_dt=&login=testlogin&secret=7fcb20d2c25956e38dbd2c9a6c3f9720 

=== Ответ ===

При возникновении ошибок возвращается код ответа сервера отличный от 200, а также описание ошибки в JSON-массиве.

'''Пример ответа:'''

Код ответа 200:
<pre>
{
"content": [
{
"storeName": "ПЗТК ООО \"Пасифик Лоджистик\"",
"certificate": "№10702/231216/00033/6 от 18.04.2017",
"internalNumber": "№0002474 от 18.04.2017",
"acceptDate": 1492446600000,
"deadLineDate": 1497733200000,
"regNumber": "10702030/180417/0046239",
"documentId": "03D4A9F1-1212-49BF-8C26-518D62776676",
"containerNumbers": [
"SKLU3518823",
"SKLU3518823"
],
"transportNumbers": [
"02011 Коносамент №SNKO02A170300708 от 07.04.2017",
"02011 Коносамент №SNKO02A170300708 от 07.04.2017",
"02011 Коносамент №SNKO02A170300708 от 07.04.2017"
],
"totalPackageNumber": 296,
"transportIdentifiers": [
"VOSTOCHNY VOYAGER 0101W",
"VOSTOCHNY VOYAGER 0101W",
"VOSTOCHNY VOYAGER 0101W"
],
"certificateLic": "LIC_PERMITION",
"weight": null,
"dtDataList": [
{
"number": "10702030/200417/0030708",
"totalPackageNumber": 296,
"weight": [
"3915,54 КГ",
"3915,54 КГ",
"3915,54 КГ"
],
"documentName": null,
"documentKind": null,
"dtRegNumber": null,
"messageType": null
}
],
"warehouseOwner": {
"organizationName": "ПЗТК ООО \"Пасифик Лоджистик\"",
"ogrn": "1122536008572",
"inn": "2536255389",
"kpp": "253601001",
"addressLine": "690001, г. Владивосток, ул. Дальзаводская, д. 2",
"certificateKind": "lic_Permition",
"certificateNumber": "10702/231216/00033/6",
"certificateDate": 1482440400000
},
"status": "REGISTERED",
"changeStatusDate": null,
"participantId": null
}
],
"totalSize": 204587,
"pageSize": 20,
"pageElements": 20,
"responseMessage": "Найдено слишком много совпадений, для получения более точной информации уточните критерии поиска."
}
</pre>

'''Пример ошибок:'''

Код ответа 404:
<pre>
{"error":"Пользователь не авторизован или неверный secret"}
</pre>
В случае каких то проблем с получением данных внутри сервера
<pre>
{"error":"Ошибка запроса, обратитесь к администратору сайта"}
</pre>

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

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

2021-07-22T06:11:13Z

Kisina:

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

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса 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 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

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

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

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

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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 -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|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||Столбец строки таблицы
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

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