Сервис ТНВЭД ИНФО
Адрес АПИ - api.tnved.info
Лицензия ТНВЭД АПИ также действует и на сайте tnved.info.
Требуется авторизация по логину и паролю.
Как получить логин и пароль. Получение лицензии.
1. Регистрируемся на сайте tnved.info. В Профиле пользователя узнаем номер рабочего места.
2. Связываемся с отделом продаж ТОО "Sector Tree" для приобретения Лицензии.
Метод поиска по полному коду/текстовому описанию
Доступен по относительному адресу /ExternalApi/Search
Имеется Basic authentication: при каждом запросе необходимо передавать свои логин и пароль, использующиеся для входа на сайт tnved.info, в формате атрибута Authorization с содержимым вида Basic bm9uZTpub25l, где bm9uZTpub25l - это base64-кодированная связка логин:пароль.
Входные параметры:
~ query (string) - поисковый запрос. Может представлять из себя полное описание кода, часть описания кода, или полный код ТНВЭД.
~ group (string) - фильтр по группам. Например, поиск с фильтром "0704" возвратит коды, входящие в эту группу (начинающиеся с "0704"). Параметр может быть пустым
Результат выполнения - JSON-форматированная строка вида:
{
Result - массив результатов (до 20ти)
[
{
Probability (double)- вероятность совпадения
Code (string) - код ТНВЭД
Description (string) - описание кода
StartDate (DateTime) - дата начала действия кода
EndDate (DateTime) - дата окончания действия кода
IsOld (bool) - показатель того, устарел ли код
}
],
Transition - информация о переходе кодов ТНВЭД 2017-2022
{
CodeFrom (string) - код ТНВЭД, с которого был совершён переход
CodeTo (string) - код ТНВЭД, на который был совершён переход
Description - описание кода ТНВЭД, на который был совершён переход
},
Vto (string), - информация о (не-)вхождении в перечень ВТО
License - информация о лицензии
{
WorkPlace (string) - номер рабочего места
EndDate (DateTime) - дата окончания действия лицензии
Remain (int) - осталось использований
Total (int) - всего использований
},
ResponseState (int) - состояние запроса (подробности ниже)
ErrorMessage (string) - сообщение о возникшей ошибке
}
Состояния запроса:
~ 200, 201 - OK
~ 203 - по запросу ничего не найдено
~ 301 - введён неполный код ТНВЭД
~ 500 - внутренняя ошибка сервера
~ 401 - неавторизованный пользователь
~ 403 - лицензия истекла
~ 449 - обновление информации для поиска. Пожалуйста, попробуйте снова через несколько секунд
Пример использования на C#:
Запрос на поиск кода
{
"Result": [
{
"Probability": 96.283471735774739,
"Code": "6109100000",
"Description": "МАЙКИ, ФУФАЙКИ С РУКАВАМИ И ПРОЧИЕ НАТЕЛЬНЫЕ ФУФАЙКИ ТРИКОТАЖНЫЕ, ИЗ ХЛОПЧАТОБУМАЖНОЙ ПРЯЖИ, МАШИННОГО ИЛИ РУЧНОГО ВЯЗАНИЯ",
"StartDate": "2017-01-01T00:00:00Z",
"EndDate": null,
"IsOld": false
},
{
"Probability": 3.6865626048069915,
"Code": "6109902000",
"Description": "МАЙКИ, ФУФАЙКИ С РУКАВАМИ И ПРОЧИЕ НАТЕЛЬНЫЕ ФУФАЙКИ ТРИКОТАЖНЫЕ МАШИННОГО ИЛИ РУЧНОГО ВЯЗАНИЯ ИЗ ШЕРСТЯНОЙ ПРЯЖИ ИЛИ ПРЯЖИ ИЗ ТОНКОГО ВОЛОСА ЖИВОТНЫХ ИЛИ ИЗ ХИМИЧЕСКИХ НИТЕЙ",
"StartDate": "2017-01-01T00:00:00Z",
"EndDate": null,
"IsOld": false
},
{
"Probability": 0.0031658153874043289,
"Code": "6109909000",
"Description": "МАЙКИ, ФУФАЙКИ С РУКАВАМИ И ПРОЧИЕ НАТЕЛЬНЫЕ ФУФАЙКИ ТРИКОТАЖНЫЕ, ИЗ ПРОЧИХ ТЕКСТИЛЬНЫХ МАТЕРИАЛОВ, МАШИННОГО ИЛИ РУЧНОГО ВЯЗАНИЯ",
"StartDate": "2017-01-01T00:00:00Z",
"EndDate": null,
"IsOld": false
}
],
"License": {
"WorkPlace": "91036",
"EndDate": "2021-10-09T00:00:00",
"Remain": 2947,
"Total": 3000
},
"ResponseState": 200,
"ErrorMessage": null
}
Если лицензия истекла
{
"Result": null,
"License": null,
"ResponseState": 403,
"ErrorMessage": "К сожалению, срок действия лицензии истёк"
}
Пример кода для 1С
АдресСервера = "api.tnved.info";
Ресурс = "/Api/ExternalApi/Search?query=3921906000"; -- 3921906000 - это код ТН ВЭД
ИмяПользователя = "имя"; -- email адрес, под которым выполняется вход
Пароль = "пароль";
СтрокаАвторизации = ПолучитьBase64СтрокуИзДвоичныхДанных(
ПолучитьДвоичныеДанныеИзСтроки(
""+ИмяПользователя+":"+Пароль,КодировкаТекста.UTF8,Ложь));
SSL = Новый ЗащищенноеСоединениеOpenSSL;
Соединение = Новый HTTPСоединение(АдресСервера,443,,,,,SSL);
Заголовки = Новый Соответствие;
Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");
Заголовки.Вставить("Authorization", "Basic "+СтрокаАвторизации);
Запрос = Новый HTTPЗапрос(Ресурс,Заголовки);
Результат = Соединение.Получить(Запрос);
ТекстОтвета = Результат.ПолучитьТелоКакСтроку();