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

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

*1 (по умолчанию) – сертификат в наличии
*0 – сертификат отсутствует

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

*1 – сертификат в наличии
*0 (по умолчанию) – сертификат отсутствует

|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
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-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|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||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|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||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 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 YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

*1 (по умолчанию) – сертификат в наличии
*0 – сертификат отсутствует

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

*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||Столбец строки таблицы
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|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

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:Такса]]

2019-07-30T02:02:45Z

Krashennikova:

2018-03-20T21:30:44Z

Krashennikova: Krashennikova переименовал страницу XML-API для Таксы онлайн в XML-API для получения справки о товаре (Такса): уточнение

XML-API для Таксы онлайн

2018-03-20T21:30:44Z

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

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

2018-01-10T11:37:25Z

Krashennikova:

API онлайн-сервиса Товары и Коды

2017-11-23T16:15:25Z

Krashennikova:

==О сервисе==
XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонние программы и сайты.

По искомому слову или словосочетанию сервис выдает список кодов ТН ВЭД и 100 первых записей по каждому коду, имеющих данное вхождение.

При необходимости можно отдельно тарифицируемым запросом дозапросить следующие 100 записей определенного кода ТН ВЭД, содержащих искомое словосочетание.

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

'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: 
Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin 
Вычисляем секрет: secret = md5("зерно:testlogin:testpassword") 
Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

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

Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
|+
!Параметр !!Тип !!Описание

|- highlight
|colspan=3 |'''Обязательные'''

|-
|srchstr||string||Слово или словосочетание; от 3-х букв

|- highlight
|colspan=3 |'''Необязательные'''

|-
|login||string||Логин к сервису

|-
|secret||string||MD5-секрет для данного запроса

|-
|tncode||string||Код ТН ВЭД; от 2 до 10 цифр для ограничения поиска по подразделам, группам, подгруппам и т.п.

|-
|page||int||Номер страницы при дополнительном запросе данных по определенному коду; от 2

|}

==Примеры запросов==
Подбор кодов по словосочетанию: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

Дополнительные записи по словосочетанию и коду 1104291700: 
https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

==XML-ответ==

{| class="wikitable" width="75%"
|-
|TikList||Корневой элемент документа
|-
|colspan=2|'''Общая информация'''
|-
|TikList->Code||Код ТН ВЭД
|-
|TikList->Count||Количество записей для данного кода
|-
|colspan=2|'''Записи для кода'''
|-
|TikList->Notes||Список из записей
|-
|TikList->Notes->Note||Запись для кода
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|200||Строка поиска должна состоять из 3-х или более символов
|-
|210||По данному запросу информация не найдена
|}

==Примеры ошибок==
Пользователь не авторизирован: 
https://www.alta.ru/tik/xml/?srchstr=test

Лимит запросов для данного пользователя исчерпан: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=42f74ba279764e904b852acb6ce8d6cd

Строка поиска не должна быть слишком короткая: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=5ad700cde63055c423288c3d624dc7c0

По данному запросу информация не найдена: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=46953aacb43eff6fcdbb408220a0152c

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:ТиК]]

API онлайн-сервиса Товары и Коды

2017-11-23T16:11:36Z

Krashennikova:

==О сервисе==
XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонние программы и сайты.

По искомому слову или словосочетанию сервис выдает список кодов ТН ВЭД и 100 первых записей по каждому коду, имеющих данное вхождение.

При необходимости можно отдельно тарифицируемым запросом дозапросить следующие 100 записей определенного кода ТН ВЭД, содержащих искомое словосочетание.

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

'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: 
Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin 
Вычисляем секрет: secret = md5("зерно:testlogin:testpassword") 
Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

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

Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
|+
!Параметр !!Тип !!Описание

|- highlight
|colspan=3 |'''Обязательные'''

|-
|srchstr||string||Слово или словосочетание; от 3-х букв

|- highlight
|colspan=3 |'''Необязательные'''

|-
|login||string||Логин к сервису

