SmartBill & Oblio для WooCommerce — рахунки-фактури із замовлень

SmartBill & Oblio Invoices for WooCommerce виставляє рахунок-фактуру (factura) із замовлення WooCommerce у румунському сервісі SmartBill Cloud або Oblio. Покупець вказує на касі назву компанії, CUI і номер торгового реєстру, а рахунок зʼявляється у вашій серії з правильним покупцем, рядками й ставками ПДВ. PDF рахунку завантажується прямо із замовлення.

Що бачить покупець

На класичній касі й у блоці Checkout покупець бачить поля «Назва компанії», «CUI» і «Номер торгового реєстру». Хто вказав CUI, отримує рахунок на компанію; хто лишив поле порожнім — як фізична особа. Для румунського CUI модуль звіряє контрольну цифру, помічає CNP, введений помилково, і просить назву компанії, якщо є CUI. Покупцю не треба нічого писати в коментарі до замовлення.

Що отримує адмін

WooCommerce → SmartBill & Oblio: вибір сервісу і дані підключення. Для SmartBill це e-mail, токен API і CIF компанії з розділу Integrari > API, для Oblio — e-mail, секрет API і CIF із Setari > Date Cont. Кнопка «Check the connection» читає з акаунта серії рахунків і ставки ПДВ, тож серію ви обираєте зі списку. Токен і секрет зберігаються зашифрованими.

У замовленні зʼявляється блок «Invoice (SmartBill / Oblio)»: кнопка «Issue the invoice», номер рахунку, стан, PDF. Рядки беруться із замовлення: товари, доставка як послуга, збори, ставка ПДВ кожного рядка, код товару (SKU), валюта замовлення. Бухарест стає «Sector N». Якщо рядки не сходяться з тим, що заплатив покупець, рахунок не йде, а блок пояснює причину. Вкладка «Invoices» показує всі рахунки з сервісом, номером, станом і сумою.

Двічі рахунок не виходить. Коли сервіс не відповідає, рахунок чекає й повторюється сам до восьми разів, з дедалі довшими паузами. Якщо відповідь сервісу загубилась, плагін спершу шукає, чи рахунок уже зроблено (Oblio — той самий ключ запиту і список рахунків, SmartBill — лічильник серії). Коли певності немає, він зупиняється і показує серію й номер, які варто глянути в сервісі, з кнопками «Link an invoice» і «It is not there, send again».

У Pro рахунок виставляється сам, коли замовлення отримує обрані статуси, а на списку замовлень є масова дія. Сервіс надсилає рахунок покупцю листом, оплачені онлайн замовлення йдуть як інкасовані (incasata, card). Повне повернення сторнує рахунок у сервісі, часткове стає рахунком із поверненими рядками з мінусом — автоматично або однією кнопкою. Рахунок можна анулювати. Для Oblio кожен новий рахунок одразу йде в e-Factura (SPV), а стан видно в замовленні. Покупець бачить посилання на рахунок у «Моєму акаунті» і в листах замовлення.

Як це працює, крок за кроком

1. Обираєте сервіс, вставляєте дані підключення з SmartBill Cloud або Oblio і натискаєте «Check the connection».
2. Обираєте серію рахунків зі списку акаунта і, за потреби, назви ставок ПДВ.
3. Покупець вказує на касі назву компанії, CUI і номер реєстру або лишає поля порожніми як фізична особа.
4. У замовленні натискаєте «Issue the invoice» — рахунок зʼявляється в сервісі, а PDF у замовленні.
5. У Pro рахунок виставляється сам за статусом, а повернення отримує сторно.

Що під капотом

• SmartBill Cloud API і Oblio REST API; секрети зашифровані.
• Кожен рядок іде як ціна без ПДВ + ставка; назва ставки 0% задається («0=SDD»), коли в акаунті їх кілька.
• Сума рядків має дорівнювати оплаті, інакше рахунок зупиняється з поясненням.
• Захист від дубля: блокування, повтори з паузами, пошук рахунку після втраченої відповіді.
• Один продаж — один рахунок поруч із нашими e-Factura ANAF for WooCommerce і Keez Invoices for WooCommerce.
• Каса: класична і блок Checkout (Additional Checkout Fields API). Сумісно з HPOS.
• Інтерфейс англійською і румунською.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте. WooCommerce має бути активним.
2. WooCommerce → SmartBill & Oblio: оберіть сервіс і вставте дані підключення.
3. Збережіть, натисніть «Check the connection» і оберіть серію рахунків.
4. Відкрийте замовлення і натисніть «Issue the invoice».
5. Для Pro: вставте ключ ліцензії або запустіть пробний період у тих самих налаштуваннях.