Skip to main content

Nova Página


 Softensistemas Logo

 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

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 corretamente variações (grades) e complementos.
Além disso, a busca via código de barras e a organização da listagem por categorias não atendem plenamente às necessidades de varejo, atacado e food-service.

O objetivo desta melhoria é:

  1. Ampliar a sincronização GA → GV para incluir ProdutoVariacaoItem e ProdutoComplemento.

  2. Permitir no GV a seleção de variações e complementos no fluxo de venda.

  3. Garantir a volta das vendas GV → GA com consistência.

  4. Viabilizar emissão de documentos fiscais no GA a partir das vendas sincronizadas.

  5. Registrar logs completos, tratar erros e exceções.

  6. Ajustar usabilidade: busca, código de barras e listagem por categorias.

2. Processo

Fluxograma - adaptação totem.jpg

 

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
Venda no GV (Mobile) Usuário (Vendedor), GV Produto selecionado, variação, complementos Pedido registrado no GV
Sincronização de Vendas (GV → GA) GV, GA Pedidos com produtos + variações + complementos Pedidos integrados no GA, Logs
Emissão Fiscal (GA) GA, SEFAZ Pedidos recebidos NF-e ou NFC-e emitidas, Logs
Cenários de Erro e Exceção GA, GV Erros de sincronização, inconsistências Mensagens ao usuário, Logs, Marcações de inconsistência

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. 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).

2. 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.

3. Sincronização de Vendas (GV → GA)

  • Todos os pedidos devem ser integrados sem perda de dados.
  • Pedido no GA deve refletir fielmente produto + variação + complemento.
  • Alterações no GA (quantidade, forma de pagamento, preço) devem ser aceitas.
  • Logs devem registrar número de pedidos recebidos, integrados e rejeitados.

4. Emissão Fiscal (GA)

  • Deve ser possível gerar NF-e e NFC-e a partir dos pedidos recebidos.
  • Dados fiscais devem respeitar CFOP, NCM, CST/CSOSN e tributações.
  • Em caso de rejeição (ex.: falta de NCM), sistema deve permitir correção e reemissão.
  • Logs devem registrar emissões, rejeições e correções.

5. Cenários de Erro e Exceção

  • Produto inativo → não deve aparecer no GV.
  • Venda offline no GV → deve ser armazenada localmente e enviada quando houver rede.
  • Pedido duplicado → não deve ser integrado em duplicidade no GA.
  • Pedido com valor divergente (preço atualizado no GA após venda) → pedido deve ser recebido e marcado como “inconsistente”.

  •  

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.

  • 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.

GA (Recebimento das Vendas)

  • Ajustar integração para receber pedidos com:

    • Produto principal.

    • Variação selecionada.

    • Complementos escolhidos.

  • Permitir edição no pedido (quantidade, forma de pagamento, preço).

  • Gerar documentos fiscais:

    • NF-e (para atacado/distribuição).

    • NFC-e (para varejo/food-service).

  • Implementar fila de reenvio em caso de falha na SEFAZ.

Cenários de Teste

  1. Food-Service: Pizza Média + borda recheada → venda no GV, sincronização, edição no GA, emissão de NFC-e.

  2. Atacado: Cerveja pack 12 unid → venda no GV, sincronização, alteração de preço no GA, emissão de NF-e.

  3. Varejo: Camiseta Polo G Azul → venda no GV, sincronização, alteração de forma de pagamento no GA, emissão de NFC-e.

  4. 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.

©SOFTEN SISTEMAS 2025

 

 

 

 

No Comments
Back to top