|-
|secret||string||MD5-секрет для данного запроса

|-
|tncode||string||Код ТН ВЭД; от 2 до 10 цифр для ограничения поиска по подразделам, группам, подгруппам и т.п.

|-
|page||int||Номер страницы при дополнительном запросе данных по определенному коду; от 2

|}

==Примеры запросов==
Подбор кодов по словосочетанию: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

Дополнительные записи по словосочетанию и коду 1104291700: 
https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

==XML-ответ==

{| class="wikitable" width="75%"
|-
|TikList||Корневой элемент документа
|-
|colspan=2|'''Общая информация'''
|-
|TikList->Code||Код ТН ВЭД
|-
|TikList->Count||Количество записей для данного кода
|-
|colspan=2|'''Записи для кода'''
|-
|TikList->Notes||Список из записей
|-
|TikList->Notes->Note||Запись для кода
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|200||Строка поиска должна состоять из 3-х или более символов
|-
|210||По данному запросу информация не найдена
|}

==Примеры ошибок==
Пользователь не авторизирован: 
https://www.alta.ru/tik/xml/?srchstr=test

Лимит запросов для данного пользователя исчерпан: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=42f74ba279764e904b852acb6ce8d6cd

Строка поиска не должна бытьслишком короткая: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=5ad700cde63055c423288c3d624dc7c0

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:ТиК]]

API онлайн-сервиса Товары и Коды

2017-11-23T16:07:56Z

Krashennikova: Новая страница: «==О сервисе== XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонни…»

==О сервисе==
XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонние программы и сайты.

По искомому слову или словосочетанию сервис выдает список кодов ТН ВЭД и 100 первых записей по каждому коду, имеющих данное вхождение.

При необходимости можно отдельно тарифицируемым запросом дозапросить следующие 100 записей определенного кода ТН ВЭД, содержащих искомое словосочетание.

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

'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: 
Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin
Вычисляем секрет: secret = md5("зерно:testlogin:testpassword")
Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

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

Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
|+
!Параметр !!Тип !!Описание

|- highlight
|colspan=3 |'''Обязательные'''

|-
|srchstr||string||Слово или словосочетание; от 3-х букв

|- highlight
|colspan=3 |'''Необязательные'''

|-
|login||string||Логин к сервису

|-
|secret||string||MD5-секрет для данного запроса

|-
|tncode||string||Код ТН ВЭД; от 2 до 10 цифр для ограничения поиска по подразделам, группам, подгруппам и т.п.

|-
|page||int||Номер страницы при дополнительном запросе данных по определенному коду; от 2

|}

==Примеры запросов==
Подбор кодов по словосочетанию: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

Дополнительные записи по словосочетанию и коду 1104291700: 
https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=3d39b0be0a5e5bb7fc071261c4a68c03

==XML-ответ==

{| class="wikitable" width="75%"
|-
|TikList||Корневой элемент документа
|-
|colspan=2|'''Общая информация'''
|-
|TikList->Code||Код ТН ВЭД
|-
|TikList->Count||Количество записей для данного кода
|-
|colspan=2|'''Записи для кода'''
|-
|TikList->Notes||Список из записей
|-
|TikList->Notes->Note||Запись для кода
|}

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

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|200||Строка поиска должна состоять из 3-х или более символов
|-
|210||По данному запросу информация не найдена
|}

==Примеры ошибок==
Пользователь не авторизирован: 
https://www.alta.ru/tik/xml/?srchstr=test

Лимит запросов для данного пользователя исчерпан: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=42f74ba279764e904b852acb6ce8d6cd

Строка поиска не должна бытьслишком короткая: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=5ad700cde63055c423288c3d624dc7c0

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:ТиК]]

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

2017-11-03T17:13:15Z

Krashennikova: /* API */

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

2017-07-31T16:38:58Z

Krashennikova:

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

2017-07-31T16:29:37Z

Krashennikova: Новая страница: «==О сервисе== Сервис «Такса онлайн» предоставляет разработчикам возможность получения и…»