{"id":8774,"date":"2026-07-19T10:02:30","date_gmt":"2026-07-19T08:02:30","guid":{"rendered":"https:\/\/consultoriaehero.com\/?p=8774"},"modified":"2026-07-21T12:44:59","modified_gmt":"2026-07-21T10:44:59","slug":"connect-holded-with-woocommerce-step-by-step-guide","status":"publish","type":"post","link":"https:\/\/consultoriaehero.com\/en\/connect-holded-with-woocommerce-step-by-step-guide\/","title":{"rendered":"Connect Holded with WooCommerce: step-by-step guide"},"content":{"rendered":"<p>Connecting Holded with WooCommerce is the step that turns your store from a simple cart into a real administrative system: every paid order is automatically converted, without manual intervention, into a correct invoice within your Holded account. In this practical guide, we focus on the specific act of connecting \u2014 generating the API key, installing the plugin, mapping invoicing, and issuing the first invoice \u2014 so you can have the process up and running in a single afternoon and without accounting surprises at the end of the month.<\/p>\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/e9miay56dfh.exactdn.com\/wp-content\/uploads\/2026\/07\/conectar-holded-con-woocommerce.jpg?strip=all&w=1920\" alt=\"Dashboard to connect Holded with WooCommerce and automate order invoicing\" \/><\/figure>\n<h2>Connect Holded with WooCommerce: what you need before you start<\/h2>\n<p>Before changing any settings, it\u2019s worth getting everything ready. Most issues don\u2019t come from the plugin, but from incomplete tax data or a poorly generated API key. If you go through this checklist, the connection will work the first time:<\/p>\n<ul>\n<li>An active Holded account with administrator permissions (plans with electronic invoicing are ideal).<\/li>\n<li>WooCommerce updated and with your company\u2019s tax details completed (tax ID, address, and legal name).<\/li>\n<li>At least one invoicing series defined in Holded, separate from your manual invoices or other channels.<\/li>\n<li>The <a href=\"https:\/\/consultoriaehero.com\/product\/holded-woocommerce-invoices\/\">EHERO Woo Holded invoicing plugin<\/a>, which sends each order to Holded automatically.<\/li>\n<li>Your store\u2019s taxes (standard VAT, reduced VAT, equivalence surcharge if applicable) correctly configured in WooCommerce.<\/li>\n<\/ul>\n<p>This piece complements our <a href=\"https:\/\/consultoriaehero.com\/integrate-holded-with-woocommerce\/\">general guide to integrating Holded with WooCommerce<\/a>: here we\u2019re not talking about strategy, but about the technical step-by-step linking process.<\/p>\n<h2>Generate the API key in Holded<\/h2>\n<p>The API key is the credential that authorizes your store to create invoices on your behalf. Log in to the <a href=\"https:\/\/www.holded.com\/\" rel=\"noopener\" target=\"_blank\">official Holded dashboard<\/a>, open your account menu, and go to <em>Settings &gt; Developers<\/em> (depending on the plan, it may appear as \u201cAPI\u201d or \u201cIntegrations\u201d). Click to create a new key, give it a recognizable name \u2014 for example, \u201cWooCommerce store\u201d \u2014 and copy it somewhere safe.<\/p>\n<p>Keep one key detail in mind: Holded only shows the full key once. If you close the window without copying it, you\u2019ll have to revoke it and generate another one. Store it in your password manager, never in an email or a shared note.<\/p>\n<h2>Install the EHERO Woo Holded plugin<\/h2>\n<p>Upload the plugin ZIP from <em>Plugins &gt; Add New &gt; Upload Plugin<\/em> in your WordPress and activate it. You\u2019ll see a new settings section where you\u2019ll paste the API key you just generated. When you save, the plugin makes a validation call to Holded: if the credential is correct, you\u2019ll get a green confirmation. This is the moment when you truly finish linking your store with Holded at the credential level.<\/p>\n<h3>How to connect Holded with WooCommerce step by step<\/h3>\n<p>With the key validated, the rest is just deciding how it should behave. To keep the connection organized, follow this sequence in the plugin settings:<\/p>\n<ol>\n<li>Paste the API key and save to verify the connection.<\/li>\n<li>Choose the invoicing series the store will use (ideally one dedicated to the online channel).<\/li>\n<li>Define the trigger: issue the invoice when the order moves to \u201cProcessing\u201d or \u201cCompleted\u201d.<\/li>\n<li>Decide whether Holded assigns the invoice number or it is inherited from the order.<\/li>\n<li>Enable automatic PDF sending to the customer if you need it.<\/li>\n<\/ol>\n<h2>Map invoicing: series, taxes, and tax data<\/h2>\n<p>Mapping is what makes the difference between a correct invoice and one your accountant will reject. Make sure the WooCommerce tax rates match those defined in Holded; if your store has 21% and that tax doesn\u2019t exist in Holded with the same value, the invoice will be created with mismatched amounts. Also review contact mapping: the plugin looks up the customer by tax ID or email and, if it doesn\u2019t find them, creates them. This avoids duplicates in your Holded contact database.<\/p>\n<p>For businesses subject to anti-fraud regulations, this connection is the foundation on which you later build a <a href=\"https:\/\/consultoriaehero.com\/tpv-for-woocommerce-with-verifactu\/\">POS for WooCommerce with VeriFactu<\/a>. EHERO Woo Holded is compatible with VeriFactu, so the invoices it generates meet the required traceability requirements.<\/p>\n<h2>Issue your first test invoice<\/h2>\n<p>Don\u2019t trust the first issuance to a real order. Create a test order with a low-priced product, mark it as paid, and see what happens. If everything is mapped correctly, the invoice will appear in Holded within seconds with the correct series, tax, and contact. Check three things: that the series number is the expected one, that the total matches the order, and that the customer has been created or linked without duplication. When that test order goes through cleanly, the connection is done and you can move to production with peace of mind.<\/p>\n<h2>Typical connection errors and how to fix them<\/h2>\n<p>Although linking both platforms is a short process, there are three failures that account for almost all support requests. Here they are and how to solve them.<\/p>\n<h3>Invalid API key or insufficient permissions<\/h3>\n<p>If you get a credential error when saving, check that you haven\u2019t copied any leading or trailing spaces in the key. The second most common reason is a key with limited permissions: some Holded plans generate read-only keys that cannot create invoices. Generate a new one with write permissions and validate again.<\/p>\n<h3>Invoicing series errors<\/h3>\n<p>When the invoice is not issued and the log mentions the \u201cseries,\u201d it almost always means a valid series hasn\u2019t been selected or it has been deleted in Holded. Create a series exclusively for the online channel, separate it from the one you use for manual invoices, and select it again in the plugin. This avoids numbering gaps that later complicate the quarterly close.<\/p>\n<figure class=\"wp-block-table\">\n<table>\n<thead>\n<tr>\n<th>Aspect<\/th>\n<th>Manual invoicing<\/th>\n<th>Connection with EHERO Woo Holded<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Time per order<\/td>\n<td>3-5 minutes copying data<\/td>\n<td>Automatic, zero minutes<\/td>\n<\/tr>\n<tr>\n<td>Error risk<\/td>\n<td>High (amounts, tax ID, series)<\/td>\n<td>Low, data inherited from the order<\/td>\n<\/tr>\n<tr>\n<td>Series numbering<\/td>\n<td>Manual, with frequent gaps<\/td>\n<td>Sequential and controlled<\/td>\n<\/tr>\n<tr>\n<td>VeriFactu compatibility<\/td>\n<td>Depends on the method<\/td>\n<td>Yes, integrated<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<h2>Frequently asked questions<\/h2>\n<p><strong>Do I need technical knowledge to make this connection?<\/strong><\/p>\n<p>No. The process is reduced to generating an API key, installing the plugin, and pasting the key. All mapping is done from a settings screen, without touching code or databases.<\/p>\n<p><strong>Does the plugin also sync stock between Holded and the store?<\/strong><\/p>\n<p>No. EHERO Woo Holded focuses on invoicing: it converts each order into an invoice within Holded. Stock management is a separate flow and is not part of this connection.<\/p>\n<p><strong>Can I use AI features in invoicing?<\/strong><\/p>\n<p>Any AI-assisted feature works in BYOK mode, meaning with your own provider key. You control the key and the cost; the plugin does not include third-party usage on its own.<\/p>\n<p><strong>What happens if I change the API key later?<\/strong><\/p>\n<p>Just paste the new key into the settings and save so the plugin validates it again. If you revoke the previous one in Holded, do it right after confirming that the new connection responds correctly.<\/p>\n<h2>Conclusion<\/h2>\n<p>Connecting Holded with WooCommerce is faster than it seems when you prepare the API key, define your own series, and validate with a test order before going live. With those four precautions \u2014 correct credential, aligned taxes, dedicated series, and real test \u2014 you\u2019ll have invoicing running unattended and compliant with VeriFactu. Take the step with the <a href=\"https:\/\/consultoriaehero.com\/product\/holded-woocommerce-invoices\/\">EHERO Holded invoicing plugin for WooCommerce<\/a> and turn every order into an invoice without ever copying a single detail by hand.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Connecting Holded with WooCommerce is the step that turns your store from a simple cart into a real administrative system: every paid order is automatically converted, without manual intervention, into a correct invoice within your Holded account. In this practical guide, we focus on the specific act of connecting \u2014 generating the API key, installing [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":7638,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_jf_save_progress":"","rank_math_focus_keyword":"connect Holded with WooCommerce","rank_math_title":"Connect Holded with WooCommerce: step-by-step guide","rank_math_description":"Learn how to connect Holded with WooCommerce: API key, EHERO plugin, invoicing mapping, and common errors. Automate your invoices compatible with VeriFactu.","footnotes":""},"categories":[825,34],"tags":[8018,8016,902],"class_list":["post-8774","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-e-commerce-en","category-marketing-digital","tag-electronic-invoicing","tag-holded-en","tag-woocommerce-en"],"acf":[],"_links":{"self":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/8774","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/comments?post=8774"}],"version-history":[{"count":1,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/8774\/revisions"}],"predecessor-version":[{"id":8775,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/8774\/revisions\/8775"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/media\/7638"}],"wp:attachment":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/media?parent=8774"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/categories?post=8774"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/tags?post=8774"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}