SmartBill & Oblio для OpenCart — счета-фактуры из заказов

SmartBill & Oblio Invoices для OpenCart 4.x, 3.x и 2.3 выставляет счёт-фактуру (factura) из заказа в румынском сервисе SmartBill Cloud или Oblio. Покупатель указывает на кассе CUI и номер торгового реестра, а счёт появляется в вашей серии с правильным покупателем, строками и ставками НДС.

Что видит покупатель

На кассе OpenCart покупатель видит поля «CUI» и «Reg. Com.» (модуль сам создаёт их кнопкой «Create the fields» для всех групп покупателей, необязательными). Кто указал CUI, получает счёт на компанию; кто нет — как физлицо. Румынский CUI с неправильной контрольной цифрой касса не принимает и объясняет почему.

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

Расширения → Модули → SmartBill & Oblio Invoices: вкладки «Connection», «Buyer», «Invoice», «Automation», «Pro». Для SmartBill — e-mail, токен API и CIF, для Oblio — e-mail, секрет API и CIF. «Save and check the connection» читает из аккаунта серии и ставки НДС. Ключи хранятся зашифрованными.

На странице заказа появляется панель счёта: предпросмотр строк (цены с НДС, скидка по ставке НДС, доставка как услуга), кнопка выставления, номер, сумма, состояние и PDF (SmartBill) или ссылка на документ (Oblio). В разделе «Продажи» — список счетов с фильтрами «In progress», «Stopped», «Issued», «Storno», «Cancelled». Остановленный счёт можно повторить или убрать.

Дважды счёт не выходит: после потерянного ответа модуль сначала ищет счёт в сервисе (Oblio — тот же ключ запроса, SmartBill — номер в серии), а когда уверенности нет, останавливается и показывает, что посмотреть. Строки должны совпадать с суммой заказа, иначе счёт не уходит.

В Pro счёт выставляется сам по статусам заказа, оплаченные на кассе заказы идут как оплаченные, оплата наличными или переводом фиксируется по статусу или кнопкой. Сервис отправляет счёт письмом. Сторно — кнопкой или по статусу, счёт можно аннулировать. Через Oblio счета уходят в e-Factura (SPV): выключено, только компаниям или всем.

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

1. Устанавливаете архив для своей версии OpenCart и включаете модуль.
2. На вкладке «Connection» выбираете сервис, вставляете данные из SmartBill Cloud или Oblio и нажимаете «Save and check the connection».
3. На вкладке «Buyer» создаёте поля CUI и Reg. Com. одной кнопкой.
4. На странице заказа смотрите строки и выставляете счёт.
5. В Pro счёт, оплата, письмо и сторно идут сами по статусам.

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

• SmartBill Cloud API и Oblio REST API; ключи зашифрованы.
• Цены уходят с НДС, округлённые до 2 знаков за единицу; сумму сверяет допуск 0,02.
• Поля CUI и Reg. Com. — стандартные Custom Fields OpenCart.
• Защита от дубля после потерянного ответа.
• События OpenCart без правок ядра; при удалении таблицы счетов остаются.
• Интерфейс на английском и румынском.

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

1. Расширения → Установка: загрузите архив для своей версии без переименования файла (OpenCart 4 — cc_sbob.ocmod.zip, 3.x — cc_sbob-oc3.ocmod.zip, 2.3 — cc_sbob-oc23.ocmod.zip).
2. Для 3.x и 2.3: Расширения → Модификаторы → Обновить.
3. Расширения → Модули → SmartBill & Oblio Invoices: установите и откройте.
4. Вставьте данные подключения, создайте поля покупателя и выберите серию.
5. Для Pro: вставьте ключ или запустите пробный период на вкладке «Pro».