195867 - User Story
Tipo: User Story
Título: zzportal - MVP upsell no Relatório de vendas
Estado: Active
Iteração: ZZAPPS\Vendas\VENDAS SPRINT 12 2026
Área: ZZAPPS\Vendas
Atribuído a: Weslei Dornelles Morais
Prioridade: 2
Descrição
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.
Link do Figma — Ready to dev (zzportal): https://www.figma.com/design/01WrvD43WhZG5F22XTVhn0/Relat%C3%B3rio-de-vendas---ZZ-Portal-Link?node-id=2170-14613&t=PfNzS2a0uJTPoxlV-0
Critérios de Aceite
Escopo:
- Pedidos com estoque da loja
- zzportal
CA-1 · Exibição do bloco "Recomendados"
Escopo: Pedidos com estoque da loja
Sistema: zzportal
Na tela de detalhes do pedido, deve ser exibido um bloco adicional denominado "Recomendados" quando o pedido possuir produtos recomendados provenientes da funcionalidade de Upsell.
Pedidos sem recomendações não devem exibir este bloco.
CA-2 · Produtos exibidos no bloco
O bloco "Recomendados" deve exibir exclusivamente os produtos selecionados pelo vendedor para recomendação à cliente durante a geração do pedido.
Os produtos exibidos neste bloco:
- não fazem parte do pedido efetivamente comprado;
- não devem compor quantidades, descontos ou totalizadores do pedido;
- possuem finalidade exclusivamente informativa.
CA-3 · Conversão de recomendado em produto vendido
Caso a cliente adicione um produto recomendado ao pedido através do zzlink:
- o produto deve deixar de ser exibido no bloco "Recomendados";
- o produto deve passar a compor o bloco "Produtos";
- o item deve ser identificado através da tag "Item recomendado adicionado ao pedido", conforme layout definido.
CA-4 · Consistência da exibição
Um mesmo produto não pode ser exibido simultaneamente nos blocos "Produtos" e "Recomendados".
A tela deve refletir sempre o estado atual do pedido.
CA-5 · Layout dos cards
Os produtos exibidos no bloco "Recomendados" devem seguir o mesmo padrão visual utilizado para exibição dos produtos do pedido, respeitando as adaptações previstas no Figma para diferenciação entre itens comprados e itens apenas recomendados.
CA-6 · Atualização visual dos cards
A implementação deve utilizar o novo layout definido no Figma para a tela de Detalhe do Pedido no Relatório de vendas.
A atualização deve contemplar:
- produtos do estoque da loja;
- produtos da Prateleira Infinita;
Ajustes:
- Ordem dos blocos recomendados e produtos vs resumo do pedido
- Layout do "card"
- Se não houver desconto no produto, exibir o Texto "Desconto" e deixar o valor zerado.
- Título do bloco "Produtos" por "Itens"
sem alterar os comportamentos atualmente existentes no acompanhamento do pedido.
Tarefas Filhas
| ID | Título | Atribuído a | Tipo | Estado |
|---|---|---|---|---|
| 195944 | [Back] Dinâmica de itens recomendados | Weslei Dornelles Morais | Task | New |
| 195945 | [Front] Dinâmica de itens recomendados | Weslei Dornelles Morais | Task | New |
| 195946 | [Front] Integração com back | Weslei Dornelles Morais | Task | New |
| 195947 | [QA] Validação | Weslei Dornelles Morais | Task | New |
| 196002 | [Front] Novo layout de card do produto | Weslei Dornelles Morais | Task | New |
Code Reviews
| Review | Escopo | Data | Status |
|---|---|---|---|
| — | — | — | — |