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

Shopify e TOConline: como emitir a fatura automaticamente e porque é que falha

A integração Shopify e TOConline falha no NIF, duplica faturas e deixa encomendas sem documento. As causas, os prazos legais e como montar um fluxo fiável.

TOConlineFaturação ShopifyFatura certificadaNIFIntegração

Resumo

O essencial antes de avançar.

  • O TOConline é muitas vezes escolhido pelo contabilista, não pela loja: as licenças são subscritas pelo contabilista certificado. A loja tem de se adaptar ao software que já existe.
  • As queixas públicas à app TOConline para Shopify repetem três problemas: o NIF lido do campo Morada 2, faturas que não são geradas e faturas duplicadas.
  • Os webhooks do Shopify podem chegar duplicados, fora de ordem ou não chegar. Uma integração que emite a fatura em cada aviso, sem verificar, vai duplicar e falhar.
  • Na venda online paga no checkout, o pagamento é anterior à entrega. Pelo artigo 36.º do CIVA, nesses casos a fatura deve ser emitida na data do recebimento.
  • Uma fatura certificada não se apaga nem se edita. Cada erro de integração corrige-se com nota de crédito e nova fatura, o que multiplica o trabalho do contabilista.

Porque é que tantas lojas acabam no TOConline

Em muitas pequenas empresas, quem escolhe o software de faturação não é o dono da loja, é o contabilista. No TOConline isso é literal: as licenças são subscritas pelo contabilista certificado, que trabalha com vários clientes na mesma plataforma.

Para a loja, isto tem uma consequência prática. Não pode trocar para o software que tem a melhor app para Shopify sem trocar a forma de trabalhar com o contabilista. A pergunta deixa de ser qual o melhor software de faturação e passa a ser como pôr o Shopify a falar bem com o TOConline.

Existe uma app oficial na Shopify App Store que promete sincronizar encomendas, faturas e notas de crédito. Nas avaliações públicas, de 2026, os lojistas descrevem falhas graves na faturação, faturas em falta e duplicados. Vale a pena perceber porquê, porque as causas aplicam-se a qualquer integração mal desenhada.

Falha 1: o NIF vem do campo Morada 2

O checkout do Shopify não tem um campo de NIF nativo. A solução mais comum, usada por várias integrações portuguesas, é pedir ao cliente que escreva o NIF no segundo campo da morada, o mesmo onde se escreve andar, porta ou fração.

Funciona até deixar de funcionar. O cliente escreve 3.º esquerdo em vez do NIF, o navegador preenche a morada automaticamente com dados antigos, o cliente coloca o NIF com espaços ou com o prefixo PT. Uma avaliação pública da app TOConline descreve exatamente isto: se o campo estiver mal preenchido, a fatura automática falha.

Uma integração robusta não confia no campo às cegas. Valida o formato e o dígito de controlo, distingue um NIF de uma indicação de morada e, quando o valor não é válido, emite como consumidor final ou coloca a encomenda numa fila de revisão, em vez de falhar em silêncio.

Falha 2: faturas duplicadas ou em falta

A maioria das integrações reage aos webhooks do Shopify, os avisos que a loja envia quando uma encomenda é criada ou paga. A documentação do Shopify é explícita: as entregas podem repetir-se e devem ser ignoradas pelo identificador do webhook, a ordem não é garantida e a entrega em si não é garantida, por isso as apps devem correr verificações periódicas.

Uma integração que emite a fatura sempre que recebe o aviso, sem verificar se a encomenda já tem fatura, duplica. Uma integração que só reage aos avisos, sem verificação periódica, perde encomendas quando um aviso não chega. As avaliações que falam em cerca de 8 faturas duplicadas em 500 encomendas descrevem este padrão.

A correção é de desenho, não de sorte. Cada encomenda tem de ficar ligada ao número da fatura emitida, a emissão tem de ser idempotente, isto é, repetir o pedido não cria segunda fatura, e uma tarefa diária tem de procurar encomendas pagas sem fatura.

