Nova Página

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

Especificação Funcional

Protótipo de Tela:

Descrição dos Campos:

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