Faturação · 8 min · 2026-11-07

Faturas duplicadas ou em falta no Shopify: causas e como corrigir

Encomendas sem fatura e faturas emitidas duas vezes têm quase sempre as mesmas causas. Diagnóstico em cinco passos, como corrigir e como evitar.

Faturação ShopifyFaturas duplicadasWebhooksReconciliaçãoFatura certificada

Resumo

O essencial antes de avançar.

  • Faturas duplicadas e encomendas sem fatura são dois sintomas da mesma causa: a integração confia que cada aviso do Shopify chega uma vez, na ordem certa. O Shopify não garante nenhuma das duas coisas.
  • A causa mais comum de duplicados não é técnica: são duas ferramentas a faturar a mesma encomenda, por exemplo uma app instalada e uma automação antiga que ninguém desligou.
  • Encomendas editadas depois de pagas, pagamentos Multibanco que chegam dias depois e reinstalações de apps são os outros três suspeitos habituais.
  • O que já saiu corrige-se com notas de crédito, nunca apagando. Antes de corrigir, faça a lista completa, para não criar um segundo problema.
  • A prevenção tem dois pilares: emissão idempotente, ligada ao número da encomenda, e uma reconciliação diária entre encomendas pagas e faturas emitidas.

Porque é que isto acontece a lojas com apps conhecidas

Quase todas as integrações de faturação reagem aos avisos que o Shopify envia, os webhooks. A documentação oficial do Shopify diz três coisas que mudam tudo: o mesmo aviso pode chegar mais do que uma vez, a ordem dos avisos não é garantida e a entrega em si não é garantida.

Uma integração que emite a fatura sempre que recebe um aviso vai duplicar quando o aviso se repete. Uma integração que só reage a avisos, sem verificar depois, vai deixar encomendas sem fatura quando um aviso não chega. Não é azar, é desenho.

Avaliações públicas de apps de faturação portuguesas para Shopify descrevem precisamente estes sintomas, com casos de cerca de 8 faturas duplicadas em 500 encomendas.

Diagnóstico em cinco passos

1. Conte. Exporte as encomendas pagas do último mês e as faturas emitidas no mesmo período. Cruze pelo número da encomenda. Vai obter três listas: encomendas com uma fatura, com mais de uma, e sem nenhuma.

2. Veja quem emitiu. Nos duplicados, confirme se as duas faturas vieram da mesma ferramenta. Se vieram de ferramentas diferentes, por exemplo uma app e uma automação no Make ou no Flow, encontrou a causa.

3. Procure padrões nas encomendas sem fatura. São todas Multibanco? Foram editadas depois de pagas? Têm o NIF num formato estranho? Aconteceram no mesmo dia, talvez durante uma reinstalação?

4. Verifique o gatilho. A fatura é emitida quando a encomenda é criada, paga ou enviada? Um gatilho na criação fatura encomendas que nunca chegam a ser pagas; um gatilho no envio pode atrasar a fatura para além do prazo.

5. Leia os registos de erro da app. Muitas falhas ficam registadas sem que ninguém seja avisado.

Os quatro suspeitos habituais

Duas ferramentas a faturar. É a causa mais comum de duplicados. Uma loja instala uma app nova e esquece a automação antiga, ou o contabilista ativa a importação de encomendas no software de faturação enquanto a app também emite.

Encomendas editadas. Quando uma encomenda é editada depois de paga, com um artigo trocado ou acrescentado, o Shopify envia novos avisos. Algumas integrações tratam a edição como uma encomenda nova e faturam outra vez.

Pagamentos diferidos. Com Multibanco, o pagamento chega horas ou dias depois. Se a integração só olha para encomendas pagas no momento em que são criadas, estas ficam para trás.

Reinstalações e credenciais expiradas. Quando a ligação ao software de faturação cai, os avisos desse período perdem-se. Uma das queixas públicas à app Moloni para Shopify fala precisamente de um login que se perde e deixa a app inativa.

Como corrigir o que já foi emitido

Uma fatura certificada não se apaga. Uma fatura duplicada corrige-se com uma nota de crédito que a anula, referenciando o número e a série. Uma encomenda sem fatura corrige-se emitindo a fatura em falta, tendo em conta o prazo legal.

Faça a lista completa antes de corrigir. Corrigir à medida que se encontra leva a anular a fatura errada ou a emitir uma segunda fatura para uma encomenda que afinal já tinha. Partilhe a lista com o contabilista, que pode preferir tratar as correções num só momento.

Como evitar que volte a acontecer

Uma só ferramenta emite faturas. Escreva qual é e desligue as outras.

A emissão tem de ser idempotente: antes de emitir, a integração verifica se a encomenda já tem fatura, e o número da fatura fica guardado na encomenda. Um aviso repetido passa a não ter efeito.

Uma reconciliação diária compara encomendas pagas com faturas emitidas e avisa quando há diferenças. É o que o próprio Shopify recomenda para lidar com avisos que não chegam.

As edições de encomenda e os reembolsos têm regras próprias: uma edição depois da fatura gera nota de crédito e nova fatura, ou fica para revisão, mas nunca gera uma segunda fatura sem ligação à primeira.

Como a Vokzar resolve

Começamos pelo diagnóstico: cruzamos encomendas e faturas, identificamos duplicados e faltas e entregamos a lista ao seu contabilista com a causa de cada caso.

Depois reconstruímos a emissão com uma só fonte, emissão idempotente e reconciliação diária, no software que já usa, seja InvoiceXpress, Moloni, Vendus ou TOConline.

Fica com um aviso simples sempre que uma encomenda paga não tem fatura, em vez de descobrir no fim do trimestre.

Próximos passos

Próximos passos.

Prova e validação

  • O comportamento dos webhooks resume as boas práticas oficiais do Shopify.
  • Os sintomas citados vêm de avaliações públicas na Shopify App Store das apps TOConline Invoices e Moloni Portugal.
  • A forma de corrigir documentos emitidos deve ser confirmada com o seu contabilista.

Documentação oficial

Fontes validadas.

A estratégia técnica deve ser auditável. Estas fontes ligam diretamente à documentação oficial que suporta as recomendações deste guia.

Perguntas frequentes

Dúvidas comuns sobre este tema.

Porque é que a minha loja emite faturas duplicadas?

As causas mais comuns são duas ferramentas a faturar a mesma encomenda, avisos do Shopify que chegam mais do que uma vez e encomendas editadas depois de pagas tratadas como novas.

Porque é que algumas encomendas ficam sem fatura?

Os avisos do Shopify nem sempre chegam, os pagamentos Multibanco chegam mais tarde e as ligações ao software de faturação podem cair. Sem reconciliação diária, estas encomendas passam despercebidas.

Posso apagar uma fatura duplicada?

Não. Uma fatura certificada corrige-se com uma nota de crédito que a referencia. Faça primeiro a lista completa e combine as correções com o contabilista.

Como evito duplicados no futuro?

Uma só ferramenta a emitir, emissão idempotente com o número da fatura guardado na encomenda e uma reconciliação diária entre encomendas pagas e faturas emitidas.

Queres aplicar isto no teu site?

Próximo passo Auditoria técnica