Pular para o conteúdo
PTEN

Descontos e cupons

Um abatimento sobre a venda inteira, antes dos impostos, distribuído entre os itens. Manual ou com um código que você administra.

Este recurso é novo e pode ainda não estar habilitado na sua conta. Se você não o vir, fale com a gente.

O que é

O Cord tem duas formas de reduzir o preço de uma venda, e as duas convivem no mesmo documento:

  • Preço negociado por item. Você reduz o preço de um item específico. É a diferença entre o preço de tabela e o negociado, e o painel a mostra como Desconto aplicado. Veja Produtos e preços.
  • Desconto no documento. Um abatimento sobre todo o orçamento ou fatura: uma porcentagem ou um valor na moeda do documento. O Cord o aplica antes dos impostos e o distribui entre os itens na proporção do valor de cada um. Você pode digitá-lo manualmente ou usar um cupom.

Um cupom é um código reutilizável (por exemplo, BEMVINDO10) que você cria em Configurações › Descontos › Cupons, com o valor, a validade e quantas vezes pode ser usado. Sua equipe o aplica no editor, e seus compradores podem digitá-lo quando fazem um orçamento no seu site com a API ou o Cord Elements.

Resumo Revise e envie de um orçamento novo, em dois momentos. Primeiro, o controle de desconto aberto em Cupom, com o código BEMVINDO10 digitado e o botão Aplicar; o resumo ainda não o inclui: subtotal $ 169.370,00 MXN, desconto de $ 5.130,00 MXN em preços negociados por item, IVA 16% $ 27.099,20 MXN e total $ 196.469,20 MXN. Depois, já aplicado: a linha Desconto (BEMVINDO10), com Remover, subtrai $ 16.937,00 MXN antes dos impostos; o IVA é calculado sobre $ 152.433,00 MXN e fica em $ 24.389,28 MXN, e o total cai para $ 176.822,28 MXN.

Requisitos

Detalhes
Plano Todos os planos.
Permissão para aplicar Orçamentos: aplicar um desconto ou validar um cupom no editor de orçamentos ou de faturas.
Permissão para administrar cupons Configurações: criar, editar, desativar e excluir cupons.
País Os 12 mercados. Cada trilho fiscal declara o desconto como a autoridade exige (veja Na sua fatura fiscal).

Aplicar um desconto

O controle fica no painel Revise e envie do editor, entre o subtotal e os impostos. Ele está no editor de novo orçamento, na edição de um orçamento e no editor de faturas.

  1. Em Revise e envie, clique em + Adicionar desconto ou cupom.
  2. Escolha o tipo: Porcentagem (de 0 a 100), Valor (na moeda do documento) ou Cupom.
  3. Digite o valor ou o código e clique em Aplicar. Um cupom é validado nesse momento: se ele não se aplicar, o painel diz por quê (veja Mensagens de um cupom).
  4. O resumo mostra a linha Desconto (10%) ou Desconto (BEMVINDO10) com o valor em verde, e os impostos e o total já calculados sobre a base com desconto. Para retirá-lo, clique em Remover ao lado do rótulo.

Um documento tem um desconto no documento por vez. Se você enviar um cupom e um desconto manual ao mesmo tempo (por exemplo, pela API), vale o cupom.

Como é calculado

  1. Subtotal bruto: a soma dos itens com o preço negociado, antes dos impostos.
  2. Desconto: a porcentagem sobre esse subtotal, ou o valor digitado. Um valor maior que o subtotal é limitado ao subtotal: o desconto nunca deixa a venda negativa.
  3. Distribuição por item: cada item recebe uma parte proporcional ao seu valor bruto. A distribuição é feita na menor unidade da moeda (centavos em MXN, cêntimos em EUR, unidades inteiras em CLP ou JPY), de modo que a soma das partes é exatamente o desconto e nenhum item fica negativo.
  4. Impostos: cada item calcula seu imposto sobre a base já com desconto, com a sua própria alíquota. Por isso um item isento e um tributado recebem, cada um, sua parte do desconto e o imposto só incide onde deve.
  5. Retenções: se seu catálogo tiver retenções (por exemplo, ISR ou IRPF), elas são calculadas sobre as bases com desconto.
Exemplo (México, IVA 16%) Sem desconto Com 10%
Subtotal 169.370,00 MXN 169.370,00 MXN
Desconto (BEMVINDO10) — −16.937,00 MXN
IVA 16% 27.099,20 MXN 24.389,28 MXN
Total 196.469,20 MXN 176.822,28 MXN

