SmartBill & Oblio Invoices for OpenCart 2.3, 3.x and 4.x — invoices from orders

SmartBill & Oblio Invoices for OpenCart 4.x, 3.x and 2.3 issues an invoice (factura) from an order in the Romanian service SmartBill Cloud or Oblio. The buyer enters the CUI and trade register number at the checkout, and the invoice appears in your series with the right buyer, rows and VAT rates.

What the buyer sees

At the OpenCart checkout the buyer sees “CUI” and “Reg. Com.” (the module creates them with “Create the fields” for all customer groups, not compulsory). A buyer who enters a CUI is invoiced as a company; otherwise as a private person. A Romanian CUI with a wrong check digit is refused at the checkout with an explanation.

What the admin gets

Extensions → Modules → SmartBill & Oblio Invoices: the Connection, Buyer, Invoice, Automation and Pro tabs. SmartBill needs the e-mail, API token and CIF; Oblio the e-mail, API secret and CIF. “Save and check the connection” reads the series and VAT rates of the account. Keys are stored encrypted.

The order page gets an invoice panel: a preview of the rows (prices with VAT, the discount per VAT rate, shipping as a service), the issue button, number, total, state and the PDF (SmartBill) or the document link (Oblio). Sales has a list of invoices with the filters In progress, Stopped, Issued, Storno and Cancelled. A stopped invoice can be retried or removed.

An invoice is never made twice: after a lost answer the module first looks for the invoice in the service (Oblio: the same request key; SmartBill: the number in the series), and when it cannot be sure it stops and shows what to look at. The rows must match the order total, otherwise the invoice is not sent.

In Pro the invoice is issued by itself at the order statuses you choose, orders paid at the checkout are invoiced as paid, and cash on delivery or bank transfer payments are recorded by status or with a button. The service e-mails the invoice. Storno by button or by status, and invoices can be cancelled. Through Oblio invoices go to e-Factura (SPV): off, companies only or everyone.

How it works, step by step

1. Install the archive for your OpenCart version and switch the module on.
2. On the Connection tab choose the service, paste the details from SmartBill Cloud or Oblio and press “Save and check the connection”.
3. On the Buyer tab create the CUI and Reg. Com. fields with one button.
4. On the order page look at the rows and issue the invoice.
5. In Pro the invoice, payment, e-mail and storno follow the order statuses.

Under the hood

• SmartBill Cloud API and Oblio REST API; keys encrypted.
• Prices go out with VAT, rounded to 2 decimals per unit; the total is matched with a 0.02 tolerance.
• The CUI and Reg. Com. fields are standard OpenCart Custom Fields.
• No duplicates after a lost answer.
• OpenCart events, no core edits; uninstalling keeps the invoice tables.
• Interface in English and Romanian.

How to install

1. Extensions → Installer: upload the archive for your version without renaming it (OpenCart 4: cc_sbob.ocmod.zip, 3.x: cc_sbob-oc3.ocmod.zip, 2.3: cc_sbob-oc23.ocmod.zip).
2. For 3.x and 2.3: Extensions → Modifications → Refresh.
3. Extensions → Modules → SmartBill & Oblio Invoices: install and edit.
4. Paste the connection details, create the buyer fields and choose the series.
5. For Pro: paste the key or start the trial on the Pro tab.