МодульКасса 54-ФЗ

Описание плагина МодульКасса 54-ФЗ

Плагин предназначен для интеграции вашего интернет-магазина с торговыми точками сервиса "МодульКасса" и в соответствии с "54-ФЗ О применении контрольно-кассовой техники при осуществлении наличных денежных расчетов и(или) расчетов с использованием электронных средств платежа". Для каждого способа оплаты у вас есть возможность включить и настроить интеграцию с сервисом, причем каждый способ оплаты имеет настройки независимые от других способов оплат.

Если вы используете Shop-Script версии 7.1 и выше, то у вас появляется возможность за каждым курьером закрепить его МодульКассу. И тогда в зависимости от настройки "Вывод чека" чек может быть отправлен на ту или иную кассу. Чеки, отправляемые на курьерские кассы, всегда печатаются на ленте.
Если выбрано "На эту кассу без вывода на ленту" или "Только вручную на эту кассу без вывода на ленту", то для данного способа оплаты все чеки будут регистрироваться на кассу указанную в настройках данного типа оплаты без печати на ленте.
Если выбрано "На эту кассу c выводом на ленту" или "Только вручную на эту кассу с выводом на ленту", то для данного способа оплаты все чеки будут регистрироваться на кассу указанную в настройках данного типа оплаты с печатью на ленте.
Если выбрано "если в заказе указан курьер, то на его кассу, иначе на эту кассу без вывода на ленту", то если в заказе указан курьер и для него есть активные настройки в плагине, то чек будет отправлен на печать на его кассу, иначе чек будет регистрироваться на кассу указанную в настройках данного типа оплаты без печати на ленте.
Если выбрано "если в заказе указан курьер, то на его кассу, иначе на эту кассу с выводом на ленту", то если в заказе указан курьер и для него есть активные настройки в плагине, то чек будет отправлен на печать на его кассу, иначе чек будет регистрироваться на кассу указанную в настройках данного типа оплаты с печатью на ленте.
Реализована отправка "отложенных чеков", которые "прилетают" на кассу, а кассир/курьер в нужное время распечатывает их из интерфейса приложения "МодульКасса". API отложенных чеков сейчас имеет ряд недоработок, поэтому данный функционал предоставляется "как есть".
Для работы плагина ваша МодульКасса должна обслуживаться по тарифу "Стандартный" или "Расширенный" и на точке продажи необходимо включить галочку "использовать для документов интернет-магазина".

РЕГИСТРАЦИЯ ЧЕКОВ
Внимание! При переходе заказа в статус "Оплачено" (вручную или автоматически), если по заказу нет ни одного успешно зарегистрированного чека, то производится регистрация чека продажи на всю сумму заказа.Кроме этого вы можете вручную оформить любой доступный тип чека и убрать позиции, которые не должны попасть в чек.

НАСТРОЙКА CRON
Внимание! Для успешного получения информации по всем запросам/чекам, необходимо настроить вызов задания в планировщике (CRON), взяв информацию со страницы настроек плагина.

ПРАВА ДОСТУПА

Для каждого сотрудника или группы сотрудников вы можете настроить права доступа к настройкам плагина, к ручной регистрации чеков (кроме случая перевода заказа в статус "Оплачено") и к отчетам плагина.

ОТЧЕТЫ

В отчетах доступны все чеки, которые были зарегистрированы через плагин в МодульКассе, которые вы можете отфильтровать по необходимым параметрам.

Аналогично можно посмотреть все запросы к сервису МодульКассе с полученными ответами, чтобы разобрать причину той или иной ошибки при работе с сервисом. Для просмотра детального отчета о запросе и ответе на него, нужно кликнуть по иконке "блокнот" в строке запроса.

В разделе "Проблемные запросы" вы увидите запросы по заказам, в которых нет ни одного зарегистрированного чека, но есть незавершенные или завершенные с ошибкой запросы. Наличие проблемных запросов можно заметить по красному лейблу с цифрой у закладки МодульКасса.

УВЕДОМЛЕНИЯ
Вы можете настроить уведомления, чтобы получать/отправлять сообщения об ошибках в работе с сервисом МодульКасса, а также ссылки на электронные чеки:
- для ошибок используйте событие "Ошибка в МодульКассе" и в нужном месте код {$e = $action_data.error|@print_r}

- для отправки чека используйте событие "Зарегистрирован чек в МодульКассе". Если вы неплохо разбираетесь в программировании, то можете посмотреть весь список параметров поступаемых в уведомления добавив код {$e = $action_data.info|@print_r} в текст сообщения уведомления.
Для всех остальных пользователей я перечислю список кодов с переменными, которые могут быть наиболее восстребованными:
- ссылка на QR-код для считывания приложением на мобильном устройстве
{$action_data.info.json_answer.fiscalInfo.qr} - URL-запрос в формате ФНС, можно использовать для некоторых ОФД для получения ссылки на чек (см.ниже)
Ссылка на чек - пример ссылки для Платформа ОФД и Контур ОФД
Ссылка на чек - пример ссылки для Первого ОФД

{$action_data.info.date} - время регистрации чека
{$action_data.info.sum} - сумма чека
{$action_data.info.fnNumber} - номер фискального накопителя
{$action_data.info.fnDocNumber} - номер фискального документа
{$action_data.info.fnDocMark} - фискальный признак документа