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.
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.

