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

Материал из Alta-Soft Wikipedia
Версия от 10:28, 5 сентября 2017; Belousov (обсуждение | вклад) (Примеры ошибок)
Перейти к навигации Перейти к поиску

О сервисе

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

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


API

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

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

Для авторизации по статичному IP-адресу никакой дополнительной информации, кроме запроса, передавать не нужно. Запрос будет выглядеть как https://www.alta.ru/tnved/xml/?tncode=0101291000

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

Параметр Тип Описание
Обязательные
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 – сертификат отсутствует


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

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

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

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


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 Лимит запросов для данного пользователя исчерпан
200 Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
210 Формат даты не соответствует
220 На запрошенную дату код не действует. «Действие кода прекращено с…» или «Действие кода начнется с…»
250 Код страны не найден


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

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

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

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

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

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

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