Fiskalizacija HR для WooCommerce — фискализация чеков в CIS Porezne uprave (ZKI, JIR, QR)

Fiskalizacija HR для WooCommerce — плагин для интернет-магазинов в Хорватии, которые продают на WooCommerce. В Хорватии каждый чек конечному покупателю должен быть фискализирован, как бы он ни платил: с 1 января 2026 года это касается и оплаты на счёт. Магазин считает защитный код ZKI, отправляет подписанный чек в сервис фискализации CIS налоговой (Porezna uprava) и печатает на чеке идентификатор JIR и QR-код. Плагин делает это для заказов WooCommerce напрямую в CIS вашим прикладным сертификатом, без стороннего сервиса счетов посередине и без ежемесячной подписки.

Магазин на OpenCart? Для него есть отдельная версия — Fiskalizacija HR для OpenCart (4.x, 3.x и 2.3), с той же подписью, ZKI и форматом запроса; лицензия для OpenCart — одна оплата, навсегда.

Что нужно от вас. OIB фирмы или обрта; интернет-магазин, зарегистрированный как пословни простор в ePorezna (плагин этого не делает — нужна лишь отметка простора, например WEB1); прикладной сертификат для фискализации, выданный на ваш OIB доверенным поставщиком, например FINA. Тестовая среда CIS принимает только DEMO-сертификаты, рабочая — только рабочие. Валюта магазина — EUR.

Честно о проверке. Плагин проверен по официальной технической спецификации CIS «Tehnička specifikacija za korisnike» v2.7 и схеме FiskalizacijaSchema / WSDL 1.10: каждый сгенерированный запрос — обычные чеки, поздняя доставка, storno с минусами, чеки с OIB покупателя — прошёл официальную XSD и независимую проверку подписи, каждый ZKI пересчитан отдельно. Полный прогон шёл на локальном магазине WooCommerce (PHP 7.4 и 8.3, HPOS включён и выключен, классический и блочный чекаут) с моделью ответов CIS: успех, отказы s001–s006 и s013, недоступность, сломанные ответы. Настоящий тестовый сервер CIS отвечал нам только без DEMO-сертификата: чтобы его получить, нужен хорватский OIB, которого у CatCode нет. Поэтому живой JIR вы получите в своём 7-дневном триале Pro с DEMO-сертификатом FINA — налоговая и так советует минимум два дня стабильной работы в тестовой среде перед переходом на рабочую. Если CIS ответит не так, как описано в спецификации, исправим оперативно.

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

Как это выглядит для покупателя

После оплаты на странице благодарности появляется блок «Fiskalizirani račun»: номер чека в формате broj/prostor/uređaj, дата и время, способ оплаты, оператор, ZKI, JIR и QR-код со ссылкой на проверку чека на porezna.gov.hr. Тот же блок есть в «Мой аккаунт» в заказе клиента.

Фискальные данные и QR-код идут и в письма WooCommerce клиенту — «В обработке», «Выполнен», счёт, возврат. QR-код в письме — картинка PNG. Блок на странице и в письмах можно отключить отдельно.

Pro. На классическом и блочном чекауте появляется поле «OIB tvrtke (za B2B račun)» — для фирм, которые платят картой или наличными и хотят свой OIB на чеке. Плагин проверяет контрольную цифру OIB: неверный номер не даст оформить заказ, с пояснением на хорватском. Поле можно скрыть, сделать необязательным или обязательным для B2B-магазина.

Что получает админ

• WooCommerce → Fiskalizacija с вкладками «Receipts», «Settings» и «Licence» (в хорватской админке — Računi, Postavke, Licenca).
• Реестр чеков: номер и дата, заказ, сумма, способ оплаты, статус («Fiskaliziran (JIR)», в очереди, отклонён), ZKI и JIR, текст ошибки CIS; фильтр по статусу и поиск по номеру или заказу.
• «Deliver waiting receipts now» отправляет очередь сразу, не дожидаясь крона, а «Send all refused receipts again» и «Send again» на отдельном чеке — отклонённые чеки после исправления настроек.
• Вверху страницы видна среда (TEST или PRODUCTION) и сообщение, если CIS отклонил чеки.

Страница чека показывает всё, что ушло в CIS и вернулось: среда, статус, ZKI, JIR, проверена ли подпись ответа, количество попыток, идентификатор последнего сообщения, а ниже — последний запрос и последний ответ XML. В тестовой среде есть кнопка «Check at CIS test» — метод provjera, которым CIS сверяет чек без фискализации.

В каждом заказе — блок «Fiskalizacija» с номером, суммой, статусом, ZKI, JIR и QR-кодом, а заметки заказа фиксируют каждый шаг: выдан чек, фискализирован, в очереди, отклонён.

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

