Nova Página 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 é: Ampliar a sincronização GA → GV para incluir ProdutoVariacaoItem e ProdutoComplemento. Permitir no GV a seleção de variações e complementos no fluxo de venda. Garantir a volta das vendas GV → GA com consistência. Viabilizar emissão de documentos fiscais no GA a partir das vendas sincronizadas. Registrar logs completos, tratar erros e exceções. Ajustar usabilidade: busca, código de barras e listagem por categorias. 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 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 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: Produto sem NCM → rejeição fiscal. Código de barras duplicado → exibir lista de escolha. Venda offline → reenvio após reconexão. ©SOFTEN SISTEMAS 2025