ERP e integrações · 9 min · 2026-11-07
Cupões de desconto no Shopify e no ERP: como repartir o desconto por linha e por taxa de IVA
Um cupão enviado ao ERP como linha negativa a 23% deixa o IVA errado quando a encomenda mistura taxas. Como o Shopify reparte descontos e como passá-los.
Resumo
O essencial antes de avançar.
- Na integração Shopify e Primavera que mapeámos, os cupões foram a parte mais difícil. Não pelo valor do desconto, mas pela forma como ele mexe com o IVA de cada linha.
- O Shopify guarda os descontos em dois sítios: as aplicações de desconto ao nível da encomenda e a parte de cada desconto atribuída a cada linha. É a segunda que interessa ao ERP.
- Enviar o cupão como uma única linha negativa só está certo quando todos os artigos têm a mesma taxa de IVA. Com taxas mistas, o IVA fica errado mesmo que o total bata certo.
- Portes grátis, leve 3 pague 2 e cartões-oferta parecem descontos e não são tratados da mesma forma. O cartão-oferta, no Shopify, é um meio de pagamento.
- Um desconto mal repartido volta a aparecer no reembolso: a nota de crédito tem de devolver o valor que foi realmente pago por aquela linha.
O desconto não é uma linha, é uma repartição
Quando o cliente usa um cupão de 10% sobre a encomenda, o Shopify mostra um desconto no total. Por dentro, faz outra coisa: reparte esse desconto pelas linhas, proporcionalmente ao valor de cada uma. Na API, a encomenda tem a lista de descontos aplicados e cada linha tem as suas alocações de desconto, com o valor que lhe coube.
Para o ERP, o que importa é o valor efetivamente pago por cada linha, depois do desconto. É sobre esse valor que se calcula a base e o IVA. Ler apenas o desconto total da encomenda e inventar uma forma de o distribuir é o caminho mais rápido para números que não batem com o Shopify.
Porque é que a linha negativa única falha
A solução mais comum, e mais tentadora, é enviar os artigos ao preço cheio e acrescentar uma linha de desconto negativa no fim do documento. Funciona quando todos os artigos têm a mesma taxa. Deixa de funcionar quando a encomenda mistura taxas.
Um exemplo com preços com IVA incluído. A encomenda tem um artigo A de 30 euros a 23% e um artigo B de 10 euros a 6%, com um cupão de 5 euros. O Shopify reparte o cupão proporcionalmente: 3,75 no artigo A e 1,25 no artigo B. O artigo A fica a 26,25, com 4,91 de IVA; o artigo B fica a 8,75, com 0,50 de IVA. IVA total: 5,41.
Com a linha negativa única a 23%: o artigo A a 30 tem 5,61 de IVA, o artigo B a 10 tem 0,57, e a linha de desconto de 5 euros abate 0,93. IVA total: 5,25. O cliente pagou o mesmo, o total do documento bate certo, mas o IVA liquidado ficou 16 cêntimos abaixo. Multiplicado por milhares de encomendas, é um erro que aparece na declaração.
Os descontos que parecem iguais e não são
Desconto num artigo. Um cupão só para uma coleção ou um produto fica alocado apenas às linhas abrangidas. A integração não deve espalhá-lo pela encomenda toda.
Leve 3 pague 2. O desconto fica alocado à linha do artigo oferecido ou repartido pelas linhas abrangidas, conforme a configuração. No ERP, a forma de mostrar a oferta deve ser acordada com o contabilista, mas o valor de cada linha tem de vir do Shopify.
Portes grátis. É um desconto sobre a linha de envio, não sobre os artigos. Se a integração o tratar como desconto nos artigos, reduz a base errada.
Cartões-oferta. No Shopify, o cartão-oferta é um meio de pagamento, não um desconto. Não reduz o valor dos artigos nem o IVA da venda; reduz apenas o que o cliente pagou por outro meio. Tratá-lo como cupão no ERP é um erro frequente.
O desconto volta no reembolso
Quando o cliente devolve o artigo A da encomenda acima, quanto deve ser reembolsado e creditado? Não 30 euros, mas 26,25, que é o que ele realmente pagou por esse artigo depois do cupão.
Se o ERP recebeu o desconto como linha negativa única, não sabe quanto do cupão pertence ao artigo A. A nota de crédito ou devolve demais, ou obriga a uma conta manual. Com o desconto repartido por linha desde a venda, a nota de crédito sai certa automaticamente.
É por isso que a decisão sobre descontos deve ser tomada a pensar também nas devoluções, e não só na venda.
Como mapear descontos para o ERP
Use a alocação por linha do Shopify como fonte. Para cada linha, o valor a passar ao ERP é o total original menos as alocações de desconto dessa linha.
Decida como mostrar o desconto no documento: como preço unitário já descontado, ou como preço cheio com desconto de linha. Ambas as formas estão certas desde que o desconto esteja na linha certa e com a taxa certa. A escolha depende do ERP e do que o contabilista prefere ver.
Teste com encomendas que tenham taxas mistas, cupões percentuais e de valor fixo, portes grátis e um cartão-oferta. São os casos onde as integrações costumam falhar.
Como a Vokzar trata os descontos na integração
Lemos as alocações de desconto linha a linha diretamente do Shopify e passamos ao ERP o valor efetivamente pago em cada linha, com a taxa de IVA correta.
Separamos portes grátis, ofertas e cartões-oferta, cada um com o tratamento que lhe corresponde, e garantimos que o mesmo valor por linha é usado nas notas de crédito.
Entregamos um conjunto de encomendas de teste com os casos difíceis, para que cada alteração futura à integração seja validada contra eles.
Próximos passos
Próximos passos.
Prova e validação
- Os campos discountApplications e discountAllocations vêm da documentação oficial da Admin API do Shopify.
- O exemplo usa IVA a 23% e 6%, preços com IVA incluído e arredondamento a 2 casas decimais. A forma de apresentar descontos no documento deve ser confirmada com o seu contabilista.
- A experiência de mapeamento refere-se a uma integração Shopify e Primavera feita numa empresa de grande dimensão.
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.
Posso enviar o cupão para o ERP como uma linha negativa?
Só quando todos os artigos da encomenda têm a mesma taxa de IVA. Com taxas mistas, o total bate certo mas o IVA fica errado, porque o desconto não reduz a base de cada taxa na proporção certa.
Onde está a repartição do desconto no Shopify?
Em cada linha da encomenda, nas alocações de desconto da Admin API. A encomenda tem também a lista dos descontos aplicados, mas é a alocação por linha que deve ir para o ERP.
Os cartões-oferta são descontos?
No Shopify, não. O cartão-oferta é um meio de pagamento: não reduz o valor dos artigos nem o IVA da venda.
Porque é que o desconto afeta as devoluções?
Porque o valor a reembolsar e a creditar é o que o cliente pagou pela linha depois do desconto. Sem a repartição por linha, a nota de crédito devolve demais ou exige cálculo manual.

