Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

inv.bg for OpenCart — invoices from orders, credit notes and company invoices (Bulgaria)

inv.bg invoices for OpenCart 4.x, 3.x, 2.3 (Bulgaria): from the order page free, Pro adds status invoices, company invoices, credit notes and N-18. Lifetime licence.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
Compatibility
OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · interface language: English, Български
Version
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Licence
a site + a staging copy, lifetime
Trial
7 days, no card, one per site
Updated
November 2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Connection with a long-term API token, a connection check, an encrypted token ✔ ✔
An invoice from the order page to a private person, amounts exactly as in the order ✔ ✔
The PDF in Bulgarian or English, a link from the order box ✔ ✔
Drafts: the invoice gets its number when you confirm it in inv.bg ✔ ✔
Payment method by the payment extension code, a note and the unit of measure ✔ ✔
A reason for rows without VAT, the order currency with its rate ✔ ✔
Interface in English and Bulgarian ✔ ✔
Invoices by order status by hand from the order page automatic — Pro
Company invoices: EIK, VAT number, MOL, VIES check — ✔
Credit notes by a button or by a refund status — ✔
A paid mark at the checkout or by status — ✔
inv.bg number sets and a payment method per extension — ✔
Ordinance N-18 data (the e-shop number and the payment type) — ✔
An e-mail to the buyer from inv.bg with the PDF or a link — ✔
A journal with bulk invoicing and a retry of stopped rows — ✔

What it looks like

inv.bg box in the order
The “inv.bg” box on the order page: the buyer, the rows, the total and the “Issue the invoice” button.
inv.bg invoice settings
The “Invoice” tab: drafts, payment method, PDF language, the reason for rows without VAT, number sets and N-18.
inv.bg company invoices
The “Companies” tab (Pro): the EIK, VAT number and MOL fields and the VIES check.

Key points

What the merchant gets

The order page gets an “inv.bg” box: the buyer, whether a private person or a company, the rows with quantity, net amount and VAT rate, the total and the payment method.

What the admin gets

Extensions → Extensions → Modules → inv.bg Invoices has five tabs: “Connection”, “Invoice”, “Companies”, “Automation” and “Licence”.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; the cURL extension.
  • An inv.bg account with your company data and a long-term API token.
  • An invoice is a tax document: an issued invoice cannot be deleted, only reversed with a credit note. For the first orders switch drafts on and check the documents in inv.bg.
  • An order with a gift voucher, a fixed tax or reward points whose amount cannot be split into rows stops with an explanation instead of being issued with a mismatch.
  • An unknown online payment method goes on the invoice as “Card”; set a payment method per extension in Pro if you need another.

Version history

v1.0.0 Current November 2026

For OpenCart 4.x, 3.x and 2.3: inv.bg invoices from the order page, the PDF in Bulgarian and English, drafts, a reason for 0 % VAT, the exact order amounts, English and Bulgarian.

Frequently bought with inv.bg

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

inv.bg Invoices for OpenCart 4.x, 3.x and 2.3 issues invoices in the Bulgarian service inv.bg straight from your orders: the “Issue the invoice” button on the order page creates a tax invoice in your inv.bg account and shows its number and PDF. The amounts on the invoice are exactly those of the order.

What you need from inv.bg. An inv.bg account with your company data and a long-term API token (Settings → About the company → API access). The service itself is paid to inv.bg under your plan: the module adds no fee per document.

What the merchant gets

The order page gets an “inv.bg” box: the buyer, whether a private person or a company, the rows with quantity, net amount and VAT rate, the total and the payment method. The “Issue the invoice” button issues the document; the box then shows the type, number, total, status and the PDF and E-mail buttons. An order that already has an invoice never gets a second one.

VAT rates come from the rows of the order (20 %, 9 %, shipping as its own row). When an order has rows at 0 % VAT the module asks for a reason (“чл. 113, ал. 9 от ЗДДС” or your own) and sends nothing without it, explaining why. For an EU company outside Bulgaria the reason is separate (“чл. 21, ал. 2 от ЗДДС”).

What the admin gets

Extensions → Extensions → Modules → inv.bg Invoices has five tabs: “Connection”, “Invoice”, “Companies”, “Automation” and “Licence”. On the first one you paste the API token (stored encrypted and never shown again) and press “Check the connection”: the module shows the name of your company in inv.bg.

On “Invoice” you switch drafts on, choose the payment method (automatic by the payment extension code: cod is cash on delivery, bank_transfer is a bank transfer, cheque, PayPal, Stripe, ePay, EasyPay and Revolut by name, anything else is a card), the language of the PDF (Bulgarian for Bulgarian orders, English for the rest), the unit of measure, the reason for rows without VAT and a note. In Pro this tab also holds the inv.bg number sets for invoices and credit notes, a payment method per extension and the Ordinance N-18 data.

