NFC-e

Introdução

Introdução

Lista de item pré-validação de layout


 Softensistemas Logo

 Projeto/Sistema:
Evolução do produto - NFC-e		 Versão do Template:
1.1
Processo:
Remodelagem de Telas de listagem e emissão de NFC-e		 Versão do Documento:
1.0
Responsável(eis): 
Jalile (P.O), Gustavo (UX)

Data: 

22/07/2025
1. Introdução

Este documento descreve o processo de 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 e do backend, foram definidas melhorias estruturais para atender às necessidades de negócio e garantir uma navegação mais intuitiva e ágil. O foco principal é facilitar a busca e filtragem de notas fiscais, otimizar a visualização dos dados e adequar os processos técnicos para assegurar maior estabilidade e desempenho.

2. Processo (adicionar fluxograma exemplo)

 

Dificuldades do Cliente:

Melhorias na Interface:

Regras de Backend Mantidas:

Ajustes de Backend Requisitados:


Processos Relacionados

Documentação Exemplo 1 

Documentação Exemplo 2

Especificação Funcional

PROC001 EXEMPLO:

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. Exemplo de regras de negócio (Exemplo de calculo imposto):
Descrição das regras de negócio envolvendo o processo, como cálculos, ações em botões e outras regras envolvendo a lógica por trás do processo.

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

 

 

 

 

Melhorias propostas

Melhorias propostas

Tela de listagem de NFC-e


 Softensistemas Logo

 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:

 

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

Modelo 101.png

---Opções de ações em lote e ações individuais ---

Modelo 102.png

Modelo 142.png

 

--- Filtros ---

Modelo 145.png

--- Tela de listagem sem dados ---

Modelo 143.png

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:

    1. Ao clicar no campo, o painel se expande exibindo as opções pré-definidas à esquerda e os dois calendários à direita.

    2. A seleção de qualquer opção pré-definida automaticamente preenche as datas inicial e final.

    3. Caso o usuário altere manualmente as datas, a seleção muda para “Personalizado”.

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

    5. 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:

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:

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:

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

    1. Série

      • Campo numérico para digitar o número da série da NFC-e.

    2. Nº Fiscal

      • Campo numérico para informar o número específico da nota fiscal.

    3. Finalidade

      • Campo do tipo dropdown (selecione uma opção), onde o usuário escolhe a finalidade da nota (ex: Normal, Devolução, Ajuste).

    4. Cliente

      • Campo do tipo dropdown com pesquisa para seleção do cliente associado à nota.

    5. Status

      • Grupo de botões seletivos (tipo toggle) com múltipla seleção possível:

        • Autorizado

        • Cancelado

        • Inutilizado

        • Erro

        • Não Enviado

Comportamento

 

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:
  1. Exibição de NFC-es com status e valores destacados:

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

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

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

3. ordenação nas colunas deverá ser mantida conforme comportamento atual

 

 

 

©SOFTEN SISTEMAS 2025

 

 

 

 

Melhorias propostas

Reformulação NFC-e


 Softensistemas Logo

 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

2. Contexto e Justificativa

3. Escopo

O que está dentro do escopo (incluído):
O que está fora do escopo (excluído):
Principais entregas esperadas:

4. Público-Alvo / Usuários

5. Requisitos

Requisitos Funcionais
Requisitos Não Funcionais

6. Fluxos / Processos

Passo a passo esperado do funcionamento:
Casos de uso:

Listagem dos campos da tela de listagem:

Cabeçalho

Cards Resumo (Status Financeiro das Notas)

Filtros e Busca

Barra de Ações Secundárias

Tabela NFC-e

Rodapé da Tabela

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
Aba Itens

Seção Adicionar Produto

Seção Itens do Cupom

Aba Identificação

Seção: Informações do Comprador

Seção: Emissão da NFC-e

Aba Pagamentos

Seção: Adicionar Pagamento

Seção: Tabela de Pagamentos

Aba Totais

Seção: Impostos e Totais

Seção: Detalhamento de Impostos

7. Integrações

8. Restrições

9. Critérios de Sucesso

10. Anexos / Referências

©SOFTEN SISTEMAS 2025