```html

Esta funcionalidade aprimora a validação de cupons destinados à primeira compra. O aplicativo agora verifica o histórico de pedidos associado ao e-mail do cliente, e não apenas ao seu documento (CPF/CNPJ). Isso impede que um mesmo usuário utilize o benefício mais de uma vez ao criar contas diferentes com o mesmo e-mail, garantindo que a promoção seja aplicada apenas a novos clientes genuínos e evitando fraudes.

Sistemas envolvidos: Esta funcionalidade foi desenvolvida especificamente para operar com a plataforma de Cloud Commerce VTEX.

Por que a verificação padrão da VTEX para "primeira compra" não era suficiente?

A validação padrão da VTEX podia ser contornada caso um cliente realizasse uma primeira compra com um cadastro completo (incluindo CPF) e, posteriormente, tentasse fazer uma nova "primeira compra" com um cadastro simplificado usando o mesmo e-mail, mas sem o CPF. Nossa validação avançada centraliza a verificação no e-mail, fechando essa brecha e tornando a regra mais segura.

O que o cliente final vê se tentar usar o cupom indevidamente?

Se um cliente que já possui um pedido registrado com seu e-mail tentar aplicar o cupom de primeira compra novamente, o aplicativo retornará a mensagem de erro: "Este cupom é válido apenas para a primeira compra", bloqueando a aplicação do desconto.

Preciso criar uma regra de promoção específica no meu painel VTEX para que isso funcione?

Sim. Você deve criar ou configurar sua promoção de primeira compra normalmente dentro do módulo de Promoções da VTEX, garantindo que a opção nativa "Somente para primeira compra" esteja ativada. A lógica do nosso aplicativo atua como uma camada extra de verificação sobre essa configuração já existente.

Como o aplicativo sabe que o cliente já comprou?

No momento em que o cupom é aplicado no carrinho, o backend do aplicativo consulta a API de pedidos da VTEX usando o e-mail do cliente. Se essa consulta retornar qualquer pedido anterior, independentemente do status, a aplicação do cupom é bloqueada.

A ativação desta funcionalidade é realizada em duas etapas. Primeiro, o lojista deve garantir que a promoção desejada esteja corretamente configurada em seu painel da VTEX, com a opção "Somente para primeira compra" marcada. Após confirmar esta configuração, é necessário abrir um chamado com a equipe de suporte técnico da Kobe Apps, solicitando a ativação técnica interna da validação avançada de cupom por e-mail para o seu aplicativo.

```