# Configuração dos modos de vendas

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
 ![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">GERENCIAMENTO DE PROJETOS</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
Configuração dos modos de vendas</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Jalile Cornachioni</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">05/09/2025</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

O aplicativo de vendas mobile **GV** será reformulado para atender diferentes cenários de operação comercial, desde representantes externos até pontos de venda em mercados, feiras e quiosques. Para isso, o sistema passará a contar com **modos de venda específicos**, que se adaptam ao perfil de cada cliente, e com a possibilidade de ativar o **Modo Ficha**, recurso que permite a impressão de fichas individuais por produto para retirada posterior.  
Essa evolução tem como objetivo oferecer mais flexibilidade, padronização dos fluxos e atender tanto operações assistidas por vendedores quanto modelos de autoatendimento.

***Comportamento Atual***

Atualmente, o app GV possui um fluxo único de vendas, voltado ao uso por representantes comerciais. Nesse modelo, o usuário precisa selecionar cliente e vendedor, buscar produtos por listagem ou código de barras, montar o carrinho, aplicar descontos e finalizar a venda com diferentes opções de pagamento.  
Esse comportamento não atende adequadamente cenários como **mini-mercados, feiras, eventos, quiosques ou autoatendimento**, onde a jornada do usuário precisa ser mais simples, rápida e sem etapas adicionais. Além disso, não existe a funcionalidade de emissão de **fichas individuais por produto**, recurso essencial em operações de consumo imediato, como bares, lanchonetes e eventos.

***Comportamento Esperado***

Com a reformulação, o app GV contará com três **modos de venda configuráveis**:

1. **Representante** – fluxo completo, com seleção de cliente e vendedor, carrinho editável, descontos e múltiplas formas de pagamento.
2. **PDV** – fluxo rápido para mercados de condomínio ou pequenos varejos, sem cliente, com inclusão de produtos apenas via código de barras, pagamento direto no TEF e sem divisão de pagamento.
3. **Touch (Catálogo/Autoatendimento)** – fluxo visual em grade, ideal para quiosques e autoatendimento, sem cliente e sem descontos, com tela de descanso personalizada.

Além disso, o **Modo Ficha** poderá ser ativado em qualquer fluxo, permitindo a emissão de fichas individuais por produto junto com o comprovante, atendendo especialmente operações de feiras, eventos e quiosques.

O resultado esperado é um aplicativo mais **versátil, escalável e alinhado às diferentes necessidades de operação dos clientes**, permitindo maior adoção e competitividade do produto.

##### <span style="color: #000000;">**2. Processo**</span>

[![Fluxo config modo venda.jpg](https://docs.softensistemas.com.br/uploads/images/gallery/2025-09/scaled-1680-/fluxo-config-modo-venda.jpg)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-09/fluxo-config-modo-venda.jpg)

#### **Especificação Funcional**

- - - - - -

##### [***Protótipo de Tela:*** ](https://www.figma.com/design/CA2GjWd7CVf0Lmn0K14AYo/Fluxo-de-Vendas---Gerencie-Vendas?node-id=2544-1924&t=IYsafmZLJAc1emR7-0)

[![Android.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-09/scaled-1680-/android.png) ](https://docs.softensistemas.com.br/uploads/images/gallery/2025-09/android.png)[![Android (1).png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-09/scaled-1680-/android-1.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-09/android-1.png)

- - - - - -

##### ***Regras de Interface:***

##### Configurações do App GV

***1. Modo de Venda (obrigatório)***

Define o fluxo principal que será carregado ao abrir o app:

- **Venda Representante (Valor default)**
- **Venda PDV**
- **Venda Touch**

*(No caso de feiras/eventos, o administrador escolhe Representante ou Touch, dependendo da operação)*

- - - - - -

***2. Modo Ficha (opcional, pode ser combinado)***

- **Ativo:** Após o pagamento, além do comprovante, o sistema imprime **fichas individuais por produto**.
- **Inativo:** Emite apenas comprovante padrão.

- - - - - -

***3.** **Venda /Orçamento***

- Define o vendedor padrão do dispositivo (necessário sincronizar vendedores do GA para selecioar um vendedor padrão)
- Define o percentual máximo de desconto permitido

- - - - - -

***4. Parâmetros do sistema***

*Define configurações que serão utilizadas durante a venda*

- Alterar vendedor na venda/orçamento?
- Bloqueia clientes de outros vendedores?
- Bloqueia descontos na venda?
- Altera preço de venda dos itens?
- Preenchimento numérico reverso (moeda)?
- Bloqueia acesso a Dashboard?

- - - - - -

***5.** **Métodos de Pagamento Permitidos (opcional por fluxo)***

- Dinheiro
- Cartão (TEF integrado)
- PIX
- Boleto
- Outros
- **Dividir pagamento (on/off)?**
- **Integração com POS Smart?**

*(Exemplo: no PDV de mercadinho → só cartão TEF; no Representante → todos; no Touch → só cartão/PIX)*

- - - - - -

<span style="text-decoration: line-through;">***6. Configuração de Impressão (por dispositivo)***</span>

- <span style="text-decoration: line-through;">**Impressora ativa:** Sim/Não</span>
- <span style="text-decoration: line-through;">**Tipo de impressão:**</span>
    
    
    - <span style="text-decoration: line-through;">Cupom fiscal</span>
    - <span style="text-decoration: line-through;">Comprovante simples</span>
    - <span style="text-decoration: line-through;">Fichas individuais</span>
- <span style="text-decoration: line-through;">**Número de vias:** 1, 2, etc.</span>

- - - - - -

***7. Tela de Descanso***

- **Ativar tela de descanso:** Sim/Não
    
    
    - Com a tela de descanso **desabilitada**, o comportamento padrão deve ser usar o logo do sistema GerencieVendas.
    - Com a tela de descanso **habilitada**, o comportamento da tela de descanso pode aceitar 3 opções.
- **Imagem genérica:** Uma imagem pré-selecionada pelo sistema - Não abre o upload de arquivos.
- **Logo da empresa:** Arquivo .SVG com o logo da Empresa do Cliente. Abre o upload de arquivos.
- **Anúncio/promocional:** Abre o upload de arquivos - Arquivo .JPEG/.PNG
- **Banner:** Com o formato do dispositivo. Abre o upload de arquivos.

*(Ex.: PDV e Touch voltam sempre para tela de descanso; Representante não precisa.)*

##### Configurações do App GV

**Modo venda** = representante  
**Modo ficha** = desativado  
**Vendedor padrão para o aparelho** = vazio  
**Percentual max de desconto** = zerado para a situação em que o vendedor não pode aplicar desconto e diferente de zero quando ele puder dar desconto na venda.

**Permissões referentes a ações do sistema**

- Alterar vendedor na venda/orçamento = desativado
- Bloqueia clientes de outros vendedores = ativado
- Bloqueia descontos na venda = ativado
- Alterar preço de venda dos itens = desativado
- Preenchimento numérico reverso (moeda) = desativado
- Bloqueia acesso a Dashboard = desativado

**Métodos de Pagamento**  
Selecione os métodos de pagamento permitidos:

- Dinheiro = ativo
- Cartão (TEF) = ativo
- Outros = ativo
- PIX = ativo
- Boleto = ativo

**Permitir divisão de pagamento**  
Permite que o pagamento seja dividido em múltiplas formas.

- Ativado

**Integração com POS Smart**  
Configurações de pagamento terceiros:

- Receber PIX via integração POS = desativado
- Receber via Integração TEF = desativado
- Não mostrar Teclado numérico virtual = desativado

**Tela de descans**o = não

##### ***Critérios de Aceitação***

- **Dado** que o modo de venda configurado é **Representante**,  
    **quando** acessar as configurações,  
    **então** o sistema deve **ocultar apenas a configuração “Tela de descanso”** e **exibir todas as demais**.
- **Dado** que o modo de venda configurado é **PDV**,  
    **quando** acessar as configurações,  
    **então** o sistema deve **ocultar a configuração “Percentual de desconto”**, **ocultar as “Parametrizações do sistema”** e **exibir a configuração “Tela de descanso”**.
- **Dado** que o modo de venda configurado é **Touch**,  
    **quando** acessar as configurações,  
    **então** o sistema deve **ocultar a configuração “Percentual de desconto”**, **ocultar as “Parametrizações do sistema”** e **exibir a configuração “Tela de descanso”**.
- **Dado** que o usuário altera o modo de venda,  
    **quando** salvar a configuração,  
    **então** o backend deve persistir a configuração correta e o frontend deve refletir automaticamente quais opções devem ser exibidas ou ocultas.

- - - - - -

##### ***Regras de Negócio:***

***1. Modo Representante***

- O sistema **deve** exigir a seleção de **cliente** e **vendedor** antes de iniciar a venda.
- O sistema **deve** permitir buscar produtos por **listagem com categorias** ou por **código de barras**.
- O sistema **deve** permitir edição de quantidade, preço unitário, desconto e acréscimo no carrinho.
- O sistema **deve** apresentar uma **tela de resumo da venda** antes da finalização.
- O sistema **deve** permitir **divisão do pagamento em múltiplas formas** (ex.: parte PIX, parte cartão).
- O sistema **não deve** permitir avançar para o pagamento sem seleção de cliente.
- O sistema **deve** emitir **comprovante impresso** após o pagamento.

***2. Modo PDV***

- O sistema **deve** iniciar na **tela de descanso**.
- O sistema **deve** incluir automaticamente um produto no carrinho ao bipar um código de barras.
- O sistema **não deve** permitir inclusão de produtos manualmente por listagem ou pesquisa.
- O sistema **não deve** permitir aplicação de desconto ou acréscimo.
- O sistema **não deve** permitir divisão do pagamento.
- O sistema **deve** direcionar o usuário para o fluxo de pagamento TEF após finalização.
- O sistema **deve** exibir status de pagamento (**sucesso/falha**) após retorno da maquininha.
- O sistema **deve** imprimir o comprovante e retornar automaticamente para a tela de descanso.

***3. Modo Touch (Catálogo / Autoatendimento)***

- O sistema **deve** iniciar na **tela de descanso** configurada (imagem genérica, logo ou publicidade).
- O sistema **deve** permitir navegação de produtos em **grade** com categorias exibidas em carrossel (superior ou lateral).
- O sistema **deve** permitir inclusão de itens no carrinho por toque.
- O sistema **não deve** permitir busca por código de barras, aplicação de desconto ou acréscimo.
- O sistema **não deve** permitir divisão do pagamento.
- O sistema **deve** direcionar o cliente ao pagamento após seleção dos itens.
- O sistema **deve** retornar à tela de descanso automaticamente após a finalização da venda.

***4. Modo Ficha (configuração aplicável a qualquer fluxo)***

- - O sistema **deve**, quando ativo, emitir **fichas individuais por produto** junto ao comprovante de venda.
    - O sistema **deve** gerar uma ficha para cada unidade do produto vendido.
        
        
        - Ex.: 3 refrigerantes → 3 fichas.
    - O sistema **deve** incluir em cada ficha:
        
        
        - Nome do produto
        - Quantidade (sempre 1)
        - Código/identificador do pedido
        - QR Code ou código de barras para conferência (quando configurado).
    - O sistema **não deve** permitir finalizar o pedido sem que todas as fichas sejam impressas corretamente.
    - O sistema **deve** retornar automaticamente para o fluxo normal após a impressão das fichas.

- - - - - -

##### ***Questões Técnicas:***

***1. Descrição de mudanças na base de dados, ou integração de API, ou arquivo que deva ser gerado.***

©SOFTEN SISTEMAS 2025