Preços com imposto incluído. Se você ativou Os preços já incluem IVA (ou o imposto do seu país), um desconto por valor reduz o que seu cliente paga, e a base sem imposto é desmembrada depois. Uma porcentagem funciona da mesma forma com ou sem imposto incluído.

O navegador e a API nunca enviam o valor do desconto: enviam a definição (porcentagem ou valor) ou o código do cupom. O Cord recalcula no servidor com o mesmo motor que o editor usa, então o que você vê é o que é salvo, cobrado e faturado.

Criar e administrar cupons

Configurações › Descontos › Cupons com quatro cupons: BEMVINDO10 de 10% sem data de término, com 14 de 100 usos e 1 por cliente; OBRA2026 de $ 2.500,00 MXN de 1 de out. de 2026 a 31 de dez. de 2026 com 3 usos; DISTRIB5 de 5% com 27 usos, e VERAO15 de 15%, vencido em 31 de ago. de 2026 e desativado. Cada linha tem o seu interruptor Ativo e os botões Editar e Excluir.
  1. Abra Configurações › Descontos › Cupons com a permissão Configurações.
  2. Clique em Novo cupom.
  3. Digite o Código: de 3 a 32 letras, números, hífen ou sublinhado. O Cord o converte para maiúsculas e não permite dois cupons com o mesmo código na sua conta.
  4. Opcional: um Nome interno (por exemplo, “Promoção de boas-vindas”).
  5. Escolha o Desconto: Porcentagem ou Valor fixo, e o Valor. Um valor fixo também pede a Moeda, entre as que sua conta oferece nos orçamentos.
  6. Opcional: Válido a partir de e Válido até. As datas são lidas no fuso horário do seu negócio.
  7. Opcional: Usos no total e Usos por cliente. Vazio significa sem limite.
  8. Clique em Criar cupom.
Regra Detalhes
Moeda Um cupom de porcentagem serve em qualquer moeda. Um de valor fixo só se aplica a documentos na sua moeda: um cupom de 2.500 MXN não pode ser aplicado a um orçamento em USD.
O que pode ser editado O nome, a validade, os limites de uso e se está ativo. O código, o tipo, o valor e a moeda não mudam depois de criado: um documento que já o tem mantém o que foi descontado. Para outro valor, crie outro cupom.
Desativar A chave de cada linha. Um cupom desativado não pode mais ser aplicado a documentos novos; os que já o têm o mantêm.
Excluir Só um cupom que nunca foi usado. Um com usos é desativado, para preservar o histórico.
Limite por cliente Um cupom com Usos por cliente exige escolher o cliente antes de aplicá-lo.

Quando um uso é contado

Um cupom é aplicado ao documento quando você o valida, mas o uso dele é contado quando o documento se torna vinculante:

Documento O uso é contado O uso é devolvido
Orçamento Quando é aprovado: o cliente clica em Aprovar orçamento no link, ou você usa Marcar como aprovado. Se o orçamento for recusado ou expirar.
Fatura Quando é emitida, antes de receber o número. Se a fatura for cancelada, ou se você excluir um rascunho cuja emissão tinha falhado.
Fatura de um orçamento Não conta de novo: reutiliza o uso do orçamento. Junto com o orçamento.
  • A validade e se o cupom está ativo são verificados ao aplicá-lo. Um documento montado enquanto o cupom era válido o mantém mesmo que depois o cupom expire ou você o desative.
  • Os limites de uso são verificados ao aplicar e de novo ao aprovar ou emitir, porque são o orçamento disponível do cupom. Se os usos se esgotaram entre o rascunho e esse momento:
    • Fatura: ela não é emitida e nenhum número é consumido. O Cord avisa que o cupom não tem mais usos disponíveis e que você deve removê-lo do rascunho para emitir a fatura.
    • Orçamento aprovado pelo cliente: a aprovação não é concluída. Seu cliente lê que o orçamento precisa de uma atualização sua, e na atividade você vê que ele tentou aprovar com um cupom esgotado. Remova o cupom e envie o orçamento de novo.

Mensagens de um cupom

Mensagem O que fazer
Esse cupom não existe. Confira o código; espaços e minúsculas não importam.
Esse cupom está desativado. Ative-o em Configurações › Descontos › Cupons se quiser continuar a usá-lo.
Esse cupom ainda não está válido. / Esse cupom já expirou. Confira Válido a partir de e Válido até.
Esse cupom é de uma moeda diferente da do documento. Use um cupom de porcentagem ou um de valor fixo na moeda do documento.
Esse cupom não tem mais usos disponíveis. Aumente Usos no total ou crie outro cupom.
Este cliente já usou esse cupom todas as vezes permitidas. O limite por cliente foi atingido.
Esse cupom é limitado por cliente: escolha um cliente primeiro. Escolha o cliente em Para quem é o orçamento? e aplique o cupom de novo.

