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

Get in touch
OpenCart

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.

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, 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
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
Holded connection with an API key and a permission check, the key encrypted ✔ ✔
VAT rates mapped to Holded taxes, the single tax with the rate filled in automatically ✔ ✔
An invoice from the order page by hand: contact by e-mail, lines, discount in %, shipping, shipping address ✔ ✔
The Holded total read back and compared with the order, PDF and a line in the order history ✔ ✔
Language of the document, SKU or model as the line code, an internal note ✔ ✔
Lost answer: the document is searched in Holded before a retry, no second invoice ✔ ✔
Interface in English and Spanish ✔ ✔
Invoice automatically by order status — ✔
Approval in Holded and numbering series for invoices and credit notes — ✔
Buyer NIF/CIF from a checkout field or the order, contact found by NIF — ✔
Credit note for the whole invoice by button or status — ✔
Payment on a Holded bank account per payment method — ✔
E-mail from Holded to the buyer automatically and by button — ✔
Stock by SKU with a Holded warehouse: changes both ways, no overwriting — ✔
A separate Holded key for each OpenCart store — ✔
Journal, bulk invoicing, retry of all stopped, totals by month — ✔

What it looks like

Holded box in the order
The “Holded” box on the order page: the contact, lines with Holded taxes, the total and the create button.
Holded invoice settings
The “Invoice” tab: the VAT-rate map to Holded taxes, the document language, the item code, approval and series (Pro).
Holded automation
The “Automation” tab (Pro): statuses for the invoice and the credit note, e-mail from Holded, payments on bank accounts.

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

v1.0.0 Current November 2026

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

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

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

  1. Install the archive for your OpenCart version and install the module in Extensions → Modules.
  2. 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).
  3. On the “Connection” tab paste the key and press “Save and test the connection”.
  4. On the “Invoice” tab check the VAT-rate map to Holded taxes, the language of the document and the item code.
  5. Open an order, check the lines and the total and press “Create the invoice in Holded”.
  6. 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

  1. 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).
  2. For 3.x and 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → Holded Invoices: install it and open the settings.
  4. On the “Connection” tab paste the API key and press “Save and test the connection”.
  5. 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.

@catcode_support Setup, compatibility, activation
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.

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