Catcode PRRO Connector — фискализация чеков (Вчасно.Каса, Checkbox) для WooCommerce

Catcode PRRO Connector — плагин фискализации для WooCommerce, который связывает магазин с украинскими программными РРО и пробивает фискальный чек автоматически, как только заказ переходит в заданный статус (например, «processing» после оплаты LiqPay или Monobank). Один плагин покрывает несколько ПРРО-сервисов с fallback между ними, управляет сменой кассы и сам отправляет чек покупателю на email и SMS.

Поддерживаемые ПРРО

• Вчасно.Каса — полная поддержка: чеки продажи, управление сменой, проверка связи.
• Checkbox — адаптер по публичной документации API.

Можно назначить основной сервис и резервный (fallback): если основной не отвечает, чек автоматически идёт через запасной.

Как это работает — шаг за шагом

1. Покупатель оплачивает заказ через любой платёжный сервис — LiqPay, Monobank, WayForPay и так далее.
2. Платёжка переводит заказ в статус «processing» своим callback-ом.
3. Плагин ловит смену статуса (woocommerce_order_status_changed) и отправляет данные чека в ПРРО; если смена кассы закрыта — сначала открывает её и повторяет чек.
4. ПРРО возвращает фискальный номер — он пишется в заметку заказа и в журнал чеков.
5. Покупатель получает чек: email со ссылкой на PDF и, при желании, SMS через TurboSMS.
6. Бухгалтерия забирает журнал чеков с PDF/HTML-ссылками через CSV-экспорт.

Отдельно: кнопка «Пробить чек» на странице заказа, список методов оплаты, которые фискализируются как наличные (наложенные платежи Новой Почты, Укрпочты), доставка в чеке, пропуск нулевых позиций, УКТЗЕД-код на каждый товар + дефолтный код.

Источник KeyCRM

С версии 0.5.0 плагин фискализирует не только заказы WooCommerce: он тянет оплаченные заказы из KeyCRM (агрегатор Rozetka, Prom, Instagram и собственных сайтов) и пробивает для них чеки через те же ПРРО-сервисы. Меню «Касса → Заказы KeyCRM»: API-ключ, интервал опроса, триггер, журнал запусков, опциональная запись ссылки на чек обратно в заказ KeyCRM. Каждый заказ фискализируется ровно один раз.

Офлайн-продажи с кассы Checkbox → остатки на сайте (Pro)

Магазин с точкой продаж и сайтом продаёт одну полку дважды. Куртку пробили на кассе час назад, а сайт всё ещё показывает её в наличии — владелец узнаёт об этом, когда онлайн-покупатель уже заплатил. С версии 1.2.0 Pro закрывает эту дыру: каждый фискализированный чек на кассе Checkbox в магазине списывает тот же товар с остатка WooCommerce, а чек возврата возвращает его обратно.

1. В Checkbox код товара равен артикулу (SKU) товара или вариации на сайте. Если код другой — плагин ищет по штрихкоду: как артикул и как GTIN/EAN.
2. На экране «Касса → Офлайн-продажи» укажите логин и пароль кассира и ключ лицензии кассы магазина (или оставьте поля пустыми, если это та же касса, что на вкладке Checkbox) и нажмите «Подключить вебхук». Адрес сайта в Checkbox плагин регистрирует сам.
3. Дальше Checkbox после каждого чека отправляет его на сайт. Плагин проверяет подпись ключом, который выдал Checkbox, берёт только фискализированные продажи и возвраты и меняет остаток.

Чеки, которые сайт сам пробил для онлайн-заказов, пропускаются — WooCommerce уже списал для них остаток. Checkbox повторяет доставку несколько часов, но тот же чек повторно ничего не меняет, даже если копии пришли одновременно. Товар, который не найден, или товар без учёта остатка виден в журнале отдельной строкой — сразу понятно, какой код в кассе исправить.

Что под капотом

• API-ключи и пароли шифруются в БД — sodium_crypto_secretbox, с фолбеком на HMAC-потоковый шифр, когда расширение libsodium недоступно. Секреты не выводятся обратно в HTML форм.
• Архитектура адаптеров: общий интерфейс провайдера + отдельный адаптер на каждый ПРРО-сервис, цепочка основной → fallback.
• Защита от дублей — фискальный номер сверяется через БД, повтор зафейленных чеков не создаёт второй чек; купоны учтены так, чтобы sum(позиций) совпадала с total.
• Телефон покупателя нормализуется до E.164 (+380…) перед отправкой в ПРРО.
• Хук catcodeprro_after_fiscalize — для собственных интеграций после успешного чека.

Как установить

1. Скачайте плагин из каталога WordPress.org, установите через «Плагины → Добавить новый → Загрузить плагин» и активируйте.
2. Меню «Касса → Настройки» → вкладка Вчасно.Каса: введите API-ключ и фискальный номер ПРРО из кабинета Вчасно.
3. Нажмите «Сохранить и проверить связь» — появится сообщение, что соединение с Вчасно.Каса работает.
4. На вкладке сервиса выберите роль «Основная касса», а на вкладке «Чеки» включите «Автоматическое пробивание».
5. Проверьте на копеечном заказе через «Касса → Тест» → «Пробить чек».
6. В «Касса → Чеки» появится строка «успешно» с реальным фискальным номером — готово.