Фискализация и 54‑ФЗ: чеки, позиции, ставки НДС

Бесшовная фискализация онлайн‑платежей — ключ к соответствию 54‑ФЗ и корректной отчётности перед ФНС. Платёжная платформа api‑platezhi.ru закрывает весь цикл: от приёма оплаты до пробития чека на онлайн‑кассе, передачи в ОФД и отправки электронного чека клиенту. Через единый API вы можете передать позиции чека, выбрать ставки НДС, оформить возвратный чек 54‑ФЗ и автоматизировать сверку чеков.

Если вы ищете «54‑ФЗ API платежи» с готовыми сценариями под интернет‑магазин, подписки, сервисы и донаты — вы на нужной странице.

Table of contents

• Что такое фискализация по 54‑ФЗ и как это работает
• Реквизиты чека: состав и обязательные поля
• Позиции и ставки НДС: как передать через API
• Сценарии чеков и признаки расчёта
• Возвратный чек по 54‑ФЗ: полные и частичные возвраты
• Отправка электронных чеков клиенту: email и SMS
• Интеграция с ККТ: облачная касса или своя
• Сверка чеков, статусы и отчётность
• Тестирование и запуск в прод
• Безопасность, тарификация и поддержка
• Чек‑лист интеграции и частые ошибки
• Итоги и следующий шаг

Что такое фискализация по 54‑ФЗ и как это работает

54‑ФЗ обязывает бизнес применять ККТ (онлайн‑кассы) и пробивать фискальные чеки при расчётах с физлицами. В онлайне процесс выглядит так:

1. Клиент оплачивает заказ удобным способом (карта, СБП и т. д.) — см. Методы оплаты.
2. Платёж подтверждён — наш сервис формирует фискальный документ (ФД) на основе переданных вами данных чека.
3. Чек уходит в ККТ (облачную или вашу) → ОФД → ФНС, а клиент получает электронный чек на email/SMS.

Фискализация чек API у нас строится вокруг безопасного обмена с ККТ и ОФД. Вы передаёте нам реквизиты, позиции и ставки НДС — мы обеспечиваем пробитие, хранение и доставку.

Полезно: если вы только начинаете приём оплат — начните с раздела Приём платежей API и Быстрый старт интеграции.

Реквизиты чека: состав и обязательные поля

Корректные «касса чек реквизиты» — основа легитимного документа. Ниже — ключевые поля, которые чаще всего требуются онлайн‑кассами по 54‑ФЗ.

Реквизит	Что это	Пример/источник	Обязательность
company.vatin (ИНН)	ИНН продавца	7701234567	Да
company.payment_address	Адрес расчётов/сайт	myshop.ru	Да
company.tax_system_code (СНО)	ОСН/УСН/ЕНВД/Патент и т. п.	1 (ОСН), 2 (УСН)	Да
customer.email / phone	Контакты покупателя для чека	user@site.ru / +7999…	Да (один из)
items[].name	Наименование позиции	Подписка PRO	Да
items[].quantity	Количество	1	Да
items[].price	Цена за единицу	990.00	Да
items[].amount	Сумма позиции	990.00	Да
items[].payment_subject	Предмет расчёта	товар/услуга/подписка	Часто да
items[].payment_method	Способ расчёта	предоплата/полный расчёт	Часто да
items[].vat_code	Ставка НДС	vat20/vat10/vat0/none	Если применимо
payments[].type/amount	Вид и сумма оплаты	card 990.00	Да
total	Итог по чеку	990.00	Да

Примечания:

• Некоторые поля (например, ФПД, номер ФД, ФН) формируются кассой автоматически.
• Состав обязательных полей зависит от модели ККТ и обновлений ФНС; сверяйтесь с Документацией API.

Позиции и ставки НДС: как передать через API

Для прозрачной отчётности важно корректно передать позиции чека и ставки НДС API. В одной продаже могут встречаться разные ставки по разным линиям. Мы поддерживаем смешанные чеки и автоматически проверяем арифметику.

