Modo de Venda

Configuração dos modos de vendas
Sincronizar tabela de complementos e variações de produtos
Incluir complementos durante o fluxo da venda

Configuração dos modos de vendas

Projeto/Sistema:
GERENCIAMENTO DE PROJETOS

Versão do Template:
1.2

Processo:
Configuração dos modos de vendas

Versão do Documento:
1.2

Responsável(eis):
Jalile Cornachioni

Data:

05/09/2025

1. Introdução

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:

Representante – fluxo completo, com seleção de cliente e vendedor, carrinho editável, descontos e múltiplas formas de pagamento.
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.
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.

2. Processo

Especificação Funcional

Protótipo de Tela:

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)

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

6. Configuração de Impressão (por dispositivo)

Impressora ativa: Sim/Não
Tipo de impressão:
- Cupom fiscal
- Comprovante simples
- Fichas individuais
Número de vias: 1, 2, etc.

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 descanso = 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

Sincronizar tabela de complementos e variações de produtos

1. Introdução

Hoje, a sincronização de produtos do Gerencie Aqui (GA – retaguarda) para o Gerencie Vendas (GV – mobile) considera apenas a tabela principal de produtos, o que impede o usuário do app de selecionar variações (grades) e/ou complementos.

O objetivo desta melhoria é: Ampliar a sincronização GA → GV para incluir as tabelas ProdutoVariacaoItem e ProdutoComplemento na sincronização e garantir que a busca via código de barras e listagem por categorias sejam aprimoradas para atender às necessidades específicas dos segmentos de varejo, atacado e food-service.

2. Processo

Processo	Envolvidos	Dados de Entrada	Dados de Saída
Sincronização de Produtos (GA → GV)	GA (Retaguarda), GV (Mobile)	Produtos, Variações, Complementos	Tabelas locais do GV atualizadas, Logs

Especificação Funcional

Protótipo de Tela:

Não há

Regras de Negócio:

1. Sincronização de Produtos (GA → GV)

Produtos simples, com variação e com complemento devem ser enviados.
Alterações/exclusões no GA devem refletir no GV.
Logs devem registrar quantidade enviada, recebida e erros (ex.: produto sem NCM, variação sem item).

Questões Técnicas:

GA (Retaguarda)

Ajustar API de sincronização de produtos para enviar também:
- ProdutoVariacaoItem
- ProdutoComplemento
Incluir no payload de produto:
- Código de barras do item principal.
- Código de barras da variação (quando existir).
Garantir que exclusões, inativação ou alterações em produtos/variações/complementos sejam refletidas na próxima sincronização.

GV (Mobile)

Adaptar sincronização local para gravar produtos + variações + complementos.
Implementar leitura de código de barras da variação

Incluir complementos durante o fluxo da venda

Projeto/Sistema:
MVP Gerencie Vendas

Versão do Template:
1.2

Processo:
Sincronização de tabelas de complementos e variações

Versão do Documento:
1.0

Responsável(eis):
Jalile Cornachioni

Data:

26/08/2025

1. Introdução

O objetivo desta melhoria é: Permitir no GV a seleção de variações e complementos no fluxo de venda.

2. Processo

Processo	Envolvidos	Dados de Entrada	Dados de Saída
Venda no GV (Mobile)	Usuário (Vendedor), GV	Produto selecionado, variação, complementos	Pedido registrado no GV

Especificação Funcional

Protótipo de Tela:

Descrição dos Campos:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
Campo	Texto	100	Sim	-	-

Regras de Interface:

1. Exemplo de regras do campo:
Descrição das regras de interface ou de tela. Eventos em campos ou botões, bloqueios ou desbloqueios e outras alterações.

Regras de Negócio:

1.Venda no GV (Mobile)

Usuário deve conseguir vender produtos simples, com variação e com complementos.
Seleção de variação deve ser obrigatória quando o produto exigir.
Complementos devem ser opcionais.
Código de barras:
- Item principal → abre seleção de variação.
- Variação → identifica direto.
- Código duplicado → lista opções.
- Código inexistente → mensagem “Produto não encontrado” e registro em log.

Questões Técnicas:

GV (Mobile)

Ajustar listagem de produtos por categorias:
- Exibir apenas itens principais.
- Variações devem ser exibidas após seleção do item principal.
- Complementos devem aparecer como etapa opcional posterior.
Implementar busca inteligente:
- Busca por nome do produto.
- Busca por variação (ex.: “camiseta azul P”).
Implementar leitura de código de barras:
- Se bipar código do item principal → abrir seleção de variação.
- Se bipar código da variação → lançar direto no carrinho.
- Se código for duplicado → exibir lista de opções.

Cenários de Teste

Food-Service: Pizza Média + borda recheada → venda no GV, sincronização, edição no GA, emissão de NFC-e.
Atacado: Cerveja pack 12 unid → venda no GV, sincronização, alteração de preço no GA, emissão de NF-e.
Varejo: Camiseta Polo G Azul → venda no GV, sincronização, alteração de forma de pagamento no GA, emissão de NFC-e.
Erros:
1. Produto sem NCM → rejeição fiscal.
2. Código de barras duplicado → exibir lista de escolha.
3. Venda offline → reenvio após reconexão.