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


Bulgaria Couriers: Econt & Speedy for OpenCart — delivery to the address, to an office and to an automat

Cart Discounts (Amount-Based and N+1) for OpenCart

eMAG Marketplace Connector for OpenCart — eMAG prices, stock and orders in your shop
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
- Install the archive for your OpenCart version and install the module in Extensions → Modules.
- In inv.bg create a long-term API token: Settings → About the company → API access.
- Paste the token on the “Connection” tab and press “Check the connection”: the name of your company appears.
- On “Invoice” switch on “Create invoices as drafts” for the first orders, enter the reason for rows without VAT and the PDF language.
- Open an order, check the rows and press “Issue the invoice”.
- 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
- 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).
- For 3.x and 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → inv.bg Invoices: install it and open the settings.
- On “Connection” paste the API token and press “Check the connection”.
- For the first orders switch drafts on on the “Invoice” tab.
- 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.
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.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
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
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















