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

Содержание

1 О сервисе
2 API
3 Примеры запросов
4 XML-ответ
5 XML-ответ особенностей нетарифного регулирования
6 HTML-ответ особенностей нетарифного регулирования
7 Ошибки
8 Примеры ошибок

О сервисе

Сервис «Справка о товаре» (Такса) предоставляет разработчикам возможность получения информации из внешних программ и сайтов в 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

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

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


Параметр	Тип	Описание
Обязательные
tncode	string	Код ТН ВЭД, 10 цифр
Необязательные
login	string	Логин к сервису
secret	string	MD5-секрет для данного запроса
сountry	int	Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/
date	date YYYY-MM-DD	Дата расчета, по умолчанию – сегодня
certificate	boolean	Наличие сертификата происхождения товара. Возможные значения: 1 (по умолчанию) – сертификат в наличии 0 – сертификат отсутствует
sp_certificate	boolean	Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. Возможные значения: 1 – сертификат в наличии 0 (по умолчанию) – сертификат отсутствует
mode	string	Таможенный режим* *параметр доступен только при получении информации о мерах нетарифного регулирования Возможные значения: import(по умолчанию) – импорт export – экспорт
type_answer	string	Тип ответа* *параметр доступен только при получении информации о мерах нетарифного регулирования Возможные значения: 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-ответ

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

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

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

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

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

Ошибки

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


Код	Описание
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

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

Содержание

О сервисе

API

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

XML-ответ

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

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

Ошибки

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

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Быстрый переход

Инструменты