Quando emitir: o prazo que muitas lojas ignoram

O artigo 36.º do Código do IVA fixa a regra geral: a fatura é emitida o mais tardar no quinto dia útil seguinte ao momento em que o imposto é devido. Mas há uma exceção que interessa às lojas online. Quando o pagamento é recebido antes da entrega, a fatura deve ser emitida na data do recebimento.

Numa loja Shopify com cartão ou MB WAY, o cliente paga no checkout, antes de a encomenda sair. Emitir a fatura só quando a encomenda é enviada, dias depois, pode não respeitar esta regra. Com Multibanco, a data relevante é a do pagamento da referência, não a da encomenda.

Esta é uma decisão a tomar com o seu contabilista, porque depende do seu caso. O ponto é que o gatilho da fatura, encomenda criada, paga ou enviada, não é um detalhe técnico. É uma escolha fiscal que a integração tem de respeitar.

Porque é que cada erro custa caro

Uma fatura certificada não se apaga nem se edita. Se sair com o NIF errado, o valor errado ou em duplicado, a correção faz-se com uma nota de crédito que anula o documento e, quando é o caso, uma nova fatura. Cada correção são dois documentos a mais, comunicados à Autoridade Tributária.

Para a loja isto é tempo perdido. Para o contabilista é trabalho que não estava previsto e que, mais cedo ou mais tarde, aparece na avença. Uma integração que falha 2% das vezes pode parecer aceitável e gerar dezenas de correções por mês numa loja com volume.

Por isso, antes de ligar a faturação automática, faça o teste ao contrário: pense no que acontece em cada erro. Quem vê o erro, quando o vê e como o corrige.

Como a Vokzar liga o Shopify ao TOConline

Usamos a API do TOConline, com as credenciais pedidas na própria conta, e definimos com o contabilista o momento de emissão, a série e o tratamento do consumidor final.

Construímos a emissão com verificação: o NIF é validado antes de seguir, cada encomenda fica ligada à sua fatura, um pedido repetido não cria duplicado e uma verificação diária encontra encomendas pagas sem documento.

Os casos que não passam vão para uma lista de revisão com o motivo, em vez de falharem em silêncio. Assim, o contabilista recebe documentos certos à primeira e a loja sabe exatamente o que ficou por tratar.

Próximos passos

Próximos passos.

Prova e validação

  • As queixas descritas vêm das avaliações públicas da app TOConline Invoices na Shopify App Store, consultadas em novembro de 2026.
  • O comportamento dos webhooks vem das boas práticas oficiais de webhooks do Shopify.
  • As regras de prazo resumem o artigo 36.º do CIVA e devem ser confirmadas com o seu contabilista para o seu caso.

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.

O Shopify tem integração com o TOConline?

Existe uma app TOConline Invoices na Shopify App Store. As avaliações públicas de 2026 relatam faturas não geradas, duplicados e falhas com o NIF lido do campo Morada 2. A alternativa é uma integração pela API do TOConline, desenhada com verificação.

Porque é que a minha integração cria faturas duplicadas?

Os webhooks do Shopify podem chegar mais do que uma vez. Se a integração emite uma fatura por cada aviso sem verificar se a encomenda já tem fatura, cria duplicados. A emissão tem de ser idempotente.

Quando devo emitir a fatura de uma encomenda online?

A regra geral do artigo 36.º do CIVA é até ao quinto dia útil seguinte. Quando o pagamento é recebido antes da entrega, como no checkout com cartão ou MB WAY, a fatura deve ser emitida na data do recebimento. Confirme o seu caso com o contabilista.

Posso corrigir uma fatura emitida com o NIF errado?

Uma fatura certificada não se edita. A correção faz-se com uma nota de crédito e, quando necessário, uma nova fatura. Por isso vale mais validar o NIF antes da emissão.

Queres aplicar isto no teu site?

Próximo passo Auditoria técnica