The “Companies” tab (Pro) ties company invoices to customer fields: EIK (Bulstat), VAT number and MOL. “Create the fields” adds these optional fields to the account and checkout forms. An order that carries an EIK or a VAT number becomes a company invoice: inv.bg finds the client by EIK or VAT number, or creates it. The VAT number is checked in VIES before the invoice.

Pro issues invoices by itself: when an order reaches one of the statuses you chose (“Complete” or another). The invoice can be marked paid at the checkout or by status, and a credit note is created by a button or when the order reaches a refund or cancellation status. The document can go to the buyer as an e-mail from inv.bg with the PDF attached or as a link.

The “inv.bg invoices” journal in the Sales menu shows every document as “Waiting”, “Stopped” or “Issued”, with the reason for a stop in words: inv.bg did not accept the token, the VAT number failed VIES, the plan does not allow it. “Invoices for many orders” takes order numbers and ranges (“1001-1020, 1025”, up to 500 at a time), and “Retry all stopped” repeats everything stopped. If an answer from inv.bg is lost, the retry looks for the document by the order mark first, so there is no duplicate.

How it works, step by step

  1. Install the archive for your OpenCart version and install the module in Extensions → Modules.
  2. In inv.bg create a long-term API token: Settings → About the company → API access.
  3. Paste the token on the “Connection” tab and press “Check the connection”: the name of your company appears.
  4. On “Invoice” switch on “Create invoices as drafts” for the first orders, enter the reason for rows without VAT and the PDF language.
  5. Open an order, check the rows and press “Issue the invoice”.
  6. Check the document in inv.bg, and when everything matches, switch drafts off.

Under the hood

  • inv.bg REST API v3 (api.inv.bg): a long-term token, invoices and credit notes, clients, the PDF, e-mails, exchange rates and number sets. The token is stored encrypted; the module journal shows inv.bg errors in full.
  • The invoice total equals the order total: rows, discounts, shipping and VAT are sent with their exact values; the order currency goes with its rate (the euro and the lev at the fixed rate 1.95583, other currencies at the inv.bg rate).
  • The invoice is issued in the background after shop pages and by the OpenCart 4 scheduler; on OpenCart 3 and 2.3 without cron the documents go from page visits, or from a server cron on a secret address shown on the “Automation” tab.
  • An inv.bg failure (429, 5xx, a timeout) puts the document in “Waiting” and retries later, while a refused token, plan or data stops the row with an explanation. The invoice of one order is never issued twice.
  • The VAT number check goes through inv.bg to VIES. If VIES takes longer than 30 seconds, the invoice goes with the order’s number unchecked, and the journal says “VAT check failed”.
  • The interface is in English and Bulgarian.

How to install

  1. Extensions → Installer: upload the archive for your version without renaming it (OpenCart 4: cc_invbg.ocmod.zip, 3.x: cc_invbg-oc3.ocmod.zip, 2.3: cc_invbg-oc23.ocmod.zip; for 2.3 copy the contents of upload/ to the shop root).
  2. For 3.x and 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → inv.bg Invoices: install it and open the settings.
  4. On “Connection” paste the API token and press “Check the connection”.
  5. For the first orders switch drafts on on the “Invoice” tab.
  6. For Pro: enter the key or start the trial on the “Licence” tab.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this the official inv.bg module?

No, it is an independent inv.bg integration by CatCode. inv.bg is a trademark of its owner.

What do I need to start?

An inv.bg account with your company data, and a long-term API token from the company settings.

Can I delete an issued invoice?

No, it is a tax document. A wrong invoice is reversed with a credit note (Pro: a button in the order or a refund status). For the first orders, switch drafts on.

How do I invoice a company?

In Pro: the EIK, VAT number and MOL come from customer fields (a button creates them) or are typed by hand in the order; the VAT number is checked in VIES.

What if an order has 0 % VAT?

Enter the reason in the settings (“чл. 113, ал. 9 от ЗДДС” or your own). Without it the invoice is not issued, and the module tells you why.

Can I issue invoices in bulk?

Yes, in Pro: the journal takes order numbers and ranges (up to 500), and “Retry all stopped” repeats the stopped ones.

Which OpenCart versions?

OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.

Is the licence lifetime?

Yes, for OpenCart one payment and a lifetime licence, for two sites.

What happens after the trial?

Pro switches off and the free part keeps working.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module