Федеральная Налоговая Служба Документация по работе с API ФНС Техническая поддержка: info@api-parser.com Адрес сервера для запросов: https://api.api-parser.com Метод regionList: ПОЛУЧЕНИЕ ID РЕГИОНОВ ДЛЯ ИСПОЛЬЗОВАНИЯ В ЗАПРОСАХ К СЕРВИСУ Для запросов необходимо указывать ID региона, по которому происходит поиск. Список ID и названий регионов может быть получен в JSON следующим запросом: https://api.api-parser.com/?service=nalog&method=regionList&key=КЛЮЧ_ДОСТУПА Метод egrul: СВЕДЕНИЯ О ГОСУДАРСТВЕННОЙ РЕГИСТРАЦИИ ЮРИДИЧЕСКИХ ЛИЦ, ИНДИВИДУАЛЬНЫХ ПРЕДПРИНИМАТЕЛЕЙ, КРЕСТЬЯНСКИХ (ФЕРМЕРСКИХ) ХОЗЯЙСТВ type - тип поискового запроса (search, pdfFile, pdfFileContent) search - ПРЕДОСТАВЛЕНИЕ СВЕДЕНИЙ ИЗ ЕГРЮЛ/ЕГРИП query* - ИНН, ОГРН (ОГРНИП) или наименование ЮЛ, ФИО ИП nameEq - поиск по точному соответствию наименования юридического лица или ФИО (true/false) region - ID региона поиска (полученный из метода regionList) pdfFile – ПОЛУЧЕНИЕ ВЫПИСКИ В ВИДЕ PDF ФАЙЛА pdfID* – параметр pdfID, полученный из поискового запроса ЕГРИЮЛ/ЕГРИП formatPdf – отображение файла pdf в запросе: base64, download, browsing search,pdfFile – ПРЕДОСТАВЛЕНИЕ СВЕДЕНИЙ ИЗ ЕГРЮЛ/ЕГРИП + PDF ФАЙЛ (при условии, что производится точная проверка и в результате будут данные об одном лице/компании. Например поиск по ИНН) query* - ИНН, ОГРН (ОГРНИП) или наименование ЮЛ, ФИО ИП nameEq - поиск по точному соответствию наименования юридического лица или ФИО (true/false) region - ID региона поиска (полученный из метода regionList) formatPdf – отображение файла pdf в запросе: base64, download, browsing pdfFileContent – ПОЛУЧЕНИЕ СОДЕРЖИМОГО ИЗ ВЫПИСКИ PDF ФАЙЛА pdf* – прямая ссылка на файл или параметр pdfID, полученный из поискового запроса ЕГРИЮЛ/ЕГРИП РЕЗУЛЬТАТ ОБРАБОТКИ ЗАПРОСА: В теле ответа на запросы содержится JSON следующего формата: client - информация о лимитах текущего ключа (к-во запросов, срок действия и тд). search - массив результатов поиска, каждый элемент - отдельный массив. Каждый элемент содержит следующие поля: pdfID - уникальный ID для получения pdf файла name - ФИО или наименование юридического лица address - Адрес (место нахождения) юридического лица OGRN - ОГРНИП/ОГРН INN - ИНН KPP - КПП dateReg - Дата присвоения ОГРНИП/ОГРН dateEnd - Дата прекращения деятельности dateInvalid - Дата признания регистрации недействительной ПРИМЕРЫ ЗАПРОСОВ API: https://api.api-parser.com/?service=nalog&method=egrul&type=search&query=772500523510&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=egrul&type=search&query=иванов виктор федорович®ion=77&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=egrul&type=search&query=7717068566&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=egrul&type=search&query=ани&nameEq=true&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=egrul&type=pdfFile&pdfID=pdfID&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=egrul&type=pdfFileContent&pdf=pdfID&key=КЛЮЧ_ДОСТУПА Метод service.io: ОТКРЫТЫЕ И ОБЩЕДОСТУПНЫЕ СВЕДЕНИЯ ЕГРН ОБ ИНОСТРАННЫХ ОРГАНИЗАЦИЯХ type - тип поискового запроса (number, name, address). number - Поиск по ИНН/КПП number* – ИНН kpp - КПП region - регион места нахождения name - Поиск по наименованию name* – наименование region - регион места нахождения address - Поиск по адресу address* - адрес места нахождения РЕЗУЛЬТАТ ОБРАБОТКИ ЗАПРОСА: В теле ответа на запросы содержится JSON следующего формата: client - информация о лимитах текущего ключа (к-во запросов, срок действия и тд). search - массив результатов поиска, каждый элемент - отдельный массив. Каждый элемент содержит следующие поля: INN - ИНН KPP - КПП nameSmall - Сокращенное наименование nameFull - Полное наименование nameUnitSmall - Сокращенное наименование обособленного подразделения nameUnitFull - Полное наименование обособленного подразделения status - Статус (Состоит на учете/Снята с учета) authorityId - ID налогового органа постановки на учет authority - Название налогового органа постановки на учет ПРИМЕРЫ ЗАПРОСОВ API: https://api.api-parser.com/?service=nalog&method=service.io&type=number&number=9909003559&kpp=773851001®ion=77&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=service.io&type=name&name=группа&nameEq=true®ion=77&key=КЛЮЧ_ДОСТУПА Метод service.inn: УЗНАТЬ ИНН. СВЕДЕНИЯ ОБ ИНН ФИЗИЧЕСКИХ ЛИЦ lastName* - Фамилия firstName* - Имя patronymic* - Отчество (Не заполнять, если Нет отчества) birthDate* - Дата рождения birthPlace - Место рождения docType* - Вид документа, удостоверяющего личность: 01-Паспорт гражданина СССР, 03-Свидетельство о рождении, 10-Паспорт иностранного гражданина, 12-Вид на жительство в Российской Федерации, 15-Разрешение на временное проживание в Российской Федерации, 19-Свидетельство о предоставлении временного убежища на территории Российской Федерации, 21-Паспорт гражданина Российской Федерации, 23-Свидетельство о рождении, выданное уполномоченным органом иностранного государства, 62-Вид на жительство иностранного гражданина docNumber* - Серия и номер документа docReceive - Дата выдачи документа РЕЗУЛЬТАТ ОБРАБОТКИ ЗАПРОСА: В теле ответа на запросы содержится JSON следующего формата: client - информация о лимитах текущего ключа (к-во запросов, срок действия и тд). search - массив результатов поиска. В результате успешного поиска, будет доступная переменная с ИНН: INN - ИНН ПРИМЕР ЗАПРОСА API: https://api.api-parser.com/?service=nalog&method=service.inn&lastName=Алдошина&firstName=Анастасия&patronymic=Александровна&birthDate=07.10.1986&docType=21&docNumber=6013425120&docReceive=25.07.2013&key=КЛЮЧ_ДОСТУПА Метод service.invalidInn: СВЕДЕНИЯ О НЕДЕЙСТВИТЕЛЬНЫХ ИНН ФИЗИЧЕСКИХ И ЮРИДИЧЕСКИХ ЛИЦ searchType* - Тип поиска: 1-физические лица, 2-юридические лица region* - ID региона поиска (полученный из метода regionList) inn - ИНН code - Код инспекции/КПП month - Месяц признания недействительным year - Год признания недействительным РЕЗУЛЬТАТ ОБРАБОТКИ ЗАПРОСА: В теле ответа на запросы содержится JSON следующего формата: client - информация о лимитах текущего ключа (к-во запросов, срок действия и тд). search - массив результатов поиска. ПРИМЕР ЗАПРОСА API: https://api.api-parser.com/?service=nalog&method=service.invalidInn&searchType=1®ion=77&inn=530700834639&code=7731&month=1&year=2019&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=service.invalidInn&searchType=2®ion=77&inn=7716871562&code=770401001&month=3&year=2018&key=КЛЮЧ_ДОСТУПА Метод service.disqualified: ПОИСК СВЕДЕНИЙ В РЕЕСТРЕ ДИСКВАЛИФИЦИРОВАННЫХ ЛИЦ lastName - Фамилия firstName - Имя patronymic - Отчество birthDate - Дата рождения name - Наименование организации inn - ИНН организации РЕЗУЛЬТАТ ОБРАБОТКИ ЗАПРОСА: В теле ответа на запросы содержится JSON следующего формата: client - информация о лимитах текущего ключа (к-во запросов, срок действия и тд). search - массив результатов поиска. ПРИМЕР ЗАПРОСА API: https://api.api-parser.com/?service=nalog&method=service.disqualified&lastName=АВЕРИНА&firstName=ТАТЬЯНА&patronymic=ВЛАДИМИРОВНА&birthDate=13.05.1977&name=КОРУС&inn=5603040203&key=КЛЮЧ_ДОСТУПА Метод service.uwsfind: ПОИСК СВЕДЕНИЙ О ЮРИДИЧЕСКИХ ЛИЦАХ И ИНДИВИДУАЛЬНЫХ ПРЕДПРИНИМАТЕЛЯХ, В ОТНОШЕНИИ КОТОРЫХ ПРЕДСТАВЛЕНЫ ДОКУМЕНТЫ ДЛЯ ГОСУДАРСТВЕННОЙ РЕГИСТРАЦИИ searchType* - Тип поиска: 1-юридические лица, 2-индивидуальные предприниматели number* - ОГРН/ОГРНИП name* - Наименование/ФИО индивидуального предпринимателя typeForm - Форма поданного документа (ID из метода typeFormList) stateFNS - ИФНС, в которую был подан документ (ID из метода stateFNSList) startDate - Начальная дата периода, в который был подан документ endDate - Конечная дата периода, в который был подан документ РЕЗУЛЬТАТ ОБРАБОТКИ ЗАПРОСА: В теле ответа на запросы содержится JSON следующего формата: client - информация о лимитах текущего ключа (к-во запросов, срок действия и тд). search - массив результатов поиска. ПРИМЕР ЗАПРОСА API: https://api.api-parser.com/?service=nalog&method=service.uwsfind&searchType=1&number=1187746787909&name=ООО%20ВИКТОРИ&key=КЛЮЧ_ДОСТУПА https://api.api-parser.com/?service=nalog&method=service.uwsfind&searchType=2&number=304253632200061&name=ЕФИМЕНКОВА%20ВИКТОРИЯ%20ВИКТОРОВНА&key=КЛЮЧ_ДОСТУПА