---
title: "Cupões Shopify no ERP: desconto e IVA por linha | Vokzar"
description: "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."
url: "https://vokzar.com/blog/cupoes-desconto-shopify-iva-erp/"
folder: "/blog/"
lang: "pt-PT"
dateModified: "2026-11-07"
timestamp: 1794009600
---

[← Voltar ao blog](https://vokzar.com/blog/) 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.

Cupões Descontos Shopify IVA ERP Integração

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.

- ### Integração com ERP e armazém

Descontos, IVA e portes mapeados linha a linha para o seu ERP.
- ### IVA incluído no Shopify

Porque é que aparece o cêntimo de diferença e como evitá-lo.
- ### Notas de crédito automáticas

Reembolsos parciais com o valor certo por linha.

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.

- Shopify

### Shopify Admin API: objeto Order (discountApplications)
- Shopify

### Shopify Admin API: objeto LineItem (discountAllocations)
- Portal das Finanças

### Código do IVA

Perguntas frequentes

## Dúvidas comuns sobre este tema.

[Mapear os descontos da minha loja](https://vokzar.com/automacoes-integracoes/integracao-erp-armazem/#pedir) [Ler em inglês](https://vokzar.com/en/blog/shopify-discount-codes-vat-erp/)

## Queres aplicar isto no teu site?

Próximo passo Auditoria técnica

[Mapear os descontos da minha loja](https://vokzar.com/automacoes-integracoes/integracao-erp-armazem/#pedir)

## Perguntas frequentes

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