API для получения справки о товаре (Такса): различия между версиями
(Метка: визуальный редактор отключён) |
(Метка: визуальный редактор отключён) |
||
Строка 1: | Строка 1: | ||
==О сервисе== | ==О сервисе== | ||
Сервис «Такса онлайн» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию о коде ТН ВЭД: | Сервис «Такса онлайн» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию о коде ТН ВЭД: | ||
+ | |||
*базовую ставку импортной пошлины; | *базовую ставку импортной пошлины; | ||
*информацию об акцизе; | *информацию об акцизе; | ||
*информацию о НДС и освобождении от него; | *информацию о НДС и освобождении от него; | ||
*меры нетарифного регулирования, применяемые к данному коду, включая информацию о документах, которыми они регулируются. | *меры нетарифного регулирования, применяемые к данному коду, включая информацию о документах, которыми они регулируются. | ||
− | |||
==API== | ==API== | ||
− | Доступ к API предоставляется по URL https://www.alta.ru/tnved/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля | + | Доступ к API предоставляется по URL https://www.alta.ru/tnved/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля. |
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Код ТН ВЭД + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br> | '''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Код ТН ВЭД + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:<br> | ||
Строка 15: | Строка 15: | ||
вычисляем секрет: secret = md5("0101291000:testlogin:md5(testpassword)")<br> | вычисляем секрет: secret = md5("0101291000:testlogin:md5(testpassword)")<br> | ||
итоговый URL: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558 | итоговый URL: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558 | ||
− | |||
− | |||
---- | ---- | ||
Строка 29: | Строка 27: | ||
Ниже приводится полный список входных параметров: | Ниже приводится полный список входных параметров: | ||
− | {| | + | {| class="wikitable" width="75%" |
|+ | |+ | ||
− | !Параметр !!Тип !!Описание | + | !Параметр!!Тип!!Описание |
|- highlight | |- highlight | ||
− | |colspan=3 |'''Обязательные''' | + | | colspan="3" |'''Обязательные''' |
|- | |- | ||
Строка 40: | Строка 38: | ||
|- highlight | |- highlight | ||
− | |colspan=3 |'''Необязательные''' | + | | colspan="3" |'''Необязательные''' |
|- | |- | ||
Строка 49: | Строка 47: | ||
|- | |- | ||
− | |сountry||int||Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/ | + | |сountry||int||Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/ |
|- | |- | ||
Строка 57: | Строка 55: | ||
|certificate||boolean||Наличие сертификата происхождения товара.<br> | |certificate||boolean||Наличие сертификата происхождения товара.<br> | ||
Возможные значения: | Возможные значения: | ||
+ | |||
*1 (по умолчанию) – сертификат в наличии | *1 (по умолчанию) – сертификат в наличии | ||
*0 – сертификат отсутствует | *0 – сертификат отсутствует | ||
Строка 63: | Строка 62: | ||
|certificate_eav||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с Вьетнамом.<br> | |certificate_eav||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с Вьетнамом.<br> | ||
Возможные значения: | Возможные значения: | ||
+ | |||
*1 – сертификат в наличии | *1 – сертификат в наличии | ||
*0 (по умолчанию) – сертификат отсутствует | *0 (по умолчанию) – сертификат отсутствует | ||
Строка 87: | Строка 87: | ||
==XML-ответ== | ==XML-ответ== | ||
− | {| | + | {| class="wikitable" width="75%" |
|- | |- | ||
|GoodInfo||Корневой элемент документа | |GoodInfo||Корневой элемент документа | ||
|- | |- | ||
− | |colspan=2|'''Общая информация''' | + | | colspan="2" |'''Общая информация''' |
|- | |- | ||
|GoodInfo -> Code||Код ТН ВЭД | |GoodInfo -> Code||Код ТН ВЭД | ||
Строка 97: | Строка 97: | ||
|GoodInfo -> Name||Наименование кода ТН ВЭД | |GoodInfo -> Name||Наименование кода ТН ВЭД | ||
|- | |- | ||
− | |colspan=2|'''Пошлина''' | + | | colspan="2" |'''Пошлина''' |
|- | |- | ||
|GoodInfo -> Import||Информация о ставке | |GoodInfo -> Import||Информация о ставке | ||
Строка 107: | Строка 107: | ||
|GoodInfo -> Import -> Link||Ссылка на документ | |GoodInfo -> Import -> Link||Ссылка на документ | ||
|- | |- | ||
− | |colspan=2|'''Акциз''' | + | | colspan="2" |'''Акциз''' |
|- | |- | ||
|GoodInfo -> Exciselist||Список применяемых акцизов | |GoodInfo -> Exciselist||Список применяемых акцизов | ||
Строка 121: | Строка 121: | ||
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ | |GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ | ||
|- | |- | ||
− | |colspan=2|'''НДС''' | + | | colspan="2" |'''НДС''' |
|- | |- | ||
|GoodInfo -> VATlist||Список применяемых НДС | |GoodInfo -> VATlist||Список применяемых НДС | ||
Строка 135: | Строка 135: | ||
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ | |GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ | ||
|- | |- | ||
− | |colspan=2|'''Меры нетарифного применения''' | + | | colspan="2" |'''Меры нетарифного применения''' |
|- | |- | ||
|GoodInfo -> Notes||Перечень особенностей нетарифного регулирования для данного кода | |GoodInfo -> Notes||Перечень особенностей нетарифного регулирования для данного кода | ||
|- | |- | ||
− | |GoodInfo -> Notes -> Note||Элемент | + | |GoodInfo -> Notes -> Note||Элемент |
|- | |- | ||
|GoodInfo -> Notes -> Note -> Name||Наименование | |GoodInfo -> Notes -> Note -> Name||Наименование | ||
Строка 149: | Строка 149: | ||
|GoodInfo -> Notes -> Note -> Link||Ссылка на документ | |GoodInfo -> Notes -> Note -> Link||Ссылка на документ | ||
|} | |} | ||
− | |||
Строка 156: | Строка 155: | ||
При работе с сервисом возможны следующие ошибки: | При работе с сервисом возможны следующие ошибки: | ||
− | {| | + | {| class="wikitable" width="75%" |
|+ | |+ | ||
!Код!!Описание | !Код!!Описание | ||
Строка 163: | Строка 162: | ||
|- | |- | ||
|110||Лимит запросов для данного пользователя исчерпан | |110||Лимит запросов для данного пользователя исчерпан | ||
+ | |- | ||
+ | |120||Ошибка тарификации | ||
|- | |- | ||
|200||Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД | |200||Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД | ||
Строка 172: | Строка 173: | ||
|250||Код страны не найден | |250||Код страны не найден | ||
|} | |} | ||
− | |||
Строка 193: | Строка 193: | ||
Код страны не найден:<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 | ||
− | |||
[[Категория:Автоматизация]] | [[Категория:Автоматизация]] | ||
[[Категория:Web-Сервисы]] | [[Категория:Web-Сервисы]] | ||
[[Категория:Такса]] | [[Категория:Такса]] |
Версия 05:02, 30 июля 2019
О сервисе
Сервис «Такса онлайн» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в 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 | Наличие сертификата происхождения товара. Возможные значения:
|
certificate_eav | 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&certificate_eav=1
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&certificate_eav=0
XML-ответ
GoodInfo | Корневой элемент документа |
Общая информация | |
GoodInfo -> Code | Код ТН ВЭД |
GoodInfo -> Name | Наименование кода ТН ВЭД |
Пошлина | |
GoodInfo -> Import | Информация о ставке |
GoodInfo -> Import -> Value | Ставка |
GoodInfo -> Import -> Order | Документ-основание для начисления ставки |
GoodInfo -> Import -> Link | Ссылка на документ |
Акциз | |
GoodInfo -> Exciselist | Список применяемых акцизов |
GoodInfo -> Exciselist -> Excise | Элемент применяемого акциза |
GoodInfo -> Exciselist -> Excise -> Value | Ставка акциза |
GoodInfo -> Exciselist -> Excise -> Condition | Описание или условие, при котором акциз применяется |
GoodInfo -> Exciselist -> Excise -> Document | Документ-основание для начисления акциза |
GoodInfo -> Exciselist -> Excise -> Link | Ссылка на документ |
НДС | |
GoodInfo -> VATlist | Список применяемых НДС |
GoodInfo -> VATlist -> VAT | Элемент применяемого НДС |
GoodInfo -> VATlist -> VAT -> Value | Ставка НДС |
GoodInfo -> VATlist -> VAT -> Condition | Описание или условие, при котором НДС применяется |
GoodInfo -> VATlist -> VAT -> Document | Документ-основание для начисления НДС |
GoodInfo -> VATlist -> VAT -> Link | Ссылка на документ |
Меры нетарифного применения | |
GoodInfo -> Notes | Перечень особенностей нетарифного регулирования для данного кода |
GoodInfo -> Notes -> Note | Элемент |
GoodInfo -> Notes -> Note -> Name | Наименование |
GoodInfo -> Notes -> Note -> Description | Описание |
GoodInfo -> Notes -> Note -> Document | Документ-основание |
GoodInfo -> Notes -> Note -> Link | Ссылка на документ |
Ошибки
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.
При работе с сервисом возможны следующие ошибки:
Код | Описание |
---|---|
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