Melhorias propostas Tela de listagem de NFC-e Projeto/Sistema:MELHORIAS PROPOSTAS NA NFC-E Versão do Template:1.1 Processo:TELA DE LISTAGEM DE NFC-E Versão do Documento:1.2 Responsável(eis): Jalile Cornachioni Data: 21/10/2025 1. Introdução Com o objetivo de melhorar a usabilidade, a clareza visual e a eficiência na navegintelação, foi realizada uma atualização no layout da tela de listagem de Notas Fiscais do Consumidor Eletrônicas (NFC-e). A nova interface traz uma experiência mais moderna e organizada, com foco na simplificação das ações mais utilizadas pelos usuários. 2. Resumo dos novos componentes da Tela de Listagem de NFC-e Detalhamento de campos: Botão Nova NFC-e Totalizadores por status Label indicador de ambiente Label indicador de certificado digital Campo Seletor de período - default "hoje" Campo de Busca Inteligente Filtro por status Grid de registros filtrados Botões de ações rápidas e ações em lote Ações individuais Rodapé com totalizador de itens por páginas e seletor de quantidade pré-definida de registros Observações: Mudanças apenas de design, ou seja, fluxos complementares  não sofrerão alteração. Visualização em grade/card será feito como pós-mvp 3. Especificação Funcional Protótipo de Tela: Listagem de NFC-e --- Tela inicial --- ---Opções de ações em lote e ações individuais --- --- Filtros --- --- Tela de listagem sem dados --- Descrição dos Componentes da Tela: # Campo Placeholder Valor Default 1 Campo Seletor de período Hoje Hoje 2 Campo de Busca Inteligente Busque por Número Fiscal, CPF/CNPJ ou nome do cliente Vazio 3 Filtros 4 Rodapé de Seleção Dinâmica inexistente Vazio 5 Toast Alert – Visualização em Grade/Card Em Breve Em Breve Regras de Interface: 1. Label imdicador do ambiente 1. Campo Seletor de Período: Descrição do comportamento: O campo "Seletor de Período" permite ao usuário definir um intervalo de tempo para consultar registros conforme datas específicas. Por padrão, a opção "Hoje" será selecionada automaticamente, exibindo os dados correspondentes à data atual sem necessidade de interação inicial. Comportamentos Esperados: Ao clicar no campo, o painel se expande exibindo as opções pré-definidas à esquerda e os dois calendários à direita. A seleção de qualquer opção pré-definida automaticamente preenche as datas inicial e final. Caso o usuário altere manualmente as datas, a seleção muda para “Personalizado”. A Data Final não pode ser anterior à Data Inicial – nesse caso, deve ser exibida uma mensagem de erro amigável e a seleção impedida. Se nenhuma data for selecionada e o usuário tentar aplicar o filtro, o sistema deve assumir o valor default (“Hoje”). Cenários Negativos e Possíveis Erros: Data Final anterior à Inicial: Mensagem sugerida: "A data final deve ser igual ou posterior à data inicial." Tratamento: bloqueia aplicação do filtro até correção. Datas fora do intervalo permitido pelo sistema (ex: muito antigas ou futuras): Mensagem sugerida: "Selecione um período válido entre [data mínima] e [data máxima]." Erro ao carregar registros (ex: falha na API após seleção): Mensagem sugerida: "Não foi possível carregar os dados para o período selecionado. Tente novamente." Usuário esquece de confirmar o intervalo personalizado: Tratamento sugerido: manter botão de “Aplicar Filtro” visível e desabilitado até que um intervalo válido esteja completo. 2. Campo de Busca Inteligente Descrição do comportamento: Este campo tem a função de localizar Notas Fiscais de Consumidor Eletrônicas (NFC-e) com base em uma das seguintes chaves: Número Fiscal CPF/CNPJ Nome do Cliente O campo possui o placeholder padrão: “Busque por Número Fiscal, CPF/CNPJ ou nome do cliente” Detecção automática: Ao digitar qualquer valor, o sistema identifica automaticamente o tipo de chave com base no formato da entrada. Assim, o seletor de filtro é atualizado automaticamente (indicando se a busca foi interpretada como CPF, CNPJ, nome ou número fiscal), sem exigir que o usuário faça essa escolha manualmente. Casos inválidos: Se o valor digitado não corresponder a nenhum formato válido reconhecido, o sistema: Não executa a busca Pode exibir uma mensagem de alerta ou orientação ao usuário (ex: “Formato inválido. Digite um CPF, CNPJ, número fiscal ou nome válido.”) Esse comportamento evita buscas sem critério e garante que apenas dados válidos sejam processados. 3. Filtros Descrição do comportamento: O componente de Filtros da tela de Nota Fiscal de Consumidor Eletrônica (NFC-e) é um painel flutuante e interativo, posicionado à direita da interface, que permite ao usuário refinar os dados exibidos na listagem. Ele é acessado por meio do botão com ícone de funil. Ao clicar, o painel de filtros se expande sobre a listagem, sem redirecionamento de tela. Campos Disponíveis Série Campo numérico para digitar o número da série da NFC-e. Nº Fiscal Campo numérico para informar o número específico da nota fiscal. Finalidade Campo do tipo dropdown (selecione uma opção), onde o usuário escolhe a finalidade da nota (ex: Normal, Devolução, Ajuste). Cliente Campo do tipo dropdown com pesquisa para seleção do cliente associado à nota. Status Grupo de botões seletivos (tipo toggle) com múltipla seleção possível: Autorizado Cancelado Inutilizado Erro Não Enviado Comportamento Os filtros são combináveis (ex: buscar por série e status ao mesmo tempo). Ao aplicar um filtro, os totais no rodapé (autorizado, cancelado e total geral) são atualizados automaticamente com base nos dados retornados. O painel pode ser reaberto a qualquer momento para ajuste dos critérios. 4. Rodapé de Seleção Dinâmica de NFC-e Descrição do comportamento: Este campo é exibido de forma dinâmica, aparecendo somente quando o usuário ativa a opção Selecionar Múltiplos no topo da tela. Ao ativar esse modo, checkboxes surgem ao lado de cada NFC-e listada na grade. Cada vez que um registro é selecionado, seu número de identificação (ex: #12345) é automaticamente adicionado ao rodapé suspenso, separado por vírgulas. O rodapé também exibe a quantidade total de cupons selecionados e oferece ações em massa no canto direito. Caso todos os itens sejam desmarcados, o rodapé é ocultado automaticamente, voltando a exibição padrão da tela. Caso o usuário pressione o x no rodapé, todos as seleções devem ser desfeitas, o rodapé é ocultado automaticamente, voltando a exibição padrão da tela. 5. Toast Alert – Visualização em Grade/Card" Descrição do comportamento: Para antecipar e preparar os usuários para uma futura funcionalidade, será exibido um toast alert informativo ao posicionar o cursor sobre o ícone ou campo de visualização em grade/card. Esse alerta trará a seguinte mensagem:  "Em breve". Esse toast terá caráter não intrusivo e informativo, sendo exibido por alguns segundos na parte inferior da tela, garantindo que o usuário seja avisado da funcionalidade futura sem prejudicar sua navegação atual. A intenção é criar expectativa e manter o usuário informado sobre as melhorias contínuas na plataforma. Regras de Negócio: Exibição de NFC-es com status e valores destacados: A listagem de NFC-es deve exibir as notas fiscais com seus respectivos dados de forma clara e objetiva. O sistema deverá: Exibir colunas com: número da nota, número fiscal, cliente, data de emissão, finalidade, valor total, status e menu de ações. Destacar o status da NFC-e com cores específicas: Verde: Autorizada Vermelho: Rejeitada ou Cancelada Cinza: Não enviada Agrupar registros por data, com paginação. Totalizadores:Os totais exibidos no rodapé da tela devem apresentar a soma dos valores autorizados, cancelados e o total geral, com base nos itens listados (respeitando filtros aplicados). Ações de múltipla seleção:O usuário pode selecionar múltiplas notas fiscais para ações em massa, como reenvio ou cancelamento (de acordo com permissões e status da nota). 4. 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. 5. Exclusões 1. Exibição em lista: Será priorizado o desenvolvimento da visão em lista; a exibição em grade/card será feita em um pós-mvp. 2. Demais links de ação não detalhados neste documento serão mantidos com o mesmo comportamento atual 3. ordenação nas colunas deverá ser mantida conforme comportamento atual ©SOFTEN SISTEMAS 2025 Reformulação NFC-e Projeto/Sistema:GERENCIAMENTO DE PROJETOS Versão do Template:1.2 Processo: Reformulação NFC-e Versão do Documento:1.0 Responsável(eis): Jalile Cornachioni Data: 24/09/2025 Reformulação NFC-e 1. Informações Gerais Nome do Projeto/Produto: Reformulação da listagem e emissão de NFC-e Objetivo principal do projeto: remodelagem das telas de listagem e emissão de NFC-e no sistema GerencieAqui, com o objetivo de melhorar a usabilidade, eficiência e a experiência do usuário a partir do levantamento das dificuldades enfrentadas pelos clientes e das limitações atuais da interface, bem como adaptação ao re-design padrão do sistema. 2. Contexto e Justificativa Problema ou necessidade que originou o projeto Impactos de não resolver esse problema Oportunidades identificadas: adaptar a tela ao redesign do sistema e resolver problemas de usabilidade trazendo evidência aos campos obrigatórios e mais utilizados. 3. Escopo O que está dentro do escopo (incluído): Alteração no design geral das telas que envolvem o processo de emissão de NFC-e; Tela de listagem: Reposicionamento de campos Reposicionamento de totalizadores e inclusão da filtragem por totalizador Agrupamento das ações em lote Ocultar coluna “finalidade” Incluir filtro adicional por tipo de lançamentos Possibilidade de exibir/ocultar colunas da grid Incluir indicador do modelo do certificado digital do cliente Tela de nova NFC-e: Agrupamento de campos em abas Aba “Itens”: aba reservada para inclusão de produto; posicionar campos conforme protótipo Manter ações: “editar” que abre a tela de informações fiscais e “excluir” Aba “Identificação”: inclusão de cliente e informações da emissão, conforme protótipo. Deve manter os valores padrão para os campos, em acordo com o comportamento atual na v5.0.18d Aba “Pagamentos”: cadastro de formas de pagamentos da NFC-e Campos devem ser mantidos conforme protótipo Exibir dados em grid em listagem, não em cards Cálculo mantido conforme comportamento atual do sistema Edição das parcelas possível dentro da própria grid Aba “Totais”: área para conferência dos valores e impostos Deve manter os totalizadores em linha e padrão de cores, conforme protótipo Ocultar totalizadores: frete e seguro Deve conter tabelas colapsáveis para cada tipo de imposto (ICMS, PIS, COFINS) Comportamento inicial: acordeon recolhido O que está fora do escopo (excluído): Este requisito não altera o comportamento atual das ações individuais ou em lote Não cria processos novos Não exclui processos Não inclui ações individuais ou em lote Não altera comportamento de tela Não impacta relatórios Principais entregas esperadas: Nova tela de listagem de NFC-e com filtros aprimorados, agrupamento e opções de personalização da grid Nova tela de emissão de NFC-e com estrutura em abas, mantendo consistência visual com o redesign Indicadores visuais mais claros para campos obrigatórios e totalizadores Inclusão de acordeons colapsados para detalhamento de impostos Consistência visual com demais módulos reformulados do sistema 4. Público-Alvo / Usuários Quem vai utilizar: Perfis principais: operador de caixa, administrativo/faturista e, em alguns casos, gestor/administrador do sistema. Principais dores e expectativas desses usuários: Reduzir erros de preenchimento na emissão Ter telas mais limpas e objetivas, com foco nos campos realmente necessários Agilidade para localizar documentos emitidos e aplicar filtros de busca Consistência visual com demais módulos do sistema 5. Requisitos Requisitos Funcionais Listagem de NFC-e com filtros adicionais (totalizadores, tipo de lançamento) Possibilidade de exibir/ocultar colunas da grid Inclusão de indicador do certificado digital Tela de emissão com estrutura em abas (Itens, Identificação, Pagamentos, Totais) Inclusão, edição e exclusão de itens conforme protótipo Grid para formas de pagamento, com possibilidade de edição direta Totalizadores visíveis e padronizados em cores Acordeons colapsados para detalhamento de impostos Requisitos Não Funcionais Usabilidade: telas alinhadas ao redesign do sistema, campos obrigatórios destacados, consistência visual e interação intuitiva Performance: carregamento de listagem e emissão em até 3 segundos em condições normais Compatibilidade: manter compatibilidade com navegadores homologados (Chrome e Edge) Segurança: respeitar regras fiscais e validações obrigatórias para emissão de NFC-e Escalabilidade: estrutura preparada para inclusão futura de novos filtros e abas 6. Fluxos / Processos Passo a passo esperado do funcionamento: Fluxo de emissão: usuário acessa “Nova NFC-e” → preenche abas (Identificação → Itens → Pagamentos → Totais) → valida informações → emite NFC-e Fluxo de listagem: usuário acessa “Listagem NFC-e” → aplica filtros (tipo de lançamento, totalizadores, colunas personalizadas) → visualiza e gerencia resultados → executa ações em lote Casos de uso: Inclusão de uma NFC-e simples com pagamento em dinheiro Inclusão de NFC-e parcelada com cartão, editando parcelas diretamente na grid Consulta de NFC-e emitida por período, filtrando por tipo de lançamento Listagem dos campos da tela de listagem: Cabeçalho Nome da empresa/usuário logado: "LAB4DEV TECHNOLOGY" Título da tela: "Nota Fiscal do Consumidor Eletrônica" Tag com o tipo de certificado: A1 ou A3 (em destaque azul) Breadcrumb: "Fiscal > Nota Fiscal do Consumidor Eletrônica" Botão de ação primária: “Nova NFC-e” (azul, canto superior direito) Cards Resumo (Status Financeiro das Notas) Autorizado: valor em verde (R$ 652,00) Pendente: valor em laranja (R$ 1.205,89) Cancelada: valor em vermelho (R$ 108,00) Total: valor em azul (R$ 1.965,89) Filtros e Busca Botão Filtros (com ícone de funil, expansível) Período de Emissão: Campo de data inicial (today) Campo de data final (today) Busca: Campo de texto com placeholder “Procure por Número Fiscal” Dropdown/selector à direita com label “Número Fiscal” Botão de busca (ícone de lupa azul) Barra de Ações Secundárias Botões: Relatórios Inutilizar Transações TEF Ações em Lote Exportar XML Enviar por E-mail Enviar ao Governo Enviar Backup Mais opções de filtros: Estoque Gerado → exibe apenas NFC-e que já tiveram movimentação/baixa de estoque registrada Não Gerado → exibe NFC-e que não geraram movimentação de estoque Contas a Receber Gerados → mostra notas que já geraram títulos no módulo de Contas a Receber Não Gerados → mostra notas que ainda não foram vinculadas Origem da Conta Venda Touch → filtra NFC-e originadas no módulo “Venda Touch” Venda → filtra NFC-e originadas pelo fluxo normal de “Venda” no sistema Incluir mais origens de venda quando houver Opções de ocultar/exibir colunas da grid: Série N° Fiscal Cliente Data Emissão Total Status Lançamentos Tabela NFC-e Colunas: Série N° Fiscal Cliente Data Emissão Total Status Lançamentos Ações Botão de ações: Exibir PDF Baixar XML Enviar ao Governo Cancelar Duplicar Estornar Financeiro Obs.: manter as opções de acordo com cada status da NFC-e Rodapé da Tabela Itens por página: dropdown (15, 50, 100) Paginação: navegação com botões (1, 2, 3, … última página) Obs.: Caso o filtro de data não retorne resultados, a tela deve ser apresentada em tons de cinza, exibindo os totalizadores com valores zerados e a mensagem padrão: “Não foram encontrados registros de Cupons Fiscais” Tela de Nova NFC-e Estrutura geral da tela Cabeçalho superior Nome da empresa/sistema Data e hora da emissão do cupom Breadcrumb: Nota Fiscal do Consumidor Eletrônica > Nova Abas de navegação: Itens, Identificação, Pagamentos, Totais Aba Itens Seção Adicionar Produto Campos: Cód. Barra, Produto, Quantidade, CFOP, Grade, Valor Unitário, Valor Total Botão: Adicionar Produto (azul, largura total) Seção Itens do Cupom Colunas: Código, Produto, CFOP, Quantidade, Valor Unitário, Valor Total, Ações Ações: Editar (lápis), Excluir (lixeira) Aba Identificação Seção: Informações do Comprador CPF/CNPJ Cliente Vendedor Data Emissão Seção: Emissão da NFC-e Tipo de Emissão Formato do DANFCE Presença do Consumidor Intermediador Observação (244 caracteres restantes) Aba Pagamentos Seção: Adicionar Pagamento Forma de Pagamento, Valor, Data de Vencimento, Parcelas, Período Botão: Adicionar Pagamento Seção: Tabela de Pagamentos Colunas: Nº Parcela, Parcelas, Forma Pgto, Valor, Data Vencimento, Ações Ações: Excluir (lixeira vermelha) Aba Totais Seção: Impostos e Totais Acréscimo (verde, ícone +) Desconto (vermelho, ícone -) Produtos (roxo, ícone caixa) Pagamentos (turquesa, ícone moeda) Troco (azul claro, ícone moeda) Total (cinza escuro/azul, ícone cifrão) Seção: Detalhamento de Impostos ICMS PIS COFINS Cada cartão com expansão/colapso (estado inicial: recolhido) 7. Integrações Mantém integração atual com SEFAZ para emissão e validação de NFC-e Não há novas integrações externas previstas 8. Restrições Utilizar exclusivamente o redesign padrão do GerencieAqui Não modificar o backend fiscal ou regras de integração com a SEFAZ Não alterar relatórios ou processos já existentes 9. Critérios de Sucesso Usuários conseguirem emitir NFC-e sem dúvidas adicionais em até 3 tentativas (testes de usabilidade) Adesão visual e funcional completa ao redesign do sistema Feedback positivo de clientes em pesquisa de satisfação interna 10. Anexos / Referências Protótipos de tela (figma) Padrões de redesign definidos pela equipe de produto ©SOFTEN SISTEMAS 2025