Интеграции ККТ: 1С, CRM, интернет‑магазин и API под 54‑ФЗ
Table of contents
- Зачем бизнесу интеграции ККТ под 54‑ФЗ
- Варианты и архитектуры: 1С, CRM, сайт, курьеры
- Интеграция ККТ с 1С: устойчивые сценарии
- Печать чеков из CRM и ERP
- Интернет‑магазин: чек из сайта, ФФД и оплата
- Курьер и мобильный чек в выездной торговле
- Маркировка: ФФД 1.2 и передача КМ
- API кассы 54‑ФЗ и webhooks чеков ОФД
- Данные чека и соответствие ФФД
- Возвраты, коррекции и офлайн‑режим
- Оборудование, ФН, ОФД и налоговые режимы
- Чек‑лист внедрения интеграции
- Итоги и следующий шаг
Зачем бизнесу интеграции ККТ под 54‑ФЗ
Интеграция кассовой техники с учётными системами и сайтами помогает автоматически формировать фискальные документы и соблюдать требования Текста закона 54‑ФЗ. Правильный обмен данными уменьшает ошибки, ускоряет чек‑аут и снижает риск штрафов за нарушения, связанных с незарегистрированными продажами или неверными реквизитами чека.
Ключевые задачи, которые закрывает интеграция:
- автоматическое формирование чека при оплате в 1С/CRM/на сайте;
- корректная передача тегов ФФД, способа и предмета расчёта;
- отправка электронных чеков клиенту, печать на ККТ или мобильном принтере;
- контроль статуса фискализации через ОФД и уведомления в систему;
- поддержка маркировки, возвратов и частичных оплат;
- единая отчётность и сверка по всем каналам продаж.
Подробнее об обязательных компонентах — онлайн‑касса, оператор ФД (ОФД) и фискальный накопитель.
Варианты и архитектуры: 1С, CRM, сайт, курьеры
Ниже — распространённые схемы, когда нужна интеграция ККТ с 1С, CRM, интернет‑магазином или мобильными приложениями.
| Сценарий |
Как работает |
Плюсы |
| Интеграция ККТ 1С |
Обмен через драйвер/коннектор ККТ или HTTP API кассы |
Надёжность, учёт остатков и номенклатуры в 1С |
| Печать чеков из CRM |
Триггеры по статусам сделки, вызов кассового API |
Единая точка для менеджеров и колл‑центра |
| Интернет‑магазин чек |
Сервер сайта вызывает API кассы при оплате |
Автоматическая фискализация онлайн‑платежей |
| Курьер и мобильный чек |
Приложение курьера печатает/отправляет чек на выезде |
Оперативные наличные/безнал на месте, QR‑чек |
Для e‑commerce отдельный раздел — интернет‑торговля: обязанности и нюансы.
Интеграция ККТ с 1С: устойчивые сценарии
Фраза «интеграция ккт 1с» традиционно означает, что чек формируется прямо из документов продажи (Реализация, ПКО, Заказ клиента) и фискализируется на подключённой кассе. Возможные подходы:
- Драйверная интеграция: ККТ подключена к рабочему месту (USB/LAN), 1С обращается к драйверу. Минимальная задержка, но зависимость от рабочего места и сети.
- Облачная/HTTP: 1С отправляет запрос на API кассы 54‑ФЗ, касса (или кассовый сервис) формирует чек и отправляет его в ОФД. Идеально для распределённых команд, касс в ЦОД или cерверной печати.
Практические советы:
- Синхронизируйте номенклатуру и ставки НДС между 1С и кассой, иначе теги ФФД могут не сойтись.
- Храните «идемпотентный ключ» операции (например, номер документа 1С): повторные попытки не создадут дублей.
- Отслеживайте статусы ОФД и показывайте их пользователю 1С (успех, повторная отправка, ошибка).
Печать чеков из CRM и ERP
«Печать чеков из CRM» — это когда сделка или счёт в CRM автоматически порождают чек (продажа/аванс/частичная оплата). Типовые триггеры:
- изменение этапа сделки (оплачено);
- поступление оплаты по эквайрингу;
- закрытие заказа с частичным постоплатным балансом.
Реализация:
- CRM вызывает API кассы: создать чек продажи/аванса/предоплаты;
- получает статус, ссылку на электронный чек для отправки клиенту;
- при смене статуса от ОФД формируется уведомление — «webhooks чеков офд» для актуализации в карточке сделки.
Точки контроля:
- корректная привязка «способа расчёта» и «предмета расчёта» по ФФД;
- учёт возвратов и чеков коррекции;
- канал доставки чека (email/SMS/мессенджер) и хранение ссылок.
Интернет‑магазин: чек из сайта, ФФД и оплата
Для e‑commerce «интернет магазин чек» — это автоматическая фискализация при онлайн‑оплате на сайте, в приложении или через платёжный агрегатор. Ключевые кейсы:
- Оплата картой/СБП: после успешного платёжного события сайт вызывает API кассы 54‑ФЗ для формирования чека. Для предоплаты/частичной оплаты формируется соответствующий признак расчёта.
- Наложенный платёж/самовывоз: чек пробивается при получении денег, часто — на точке или у курьера.
ФФД и чек из сайта (часто в запросах пишут «ffд и чек из сайта»):
- корректно указывайте «признак способа расчёта» (предоплата, полный расчёт, кредит и т. п.);
- для доставки выделяйте отдельную позицию, если она оплачивается отдельно;
- отправляйте e‑чек клиенту и обеспечьте доступ к ссылке на чек.
Учтите требования для онлайн‑продаж в разделе интернет‑торговля и зафиксируйте состав обязательных полей — см. реквизиты чека.
Курьер и мобильный чек в выездной торговле
«Курьер и мобильный чек» — это офлайн‑сценарии с переносной ККТ или приложением, печатающим чек на месте. Опции:
- mPOS/смартфон + мобильная ККТ или принтер;
- безбумажный e‑чек с QR‑кодомотображением на экране;
- приём наличных/карты, СБП.
Важные моменты:
- синхронизация остатков и скидок с центральной системой;
- устойчивый офлайн‑режим с последующей отправкой в ОФД;
- быстрый возврат при частичном отказе.
Подробности — в материале про выездную торговлю и курьеров.
Маркировка: ФФД 1.2 и передача КМ
Если вы продаёте товары, подлежащие обязательной маркировке (Честный ЗНАК), интеграция должна поддерживать ФФД 1.2 и передачу кода маркировки (КМ). Это и есть «интеграция маркировки» в кассовый процесс:
- сканирование и проверка КМ на этапе комплектации/продажи;
- корректное заполнение тегов ФФД (тип товара, способ расчёта, количество);
- обработка возвратов маркированных товаров с передачей статуса.
Смотрите базу по теме — маркировка и 54‑ФЗ и ближайшие изменения 2024–2025.
API кассы 54‑ФЗ и webhooks чеков ОФД
«API кассы 54 фз» — это программный интерфейс, позволяющий системам 1С/CRM/сайту создавать, подписывать и отправлять чеки, а также получать статусы. Базовые возможности:
- операции: продажа, возврат, предоплата/аванс, закрытие кредита;
- отчётность: открытие/закрытие смены, отчёты о состоянии ККТ;
- управление номенклатурой и налогами (опционально);
- доставка электронных чеков клиенту (email/SMS/ссылка).
Типовые эндпоинты в рамках интеграции:
- создание чека продажи/возврата;
- печать нефискальных документов (товарный чек, слип);
- открытие/закрытие смены;
- получение статуса чека и смены;
- список документов за период.
Webhooks чеков ОФД: кассовый сервис может уведомлять ваш сайт/CRM о смене статуса (принят ОФД/ФНС, ошибка, повтор). Это снижает поллинг, ускоряет отражение оплаты и запуск бизнес‑процессов (выдача, доставка, начисление бонусов).
Практики надёжности и безопасности:
- идемпотентность (ключ операции) для повторов без дублей;
- взаимная аутентификация: OAuth/JWT, IP‑allowlist;
- журналирование и трассировка с маскированием персональных данных;
- таймауты/ретраи и дедупликация событий webhook.
Данные чека и соответствие ФФД
Чтобы избежать ошибок и штрафов, сверьте набор данных с ФФД вашей версии и фактическими реквизитами. Критично:
- номенклатура, цена, количество, ставка НДС, признак предмета расчёта;
- способ расчёта (полный, частичный, предоплата, кредит);
- форма оплаты (наличные, электронные, встречное предоставление);
- данные покупателя для e‑чека (телефон/email);
- признаки признака агента и предметов, если выступаете как агент;
- ФФД 1.2 для маркированных товаров.
Подробный перечень — в разделе реквизиты чека. Не забудьте учесть работу ФН — см. фискальный накопитель.
Возвраты, коррекции и офлайн‑режим
Интеграция должна одинаково хорошо обрабатывать нестандартные ситуации:
- возвраты по позиции/чеку с авто‑подбором основания и признака расчёта;
- чеки коррекции (по решению ФНС/самостоятельные) с нужными основаниями;
- офлайн‑режим с буферизацией документов и контролем лимитов ФН;
- повторная отправка в ОФД при временных сбоях.
Подробно — в материале про возвраты и коррекции. О рисках несоблюдения — штрафы и ответственность.
Оборудование, ФН, ОФД и налоговые режимы
Выбор оборудования и сервисов влияет на архитектуру интеграции:
Не забудьте этапы регистрации ККТ в ФНС и плановое обслуживание/ремонт ККТ.
Чек‑лист внедрения интеграции
- Опишите процессы: когда и где формируется чек (1С, CRM, сайт, курьер).
- Утвердите версии ФФД и требования к маркировке.
- Проверьте режимы налогообложения и ставки НДС.
- Настройте API кассы 54‑ФЗ, каналы отправки e‑чеков, «webhooks чеков ОФД».
- Реализуйте идемпотентность и ретраи; настройте мониторинг.
- Покройте кейсы: частичные оплаты, предоплата/постоплата, доставка, скидки.
- Протестируйте возвраты/коррекции и офлайн‑режимы.
- Проведите пилот и обучение сотрудников; подготовьте инструкции.
- Зафиксируйте регламент смен, Z‑отчётов и разбор инцидентов.
Часто задаваемые вопросы — в разделе FAQ 54‑ФЗ и глоссарии.
Итоги и следующий шаг
Грамотная интеграция ККТ с 1С, CRM, интернет‑магазином и API под 54‑ФЗ обеспечивает корректные чеки, устойчивую работу касс, прозрачную аналитику и быстрое обслуживание клиентов. Начните с описания процессов, утвердите требования ФФД/маркировки и подключите «API кассы 54‑ФЗ» с webhooks. Нужна помощь с архитектурой и внедрением? Оставьте заявку — мы подберём решение под ваши сценарии и интегрируем за короткие сроки.