Onde o desconto aparece

  • Link do orçamento e PDF: a linha Desconto (BEMVINDO10) ou Desconto (10%) entre o subtotal e os impostos. Cada item mantém o valor antes do desconto.
  • Detalhes do orçamento e da fatura, e o link da fatura: a mesma linha.
  • Google Sheets e Excel: a coluna desconto da planilha de orçamentos, com o subtotal antes do desconto.
  • QuickBooks Online e Xero: cada item chega com o preço já com desconto.

Na sua fatura fiscal

O desconto chega distribuído por item a cada documento fiscal, no formato que cada autoridade exige:

Documento Como é declarado
CFDI 4.0 (México) Cada item leva o valor unitário antes do desconto e sua parte do desconto no atributo Descuento; a base do IVA é o valor menos o desconto. Um item que o desconto deixa zerado não pode ser timbrado (o SAT exige uma base maior que zero para um imposto trasladado): o Cord o rejeita antes de timbrar e indica qual é. Na fatura global, cada venda leva sua parte do desconto.
Verifactu (Espanha) Cada item declara sua base já com desconto.
Factur-X, XRechnung e Peppol Cada item com o valor antes do desconto, e o desconto como desconto no documento, um por categoria e alíquota de IVA, para que cada grupo do detalhamento bata com a fatura até o centavo.
Facturae (Espanha) Cada item com seu próprio desconto.
Faturas autorizadas na Argentina, no Brasil, no Chile, na Colômbia e no Peru Cada item com sua parte do desconto, no campo que a autoridade de cada país exige.

Uma nota de crédito distribui seu valor na mesma proporção, desconto incluído.

Cópias, recorrências e aprovação parcial

Caso O que acontece com o desconto
Aprovação parcial O Cord aplica de novo a definição aos itens aprovados: uma porcentagem é recalculada; um valor é limitado ao novo subtotal.
Fatura de um orçamento Herda a definição e a aplica sobre o que é faturado.
Duplicar ou repetir uma fatura Copia o preço bruto de cada item e o desconto à parte.
Faturas recorrentes Só levam um desconto manual: um cupom não se repete todo mês.
Duplicar um orçamento A cópia não leva o desconto no documento: adicione-o de novo, se for o caso.
Substituir um CFDI (México) O substituto herda o desconto do original, com o cupom, sem contar outro uso.
Pedido no Shopify O pedido que o Cord cria na sua loja leva o preço negociado de cada item, mas ainda não o desconto no documento. Confira o total do pedido no Shopify.

Descontos e aprovações internas

Se sua organização usa aprovações internas:

  • Um desconto manual no documento conta como desconto de cada item para o limite de desconto máximo e para o de margem mínima. Mover o abatimento para o rodapé não contorna a regra.
  • Um cupom não conta para esses limites: foi criado por quem administra as Configurações e já é um abatimento autorizado.

Pela API e pelo Cord Elements

  • POST /api/v1/cotizaciones e POST /api/v1/facturas aceitam descuento ({ "tipo": "porcentaje" | "monto", "valor": 10 }) ou cupon ("BEMVINDO10"). Veja a API de orçamentos e a API de faturas.
  • Com uma chave publicável (a do seu site), o único desconto aceito é um cupon: um comprador não pode definir uma porcentagem para si mesmo.
  • Um cupom que não existe responde 404 com code: "coupon_no_existe"; um expirado, esgotado ou de outra moeda responde 409 com coupon_vencido, coupon_agotado, coupon_moneda e assim por diante.

Limites

  • Um desconto no documento por documento.
  • Porcentagem de 0 a 100; um valor é limitado ao subtotal bruto.
  • Código de cupom de 3 a 32 caracteres (A-Z, 0-9, -, _), único na sua conta.
  • Os usos são contados por documento vinculante: aprovar e depois faturar a mesma venda conta um único uso.

Problemas comuns

O cupom diz que está esgotado, mas há documentos que não foram aprovados. Um uso é contado ao aprovar ou emitir. Confira quais orçamentos aprovados ou faturas emitidas o levam; ao cancelar uma fatura ou quando um orçamento é recusado, o uso volta.

Não consigo alterar o valor de um cupom. O valor não é editável para não mudar o que já foi descontado em documentos existentes. Desative-o e crie outro.

O CFDI é rejeitado por um item zerado. O desconto deixou um item sem base. Reduza o desconto ou remova esse item antes de timbrar.

O cupom não aparece no orçamento duplicado. Duplicar não copia o desconto no documento: aplique-o de novo.

Relacionadas