Fiscalization Handbook¶
База знаний по фискализации для человека, который должен быстро войти в 54-ФЗ, облачные кассы, ФФД, банковскую фискализацию и поведение кассовых провайдеров.
Фокус сайта - электронная коммерция: интернет-эквайринг, облачные ККТ, электронные чеки, возвраты, зачет аванса, маркировка, ОФД и проверка тестовых касс. Розничная касса на торговой точке рассматривается только там, где она помогает отличить дистанционный сценарий от офлайн-расчета.
Текущий статус¶
Healthcheck тестовых касс показывает текущий hourly-статус test-контуров: быстрый getToken по провайдерам, последний подтвержденный smoke-статус регистрации чеков из daily-мониторинга и состояние ККТ АТОЛ.
Последняя проверка: Загрузка...
Провайдеры и тестовые группы
| Провайдер | Группа | Логин | Статус | Токен | Регистрация | Задержка |
|---|---|---|---|---|---|---|
| Загрузка... | ||||||
ККТ АТОЛ
| Группа | РНМ | ФН | Срок ФН | Заполнение | Неотпр. | Связь |
|---|---|---|---|---|---|---|
| Загрузка... | ||||||
Как читать¶
- Начните с 54-ФЗ и ККТ: термины, типы касс, где облачная ККТ допустима, а где нет.
- Затем прочитайте облачную кассу в e-commerce: путь от платежа до ФНС и роль банка.
- После этого переходите к типам чеков, ФФД, чекам коррекции и холду/capture.
- Для интеграционной работы используйте сравнение провайдеров, отличия протоколов и матрицу ошибок.
- Для текущего контроля используйте только healthcheck тестовых касс: он отвечает на вопрос, работают ли тестовые кассы сейчас.
Главная модель¶
Фискализация - это не один API-вызов. Это цепочка:
Платеж / бизнес-событие
-> решение, какой фискальный документ нужен
-> payload банка или мерчанта
-> кассовый провайдер
-> ККТ и фискальный накопитель
-> ОФД
-> ФНС
Успешный платеж не доказывает, что чек сформирован. Успешная регистрация задания у провайдера не доказывает, что чек фискализирован. Публичная страница ОФД не всегда показывает все теги, которые есть в фискальном документе. Поэтому в спорных случаях нужно смотреть весь маршрут: payload, ответ регистрации, report, ФД, ОФД и финальный статус ФНС.
Базовые принципы¶
| Принцип | Что означает на практике |
|---|---|
| Расчет шире списания денег | Предоплата, аванс, зачет аванса, возврат и коррекция могут требовать разных чеков. |
| Облачная ККТ не заменяет кассу на точке | Если покупатель взаимодействует с продавцом на месте, сценарий может требовать наземную ККТ. |
| ФФД важнее витрины ОФД | Отсутствие поля на публичной странице ОФД не всегда означает отсутствие тега в ФД. |
| Провайдеры похожи, но не одинаковы | АТОЛ-подобный API не гарантирует одинаковые endpoint, token placement, ошибки и поддержку коррекций. |
| Healthcheck - только про доступность тестовых касс | Методология, ссылки и обучающий контент не должны смешиваться с ежедневным тестом работоспособности. |
Что не входит в сайт¶
- внутренние рассуждения о том, чем заполнить раздел;
- разборы отдельных сбоев как самостоятельный жанр;
- поверхностные сценарии операторского ответа;
- сырые учетные данные, токены, raw JSON с секретами;
- непроверенные таблицы с вопросительными знаками вместо результата.
Если факт не подтвержден тестом, спецификацией или официальным источником, он должен быть помечен как ограничение источника, а не как готовый вывод.