Brindes com valor real na API e desconto centralizado no total do pedido

Antes, o produto de brinde era enviado à API e ao faturamento com valor R$ 0,00. Como a legislação não permite faturar item zerado na Nota Fiscal, os lojistas precisavam fazer ajustes manuais ou criar regras nos ERPs para corrigir esse valor antes de emitir a nota.

Agora, uma nova configuração no painel ("Descontar valor do brinde do valor do pedido na API Pública") automatiza a operação:

• Para o consumidor: nada muda, o brinde continua aparecendo como "Grátis" / R$ 0,00 no carrinho.
• Para o ERP e a API: o brinde assume seu valor real de cadastro, e o desconto é movido para o total do pedido.

Se houver mais de um brinde, ou o cliente já tiver outros descontos (cupom, desconto no boleto), tudo é somado de forma acumulativa no desconto do pedido. O valor total pago pelo cliente permanece exatamente o mesmo, mas a composição fiscal fica correta.

Exemplo prático (brinde de R$ 35):

Sem a configuração: o brinde vai zerado e o desconto fica dentro do item; o total do pedido não recebe o desconto:

// item brinde
{ "precoVenda": 0, "isBrinde": true, "desconto": -35 }
// nível do pedido
{ "valorDesconto": 0 }

Com a configuração: o brinde assume o valor real e o desconto migra para o pedido (valorDesconto, somado a descontos já existentes):

// item brinde
{ "precoVenda": 35, "isBrinde": true, "desconto": 0 }
// nível do pedido
{ "valorDesconto": 35 }

Benefícios:

• Compliance fiscal sem esforço: notas fiscais limpas e dentro das normas, sem travamentos no faturamento.
• Fim do trabalho manual no ERP: sem precisar consertar pedidos ou rodar scripts para faturar.
• Marketing e fiscal alinhados: liberdade para campanhas de "Compre e Ganhe" com os dados batendo perfeitamente.

Observação: por padrão a API continua exibindo os dados como antes; a nova forma passa a valer apenas ao ativar a configuração geral.