Интерфейс: /fns-calc API статуса самозанятого по ИНН и справочник ставок ФНС
Название сервиса сложилось исторически и вводит в заблуждение, поэтому скажем сразу: расчёты налогов по HTTP тут не отдаются. Через сеть работают проверки статусов по ИНН и справочник ставок. Расчёты — налог на добавленную стоимость, упрощённая система, взносы, патент — живут в пакете с открытым кодом и считаются у вас локально, без сети и без ключа.
Что означает статус. Проверено запросом 2 августа 2026 года, и статус здесь понижен намеренно. Сервис запущен и отвечает, но работают не все проверки: из пяти проверок статуса отвечают две — самозанятый и предприниматель. Задолженность и блокировки по счетам возвращают ошибку источника. Хуже всего с проверкой дисквалификации: на боевом сервере она прямо сейчас отвечает «совпадение не обнаружено» даже для человека, который в реестре есть. Мы нашли причину и исправили её в коде, но на сервер исправление ещё не выложено — до выкладки этой проверке доверять нельзя. Отдельно: расчётов налогов по HTTP сервис не отдаёт вовсе, они есть только в офлайн-пакете. В реестре наших серверов запись помечена как боевая; страница показывает более осторожную оценку, потому что она ближе к факту.
Строка из нашего реестра серверов: Размещённый доступ: состав и подключение — по инструкции сервиса
Как проверить подключение и сообщить об ошибке
Описание, опубликованный клиент и учебный пример сами по себе не подтверждают ответ источника. Статус на странице отражает сохранённые сведения о продукте, а не проверку в момент вашего посещения.
Происхождение сведений и правовые основания — в описании источников; возможности клиента и ограничения — на странице продукта.
- Сверьте состав данных и ограничения продукта. Возьмите адрес метода и способ авторизации из инструкции подключения.
- Проверьте ключ и разрешения. Ответ 401 или 403 требует проверки доступа; он сам по себе не означает, что источник недоступен. Ответ 200 от страницы документации или health-метода тоже не подтверждает получение данных.
- При выполнении своего разрешённого запроса проверьте дату данных, нужные поля и статус источника. Ошибка, пустой ответ и отсутствие совпадений — разные результаты.
Сообщить о проблеме с этим продуктом: укажите метод, время и текст ошибки без ключа и персональных данных. Форма также позволяет скопировать обращение для отправки по почте.
Что этот сервис отдаёт по сети, а что нет
По сети сервис отдаёт две вещи. Первая — проверки статуса по ИНН: плательщик налога на профессиональный доход и предприниматель в государственном реестре. Обе идут к сервисам налоговой службы в момент запроса и проверены живьём. Вторая — справочник ставок и предельных значений: фиксированные взносы предпринимателя по годам, порог однопроцентного взноса, шкала налога на доходы физических лиц, предел упрощённой системы, ключевая ставка. Опознание клиента — заголовок X-API-Key. Суточная квота на ключ по умолчанию 500 запросов; ограничения на количество обращений в минуту в коде нет.
Чего сервис по сети не делает. Расчётов налогов среди его адресов нет ни одного — ни в коде, ни в машинном описании интерфейса. Раньше эта страница обещала расчёт налога на добавленную стоимость и упрощённой системы по HTTP; это было неверно, и мы это убрали. Ещё три проверки объявлены, но результата не дают, и причины у них разные. Задолженность: сервис «Прозрачный бизнес» перешёл на двухшаговый порядок обращения, наш код пока на один шаг. Блокировки по счетам: источник требует ввести код с картинки, а обходить такую защиту мы не станем. Обе возвращают явную ошибку, а не «нарушений не найдено», — так и должно быть. Третья, проверка дисквалификации, вела себя неправильно: отвечала «совпадение не обнаружено» на любой запрос. Причину нашли, исправление готово, ждёт выкладки на сервер.
Что сервис отдаёт
Важно не перепутать два перечня. Таблица ниже — возможности MCP-сервера, пакета для ИИ-агентов; расчёты налогов в ней выполняются локально на машине пользователя. Адреса для обмена по HTTP — отдельным разделом дальше, и расчётов среди них нет.
| Возможность | Что делает | Что подаётся | Что приходит |
|---|---|---|---|
| calc_vat | Расчёт НДС (offline). | amount: float, rate: float | VatResult |
| check_selfemployed | Статус плательщика НПД (hosted Pro). | inn: str | SelfemployedStatus |
| check_disqualified | Реестр дисквалифицированных лиц (hosted Pro). | inn?: str, fio?: str | DisqualifiedMatch |
- Опознание клиента — заголовок X-API-Key. Не перепутайте с проверкой контрагента: там другая схема, Authorization: Bearer.
- Ключ нужен всем адресам под /v1. Проверки живости и готовности открыты.
- Ограничение — суточная квота на ключ, по умолчанию 500 запросов. Поминутного ограничения в коде нет.
- Заголовков с остатком квоты сервис не присылает: об исчерпании клиент узнаёт только по отказу. Это в доработках.
- Ответы проверок кэшируются на час. В теле есть поле cached: false означает, что сходили к источнику.
- Справочник ставок — не живое обращение к налоговой службе, а выверенный список внутри пакета. Ставки стоит сверять с первоисточником.
Адреса запросов
| Метод | Путь | Ключ | Что делает |
|---|---|---|---|
| GET | /fns-calc/health | не нужен | Проверка живости — адрес проверен на боевом сервере |
| GET | /fns-calc/readyz | не нужен | Готовность: хранилище и сетевой клиент |
| GET | /fns-calc/openapi.json | не нужен | Машинное описание всех адресов |
| GET | /fns-calc/v1/rates | ключ | Справочник ставок и предельных значений; параметр kinds сужает выдачу |
| POST | /fns-calc/v1/status/selfemployed | ключ | Плательщик налога на профессиональный доход по ИНН — работает |
| POST | /fns-calc/v1/status/ip | ключ | Предприниматель в государственном реестре; ИНН ровно 12 цифр — работает |
| POST | /fns-calc/v1/status/disqualified | ключ | Реестр дисквалифицированных лиц — сейчас отвечает неверно, исправление ждёт выкладки |
| POST | /fns-calc/v1/status/arrears | ключ | Индикатор налоговой задолженности — источник не отвечает |
| POST | /fns-calc/v1/status/account-block | ключ | Приостановление операций по счетам — источник требует код с картинки |
Раньше на этом месте было написано, что публичного справочника путей нет. Это оказалось неверно: машинное описание интерфейса открыто без ключа по адресу /fns-calc/openapi.json, перечень выше снят оттуда и проверен запросами. Человекочитаемых страниц документации у сервиса нет — они отключены в коде. Обратите внимание, что приставку /fns-calc снимает шлюз, поэтому в машинном описании адреса начинаются сразу с /health и /v1.
api.atomno-data.ru, формат JSON.
Полный URL метода и формат ошибки смотрите в инструкции подключения продукта.
Authorization: Bearer или
X-API-Key — способ зависит от сервиса
и указан в примерах.
Примеры запросов
В шаблонах ATOMNO_METHOD_URL — полный URL метода из инструкции подключения. Сохранённые ответы иллюстрируют формат данных; доступные проверки указаны выше.
Справочник ставок — живой запрос и настоящий ответ
Снято 2 августа 2026 года. Ответ приведён целиком, ничего не убрано. Параметр kinds позволяет запросить только нужные разделы, например ?kinds=ndfl_scale,cbr_key_rate — проверено, работает.
Статус самозанятого — живой запрос и настоящий ответ
Снято 2 августа 2026 года. Поле request_date необязательно, по умолчанию берётся сегодняшняя дата. Повторный такой же запрос вернул то же тело с cached: true — кэш работает.
Так выглядит неработающая проверка — и это правильно
Тот же боевой сервер, проверка налоговой задолженности. Сервис не пишет «задолженности нет», а честно возвращает ошибку источника. Причина найдена: сервис «Прозрачный бизнес» перешёл на двухшаговый обмен и переименовал поле запроса. Починка в работе.
Правовое основание и источник данных
Расчётная часть ни к каким реестрам не обращается — это применение норм Налогового кодекса к вашим числам. Правовое основание нужно только живым проверкам, и оно своё у каждого источника.
Кодекс об административных правонарушениях, часть 3 статьи 32.11: реестр открыт для всеобщего ознакомления и размещается на сайте налоговой службы.
Федеральный закон от 08.08.2001 № 129-ФЗ, пункт 1 статьи 6: сведения государственных реестров открыты и общедоступны, кроме прямо ограниченных законом.
Федеральный закон от 27.07.2006 № 149-ФЗ, часть 4 статьи 7: информация, размещённая обладателем в интернете в машиночитаемом виде, является общедоступной в форме открытых данных.
Проверка статуса плательщика налога на профессиональный доход в нашем перечне источников и правовых оснований отдельной строкой пока не описана — это пробел, который мы закрываем. Отдельно про проверку блокировок по счетам: сервис налоговой службы требует ввода кода с картинки, а обходить такую защиту мы не будем. Пока налоговая не даст другой способ обращения, эта проверка непригодна для автоматической работы, и продавать её мы не станем. Справочник ставок носит справочный характер: он не заменяет налоговую, бухгалтерскую или юридическую консультацию, ставки меняются, и их стоит сверять с первоисточником.
По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — ФНС России . Atomno MCP не аффилирован с ним.
Чем это отличается от MCP-сервера
Данные одни и те же, отличается способ обращения. Обмен по HTTP разбирает ваш код, MCP-сервер — языковая модель внутри вашего продукта или редактора.
Берите обмен по HTTP, если
- Статус самозанятого проверяется автоматически перед каждой выплатой исполнителю.
- Нужна проверка партии исполнителей по расписанию, без участия человека.
- Ставки нужны бизнес-логике: подстановка в калькулятор, пересчёт при смене года.
Берите MCP-сервер, если
- Бухгалтер или предприниматель спрашивает ассистента текстом: «посчитай налог с этой суммы».
- Нужны сами расчёты — по сети их нет, они есть только в пакете с открытым кодом.
- Хочется попробовать бесплатно и локально: офлайн-часть работает без ключа и без сети.
Тут разница принципиальная, а не в удобстве. Расчёты налогов существуют только в пакете с открытым кодом и выполняются у вас на машине. По сети их получить нельзя — это не ограничение тарифа, таких адресов просто нет.
Чего пока нет
Мы предпочитаем назвать пробел, чем показать красивую страницу и подвести вас на этапе интеграции. Здесь и то, чего нет в документации, и то, что не работает в самом сервисе.
- Три проверки статуса из пяти не дают результата. Задолженность: сервис «Прозрачный бизнес» перешёл на двухшаговый обмен, наш код на один шаг. Блокировки по счетам: источник требует код с картинки, обходить нельзя. Дисквалификация: исправление сделано, но на сервер не выложено.
- Пока исправление дисквалификации не выложено, боевой сервис отдаёт «совпадение не обнаружено» даже для человека, который в реестре есть. Это самая опасная из найденных ошибок.
- Квота списывается до обращения к источнику, поэтому неудачная проверка тоже стоит клиенту запроса. Так быть не должно.
- Заголовков с остатком квоты нет — клиент узнаёт об исчерпании только по отказу.
- Ошибки ввода возвращаются как ошибки источника: неверная контрольная сумма ИНН и десятизначный ИНН в проверке предпринимателя дают ответ «источник не ответил», хотя виноват запрос.
- В поле БИК у проверки блокировок стоит пометка «необязательно», хотя без него источник отказывает сразу.
Вопросы и ответы
Можно ли посчитать налог на добавленную стоимость через запрос к вашему серверу?
Какие проверки реально отвечают прямо сейчас?
Как передавать ключ доступа?
Есть ли ограничение на количество запросов?
Все ли проверки доступны через API?
Почему офлайн-расчёт и ответ проверки статуса могут различаться по доступности?
Можно ли отправить запрос без ключа для проверки состояния сервиса?
Получить ключ к проверкам статусов
Работают проверка самозанятого, проверка предпринимателя и справочник ставок — примеры выше настоящие. Расчёты берите бесплатно в пакете с открытым кодом. Напишите, какой объём обращений ожидаете, и мы пришлём ключ; заодно скажем прямо, какие проверки пока не отвечают. Почта для писем: sales@atomno.com .
Как поставитьОтвет сервиса — сводка сведений из открытых государственных реестров на момент запроса, а не юридическое заключение. Недоступность источника мы не выдаём за отсутствие записей.
