Carrinhos abandonados

Um carrinho abandonado é um carrinho com itens cujo dono parou de mexer e não concluiu a compra. Recuperá-lo vale dinheiro: a plataforma guarda uma cópia do que estava no carrinho, gera um link secreto de recuperação e envia e-mails lembrando o cliente. Quando o cliente volta pelo link e fecha o pedido, o registro passa a recuperado. Estas são as rotas do administrador da loja para acompanhar e acionar esse processo.

Como funciona

1. Detecção. Um carrinho vira registro de abandonado quando fica parado por mais que o limite (por padrão, o menor atraso entre as regras de recuperação ativas da loja; sem regras, 2 horas) e ainda não tem registro em aberto. Se o cliente mexeu no carrinho depois, a cópia é atualizada em vez de duplicada.
2. Lembretes. O envio automático segue as regras de recuperação da loja (campanha em até 3 passos). O administrador também pode disparar um e-mail manualmente.
3. Retorno. O e-mail leva a /recover?token=... na loja, que reconstrói o carrinho do cliente.
4. Recuperação. Ao concluir um pedido o registro é marcado recovered com o pedido que o recuperou.

Conceitos importantes

Limpeza

Registros não se apagam sozinhos nestas rotas. cleanup apaga os mais velhos que N dias, recuperados ou não.

Indicadores

stats soma os registros: total, e-mails enviados, recuperados, taxa de recuperação (percentual de 0 a 100), valor total e valor médio em centavos.

Endpoints

Erros comuns

• Esperar que visitante anônimo apareça. Sem usuário logado nem e-mail informado o carrinho não gera registro.
• Enviar e-mail para carrinho recuperado. Responde erro; confira recovered antes.
• Tratar 500 como falha da plataforma. Aqui, regras de negócio como "carrinho já recuperado" e "sem e-mail" também voltam como 500, com o motivo em detail.
• Passar store_url esperando mudar o link. A loja usa o endereço público dela; store_url só entra quando a loja não tem um configurado.
• Vazar o recovery_token. Ele reabre o carrinho (e pode carregar o cupom de recuperação). Não registre nem exponha em telas públicas.
• Rodar cleanup sem querer. Ele apaga registros de verdade, e o padrão é 90 dias quando o corpo traz um número menor que 1.

Próximos passos