Интеграции ККТ: 1С, CRM, интернет‑магазин и API под 54‑ФЗ

Получить CloudPayments бесплатно

Интеграции ККТ: 1С, CRM, интернет‑магазин и API под 54‑ФЗ

Схема интеграции ККТ с 1С, CRM и интернет‑магазином

Зачем бизнесу интеграции ККТ под 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. Нужна помощь с архитектурой и внедрением? Оставьте заявку — мы подберём решение под ваши сценарии и интегрируем за короткие сроки.

Получить CloudPayments бесплатно