Conectar Holded com WooCommerce é o passo que transforma a tua loja de um simples carrinho num sistema administrativo real: cada pedido pago passa, sem intervenção manual, a converter-se numa fatura correta dentro da tua conta Holded. Neste guia prático, focamo-nos no ato concreto da ligação — gerar a API key, instalar o plugin, mapear a faturação e emitir a primeira fatura — para que deixes o processo a funcionar numa única tarde e sem sustos contabilísticos no fim do mês.
Conectar Holded com WooCommerce: o que precisas antes de começar
Antes de mexer em qualquer ajuste, convém ter o terreno preparado. A maioria das incidências não surge do plugin, mas de dados fiscais incompletos ou de uma API key mal gerada. Se reveres esta lista, a ligação será concluída à primeira:
- Uma conta Holded ativa com permissões de administrador (os planos com faturação eletrónica são os ideais).
- WooCommerce atualizado e com os dados fiscais da tua empresa preenchidos (NIF, morada e razão social).
- Pelo menos uma série de faturação definida em Holded, distinta das tuas faturas manuais ou de outros canais.
- O plugin EHERO Woo Holded para faturação, que transfere cada pedido para Holded de forma automática.
- Os impostos da tua loja (IVA geral, reduzido, recargo de equivalência se aplicável) bem configurados em WooCommerce.
Esta peça é complementar ao nosso guia geral para integrar Holded com WooCommerce: aqui não falamos de estratégia, mas do procedimento técnico de ligação passo a passo.
Gera a API key em Holded
A API key é a credencial que autoriza a tua loja a criar faturas em teu nome. Entra no painel oficial de Holded, abre o menu da tua conta e vai a Configuração > Desenvolvedores (consoante o plano aparece como «API» ou «Integrações»). Clica em criar uma nova chave, dá-lhe um nome reconhecível — por exemplo «WooCommerce loja» — e copia-a para um local seguro.
Tem em conta um detalhe importante: Holded só mostra a chave completa uma vez. Se fechares a janela sem a copiares, terás de a revogar e gerar outra. Guarda-a no teu gestor de palavras-passe, nunca num e-mail ou numa nota partilhada.
Instala o plugin EHERO Woo Holded
Envia o ZIP do plugin a partir de Plugins > Adicionar novo > Enviar plugin no teu WordPress e ativa-o. Verás uma nova secção de definições onde vais colar a API key que acabaste de gerar. Ao guardar, o plugin faz uma chamada de validação a Holded: se a credencial estiver correta, receberás uma confirmação a verde. Este é o momento em que realmente terminas de ligar a tua loja a Holded ao nível das credenciais.
Como conectar Holded com WooCommerce passo a passo
Com a chave validada, o resto é uma questão de decidir o comportamento. Para deixar a ligação organizada, segue esta sequência dentro das definições do plugin:
- Cole a API key e guarde para verificar a ligação.
- Escolha a série de faturação que a loja vai usar (idealmente uma série dedicada ao canal online).
- Defina o gatilho: emitir a fatura quando o pedido passar para «Processando» ou para «Concluído».
- Decida se o número da fatura é atribuído por Holded ou herdado do pedido.
- Ative, se necessário, o envio automático do PDF ao cliente.
Mapeia a faturação: séries, impostos e dados fiscais
O mapeamento é a parte que faz a diferença entre uma fatura correta e uma que a tua contabilidade rejeitará. 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ão existe com o mesmo valor, a fatura será criada com valores desenquadrados. Revê também o mapeamento de contactos: o plugin procura o cliente por NIF ou e-mail e, se não o encontrar, cria-o. Isto evita duplicados na tua base de contactos de Holded.
Para negócios sujeitos à legislação antifraude, esta ligação é a base sobre a qual depois montas um TPV para WooCommerce com VeriFactu. EHERO Woo Holded é compatível com VeriFactu, pelo que as faturas que gera cumprem os requisitos de rastreabilidade exigidos.
Emite a tua primeira fatura de teste
Não confies a primeira emissão 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á a fatura em Holded com a série, o imposto e o contacto corretos. Confirma três coisas: que o número de série é 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á terminaste a ligação e podes passar a produção com tranquilidade.
Erros típicos de ligação e como resolvê-los
Embora ligar ambas as plataformas seja um processo curto, há três falhas que concentram quase todas as consultas de suporte. São estas e assim se resolvem.
API key inválida ou sem permissões
Se ao guardar receberes um erro de credencial, verifica se não copiaste espaços em branco no início ou no fim da chave. O segundo motivo mais comum é uma chave com permissões limitadas: alguns planos de Holded geram chaves só de leitura que não podem criar faturas. Gera uma nova com permissões de escrita e volta a validar.
Erros de série de faturação
Quando a fatura não é emitida e o registo menciona a «série», quase sempre falta selecionar uma série válida ou esta foi eliminada em Holded. Cria uma série exclusiva para o canal online, separa-a da que usas para faturas manuais e volta a escolhê-la no plugin. Assim evitas saltos de numeração que depois complicam o fecho trimestral.
| Aspeto | Faturação manual | Ligação com EHERO Woo Holded |
|---|---|---|
| Tempo por pedido | 3-5 minutos a copiar dados | Automático, zero minutos |
| Risco de erro | Alto (valores, NIF, série) | Baixo, dados herdados do pedido |
| Numeração de série | Manual, com saltos frequentes | Consecutiva e controlada |
| Compatibilidade VeriFactu | Depende do método | Sim, integrada |
Perguntas frequentes
Preciso de conhecimentos técnicos para fazer esta ligação?
Não. O processo reduz-se a gerar uma API key, instalar o plugin e colar a chave. Todo o mapeamento é feito a partir de um ecrã de definições, sem tocar em código nem em bases de dados.
O plugin sincroniza também o stock entre Holded e a loja?
Não. EHERO Woo Holded centra-se na faturação: converte cada pedido numa fatura dentro de Holded. A gestão de stock é um fluxo diferente e não faz parte desta ligação.
Posso usar funções de IA na faturação?
Qualquer função assistida por IA funciona em modo BYOK, ou seja, com a tua própria chave do fornecedor. Tu controlas a chave e o gasto; o plugin não inclui consumo de terceiros por conta própria.
O que acontece se eu mudar a API key mais tarde?
Basta colar a nova chave nas definições e guardar para que o plugin a valide novamente. Se revogares a anterior em Holded, fá-lo logo após confirmares que a nova ligação responde corretamente.
Conclusão
Conectar Holded com WooCommerce é mais rápido do que parece quando preparas a API key, defines uma série própria e validas com um pedido de teste antes de passar a produção. Com esses quatro cuidados — credencial correta, impostos alinhados, série dedicada e teste real — deixarás a faturação a funcionar de forma desatendida e em conformidade com VeriFactu. Dá o passo com o plugin de faturação Holded para WooCommerce de EHERO e converte cada pedido numa fatura sem voltares a copiar um dado à mão.