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