{"id":5797,"date":"2026-07-08T13:08:54","date_gmt":"2026-07-08T11:08:54","guid":{"rendered":"https:\/\/consultoriaehero.com\/?p=5797"},"modified":"2026-08-13T16:13:20","modified_gmt":"2026-08-13T14:13:20","slug":"how-to-integrate-holded-with-woocommerce-step-by-step","status":"publish","type":"post","link":"https:\/\/consultoriaehero.com\/en\/how-to-integrate-holded-with-woocommerce-step-by-step\/","title":{"rendered":"How to integrate Holded with WooCommerce step by step"},"content":{"rendered":"<p>Integrating Holded with WooCommerce means connecting your online store with your invoicing software so that every sale is invoiced, recorded, and synchronized automatically, without copying orders by hand. If you run a store on WooCommerce and handle invoicing in Holded, in this guide you will see how to <strong>connect Holded with WooCommerce<\/strong> from start to finish, what you need, and what you gain by automating it.<\/p>\n<figure style=\"text-align:center;margin:1.4em 0\"><img decoding=\"async\" src=\"https:\/\/e9miay56dfh.exactdn.com\/wp-content\/uploads\/2026\/07\/integrar-holded-con-woocommerce.jpg?strip=all&w=1920\" alt=\"Integrar Holded con WooCommerce paso a paso con EHERO Woo Holded\" style=\"max-width:100%;height:auto;border-radius:12px\" \/><\/figure>\n<h2>What you get by integrating Holded with WooCommerce<\/h2>\n<p>Connecting Holded with WooCommerce turns invoicing into an invisible process. Every order starts generating, without you touching anything:<\/p>\n<ul>\n<li><strong>Automatic invoice or receipt<\/strong> in Holded when the order is completed, with your official numbering.<\/li>\n<li><strong>Automatic credit notes<\/strong> for every refund, including partial returns.<\/li>\n<li><strong>Stock and catalog synchronized by SKU<\/strong>, so you do not sell what you do not have.<\/li>\n<li><strong>Customers and tax data<\/strong> sent to Holded, ready for your accountant.<\/li>\n<li><strong>Payments and cash flow<\/strong> balanced: each payment is recorded in its bank account.<\/li>\n<\/ul>\n<p>The math is simple: if today you spend five minutes per order invoicing by hand, with 300 orders a month that is 25 hours you get back.<\/p>\n<h2>What you need before you start<\/h2>\n<p>To integrate Holded with WooCommerce, you only need three things:<\/p>\n<ul>\n<li>An active <a href=\"https:\/\/woocommerce.com\/\" target=\"_blank\" rel=\"noopener\">WooCommerce<\/a> store on WordPress 5.8 or higher.<\/li>\n<li>A Holded account with access to its API (any plan that includes it).<\/li>\n<li>The connector that links both worlds: <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-holded-complete-holded-woocommerce-integration\/\">EHERO Woo Holded<\/a>, the Holded WooCommerce integration that automates the entire flow.<\/li>\n<\/ul>\n<p style=\"margin:1.4em 0;padding:14px 18px;background:#f0f9ff;border-left:4px solid #017cba;border-radius:4px;font-size:14px;line-height:1.65;color:#0c4a6e\"><strong>Don&#8217;t have Holded yet?<\/strong> You can <a href=\"https:\/\/holded.cello.so\/cDnFpginjNF\" rel=\"sponsored nofollow noopener\" target=\"_blank\">create your account here<\/a> and get your first three months at half price. This is a referral link: you pay less and it helps us keep this guide up to date.<\/p>\n<h2>How to integrate Holded with WooCommerce step by step<\/h2>\n<h3>1. Generate your API key in Holded<\/h3>\n<p>In Holded, go to <em>Settings \u2192 Developers \u2192 API<\/em> and create a new key (you have the reference in the <a href=\"https:\/\/developers.holded.com\/\" target=\"_blank\" rel=\"noopener\">Holded API documentation<\/a>). Copy it: this is what authorizes your store to create invoices in your account. You will need it in step 3.<\/p>\n<h3>2. Install EHERO Woo Holded in your WordPress<\/h3>\n<p>Upload the <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-holded-complete-holded-woocommerce-integration\/\">EHERO Woo Holded<\/a> plugin from <em>Plugins \u2192 Add New \u2192 Upload<\/em>, activate it, and you will see a new configuration menu for the Holded WooCommerce integration. There is no need to touch code at any point.<\/p>\n<h3>3. Connect and map your invoicing<\/h3>\n<p>Paste your API key and define how each order is translated into Holded: the <strong>invoice series<\/strong>, the <strong>VAT types<\/strong>, the <strong>payment methods<\/strong>, and which <strong>bank account<\/strong> each payment goes to. This mapping is the key to making invoices come out correct to the cent, with coupons, shipping costs, and taxes calculated properly.<\/p>\n<h3>4. Decide when the document is issued<\/h3>\n<p>Choose whether you want an <strong>invoice or receipt<\/strong> and when it is generated (when completed or when the order is processed). Save, place a <strong>test order<\/strong>, and check that the invoice appears automatically in Holded with everything balanced. From then on, the Holded WooCommerce integration works for you on every sale.<\/p>\n<h3>5. Issue your first test invoice<\/h3>\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>Connecting Holded with WooCommerce vs. doing it manually<\/h2>\n<div style=\"overflow:auto;max-width:100%\">\n<table style=\"width:100%;border-collapse:collapse;min-width:430px\">\n<thead>\n<tr style=\"background:#017cba;color:#fff\">\n<th style=\"padding:10px;text-align:left\">Task<\/th>\n<th style=\"padding:10px;text-align:left\">Manually<\/th>\n<th style=\"padding:10px;text-align:left\">With EHERO Woo Holded<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\"><strong>Invoice for each order<\/strong><\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">3-5 min per order<\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Automatic<\/td>\n<\/tr>\n<tr>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\"><strong>Refunds and corrective invoices<\/strong><\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Another invoice by hand<\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Automatic<\/td>\n<\/tr>\n<tr>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\"><strong>Store stock \u2194 Holded<\/strong><\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Frequent mismatches<\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Synchronized by SKU<\/td>\n<\/tr>\n<tr>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\"><strong>Cash flow closing<\/strong><\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Review bank by bank<\/td>\n<td style=\"padding:10px;border-top:1px solid #e0eaf1\">Each payment in its account<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Common mistakes when connecting Holded with WooCommerce<\/h2>\n<ul>\n<li><strong>Not mapping VAT types:<\/strong> this is the number one cause of invoices with incorrect taxes. Check it before going live.<\/li>\n<li><strong>Forgetting the numbering series:<\/strong> define a specific series for online sales and you will avoid gaps in your numbering.<\/li>\n<li><strong>Skipping the test order:<\/strong> always make a real test purchase before activating it for all orders.<\/li>\n<\/ul>\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><!-- faq-conectar --><\/p>\n<p><strong>How do I connect Holded with WooCommerce?<\/strong><\/p>\n<p>Install <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-holded-complete-holded-woocommerce-integration\/\">EHERO Woo Holded<\/a>, generate your API key in Holded and map your invoicing: from then on every order is invoiced automatically. See the steps above for the full detail.<\/p>\n<p><strong>Do I need technical knowledge to connect Holded with WooCommerce?<\/strong><br \/>No. The entire Holded WooCommerce integration is configured from a visual panel, without touching code.<\/p>\n<p><strong>Are the invoices legally valid?<\/strong><br \/>Yes. They are generated in Holded with your official numbering and your data, ready for your accountant and compatible with VeriFACTU.<\/p>\n<p><strong>Can I invoice orders I already have in the store?<\/strong><br \/>Yes. EHERO Woo Holded includes a bulk history feature to issue previous order invoices all at once.<\/p>\n<h2>Holded WooCommerce integration and VeriFACTU<\/h2>\n<p>With VeriFACTU already in place, every invoice must meet the requirements of the Tax Agency. The advantage of connecting Holded with WooCommerce is that invoices are issued directly in Holded \u2014your invoicing software\u2014 which already handles compliance: you just sell and the document comes out correct, numbered, and traceable. And if you also sell in a physical store, you close the loop with <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-pos-point-of-sale-terminal-for-woocommerce-with-verifactu-and-ticketbai\/\">EHERO Woo POS<\/a>, which generates the VeriFACTU receipt in the same Holded.<\/p>\n<h2>When is it worth integrating Holded with WooCommerce?<\/h2>\n<p>Not every store needs the same thing. Integrating Holded with WooCommerce clearly pays off when:<\/p>\n<ul>\n<li>You issue <strong>more than 20-30 invoices per month<\/strong> and doing them by hand starts to become a burden.<\/li>\n<li>You handle <strong>multiple VAT types<\/strong>, shipping costs, and coupons that make manual calculation complicated.<\/li>\n<li>You work with an <strong>accountant<\/strong> who needs the data organized and on time.<\/li>\n<li>You want <strong>stock and cash flow balanced<\/strong> without spending hours closing each month.<\/li>\n<\/ul>\n<p>If you invoice very sporadically, the manual process may work for a while longer; as soon as volume grows, the integration pays for itself in saved hours.<\/p>\n<h2>Best practices to keep everything balanced<\/h2>\n<ul>\n<li>Check once a month that the <strong>numbering series<\/strong> in Holded and WooCommerce are still aligned.<\/li>\n<li>Whenever there is a change in VAT or payment method, <strong>update the mapping<\/strong> before the next sale.<\/li>\n<li>Use the <strong>bulk history<\/strong> only for orders that are already closed, so you do not duplicate invoices.<\/li>\n<\/ul>\n<p><strong>Does it handle intra-EU VAT and equivalence surcharge?<\/strong><br \/>Yes. By mapping the tax types in step 3, the Holded WooCommerce integration respects the VAT of each line, including intra-EU transactions.<\/p>\n<p><strong>What if I also sell in a physical store?<\/strong><br \/>You can connect online and counter sales with <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-pos-point-of-sale-terminal-for-woocommerce-with-verifactu-and-ticketbai\/\">EHERO Woo POS<\/a>, so both are invoiced in the same Holded.<\/p>\n<p><!-- guias-relacionadas --><\/p>\n<h2>Related guides<\/h2>\n<ul>\n<li><a href=\"https:\/\/consultoriaehero.com\/en\/connect-holded-with-woocommerce-step-by-step-guide\/\"><strong>Connect Holded with WooCommerce<\/strong><\/a> \u2014 API key, install plugin, map billing, first invoice.<\/li>\n<\/ul>\n<p><!-- \/guias-relacionadas --><\/p>\n<h2>Start invoicing automatically<\/h2>\n<p>Integrating Holded with WooCommerce stops being a technical project with <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-holded-complete-holded-woocommerce-integration\/\">EHERO Woo Holded<\/a>: install it, connect your API key, and every sale is invoiced automatically. <a href=\"https:\/\/consultoriaehero.com\/en\/product\/ehero-woo-holded-complete-holded-woocommerce-integration\/\">Discover EHERO Woo Holded<\/a> and recover the hours you are losing today invoicing by hand. And if you want to go deeper into the workflow, read our guide to <a href=\"https:\/\/consultoriaehero.com\/en\/how-to-automate-woocommerce-invoices-with-holded\/\">automating WooCommerce invoices with Holded<\/a> or explore more <a href=\"https:\/\/consultoriaehero.com\/en\/product-category\/integrations-and-sync\/erp-and-billing\/\">ERP integrations for WooCommerce<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Step-by-step guide to integrating Holded with WooCommerce: connect your store, invoice every order automatically, and synchronize stock, customers, and cash flow.<\/p>\n","protected":false},"author":4,"featured_media":11765,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_jf_save_progress":"","rank_math_focus_keyword":"how to integrate Holded with WooCommerce step by step,Holded WooCommerce guide,Holded WooCommerce requirements","rank_math_title":"How to integrate Holded with WooCommerce in 4 steps | EHERO","rank_math_description":"How to integrate Holded with WooCommerce step by step: connect your store, invoice every order automatically, and sync stock and customers. Guide in Spanish.","rank_math_robots":[],"rank_math_canonical_url":"","rank_math_seo_score":75,"footnotes":""},"categories":[825,34],"tags":[4308,4307,902],"class_list":["post-5797","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-e-commerce-en","category-marketing-digital","tag-facturacion-electronica","tag-holded","tag-woocommerce-en"],"acf":[],"_links":{"self":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/5797","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=5797"}],"version-history":[{"count":6,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/5797\/revisions"}],"predecessor-version":[{"id":11820,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/5797\/revisions\/11820"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/media\/11765"}],"wp:attachment":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/media?parent=5797"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/categories?post=5797"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/tags?post=5797"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}