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».