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

Материал из Alta-Soft Wikipedia
Версия от 19:29, 31 июля 2017; Krashennikova (обсуждение | вклад) (Новая страница: «==О сервисе== Сервис «Такса онлайн» предоставляет разработчикам возможность получения и…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

О сервисе

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