
Holded for OpenCart — invoices from orders, credit notes, NIF/CIF and stock (Spain)
Holded for OpenCart 4.x, 3.x, 2.3 (Spain): invoices from the order page free; Pro adds status rules, credit notes, payments, stock and a journal. A licence for life.
- Compatibility
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · interface language: English, Español
- 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 seller gets
The order page gets a “Holded” box: the contact (by the buyer e-mail, found or created), a table of lines with item code, quantity, price without tax, discount and the Holded tax, and the order total.
What’s in the admin
Extensions → Extensions → Modules → Holded Invoices: seven tabs, “Connection”, “Invoice”, “Buyer”, “Automation”, “Stock”, “Stores” 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; a store address on https.
A Holded account and an API key with the scopes listed above.
An invoice approved in Holded is final. Approval is off by default: documents stay drafts and you check them in Holded. How Holded reports an approved invoice to VeriFactu is set in Holded: the module does not change it, and it shows a series that Holded marks as excluded from VeriFactu next to the series choice.
Holded counts API calls per account per month: an invoice takes 2 to 4 calls, and each Pro step (approval, read-back, e-mail, payment, a stock move per line) one more. The lists of taxes, series and warehouses are kept for an hour to save calls; the module reads the calls left from the Holded response header.
If the shop also runs another Holded connector, documents for the same orders can be doubled.
Stock: a quantity change whose answer from Holded was lost is never resent (the row names the SKU to check); the first time a product is matched, the OpenCart quantity becomes the Holded figure; products with variants in Holded are left alone.
Stores with their own key: taxes are matched by percentage only, the default series is used, and payments and stock are handled for the main account only.
A credit note is issued for the whole invoice only; there are no partial refunds.
Version history
For OpenCart 4.x, 3.x and 2.3: Holded invoices from the order page, the contact by e-mail, a map of VAT rates to Holded taxes, PDF, English and Spanish.
Frequently bought with Holded


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

Billin Invoices for OpenCart — Billin (TS Facturas) invoices and receipts from orders

