ERP e integrações · 9 min · 2026-11-07

Preços com IVA incluído no Shopify: como calcular o IVA certo para o ERP

O Shopify vende a preço final e o ERP pensa em base tributável. De onde vem o cêntimo de diferença e como passar encomendas sem acertos manuais.

IVAShopifyERPPrimaveraArredondamentos

Resumo

O essencial antes de avançar.

  • Em Portugal, as lojas Shopify vendem quase sempre com IVA incluído. O preço que o cliente paga é o ponto fixo; a base e o IVA têm de ser calculados a partir dele, e não o contrário.
  • A maioria dos ERP portugueses foi pensada ao contrário: preço sem IVA, mais IVA, igual a total. Passar o preço final como se fosse base gera totais diferentes do que o cliente pagou.
  • O Shopify arredonda o IVA por linha, e não há opção para arredondar no total. Um ERP que arredonda por unidade ou no fim da fatura vai divergir em 1 cêntimo em parte das encomendas.
  • A regra de ouro é simples: o total de cada linha no ERP tem de ser igual ao total pago no Shopify. A base e o IVA ajustam-se a esse valor, não ao contrário.
  • Na integração Shopify e Primavera que mapeámos, esta inversão foi a primeira decisão a tomar e a que evitou centenas de acertos manuais.

Dois sistemas, duas lógicas

No Shopify, com a opção de IVA incluído nos preços, o artigo custa 24,99 euros e é isso que o cliente paga. O IVA é uma parte desse valor, calculada para efeitos fiscais. A API do Shopify indica-o no campo taxesIncluded da encomenda.

No ERP, o raciocínio clássico é inverso: o artigo tem um preço sem IVA, aplica-se a taxa e chega-se ao total. Se a integração enviar 24,99 como preço sem IVA, o ERP cobra 30,74. Se enviar 24,99 a dividir por 1,23 arredondado, o ERP recalcula o IVA a partir dessa base e, conforme o preço e a quantidade, o total pode deixar de bater certo por um cêntimo.

O cliente pagou 24,99. Qualquer outro valor na fatura ou no ERP é um erro, por pequeno que seja, e obriga a acertos na reconciliação de pagamentos.

De onde vem o cêntimo de diferença

Imagine 3 unidades de um artigo a 24,99 euros com IVA a 23%. O total da linha é 74,97.

Se o ERP calcular por unidade: 24,99 a dividir por 1,23 dá 20,317, arredondado a 20,32. Três unidades dão 60,96 de base. Aplicando 23% a 60,96 obtém 14,02 de IVA, e o total passa a 74,98. Um cêntimo a mais do que o cliente pagou.

Se calcular por linha: 74,97 a dividir por 1,23 dá 60,951, arredondado a 60,95. O IVA é a diferença, 14,02, e o total fica 74,97. Igual ao que o cliente pagou.

O Shopify, por seu lado, arredonda o IVA linha a linha. A própria equipa do Shopify confirmou na comunidade de programadores que não há definição para passar a arredondar no total da encomenda. Um ERP que arredonda no fim da fatura vai, por isso, divergir do Shopify em parte das encomendas com várias linhas.

A regra que resolve: o total da linha manda

A forma mais robusta de passar encomendas para o ERP é tratar o total pago de cada linha como fixo. A integração calcula a base a partir desse total, arredonda, e o IVA é a diferença entre o total e a base. Assim, a soma das linhas é sempre igual ao que o cliente pagou.

Alguns ERP aceitam documentos com preços com IVA incluído e fazem esta conta sozinhos. Nesse caso, a integração deve usar essa opção em vez de enviar bases calculadas. Outros só aceitam preço sem IVA, e então a integração tem de enviar a base calculada por linha e, se o ERP insistir em recalcular, uma regra de acerto explícita.

O pior cenário é deixar cada sistema arredondar à sua maneira e corrigir as diferenças à mão no fim do mês.

Portes, isenções e taxas mistas

Os portes também são vendidos com IVA incluído no Shopify, numa linha própria de envio. No ERP costumam ser um artigo de serviço. Pelo artigo 16.º, n.º 5, alínea b) do Código do IVA, os portes integram o valor tributável dos bens enviados e seguem a sua taxa. Numa encomenda só com artigos a 23%, a regra é direta; com taxas mistas, a repartição deve ser acordada com o contabilista.

Encomendas com taxas diferentes, como livros a 6% e acessórios a 23%, exigem que cada linha leve a sua taxa. Mapear todos os artigos para uma única taxa no ERP é um erro comum e difícil de detetar, porque o total bate certo e só o IVA por taxa fica errado.

Encomendas isentas, por exemplo vendas a empresas de outros países da União Europeia com número de IVA válido, têm o campo taxExempt na API e precisam do motivo de isenção correto no ERP.

Como testar antes de ligar

Escolha 20 encomendas reais do último mês que incluam: várias unidades do mesmo artigo, várias linhas, portes, um desconto, uma taxa reduzida e um reembolso parcial.

Passe-as pela integração num ambiente de teste e compare, linha a linha, o total no ERP com o total no Shopify. Qualquer diferença, mesmo de 1 cêntimo, é um erro de regra e deve ser corrigida antes de ligar a integração a sério.

Guarde estas 20 encomendas como teste permanente. Sempre que a integração muda, voltam a passar.

Como a Vokzar faz o mapeamento

Começamos por ler como o seu ERP trata preços com e sem IVA e definimos a regra de cálculo por linha, com o total pago como valor fixo.

Mapeamos taxas, portes, isenções e descontos para os códigos do seu ERP, seja Primavera, PHC, Sage ou outro, e acordamos com o contabilista os casos de taxas mistas.

Entregamos a integração com o conjunto de encomendas de teste e um relatório que compara totais entre o Shopify e o ERP, para que qualquer diferença apareça no próprio dia e não no fecho do trimestre.

Próximos passos

Próximos passos.

Prova e validação

  • O campo taxesIncluded e os valores por linha vêm da documentação oficial da Admin API do Shopify.
  • A ausência de opção para arredondar o IVA no total foi confirmada por um membro da equipa do Shopify na comunidade de programadores.
  • Os exemplos numéricos foram calculados com IVA a 23% e arredondamento a 2 casas decimais. A regra dos portes resume o artigo 16.º do CIVA.

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 o total no ERP difere 1 cêntimo do Shopify?

Porque os sistemas arredondam em sítios diferentes. O Shopify arredonda o IVA por linha; se o ERP calcula a partir do preço unitário sem IVA ou arredonda no total da fatura, chega a valores diferentes em parte das encomendas.

Devo enviar para o ERP o preço com ou sem IVA?

Se o ERP aceitar documentos com IVA incluído, envie o preço com IVA e deixe-o calcular. Se não aceitar, calcule a base por linha a partir do total pago e trate o IVA como a diferença.

O Shopify permite arredondar o IVA no total da encomenda?

Não. Segundo a equipa do Shopify, não existe definição para trocar o arredondamento por linha pelo arredondamento no total.

Como trato os portes no ERP?

Como uma linha própria, com IVA incluído no Shopify. Pelo artigo 16.º do CIVA, os portes seguem a taxa dos bens enviados; em encomendas com taxas mistas, defina a repartição com o contabilista.

Queres aplicar isto no teu site?

Próximo passo Auditoria técnica