194760 - User Story
Tipo: User Story
Título: zzapp - MVP upsell no fluxo de vendas (Carrinho)
Estado: Active
Iteração: ZZAPPS\Vendas\VENDAS SPRINT 11 2026
Área: ZZAPPS\Vendas
Atribuído a: Weslei Dornelles Morais
Prioridade: 2
Descrição (ReproSteps)
Problema: O fluxo atual de criação de carrinho no zzapp não estimula, de forma estruturada, a inclusão de produtos complementares. Com isso:
- Pedidos são finalizados sem explorar todo o potencial da cliente;
- A performance de upsell depende exclusivamente da habilidade individual do vendedor;
- Ficamos "reféns" de vendedores mais experientes ou mais persuasivos;
- Não existe mecanismo sistêmico que incentive aumento de ticket.
O resultado é um P/A (peças por atendimento) abaixo do potencial.
Contexto — Hoje, no fluxo de vendas do zzapp:
- O vendedor seleciona a cliente;
- Adiciona os produtos ao carrinho;
- Gera o pedido e o link de pagamento (zzlink).
Não há etapa estruturada de recomendação de itens complementares antes da geração do link.
Sabemos que existem oportunidades de:
- venda de itens complementares (cross/upsell);
- aumento de ticket médio;
- melhora no P/A.
Mas essa decisão fica totalmente a cargo do vendedor.
Objetivo: Inserir, no fluxo de criação do carrinho no zzapp, uma etapa de recomendação guiada de produtos complementares após a seleção dos itens e da cliente.
A funcionalidade deverá:
- Recomendar itens adicionais com alto potencial de complementar a compra;
- Permitir que o vendedor:
- visualize os itens sugeridos;
- valide disponibilidade em estoque;
- adicione ao pedido antes de gerar o link;
- Exibir esses itens no zzlink como disponíveis para a cliente incluir no pedido antes do pagamento.
Critérios de Aceite (SystemInfo)
Escopo:
- Fluxo de vendas com estoque da loja
- zzportal, zzapp e zzlink
Atenção: O fluxo de vendas com o MVP da feature "Upsell" deverá ser habilitado individualmente em nível loja.
Critérios de implementação (nível macro):
- Requisição ao time de dados
- Validação do estoque mínimo
- Versões da mensagem de pedido gerado para a cliente
Tarefas Filhas
| ID | Título | Atribuído a | Tipo | Estado |
|---|---|---|---|---|
| 194873 | [Front] zzapp - Tela de recomendação | Altamir Benkenstein | Task | Desenv |
| 194874 | [Front] zzapp - Tela de conferir pedido | Altamir Benkenstein | Task | New |
| 194875 | [Front] zzapp - Integração com API | Altamir Benkenstein | Task | New |
| 194987 | [Back] 1 Criar CartItemRecommendation e CartItem.IsRecommended | Nicholas Oliveira do Nascimento | Task | New |
| 194989 | [Back] 3 Ajustar endpoint api/cart | Nicholas Oliveira do Nascimento | Task | New |
| 194988 | [Back] 2 Criar endpoint customer-product-recommendation | Nicholas Oliveira do Nascimento | Task | New |
| 194876 | [Front] Portal - Implementar etapa de recomendação na geração do link | Celso Lucas Rodrigues Medeiros | Task | Desenv |
| 194877 | [Front] zzportal - Integrar seleção de recomendados ao carrinho/link | Celso Lucas Rodrigues Medeiros | Task | New |
| 195121 | [Front] zzportal - Implementar Firebase/remote config | Celso Lucas Rodrigues Medeiros | Task | Test |
| 194878 | [QA] Validação zzapp | William Augusto Pez | Task | New |
| 195120 | [QA] Validação zzportal | William Augusto Pez | Task | New |
Code Reviews
| Review | Escopo | Data | Status |
|---|---|---|---|
| review-v1 | feat/194760_upsell_v1 — zzapp | 2026-06-10 | Aprovado com ajustes |
| review-v2 | feat/194760_upsell_v1 — zzapp | 2026-06-10 | Aprovado com ajustes |