Abandoned Cart Recovery for OpenCart 2.3, 3.x and 4.x
Full module description
Holded Invoices for OpenCart 4.x, 3.x and 2.3 creates invoices in the Spanish Holded service straight from store orders: a button on the order page finds or creates the buyer as a Holded contact, passes the order lines with your IVA rates, reads the document total back, compares it with the order and gives you the PDF.
What you need from Holded. A Holded account and an API key created in Configuración → Desarrolladores → Credenciales (“Agregar API Token”, scopes “Por áreas”). Scopes for Free: Ventas → Facturas (Full), Ventas → Configuración de facturación (Leer), Contabilidad → Impuestos (Leer), Contactos → Contactos (Full); for Pro also Contabilidad → Bancos (Leer), Inventario → Productos (Full) and Inventario → Almacenes (Leer). Holded itself is paid under your plan: the module adds no per-document fee.
What the seller gets
The order page gets a “Holded” box: the contact (by the buyer e-mail, found or created), a table of lines with item code, quantity, price without tax, discount and the Holded tax, and the order total. The “Create the invoice in Holded” button creates the document; the box then shows the type, number, total, status and the PDF and E-mail (Pro) buttons.
Holded creates a document as a draft, and the series number (for example F260086) appears after approval. In Free you check and approve the draft in Holded; in Pro you can turn on approval right after creation or press “Approve” in the order. A coupon goes as a line discount, shipping as its own line. The module reads the total back from Holded and compares it with the order: if they differ, the note shows both amounts.
What’s in the admin
Extensions → Extensions → Modules → Holded Invoices: seven tabs, “Connection”, “Invoice”, “Buyer”, “Automation”, “Stock”, “Stores” and “Licence”. On the first one you paste the API key and press “Save and test the connection”: the module checks every permission it reads, names the missing ones and shows how many VAT rates it matched to Holded taxes. The key is stored encrypted.
On “Invoice” every VAT rate of the shop (0, 21, 10%…) is mapped to a Holded sales tax: “Automatic” takes the single active tax with that percentage, and if there is none or there are several, the invoice stops and names the rate to choose. The same tab holds the language of the document (the order language, Spanish when Holded does not have it), the item code (SKU or model) and an internal note that only your team sees in Holded. “Buyer” describes how the buyer becomes a Holded contact.
The “Automation”, “Stock” and “Stores” tabs are for Pro. Without a key they open with an explanation and disabled fields, and stored Pro values are not shown.
Pro creates invoices on its own: when an order reaches one of the statuses you pick (for example “Processing”). A credit note for the whole invoice is made by button or at a refund status (“Refunded”): the invoice number goes into its description, which is how it refers to the invoice. A payment is registered on the Holded bank account of its payment method: at once for an order paid online, or at a status you choose for cash on delivery or a bank transfer. Holded can send the approved document to the buyer itself, with the e-mail template of your account. The NIF/CIF comes from a buyer field at checkout or is typed in the order, and the contact is found by it.
Stock: products are matched by SKU or model, and Holded and OpenCart each receive the other’s changes instead of overwriting the quantity. A sale takes the quantity off the chosen Holded warehouse, a credit note brings it back, and what changed in Holded is added to the OpenCart quantity. OpenCart stores can each have their own Holded key. The “Holded invoices” journal in the Sales menu shows each document with its status, filters, totals by month, “Queue invoices” for bulk invoicing by order numbers and “Retry all stopped”.
How it works, step by step
- Install the archive for your OpenCart version and install the module in Extensions → Modules.
- In Holded open Configuración → Desarrolladores → Credenciales, press “Agregar API Token”, choose “Por áreas”, give it the scopes listed on the “Connection” tab and copy the token (it is shown once).
- On the “Connection” tab paste the key and press “Save and test the connection”.
- On the “Invoice” tab check the VAT-rate map to Holded taxes, the language of the document and the item code.
- Open an order, check the lines and the total and press “Create the invoice in Holded”.
- For Pro: a key or the trial on the “Licence” tab, then “Automation”, “Stock” and “Stores”.
Under the hood
- Holded API v2 (api.holded.com): the key in the Authorization header, JSON; contacts, taxes, numbering series, invoices, credit notes, approval, payments, e-mail sending, PDF, bank accounts, warehouses and products. The key is stored encrypted.
- Lines, discounts, the coupon, shipping and taxes are sent separately, and the Holded total is read back and compared with the order. Holded amounts that arrive as Spanish decimals (28,05) are read correctly. A tax from the map must be an active sales tax of the account: Holded accepts an unknown tax without an error and charges 0%, so the module does not create such an invoice and names the rate.
- Background work (a retry after a temporary failure, invoices by status, bulk actions, stock) runs from the OpenCart 4 scheduler every hour and from page views; a server cron at the address on the “Automation” tab speeds it up.
- A call that got no answer from Holded does not create a duplicate: before a retry the module looks for the document in Holded by the description “OpenCart order #N” in a date window. A call times out after 8 seconds (PDF 20), 422 field errors are shown in words, and a 429 waits for the time in Retry-After.
- The interface is in English and Spanish, the document in the order language.
How to install
- Extensions → Installer: upload the archive for your version without renaming the file (OpenCart 4 — cc_holded.ocmod.zip, 3.x — cc_holded-oc3.ocmod.zip, 2.3 — cc_holded-oc23.ocmod.zip; for 2.3 the contents of the upload/ folder are copied to the shop root).
- For 3.x and 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → Holded Invoices: install it and open the settings.
- On the “Connection” tab paste the API key and press “Save and test the connection”.
- For Pro: enter a 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 Holded module?
No, it is an independent Holded integration by CatCode. Holded is a trademark of its owner.
What do I need to start?
A Holded account and an API key with the scopes listed on the "Connection" tab.
Why does the invoice have no number?
Holded creates a document as a draft, and the series number appears after approval. In Free you approve the invoice in Holded; in Pro with the "Approve" button in the order, or automatically if you turn approval on.
Can I delete an issued document?
A draft can be changed in Holded. An approved invoice is final: a credit note corrects it (Pro: a button in the order or a refund status).
How is a credit note tied to the invoice?
The module writes the invoice number in the description of the credit note. A credit note covers the whole invoice; there are no partial refunds.
What if no Holded tax matches a VAT rate?
The invoice is not created, and the message names the rate for which you need to choose a tax on the "Invoice" tab.
What if Holded did not answer?
The module queues the row for a retry and first looks for the document in Holded by the order description, so there will be no second invoice.
Can I invoice in bulk?
Yes, in Pro: "Queue invoices" takes order numbers and ranges (up to 500), "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 for life?
Yes, for OpenCart it is a one-time payment and a licence for life, for two sites.
What happens after the trial?
Pro turns off, invoices queued by status stop with a reason, 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.




















