> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# cupom

o cupom é a única política que depende de uma ação do cliente: a marca define o desconto e as
condições, e o cliente aplica o cupom no pedido. os cupons disponíveis aparecem para ele em
meus cupons.

## criar a política

1. no menu lateral, selecione **configurações**.

2. clique em **políticas e promoções**.

3. clique em **criar política**.

4. na seção **dados gerais**, selecione o tipo de política **cupom**. o tipo fica bloqueado depois
   que a política é salva, então confira antes de seguir.

5. defina o **nome** da política. é por ele que ela é encontrada na listagem.

6. preencha o **código de integração** se a marca for integrada a um sistema de gestão. o cupom é o
   único tipo de política em que este campo é editável.

7. defina **data inicial** e **data final** se a política tiver prazo. sem datas, ela vale enquanto
   estiver ativa.

8. deixe **ativar política** desmarcado até terminar a configuração. a política pode ser ativada a
   qualquer momento, e uma política ativa já passa a valer nos pedidos.

9. na seção **para quem**, selecione os clientes ou as classificações de clientes atingidos. sem
   nenhuma seleção, a política vale para todos os clientes.

   ao restringir a clientes ou classificações, o cupom fica disponível apenas para os clientes
   selecionados.

10. na seção **para quais pedidos**, defina os filtros de disponibilidade, janela de entrega,
    classificação ou coleção. sem nenhum filtro, a política vale para todos os pedidos.

## definir o cupom

11. na seção **definições do cupom**, no campo **bloquear aplicação de desconto para**, selecione
    os perfis que não podem aplicar o cupom. deixe vazio para liberar a todos.

12. escolha o tipo de desconto. a escolha muda como o uso do cupom é contado.

    * **valor percentual (%)**: conta um uso por pedido, independente de quantas condições o cupom
      alcança.
    * **valor fixo (R\$)**: conta um uso por condição, mesmo quando aplicadas dentro de um único
      pedido.

13. defina o **limite de uso do cupom**, que é o total de usos disponíveis somando todos os
    clientes. sem limite, o cupom pode ser usado indefinidamente enquanto estiver ativo.

14. defina o **limite de uso do cupom por cliente**. o valor não pode ser maior que o limite de uso
    do cupom.

15. defina **data de início** e **data de expiração** do cupom. são os prazos de uso do cupom, e não
    se confundem com a vigência da política em dados gerais.

16. clique em **criar critério simples** e defina a condição que o pedido precisa atingir para o
    cupom poder ser aplicado. estão disponíveis **qtd. de peças** e **valor líquido dos itens**.

    para condicionar o cupom ao próprio valor do desconto, clique em **criar critério dinâmico** e
    compare o valor líquido dos itens com o **desconto do cupom**.

17. se o cupom precisar valer só em parte dos itens, defina os subcritérios por disponibilidade,
    janela de entrega, classificação, produto-cor, coleção do pedido ou status do pedido. todos os
    subcritérios atuam em conjunto.

18. defina o valor do desconto.

19. defina se o cupom alcança itens promocionados.

    * mantenha **aplicar desconto em todos os itens, incluindo itens promocionados** ativo para
      descontar também os itens com promoção.
    * desative a opção e o desconto do cupom vale somente para itens não promocionados.

20. marque **ativar política** e salve.

<Accordion title="exemplo, como o tipo de desconto muda a contagem de uso">
  cupom com **limite de uso do cupom** 100 e **limite de uso do cupom por cliente** 2.

  o cliente aplica o cupom em um pedido dividido em 3 condições.

  * como **valor percentual (%)**: conta 1 uso. o cliente ainda tem 1 uso disponível.
  * como **valor fixo (R\$)**: conta 3 usos, um por condição. o cliente estoura o limite de 2.

  é a diferença que mais surpreende na configuração: o mesmo cupom, no mesmo pedido, consome uso
  diferente conforme o tipo de desconto.
</Accordion>

<Accordion title="exemplo, itens promocionados">
  cupom de 10%, com **aplicar desconto em todos os itens, incluindo itens promocionados**
  desativado.

  pedido do cliente:

  * produto A: R\$ 100, sem promoção

  * produto B: R\$ 80, com promoção ativa

  * resultado: o desconto do cupom incide só no produto A.

  * cálculo: R\$ 100 menos 10% = R\$ 90, e o produto B fica em R\$ 80.
</Accordion>

## o que acontece depois

o cupom passa a aparecer em meus cupons para os clientes alcançados pela seção para quem, e pode ser
aplicado nos pedidos que atendem ao critério.

o desconto não é automático: enquanto o cliente não aplicar o cupom, o pedido segue com o preço
normal. cada aplicação consome um uso, contado conforme o tipo de desconto escolhido.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.