1. Пословни простор. Вы регистрируете интернет-магазин в ePorezna и записываете его отметку (например, WEB1) — в плагине она должна быть точно такой же.
2. Настройки. OIB обвезника, в системе ли вы НДС, отметка простора, номер устройства, последовательность нумерации (по простору или устройству), рестарт 1 января, оператор, статус заказа, на котором выдаётся чек, и последний использованный номер, если продолжаете серию из другой программы.
3. Сертификат. Загрузите .p12 с паролем — для теста DEMO, для рабочей среды рабочий. Плагин показывает владельца и срок действия сертификата, предупреждает, если OIB в нём не совпадает с OIB обвезника (CIS отклонил бы такие чеки с s005), и хранит приватный ключ зашифрованным. «Check connection to CIS» проверяет связь методом echo.
4. Заказ. Когда заказ становится «В обработке» или «Выполнен» (как выберете), плагин проверяет суммы и ставки локально, только тогда берёт следующий номер, считает ZKI, строит и подписывает RacunZahtjev и отправляет его в CIS.
5. Ответ. CIS возвращает JIR — плагин проверяет подпись ответа, сохраняет JIR в заказе и показывает чек клиенту. Ошибка s001–s005 или s013 — чек «отклонён», причина видна в реестре, «Send again» после исправления.
6. Сбой связи. CIS не ответил за несколько секунд (по умолчанию 8) — чек уже действителен с ZKI, клиент его видит, а плагин доставляет его позже с отметкой NakDost и новым идентификатором сообщения, с нарастающей паузой между попытками.

НДС берётся из налоговых строк каждого заказа и группируется по ставке — 25 %, 13 %, 5 % или 0 %. Ставку, которую CIS не принимает (например, 19 %), плагин останавливает ещё до отправки, номер не тратится. Строки без налога идут как освобождение от НДС, «не облагается» или 0 % — как выберете; сборы с названием вроде «povratna naknada» — как Naknade. Копейки округления между строками и итогом заказа плагин сводит так, чтобы сумма чека совпадала до цента. Способ оплаты задаётся для каждого шлюза: G наличные, K карта, T счёт, O другое.

Pro. Возврат WooCommerce — полный, частичный по позициям или только суммой — даёт storno-чек с минусовыми суммами по тем же ставкам НДС; каждый следующий возврат «только суммой» считается от остатка после предыдущих storno. Фискальные данные и QR-код (25×25 мм) добавляются в счета плагина PDF Invoices & Packing Slips. Реестр выгружается в CSV (UTF-8 с BOM, разделитель «;», десятичная запятая), а на указанный адрес приходят письма, когда CIS отклонил чек или недоступен.

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

• CIS: RacunZahtjev (фискализация), ProvjeraZahtjev (проверка, только тест), echo (связь); адреса cistest.apis-it.hr:8449 и cis.porezna-uprava.hr:8449.
• ZKI — MD5 от подписи RSA-SHA256 строки OIB + дата и время + номер + простор + устройство + сумма, как в разделе 12 спецификации v2.7.
• Подпись запроса — enveloped XMLDSig: Exclusive C14N, RSA-SHA256, дайджест SHA-256. RSA-SHA1 не используется: тестовый CIS отклоняет его с 1 июля 2026, рабочий — с 1 января 2027.
• TLS и ответ: соединение проверяется по вложенным сертификатам FINA (Fina RDC 2020, Fina Demo CA 2020), подпись ответа — по сертификату fiskalcis. После замены CA сертификаты обновляются с новой версией или фильтром ccfh_ca_file.
• Нумерация с блокировкой: параллельные заказы не получают одинаковый номер и не оставляют дыр; отдельные счётчики для теста и продакшна.
• Очередь — Action Scheduler WooCommerce (или WP-Cron) с нарастающей паузой; чеки старше 30 дней не отправляются (CIS их отклоняет).
• Сертификат: приватный ключ хранится в базе зашифрованным AES-256 ключом, производным от солей сайта, или как файл вне веб-корня через CCFH_CERT_FILE и CCFH_CERT_PASSWORD в wp-config.php.
• Модель CIS: константа CCFH_CIS_MOCK (ok, down, s002, s004, s006, s013) моделирует ответы только в тестовой среде — чтобы проверить магазин до получения сертификата.
• Удаление плагина убирает сертификаты и задания крона; реестр, счётчики и настройки остаются как налоговые записи. Константа CCFH_DELETE_DATA убирает и их.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите catcode-fiskalizacija-hr-for-woocommerce-1.0.0.zip и активируйте (WooCommerce должен быть активен).
2. Зарегистрируйте интернет-магазин как пословни простор в ePorezna и запишите его отметку.
3. WooCommerce → Fiskalizacija → Settings: OIB обвезника, система НДС, отметка простора, номер устройства, оператор, способы оплаты.
4. Загрузите DEMO-сертификат .p12 с паролем и нажмите «Check connection to CIS».
5. Оформите тестовые заказы, проверьте чеки в реестре и кнопкой «Check at CIS test».
6. Покажите настройки бухгалтеру, переключите среду на Production и загрузите рабочий сертификат.
7. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал во вкладке «Licence».