{"id":8836,"date":"2026-07-21T12:25:28","date_gmt":"2026-07-21T10:25:28","guid":{"rendered":"https:\/\/consultoriaehero.com\/conectar-holded-com-woocommerce-guia-passo-a-passo\/"},"modified":"2026-07-21T12:25:28","modified_gmt":"2026-07-21T10:25:28","slug":"conectar-holded-com-woocommerce-guia-passo-a-passo","status":"publish","type":"post","link":"https:\/\/consultoriaehero.com\/pt\/conectar-holded-com-woocommerce-guia-passo-a-passo\/","title":{"rendered":"Conectar Holded com WooCommerce: guia passo a passo"},"content":{"rendered":"<p>Conectar Holded com WooCommerce \u00e9 o passo que transforma a tua loja de um simples carrinho num sistema administrativo real: cada pedido pago passa, sem interven\u00e7\u00e3o manual, a converter-se numa fatura correta dentro da tua conta Holded. Neste guia pr\u00e1tico, focamo-nos no ato concreto da liga\u00e7\u00e3o \u2014 gerar a API key, instalar o plugin, mapear a fatura\u00e7\u00e3o e emitir a primeira fatura \u2014 para que deixes o processo a funcionar numa \u00fanica tarde e sem sustos contabil\u00edsticos no fim do m\u00eas.<\/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=\"Painel para conectar Holded com WooCommerce e automatizar a fatura\u00e7\u00e3o de pedidos\" \/><\/figure>\n<h2>Conectar Holded com WooCommerce: o que precisas antes de come\u00e7ar<\/h2>\n<p>Antes de mexer em qualquer ajuste, conv\u00e9m ter o terreno preparado. A maioria das incid\u00eancias n\u00e3o surge do plugin, mas de dados fiscais incompletos ou de uma API key mal gerada. Se reveres esta lista, a liga\u00e7\u00e3o ser\u00e1 conclu\u00edda \u00e0 primeira:<\/p>\n<ul>\n<li>Uma conta Holded ativa com permiss\u00f5es de administrador (os planos com fatura\u00e7\u00e3o eletr\u00f3nica s\u00e3o os ideais).<\/li>\n<li>WooCommerce atualizado e com os dados fiscais da tua empresa preenchidos (NIF, morada e raz\u00e3o social).<\/li>\n<li>Pelo menos uma s\u00e9rie de fatura\u00e7\u00e3o definida em Holded, distinta das tuas faturas manuais ou de outros canais.<\/li>\n<li>O plugin <a href=\"https:\/\/consultoriaehero.com\/pt\/produto\/ehero-woo-holded-integracao-completa-holded-woocommerce\/\">EHERO Woo Holded para fatura\u00e7\u00e3o<\/a>, que transfere cada pedido para Holded de forma autom\u00e1tica.<\/li>\n<li>Os impostos da tua loja (IVA geral, reduzido, recargo de equival\u00eancia se aplic\u00e1vel) bem configurados em WooCommerce.<\/li>\n<\/ul>\n<p>Esta pe\u00e7a \u00e9 complementar ao nosso <a href=\"https:\/\/consultoriaehero.com\/pt\/como-integrar-holded-com-woocommerce-passo-a-passo\/\">guia geral para integrar Holded com WooCommerce<\/a>: aqui n\u00e3o falamos de estrat\u00e9gia, mas do procedimento t\u00e9cnico de liga\u00e7\u00e3o passo a passo.<\/p>\n<h2>Gera a API key em Holded<\/h2>\n<p>A API key \u00e9 a credencial que autoriza a tua loja a criar faturas em teu nome. Entra no <a href=\"https:\/\/www.holded.com\/\" rel=\"noopener\" target=\"_blank\">painel oficial de Holded<\/a>, abre o menu da tua conta e vai a <em>Configura\u00e7\u00e3o &gt; Desenvolvedores<\/em> (consoante o plano aparece como \u00abAPI\u00bb ou \u00abIntegra\u00e7\u00f5es\u00bb). Clica em criar uma nova chave, d\u00e1-lhe um nome reconhec\u00edvel \u2014 por exemplo \u00abWooCommerce loja\u00bb \u2014 e copia-a para um local seguro.<\/p>\n<p>Tem em conta um detalhe importante: Holded s\u00f3 mostra a chave completa uma vez. Se fechares a janela sem a copiares, ter\u00e1s de a revogar e gerar outra. Guarda-a no teu gestor de palavras-passe, nunca num e-mail ou numa nota partilhada.<\/p>\n<h2>Instala o plugin EHERO Woo Holded<\/h2>\n<p>Envia o ZIP do plugin a partir de <em>Plugins &gt; Adicionar novo &gt; Enviar plugin<\/em> no teu WordPress e ativa-o. Ver\u00e1s uma nova sec\u00e7\u00e3o de defini\u00e7\u00f5es onde vais colar a API key que acabaste de gerar. Ao guardar, o plugin faz uma chamada de valida\u00e7\u00e3o a Holded: se a credencial estiver correta, receber\u00e1s uma confirma\u00e7\u00e3o a verde. Este \u00e9 o momento em que realmente terminas de ligar a tua loja a Holded ao n\u00edvel das credenciais.<\/p>\n<h3>Como conectar Holded com WooCommerce passo a passo<\/h3>\n<p>Com a chave validada, o resto \u00e9 uma quest\u00e3o de decidir o comportamento. Para deixar a liga\u00e7\u00e3o organizada, segue esta sequ\u00eancia dentro das defini\u00e7\u00f5es do plugin:<\/p>\n<ol>\n<li>Cole a API key e guarde para verificar a liga\u00e7\u00e3o.<\/li>\n<li>Escolha a s\u00e9rie de fatura\u00e7\u00e3o que a loja vai usar (idealmente uma s\u00e9rie dedicada ao canal online).<\/li>\n<li>Defina o gatilho: emitir a fatura quando o pedido passar para \u00abProcessando\u00bb ou para \u00abConclu\u00eddo\u00bb.<\/li>\n<li>Decida se o n\u00famero da fatura \u00e9 atribu\u00eddo por Holded ou herdado do pedido.<\/li>\n<li>Ative, se necess\u00e1rio, o envio autom\u00e1tico do PDF ao cliente.<\/li>\n<\/ol>\n<h2>Mapeia a fatura\u00e7\u00e3o: s\u00e9ries, impostos e dados fiscais<\/h2>\n<p>O mapeamento \u00e9 a parte que faz a diferen\u00e7a entre uma fatura correta e uma que a tua contabilidade rejeitar\u00e1. Certifica-te de que os tipos de IVA de WooCommerce coincidem com os definidos em Holded; se na loja tens 21 % e em Holded esse imposto n\u00e3o existe com o mesmo valor, a fatura ser\u00e1 criada com valores desenquadrados. Rev\u00ea tamb\u00e9m o mapeamento de contactos: o plugin procura o cliente por NIF ou e-mail e, se n\u00e3o o encontrar, cria-o. Isto evita duplicados na tua base de contactos de Holded.<\/p>\n<p>Para neg\u00f3cios sujeitos \u00e0 legisla\u00e7\u00e3o antifraude, esta liga\u00e7\u00e3o \u00e9 a base sobre a qual depois montas um <a href=\"https:\/\/consultoriaehero.com\/pt\/tpv-para-woocommerce-com-verifactu\/\">TPV para WooCommerce com VeriFactu<\/a>. EHERO Woo Holded \u00e9 compat\u00edvel com VeriFactu, pelo que as faturas que gera cumprem os requisitos de rastreabilidade exigidos.<\/p>\n<h2>Emite a tua primeira fatura de teste<\/h2>\n<p>N\u00e3o confies a primeira emiss\u00e3o a um pedido real. Cria um pedido de teste com um produto de valor baixo, marca-o como pago e observa o que acontece. Se tudo estiver bem mapeado, em segundos aparecer\u00e1 a fatura em Holded com a s\u00e9rie, o imposto e o contacto corretos. Confirma tr\u00eas coisas: que o n\u00famero de s\u00e9rie \u00e9 o previsto, que o total coincide com o pedido e que o cliente foi criado ou associado sem duplicar. Quando esse pedido de teste sair limpo, j\u00e1 terminaste a liga\u00e7\u00e3o e podes passar a produ\u00e7\u00e3o com tranquilidade.<\/p>\n<h2>Erros t\u00edpicos de liga\u00e7\u00e3o e como resolv\u00ea-los<\/h2>\n<p>Embora ligar ambas as plataformas seja um processo curto, h\u00e1 tr\u00eas falhas que concentram quase todas as consultas de suporte. S\u00e3o estas e assim se resolvem.<\/p>\n<h3>API key inv\u00e1lida ou sem permiss\u00f5es<\/h3>\n<p>Se ao guardar receberes um erro de credencial, verifica se n\u00e3o copiaste espa\u00e7os em branco no in\u00edcio ou no fim da chave. O segundo motivo mais comum \u00e9 uma chave com permiss\u00f5es limitadas: alguns planos de Holded geram chaves s\u00f3 de leitura que n\u00e3o podem criar faturas. Gera uma nova com permiss\u00f5es de escrita e volta a validar.<\/p>\n<h3>Erros de s\u00e9rie de fatura\u00e7\u00e3o<\/h3>\n<p>Quando a fatura n\u00e3o \u00e9 emitida e o registo menciona a \u00abs\u00e9rie\u00bb, quase sempre falta selecionar uma s\u00e9rie v\u00e1lida ou esta foi eliminada em Holded. Cria uma s\u00e9rie exclusiva para o canal online, separa-a da que usas para faturas manuais e volta a escolh\u00ea-la no plugin. Assim evitas saltos de numera\u00e7\u00e3o que depois complicam o fecho trimestral.<\/p>\n<figure class=\"wp-block-table\">\n<table>\n<thead>\n<tr>\n<th>Aspeto<\/th>\n<th>Fatura\u00e7\u00e3o manual<\/th>\n<th>Liga\u00e7\u00e3o com EHERO Woo Holded<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Tempo por pedido<\/td>\n<td>3-5 minutos a copiar dados<\/td>\n<td>Autom\u00e1tico, zero minutos<\/td>\n<\/tr>\n<tr>\n<td>Risco de erro<\/td>\n<td>Alto (valores, NIF, s\u00e9rie)<\/td>\n<td>Baixo, dados herdados do pedido<\/td>\n<\/tr>\n<tr>\n<td>Numera\u00e7\u00e3o de s\u00e9rie<\/td>\n<td>Manual, com saltos frequentes<\/td>\n<td>Consecutiva e controlada<\/td>\n<\/tr>\n<tr>\n<td>Compatibilidade VeriFactu<\/td>\n<td>Depende do m\u00e9todo<\/td>\n<td>Sim, integrada<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<h2>Perguntas frequentes<\/h2>\n<p><strong>Preciso de conhecimentos t\u00e9cnicos para fazer esta liga\u00e7\u00e3o?<\/strong><\/p>\n<p>N\u00e3o. O processo reduz-se a gerar uma API key, instalar o plugin e colar a chave. Todo o mapeamento \u00e9 feito a partir de um ecr\u00e3 de defini\u00e7\u00f5es, sem tocar em c\u00f3digo nem em bases de dados.<\/p>\n<p><strong>O plugin sincroniza tamb\u00e9m o stock entre Holded e a loja?<\/strong><\/p>\n<p>N\u00e3o. EHERO Woo Holded centra-se na fatura\u00e7\u00e3o: converte cada pedido numa fatura dentro de Holded. A gest\u00e3o de stock \u00e9 um fluxo diferente e n\u00e3o faz parte desta liga\u00e7\u00e3o.<\/p>\n<p><strong>Posso usar fun\u00e7\u00f5es de IA na fatura\u00e7\u00e3o?<\/strong><\/p>\n<p>Qualquer fun\u00e7\u00e3o assistida por IA funciona em modo BYOK, ou seja, com a tua pr\u00f3pria chave do fornecedor. Tu controlas a chave e o gasto; o plugin n\u00e3o inclui consumo de terceiros por conta pr\u00f3pria.<\/p>\n<p><strong>O que acontece se eu mudar a API key mais tarde?<\/strong><\/p>\n<p>Basta colar a nova chave nas defini\u00e7\u00f5es e guardar para que o plugin a valide novamente. Se revogares a anterior em Holded, f\u00e1-lo logo ap\u00f3s confirmares que a nova liga\u00e7\u00e3o responde corretamente.<\/p>\n<h2>Conclus\u00e3o<\/h2>\n<p>Conectar Holded com WooCommerce \u00e9 mais r\u00e1pido do que parece quando preparas a API key, defines uma s\u00e9rie pr\u00f3pria e validas com um pedido de teste antes de passar a produ\u00e7\u00e3o. Com esses quatro cuidados \u2014 credencial correta, impostos alinhados, s\u00e9rie dedicada e teste real \u2014 deixar\u00e1s a fatura\u00e7\u00e3o a funcionar de forma desatendida e em conformidade com VeriFactu. D\u00e1 o passo com o <a href=\"https:\/\/consultoriaehero.com\/pt\/produto\/ehero-woo-holded-integracao-completa-holded-woocommerce\/\">plugin de fatura\u00e7\u00e3o Holded para WooCommerce de EHERO<\/a> e converte cada pedido numa fatura sem voltares a copiar um dado \u00e0 m\u00e3o.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Conectar Holded com WooCommerce \u00e9 o passo que transforma a tua loja de um simples carrinho num sistema administrativo real: cada pedido pago passa, sem interven\u00e7\u00e3o manual, a converter-se numa fatura correta dentro da tua conta Holded. Neste guia pr\u00e1tico, focamo-nos no ato concreto da liga\u00e7\u00e3o \u2014 gerar a API key, instalar o plugin, mapear [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":7638,"comment_status":"","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_jf_save_progress":"","rank_math_focus_keyword":"conectar Holded com WooCommerce","rank_math_title":"Conectar Holded com WooCommerce: guia passo a passo","rank_math_description":"Aprende a conectar Holded com WooCommerce: chave API, plugin EHERO, mapeamento de fatura\u00e7\u00e3o e erros t\u00edpicos. Automatiza as tuas faturas compat\u00edvel com VeriFactu.","footnotes":""},"categories":[122],"tags":[4308,4307,137],"class_list":["post-8836","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-e-commerce","tag-facturacion-electronica","tag-holded","tag-woocommerce"],"acf":[],"_links":{"self":[{"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/8836","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=8836"}],"version-history":[{"count":0,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/posts\/8836\/revisions"}],"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=8836"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/categories?post=8836"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/consultoriaehero.com\/wp-json\/wp\/v2\/tags?post=8836"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}