Проверки ФНС через API Cloud

by API-CLOUD

Проверяйте ИНН физлица по паспортным данным, валидность ИНН или статус плательщика налога на профессиональный доход по ИНН.

🏛️ Госуслуги
Компания
API-CLOUD
Сайт компании
api-cloud.ru ↗

Что делает API

В API Cloud предусмотрены методы inn, invalidinn и npd. Первый сопоставляет персональные данные и реквизиты документа с ИНН; два других принимают 12-значный ИНН и возвращают сведения о проверке недействительности номера или статусе НПД. Это посреднические ответы по налоговым данным, применимость и актуальность ограничены конкретной операцией и источником.

Когда использовать

  • Если нужен статус НПД, вызывайте npd по ИНН; если требуется найти ИНН физлица, используйте отдельный inn с предусмотренными документом полями и обрабатывайте результат отдельно.
  • Повторно запросить статус НПД по сохранённому ИНН и отобразить его вместе с датой из ответа.

Подключение и ограничения

Авторизация
Персональный токен API Cloud из настроек; параметр token или заголовок Token.
Что учесть
Не путайте проверку ИНН (inn), недействительность номера (invalidinn) и статус НПД (npd). Передавайте минимум сведений, строго нужных выбранному методу.

Пример использования

Подготовьте доступ по инструкции выше и замените параметры своими. Пример не выполняется на этой странице.

# Задайте API_CLOUD_TOKEN; замените заполнители реквизитами своего запроса.
curl --silent --show-error --fail-with-body --get --max-time 120 'https://api-cloud.ru/api/nalog.php' \
  --data-urlencode 'type=npd' \
  --data-urlencode 'inn=12_ЦИФР_ИНН' \
  --header "Token: ${API_CLOUD_TOKEN:?Укажите токен API Cloud}"
Результат
Для npd пример возвращает status, found, inn, date, NPD и message; NPD=1 означает статус плательщика НПД, NPD=0 — отсутствие этого статуса на указанную дату. Для invalidinn документированы invalid и date_invalid. В примерах провайдер также передаёт inquiry с price и техническими сведениями об обработке.

Сверено с документацией: .

Порядок интеграции

  1. Для статуса НПД вызовите npd с 12-значным ИНН; не отправляйте паспортные реквизиты в этом методе.
  2. Прочитайте NPD вместе с date и inn; сохраните дату результата, так как она входит в ответ и показывает дату проверки.
  3. Для проверки недействительного ИНН используйте отдельный invalidinn и трактуйте invalid/date_invalid по его собственной схеме.

Что проверить перед запуском

  • NPD=0 означает только отсутствие статуса НПД на дату, указанную в ответе; не трактуйте результат как постоянный статус или подтверждение иных налоговых сведений.

Связанные API