**Projeto/Sistema:**
[Evolução do Produto GA - Interno](https://docs.softensistemas.com.br/shelves/evolucao-do-produto-ga-interno)
**Versão do *Template:***1.1
**Processo:**
Tela de listagem de receitas a receber
**Versão do Documento:**1.0
**Responsável(eis):**
Jalile Cornachioni
**Data:** 08/08/2025
#### **1. Objetivo geral:**
Contas a Receber do módulo Financeiro foi redesenhado para melhorar a clareza das informações, reduzir tempo de operação, evitar frustrações comuns relatadas por usuários e garantir boas práticas do mercado.
#### **2. Impacto previsto:**
\#1 - Tela de listagem de receitas a receber
\#2 - Tela de nova receita
\#3 - Tela de visualização
\#4 - Tela de edição da receita
\#5 - Tela de recebimento
\#6 - Ação baixa por perda
#### **3. Descrição das alterações**
**\#1. Tela de listagem de receitas a receber**
- Tornar a experiência mais intuitiva e eficiente.
- Expor indicadores financeiros de forma clara e visual.
- Facilitar buscas com filtro dinâmico multi-coluna.
- Destacar acesso rápido a ações relevantes (recebimento, remessa, retorno).
- Reduzir o número de cliques para ações rotineiras.
##### **3.1 Header:**
Deve apresentar o título da tela, caminho acessado e botão de nova receita *\[funcionalidade existente - manter\]*
##### **3.2 Cards com indicadores financeiros que servem de filtro** *\[funcionalidade nova\]*
*[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-08/modelo-68-1.png)*
**Descrição**: Conjunto de quatro cards que apresentam indicadores financeiros do módulo Contas a Receber. Cada card exibe: Título (status financeiro), Valor total (formato monetário), Quantidade de contas (texto cinza, no formato “X contas”), com texto é alinhado à esquerda e os ícones ficam no canto superior direito.
**Configuração visual e cores:**
- - - Vencidas – vermelho (#DB102B) – ícone de alerta.
- A Vencer – amarelo (#FFB300) – ícone de relógio.
- Recebidas – verde (#009966) – ícone de check.
- Total Geral – azul (#044572) – ícone de cifrão.
**OBS**.: todos os ícones estão dentro de um círculo de mesma cor com 10% de opacidade.
**Função**: Fornecer ao usuário um resumo visual e quantitativo da situação financeira atual e servir como filtro interativo, permitindo que o usuário visualize apenas os registros da grid correspondentes ao(s) card(s) selecionado(s).
**Comportamento**:
- - - Estado inicial (dependente da data de vencimento padrão)
- O sistema deve considerar a data de vencimento vinda do filtro como referência (por padrão, data atual do sistema – today).
- Se existirem registros para o período filtrado:
- Todos os cards correspondentes aos status encontrados são carregados selecionados e coloridos.
- A grid exibe os registros de todos os cards selecionados.
- Se não existirem registros para um status na data filtrada:
- O card é carregado desmarcado e exibido em cinza (estilo “desabilitado”).
- A grid não exibe registros desse status.
- Caso nenhum card tenha registros para a data filtrada (ex.: domingo sem títulos):
- Todos os cards carregam em cinza/desabilitado.
- A grid permanece vazia.
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-08/modelo-78.png)
**Interação:** Cada card funciona como um checkbox visual:
- Selecionado: cor ativa e registros exibidos na grid.
- Desmarcado: cor cinza e registros ocultos.
- É possível selecionar ou desmarcar múltiplos cards simultaneamente para refinar a exibição.
**Atualização dinâmica**
- Ao alterar o período de vencimento no filtro e aplicar, O sistema recalcula quais cards têm registros.
- Aplica automaticamente o estado colorido/ativo ou cinza/inativo.
- Atualiza a grid em tempo real.
#####
##### **3.3 Sessão de filtros** *\[funcionalidade existente - manter conforme protótipo\]*
**Descrição**: Copmonente de filtro apresentado dentro de um painel expansível, porém carregado aberto por padrão (default expanded). Os campos incluídos são: Tipo data, Período, Conta e Filtro de Informações.
**Função**: Agrupar elementos de formulário de filtros, permitir que o usuário restrinja ou amplie os resultados exibidos na listagem e Aplicar os critérios selecionados.
**Comportamento**: Estado inicial = Painel de filtros expandido (expanded) ao carregar a tela.
Campos e valores padrão:
- Tipo data = Vencimento
- Campo “Data inicial”: pré-preenchido com data atual do sistema (today).
- Campo “Data final”: pré-preenchido com data atual do sistema (today).
- Validação: data final não pode ser anterior à inicial.
- Conta (dropdown) - Valor padrão: “Todas”.
- Filtro de Informações: Campo de texto = vazio por padrão.
- Dropdown lateral: valor padrão “Cliente”.
- Botão de busca (ícone lupa) dispara aplicação dos filtros.
**Ações do usuário**
Alterar qualquer campo e clicar no botão de busca para atualizar a listagem.
Contrair o painel para ganhar espaço visual na tela (estado collapsed).
Reabrir o painel para novos ajustes de filtros.
Persistência: Caso a tela seja recarregada, os filtros retornam aos valores padrão acima (não há persistência entre sessões).
##### **3.4 Grid de listagem de registros**
**Função**: Facilitar o acesso às operações mais utilizadas pelo usuário, reduzir o número de cliques necessários para executar ações recorrentes e centralizar as principais ferramentas de trabalho da tela.
**Descrição e Comportamento**: A Grid devfe conter o título "Lista de COntas a Receber" e botões de acesso rápido:
- **Receber** – Ação para registrar recebimento de títulos. Estado inicial: desabilitado e habilita quando o usuário selecionar ao menos um título.
- **Remessa** – Geração de arquivo de remessa bancária. Estado inicial: desabilitado e habilita quando o usuário selecionar ao menos um título.
- **Retorno** – Importação de arquivo de retorno bancário. Abre dialog para importação de arquivo.
- **Relatórios** – Acesso rápido a relatórios financeiros. Abre dialog com lista de relatórios existentes.
- **Ações em Lote** – Dropdown com múltiplas ações aplicáveis aos registros selecionados. Estado inicial: desabilitado e habilita quando o usuário selecionar ao menos um título.
- **Filtros** – Botão para expandir/contrair painel de filtros.
- Estado inicial: todos os filtros selecionados, caso deseje, o usuário poderá desmarcar.
- Filtros são combináveis entre si (ex.: “Com anexos” + “Registrados” + "Sem Registros).
- **Exibição** – Mostra quais colunas da grid o usuário pode exibir ou ocultar.
- Estado inicial: Colunas ocultas por padrão: "Juros/Receita", "Transferências" e "Categoria/Plano"
- A ordem das opções deve seguir a ordem das colunas.
##### **3.5 Coluna situações:**
**Descrição**: Coluna adicionada à Lista de Contas a Receber, exibe até dois ícones representando atributos específicos de cada título, sendo Regsitrado e Anexo.
**Função**: Apresentar de forma compacta e visual o estado de dois informações relevantes para cada título: Se o título está registrado em banco e se existem anexos vinculados.
**Comportamento**:
- - Registros: opções Registrados (azul) / Não registrados (cinza)
- Anexos: opções Com anexos (azul) / Sem anexos (cinza)
OBS.:
- Todos os títulos devem possuir ambos ícones (papelzinho e clips) com o padrão de de cores azul para situação ativa e cinza para a negativa.
- Manter o comportamento de permitir apenas 1 anexo. Caso o usuário deseje importar outro anexo, o primeiro será sobrescrito.
- Ícones ativos possuem a cor correspondente e exibem tooltip ao passar o mouse (por exemplo: "Agendado", "Com anexos", "Registrado").
##### **3.6 Footer**
**Descrição**: Localizado na parte inferior da tabela Lista de Contas a Receber. Deve exibir itens por página com opções pré-definidas 15, 50 e 100 registros, Paginação numérica para navegar entre as páginas. O valor 15 está definido como padrão de carregamento inicial.
**Função**: Controlar quantos registros são exibidos simultaneamente na grid, permitir navegação entre páginas de forma sequencial ou direta (selecionando um número da paginação), otimizar o carregamento e a performance da tela, evitando que todos os registros sejam carregados de uma só vez.
**Comportamento**:
- Quantidade de registros
- Por padrão, a grid carrega 15 registros por página.
- Ao selecionar 50 ou 100, o sistema recarrega a grid exibindo mais linhas sem alterar o estado dos filtros ou dos cards.
- Rolagem da tela inteira
- A grid não possui scroll interno; a rolagem é aplicada à tela inteira.
- Isso significa que, ao rolar para baixo, o usuário perde de vista o header com os filtros e os cards, dificultando a referência visual.
#### 4. Link do Protótipo
[Listagem de contas a receber](https://www.figma.com/design/mN0I8GyW16Nio4YwGf82b1/Melhorias-Clarity?node-id=1228-7753&t=RBp8ymjuXrcElwls-0)
**Projeto/Sistema:**
[Evolução do Produto GA - Interno](https://docs.softensistemas.com.br/shelves/evolucao-do-produto-ga-interno)
**Versão do *Template:***1.1
**Processo:**Tela nova receita
**Versão do Documento:**1.0
**Responsável(eis):** Jalile Cornachioni
**Data:** 14/08/2025
#### **1. Objetivo geral:**
Contas a Receber do módulo Financeiro foi redesenhado para melhorar a clareza das informações, reduzir tempo de operação, evitar frustrações comuns relatadas por usuários e garantir boas práticas do mercado.
#### **2. Impacto previsto:**
\#1 - Tela de listagem de receitas a receber
\#2 - Tela de nova receita
\#3 - Tela de visualização
\#4 - Tela de edição da receita
\#5 - Tela de recebimento
\#6 - Ação baixa por perda
#### **3. Descrição das alterações**
**\#2 - Tela de nova receita**
A tela de Nova Receita tem como objetivo permitir que o usuário cadastre rapidamente um novo lançamento no Contas a Receber, informando os dados essenciais. Reposicionamos os campos obrigatórios e mais utilizados para o topo da tela, facilitando o acesso e acelerando o preenchimento. Embora a funcionalidade em si não tenha mudado, o layout foi modernizado para melhorar a experiência do usuário e reduzir o tempo de operação.3.1 **Header – Informações da Receita**
- **Título:** Nova Receita - Identificação visual da área de cadastro da receita.
- **Campos obrigatórios e prioritários**: Cliente, Número do Documento, Descrição, Conta, Categoria, Data de Vencimento, Forma de Pagamento e Valor da Receita.
- **Valores default**: Conta = "Caixa Fìsico" e Forma de Pagamento = "Dinheiro".
- **Indicador de status**: Selo “A Vencer” posicionado no topo direito, em amarelo (#FFB300).
**3.2. Grid – Repetição de Lançamentos**
- **Campos de configuração**: Quantidade de lançamentos e período de repetição (ex.: mensal).
- **Tabela de parcelas**: Lista com número da parcela e respectiva data de lançamento.
- **Controles de expansão/retração**: Permitem ocultar ou exibir detalhes dessa seção.
**3.3. Rodapé – Informações Adicionais e Ações**
- **Campo de observação**: Área livre para comentários e detalhes adicionais.
- **Upload de comprovante**: Botão “Adicionar Comprovante” com instruções de formato e tamanho de arquivo.
- **Botões de ação**: “Salvar e Fechar” e “Salvar e Receber”, posicionados para finalização rápida da operação.
**3.4 Comportamento geral da tela:**
No estado inicial, a sessão "informações da receita" deve estar no estado **expanded** (aberto) e os demais accordions renderizados em estado **collapsed** (fechados), exibindo apenas o header de cada seção. O usuário pode expandir ou retrair cada accordion de forma independente, conforme sua necessidade.
#### 4. Link do Protótipo
[Listagem de contas a receber](https://www.figma.com/design/mN0I8GyW16Nio4YwGf82b1/Melhorias-Clarity?node-id=1237-11958&t=HeIk5uatZMUwchFe-0)
**Projeto/Sistema:**
[Evolução do Produto GA - Interno](https://docs.softensistemas.com.br/shelves/evolucao-do-produto-ga-interno)
**Versão do *Template:***1.1
**Processo:**
Tela de visualização da receita
**Versão do Documento:**1.0
**Responsável(eis):** Jalile Cornachioni
**Data:** 08/08/2025
#### **1. Objetivo geral:**
Contas a Receber do módulo Financeiro foi redesenhado para melhorar a clareza das informações, reduzir tempo de operação, evitar frustrações comuns relatadas por usuários e garantir boas práticas do mercado.
#### **2. Impacto previsto:**
\#1 - Tela de listagem de receitas a receber
\#2 - Tela de nova receita
\#3 - Tela de visualização
\#4 - Tela de edição da receita
\#5 - Tela de recebimento
\#6 - Ação baixa por perda
#### **3. Descrição das alterações**
**\#3. Tela de visualização da receita**
O objetivo da criação desta nova tela de detalhes da receita é centralizar a visualização completa das informações de um título no Contas a Receber em um formato não editável por padrão, garantindo mais segurança contra alterações acidentais, padronizando o fluxo de consulta e edição conforme o status do título e as permissões do usuário.
Além disso, ela permite acesso rápido a anexos, histórico e dados complementares, servindo como um ponto único de consulta antes de qualquer ação de edição ou recebimento, reduzindo erros operacionais e aumentando a rastreabilidade das mudanças.
##### 3.1 Detalhes da tela
**3.1.1 Header (Cabeçalho)**
**Objetivo**: Apresentar de forma clara a identificação do título, status e ações principais.
- **Título da página:** Label: "Receita \[Número da Receita\]" (ex.: Receita 12345-1/3)
- **Ícone** **indicando registro e anexo:** Icon de boletinho para indicar registro e clips para títulos com anexo.
- **Status do título:** Label: "À vencer", "Vencido", "Recebido"
- **Informações de criação**: Label: "Criado em \[Data\] por \[Usuário\]"
- **Botões de ação:** Editar (ícone de lápis), Receber (ícone de confirmação/pagamento),
- **Ações:** (menu dropdown com opções adicionais.)
***Obs.:*** *O botão "**receber**" muda para "**estornar**" quando o **status** do título for "**recebido**".*
*O dropdown deve oferecer ações de acordo com a regras de status já existentes, adicionar ação de "excluir" e "baixa como perda" - estes status devem estar ativos/inativos conforme permissão do usuário.*
**3.2.2. Grid (Corpo da tela)**
**Objetivo**: Exibir todos os dados da receita de forma organizada em blocos de informação.
Bloco 1:
- **Cliente**: Label: "Cliente" – valor: nome do cliente
- **Número Documento:** Label: "Número Documento" – código ou número de referência
- **Descrição**:
- **Conta**: Label: "Conta" – conta bancária vinculada
- **Categoria**: Label: "Categoria" – categoria da receita (ex.: Alimentício)
- **Forma de Pagamento**: Label: "Forma de Pagamento" – ex.: Dinheiro, Pix, Cartão etc.
- **Data de Vencimento:** Label: "Data de Vencimento" – valor formatado (DD/MM/AAAA)
- **Valor da Receita**: Label: "Valor da Receita" – valor em moeda
**OBS**.: em alguns casos exibir o campo: "Juros adicional do boleto", de acordo com a configuração da conta selecionada.
Bloco 2
- Alterações de Valores: área de texto exibindo campos que alteram o valor, seja por juros, desconto, etc.
- **Valor Original; Juros/Multa; Desconto; Valor**
Bloco 3 e 4
- **Informações Adicionais**: área de texto exibindo a descrição ou observações complementares
- **Anexos**: Miniatura/listagem de anexos: com botão "Abrir anexo"
#####
##### 3.2 Comportamento geral e regras da tela
A tela de visualização de receita deve ser exibida em modal sempre que o usuário clicar em qualquer registro da listagem do contas a receber.
Todos os botões devem estar habilitados para interação, independente do status do título.
Esta tela não deve permitir edição, a não ser que o usuário clique no botão "editar". Ao clicar em "**editar**" deve-se aplicar regras conforme os seguintes cenários:
**Regras mandatórias:**
- Usuário super\_admin:
- Permissão de usuário "Financeiro > Contas a Receber":
- Permissão de usuário "Financeiro > Alterar Contas A Receber":
- Permissão de usuário "Financeiro > Alterar Valor A Receber":
**Cenário 1 – Títulos vencidos e a vencer :** Abrir diretamente no **modo edição.**
**Cenário 2 – Títulos abertos, porém registrados:** Abrir tela de visualização e executar as seguintes validações:
- 1. **Se usuário Admin** → edição completa, sem restrições.
2. **Se usuário Não-admin com todas as permissões** → edição de tudo, exceto valores.
3. **Se usuário Não-admin com permissões parciais** → respeitar restrições de acordo com o módulo financeiro.
4. **Se usuário Sem permissão** → exibir mensagem de bloqueio: "Este título já está registrado. Caso precise modificar informações bloqueadas, entre em contato com um administrador."**Cenário 3 – Títulos recebidos:**
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-08/modelo-97.png)
- Permitir apenas visualização;
- Sessão: Informações do recebimento
- Valor recebido, Data de pagamento, Juros, Multa.
- ao clicar em "**editar"**, o sistema deve exibir aviso sobre necessidade de estorno: "Não é possível alterar o vencimento ou valor de um título já recebido. Para prosseguir, realize o estorno do recebimento e tente novamente."
##### 3.3 Registro em Log
Para garantir rastreabilidade e auditoria das ações realizadas no sistema, toda operação de alteração em títulos deve gerar um registro em log contendo, no mínimo, os seguintes campos:
- **Data/Hora da ação** – momento exato em que a alteração foi realizada.
- **Usuário** – identificação única do usuário (ID) e nome completo responsável pela ação.
- **Status anterior e novo do título** – somente quando houver alteração de status.
- **Lista de campos alterados** – exibição dos campos modificados com seus respectivos valores **antes** e **depois** da edição.
#### 4. Link do Protótipo
[Listagem de contas a receber](https://www.figma.com/design/mN0I8GyW16Nio4YwGf82b1/Melhorias-Clarity?node-id=1179-14456&t=PhzbfGCD7RnbTIyN-0)
Contas a Receber do módulo Financeiro foi redesenhado para melhorar a clareza das informações, reduzir tempo de operação, evitar frustrações comuns relatadas por usuários e garantir boas práticas do mercado.
#### **2. Impacto previsto:**
\#1 - Tela de listagem de receitas a receber
\#2 - Tela de nova receita
\#3 - Tela de visualização
\#4 - Tela de edição da receita
\#5 - Tela de recebimento
\#6 - Ação baixa por perda
#### **3. Descrição das alterações**
**\#4 - Tela de edição da receita**
O objetivo da nova tela de edição da receita é restringir a alteração de campos sensíveis, garantindo maior segurança dos dados financeiros e evitando inconsistências em relatórios. Diferente do modelo atual, que permite editar todas as informações, a edição passa a respeitar o status do título (à vencer, vencido, recebido e perdido) e as permissões do usuário, permitindo apenas ajustes realmente necessários, como observações, comprovantes ou variações de valores autorizadas. Essa mudança fortalece a confiabilidade do sistema e cria a base para o novo fluxo de **baixa por perda**, assegurando rastreabilidade entre títulos recebidos, em aberto e insolventes.
##### 3.1 Detalhes da tela
**3.1.1 Header (Cabeçalho)**
**Objetivo**: Apresentar de forma clara a identificação do título, status e ações principais.
- **Título da página:** *Editar Receita* \[Número da Receita\]" (ex.: Receita 12345-1/3)
- **Ícone** **indicando registro e anexo:** Icon de boletinho para indicar registro e clips para títulos com anexo.
- **Status do título:** Label: "À vencer", "Vencido", "Recebido"
- **Informações de criação**: Label: "Criado em \[Data\] por \[Usuário\]"
**3.1.2 Informações da Receita**
- **Cliente** (campo bloqueado, apenas visualização).
- **Número do Documento** e **Descrição**.
- **Conta**, **Categoria**, **Forma de Pagamento**.
- **Data de Vencimento**.
- **Valor da Receita** (com validações de edição).
- **Acréscimo de boleto** (respeitando a configuração da conta seleiconada"
**3.1.3 Alterações de valores**
- **Valor Original** (bloqueado).
- **Juros/Multa** (editável conforme status).
- **Desconto** (editável conforme status).
- **Valor da Receita final** (cálculo automático com destaque).
**3.1.4 Informações adicionais**
- **Observação** (texto livre).
- **Comprovantes**: upload de arquivos (limite de tamanho, extensões permitidas, múltiplos anexos).
**3.1.5 Botões de ação:**
- **Salvar e Fechar:** Salva alterações e fecha a tela voltando para a tela de listagem de receitas
- **Salvar e Receber:** Salva alterações e abre tela de recebimento
#### 4. Link do Protótipo
[Listagem de contas a receber](https://www.figma.com/design/mN0I8GyW16Nio4YwGf82b1/Melhorias-Clarity?node-id=1419-155690&t=XX8Nhdwwthgoc6e0-0)
**Projeto/Sistema:**
[Evolução do Produto GA - Interno](https://docs.softensistemas.com.br/shelves/evolucao-do-produto-ga-interno)
**Versão do *Template:***1.1
**Processo:**
Recebimento
**Versão do Documento:**1.0
**Responsável(eis):** Jalile Cornachioni
**Data:** 20/08/2025
#### **1. Objetivo geral:**
Contas a Receber do módulo Financeiro foi redesenhado para melhorar a clareza das informações, reduzir tempo de operação, evitar frustrações comuns relatadas por usuários e garantir boas práticas do mercado.
#### **2. Impacto previsto:**
\#1 - Tela de listagem de receitas a receber
\#2 - Tela de nova receita
\#3 - Tela de visualização
\#4 - Tela de edição da receita
\#5 - Tela de recebimento
\#6 - Ação baixa por perda
#### **3. Descrição das alterações**
**\#5 - Tela de recebimento**
A tela de **Recebimento de Receita** foi modernizada para oferecer uma experiência mais clara e eficiente no processo de baixa de títulos, permitindo tanto o recebimento unitário quanto múltiplo. A nova interface organiza informações essenciais (valor original, multa, juros, desconto, acréscimos e valor final a receber) de forma intuitiva
##### 3.1 Detalhes da tela
**3.1.1 Header (Cabeçalho)**
- **Título**: “Receber Conta”
**3.1.2. Dados de Recebimento**
- **Data Recebimento** (campo obrigatório): campo de data com calendário para seleção.
- **Conta**: lista suspensa para escolha da conta de destino (ex.: Caixa, Banco).
- **Categoria**: campo de seleção para classificação do recebimento (vinculado ao plano de contas).
**3.1.3. Referente a estes pagamentos (Tabela de Títulos)**
- Tabela listando os títulos selecionados para recebimento, com as seguintes colunas:
- **Desc./Cliente**: identificação do cliente ou descrição da receita.
- **Nº Documento:** número do título/documento.
- **Vencimento**: data de vencimento do título.
- **Valor Original:** valor principal do título.
- **Multa:** campo editável para inserção de multa.
- **Juros**: campo editável para juros aplicados.
- **Desconto**: campo editável para descontos concedidos.
- **Acréscimo**: campo editável para acréscimos manuais.
- **Valor a Receber:** cálculo automático do valor final considerando os ajustes.
**3.1.4. Ações do Rodapé**
- **Cancelar**: retorna para a tela anterior sem efetivar o recebimento.
- **Receber**: confirma a operação de baixa, aplicando os valores informados.
##### 3.2 Comportamento geral da tela:
A tela deve abrir em modo edição com os campos:
- **Data recebimento** deve ser atribuído data atual e respeitar a configuração FInanceiro > **Proibir lançamentos com data retroativa**", ou seja, habilitar somente se este campo estiver desmarcado na configuração adicional do sistema.
- Todos os **demais campos** dever estar habilitados para edição, respeitando as configurações de usuário.
- Ao imputar valor nos campos de acréscimo, juros/multa e/ou desconto o sistema deve recalcular o valor no campo "Valor a receber" (manter o funcionamento atual)
#### 4. Link do Protótipo
[Listagem de contas a receber](https://www.figma.com/design/mN0I8GyW16Nio4YwGf82b1/Melhorias-Clarity?node-id=1071-9524&t=Eo7tNRbyUowwOwTA-0)