Частые ставки НДС и их коды:

Код НДС в API	Ставка	Когда применять
vat20	20%	Большинство облагаемых операций
vat10	10%	Социально значимые товары (при наличии основания)
vat0	0%	Экспорт, особые режимы
none	Без НДС	УСН/патент и т. п. при отсутствии обязанности начислять НДС
vat120	20/120	Расчётная ставка в составе цены (tax included)
vat110	10/110	Расчётная ставка в составе цены

Советы:

• Если вы на УСН и «без НДС» — используйте none для всех позиций.
• При составной корзине с разными ставками передавайте корректные vat_code на уровне каждой позиции.

Пример структуры данных для чека

Ниже — типичный JSON‑объект (поля могут отличаться в зависимости от вашей схемы и настроек ККТ):

{
  "customer": {"email": "user@site.ru", "phone": "+79990000000"},
  "company": {"vatin": "7701234567", "payment_address": "myshop.ru", "tax_system_code": 2},
  "items": [
    {"name": "Подписка PRO", "quantity": 1, "price": 990.00, "amount": 990.00, "vat_code": "none", "payment_subject": "service", "payment_method": "full_payment"},
    {"name": "Сувенир", "quantity": 2, "price": 100.00, "amount": 200.00, "vat_code": "vat20", "payment_subject": "commodity", "payment_method": "full_payment"}
  ],
  "payments": [{"type": "card", "amount": 1190.00}],
  "total": 1190.00
}

Если у вас есть аванс/частичная оплата — добавьте соответствующий payment_method на уровне позиции.

Сценарии чеков и признаки расчёта

54‑ФЗ различает сценарии в зависимости от факта отгрузки и оплаты. Основные признаки расчёта:

• Полный расчёт (full_payment) — деньги и отгрузка одновременно.
• Предоплата 100% (prepayment) — оплата до отгрузки, затем чек «расход» при закрытии.
• Частичный расчёт/кредит (partial_payment/credit) — оплата частями.
• Аванс (advance) — отдельный чек на аванс, затем закрывающий.

Рекомендации:

• Для подписок используйте «услуга» как payment_subject и корректный признак способа расчёта согласно вашему бизнес‑процессу.
• Для маркетплейсов и сложных схем уточняйте требования в вашей ККТ и в Документации API.

Возвратный чек по 54‑ФЗ: полные и частичные возвраты

Возвратный чек 54‑ФЗ оформляется при отмене операции или частичном возврате. В API это отдельное действие с признаком «возврат прихода» и ссылкой на исходный чек.

Как оформить возврат:

1. Инициируйте возврат платежа — см. раздел Возвраты и отмены.
2. Передайте реквизиты возвратного чека: позиции (в полном или сокращённом составе), суммы, ставку НДС и идентификатор исходного чека/ФД.
3. Получите статусы пробития и доставку чека покупателю (email/SMS).

Важно:

• Частичный возврат — передавайте только возвращаемые позиции или дробные количества.
• Сумма возврата в чеке должна совпадать с фактически возвращённой суммой по платёжной операции.

Отправка электронных чеков клиенту: email и SMS

Сервис позволяет автоматически отправить email чек клиенту или SMS сразу после фискализации. Вы можете передавать оба контакта; мы используем приоритетный канал и логируем факт доставки.

• Email: рекомендуется всегда передавать, чтобы уменьшить число запросов в поддержку.
• SMS: удобно, когда email неизвестен, но есть номер телефона.
• Согласие на коммуникации: соблюдайте требования закона о персональных данных.

Для статусов доставки и переотправки используйте Вебхуки и события.

Интеграция с ККТ: облачная касса или своя

У нас доступны два подхода «интеграция с ККТ»:

• Облачная ККТ: самая быстрая фискализация чек API — мы берём на себя инфраструктуру касс, ФН и связь с ОФД. Масштабируемость, очереди и мониторинг включены.
• Подключение своей ККТ: если у вас уже есть касса, мы интегрируемся по согласованному протоколу. Подходит для сложных схем учёта.

Технические моменты:

• Синхронная/асинхронная фискализация в зависимости от метода оплаты и SLA по UX.
• Очередь и ретраи при сетевых сбоях, устойчивость к «провалам» ОФД.
• Гарантированная доставляемость статусов через Вебхуки и события.

Сверка чеков, статусы и отчётность

Сверка чеков помогает убедиться, что на каждый успешный платёж пробит чек с корректными суммами и ставками НДС. Мы сохраняем историю статусов и предоставляем выгрузки.

Типичные статусы:

• created — чек сформирован;
• sent_to_kkt — отправлен на кассу;
• fiscalized — пробит (получен ФД/ФПД);
• sent_to_ofd — доставлен в ОФД;
• delivered_to_customer — отправлен email/SMS.

Для оперативного контроля подключите вебхуки и экспорт в разделе Отчёты и выгрузки. При расхождениях мы предложим инструменты «сверка чеков» и перегенерации.

Тестирование и запуск в прод

Перед стартом пройдите «боевую готовность» в тестовой среде:

• Песочница: используйте Песочница и тестирование для эмуляции платежей и чеков.
• Гайды: начните с Быстрый старт интеграции, затем углубляйтесь в Документация API.
• Готовые модули: посмотрите CMS‑плагины и Mobile SDK, если не хотите писать интеграцию с нуля.

Безопасность, тарификация и поддержка

Фискальные данные — чувствительная часть бизнес‑процессов. Мы уделяем особое внимание защите и SLA.

• Безопасность: соответствие PCI DSS и best‑practice — раздел Безопасность и PCI DSS.
• Антифрод: фильтры и скоринг, чтобы не фискализировать мошеннические операции — Антифрод и риск.
• Тарифы: прозрачные условия — Тарифы и комиссии.
• Поддержка и SLA: ускоренные каналы связи по инцидентам — SLA и поддержка.

Чек‑лист интеграции и частые ошибки

Перед релизом проверьте ключевые пункты, чтобы «54‑ФЗ API платежи» работали без сбоев:

• Передать позиции чека по всем товарам/услугам, а не только итоги.
• Указать корректную СНО (tax_system_code) для вашей организации.
• Проставить ставки НДС API на уровне каждой позиции; не смешивать «none» с vat20 для одной и той же позиции.
• Для предоплаты/аванса — верные payment_method и сценарии закрытия.
• Убедиться, что суммы по позициям и total сходятся с платёжной транзакцией.
• Передавать email чек клиенту или телефон; проверить доставку в песочнице.
• Настроить вебхуки и логи для «сверка чеков» и оперативной диагностики.
• Для возвратов — формировать возвратный чек 54‑ФЗ с ссылкой на исходный чек; суммы должны совпадать с рефандом.

Частые ошибки:

• Неверный ИНН/адрес расчётов → чек отклоняется кассой.
• Расхождение арифметики (округления) → касса не принимает сумму.
• Отсутствуют признаки расчёта для предоплаты → нарушение сценария 54‑ФЗ.

Итоги и следующий шаг

Фискализация по 54‑ФЗ через api‑platezhi.ru — это единый поток: платёж → чек → ОФД/ФНС → клиент. Вы передаёте реквизиты, позиции и ставки — мы обеспечиваем пробитие, доставку и «сверку чеков». Готовы подключиться? Начните с Быстрый старт интеграции и Документация API, протестируйте в Песочница и тестирование и выйдите в прод с поддержкой SLA и поддержка.

Материал носит информационный характер и не является юридической консультацией. За уточнениями по применению 54‑ФЗ в вашей отрасли обратитесь к бухгалтеру/консультанту.