# Financeiro
# 1. Permissão de alteração de valor
# PROC001 - Nova permissão de alteração de valor da duplicata
|
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)
| **Projeto/Sistema:**
Financeiro-GerencieAqui | **Versão do *Template:***
1.2 |
| **Processo:**
PROC001 - Nova permissão de alteração de valor da duplicata | **Versão do Documento:**
1.0 |
| **Responsável(eis):**
Luís Leite | **Data:**
05/01/2026
|
##### **1. Introdução**
Este processo descreve a criação de uma permissão de usuário responsável por controlar a edição do campo **Valor Original** de títulos financeiros, aplicável aos módulos de **Contas a Receber** e **Contas a Pagar**.
| **Processo**
| **Envolvidos**
| **Dados de Entrada**
| **Dados de Saída**
|
| PROC001 - Nova permissão de alteração de valor da duplicata
| -
| Configuração alterada no usuário
| Valor da configuração salvo na base de dados
|
| PROC002 - Edição de valor da duplicata | -
| Edição de valor da duplicata
| Valor editado salvo na base
|
#### **Processos Relacionados**
- - - - - -
PROC002 - Edição de valor da duplicata
#### **Especificação Funcional**
- - - - - -
#### **PROC001 EXEMPLO:**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768321877450.png)
*Imagem I - Nova permissão*
##### ***Descrição dos Campos:***
| **Campo**
| **Tipo**
| **Tamanho**
| **Obrig. ?**
| **Máscara**
| **Observações**
|
| Alterar valor original
| *CheckBox*
| -
| -
| -
| Por padrão desmarcado
|
##### ***Regras de Negócio:***
***1.*** A permissão deve estar disponível em "Usuários e Permissões"
***2. Alterar valor original:*** Por padrão a configuração deve ficar desmarcada.
##### ***Regras de Negócio:***
***1.*** Alterações nessa permissão devem produzir efeito imediato, respeitando sessões ativas conforme padrão do sistema.
***2.*** A configuração produz efeito descrito no **PROC002 - Edição de valor da duplicata:**
- A permissão controla exclusivamente a possibilidade de edição do campo **Valor Original**.
- A permissão se aplica de forma **unificada** a:
- Contas a Receber
- Contas a Pagar
##### ***Questões Técnicas:***
***1. Deve ser criado uma nova coluna na base de dados***
```SQL
ALTER TABLE gerencieaqui.usuario ADD editaValorOriginal bit(1) default 0 NOT NULL; --0 False, 1 True
```
©SOFTEN SISTEMAS 2026
# PROC002 - Edição de valor da duplicata
|
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)
| **Projeto/Sistema:**
Financeiro-GerencieAqui | **Versão do *Template:***
1.2 |
| **Processo:**
PROC002 - Edição de valor da duplicata | **Versão do Documento:**
1.0 |
| **Responsável(eis):**
Luís Leite | **Data:**
05/01/2026
|
##### **1. Introdução**
Este processo descreve o comportamento do sistema ao permitir a edição do campo **Valor Original** de títulos financeiros (Receitas e Despesas), condicionada à permissão do usuário e ao status do título.
| **Processo**
| **Envolvidos**
| **Dados de Entrada**
| **Dados de Saída**
|
| PROC001 - Nova permissão de alteração de valor da duplicata
| -
| Configuração alterada no usuário
| Valor da configuração salvo na base de dados
|
| PROC002 - Edição de valor da duplicata | -
| Edição de valor da duplicata
| Valor editado salvo na base
|
#### **Processos Relacionados**
- - - - - -
PROC001 - Nova permissão de alteração de valor da duplicata
#### **Especificação Funcional**
- - - - - -
#### **PROC001 EXEMPLO:**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768412332408.png)
*Imagem I - Campo Valor Original Desbloqueado*
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768412593489.png)
*Imagem II - Campo Valor Original Bloqueado*
##### ***Descrição dos Campos:***
| **Campo**
| **Tipo**
| **Tamanho**
| **Obrig. ?**
| **Máscara**
| **Observações**
|
| Valor original
| -
| -
| -
| -
| -
|
| Tooltip
| -
| -
| -
| -
| -
|
##### ***Regras de Interface:***
***1.*** Deve ser adicionado um *tooltip* com a seguinte mensagem de orientação***: "O valor original poderá ser alterado apenas pelos usuário com permissão."***
***2.*** Ao abrir um titulo financeiro em modo de edição, **caso permitida a edição do valor do documento:** o campo "Valor Original" deve renderizar desbloqueado, permitindo a edição por parte do usuário habilitado. (Imagem I)
**Caso não seja permitido:** o campo deve ser renderizado bloqueado, conforme fluxo existente atualmente. (Imagem II)
3\. Ao alterar o valor original, o valor da receita/despesa também deve ser atualizado em tela.
4\. Para títulos **baixados/pagos**, o campo permanece bloqueado até a conclusão do estorno.
##### ***Regras de Negócio:***
***1.*** A validação para como será renderizado o campo será feita com base na permissão de usuário descrito no **PROC001 - Nova permissão de alteração de valor da duplicata.**
***2.*** Para documentos pagos ou recebidos, o fluxo de estorno deve ser mantido antes da liberação para a edição dos valores.
**3.** Deve ser gerado o log da mudança do valor original, exemplo: **"Valor da despesa/Receita '{descricao}' Alterado: de {valor\_antigo} para {valor\_novo}"**
##### ***Questões Técnicas:***
***1. O valor deve ser consultado e editado nas tabelas 'despesa' e 'receita' na base de dados.***
©SOFTEN SISTEMAS 2026
# 2. Pagamento múltiplo
# PROC001 - Pagamento múltiplo deve operar com controle de fluxo global
|
[](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)
| **Projeto/Sistema:**
Financeiro - GerencieAqui | **Versão do *Template:***
1.2 |
| **Processo:**
Pagamento múltiplo deve operar com controle de fluxo global | **Versão do Documento:**
1.0 |
| **Responsável(eis):**
Luís Leite | **Data:**
19/01/2026
|
##### **1. Introdução**
**Este processo visa documentar a alteração para a permissão de baixa de vários títulos parcialmente ou concedendo desconto global.**
| **Processo**
| **Envolvidos**
| **Dados de Entrada**
| **Dados de Saída**
|
| PROC001 - Pagamento múltiplo deve operar com controle de fluxo global
| | Pagamento de múltiplos documentos com desconto ou parcial
| Informação dos pagamentos armazenadas na base de dados
|
#### **Especificação Funcional**
- - - - - -
#### **PROC001 - Pagamento múltiplo deve operar com controle de fluxo global:**
##### ***Protótipo de Tela:***
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768570269920.png)
*Imagem I - Tela de pagamento em "Quitar com desconto"*
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768570286599.png)
*Imagem II - Confirmação de quitação com desconto*
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768570689285.png)
*Imagem III - Tela de pagamento em "Aplicar pagamento parcial"*
[](https://docs.softensistemas.com.br/uploads/images/gallery/2026-01/image-1768570696725.png)
*Imagem IV - Confirmação de quitação parcial*
##### ***Descrição dos Campos:***
| **Campo**
| **Tipo**
| **Tamanho**
| **Obrig. ?**
| **Máscara**
| **Observações**
|
| Data Pagamento
| Data
| -
| Sim
| dd/MM/AAAA
| |
| Conta
| SelectBox
| -
| Sim
| -
| |
| Total a Pagar
| Decimal
| 19,2
| Sim
| R$ 0,00
| |
| Quitar com Desconto
|
RadioButton
|
-
| Não
| -
| |
| Aplicar pagamento parcial
|
| Desc/Cliente
| Column
Header
| -
| -
| -
| |
| Nº Documento
| Column
Header
| -
| -
| -
| |
| Vencimento
| Column
Header
| -
| -
| dd/MM/AAAA
| |
| Valor Original
| Column
Header
| -
| -
| R$ 0,00
| |
| Multa/Juros
| Column
Header
| -
| -
| 0,00
| |
| Desconto
| Column
Header
| -
| -
| 0,00
| |
| Valor Pagamento
| Column
Header
| -
| -
| R$ 0,00
| |
| TOTAL A PAGAR
| Decimal
| -
| -
| -
| |
| DESCONTOS
| Decimal
| -
| -
| -
| |
| ACRÉSCIMOS
| Decimal
| -
| -
| -
| |
| PAGO
| Decimal
| -
| -
| -
| |
| SALDO A PAGAR
| Decimal
| -
| -
| -
| |
| Cancelar
| Botão
| -
| -
| -
| |
| Pagar
| Botão
| -
| -
| -
| |
##### ***Regras de Interface:***
1. A *Dialog* de pagamento deve ser aplicada tanto para o recebimento de múltiplos títulos (Contas a Receber) ou no pagamento de múltiplos títulos (Contas a Pagar)**.**
2. A *Dialog* só deve disponibilizar as opções globais de desconto e parcial para quando a seleção das contas serem do mesmo cliente/fornecedor. Caso contrário as opções "Quitar com desconto" e "Aplicar pagamento parcial" devem permanecer bloqueadas. Campo "Valor Total" também deve permanecer bloqueado.
Caso esteja selecionado clientes/fornecedores diferentes, dar um aviso na dialog:
Selecionados clientes/fornecedores diferentes para o recebimento.
Nessa condição, apenas o pagamento integral dos títulos é permitido.
1. **Seleção "Quitar com desconto"/"Aplicar pagamento parcial":**
Devem ser renderizadas as opções e por padrão não devem vir preenchidas. (Imagem I e Imagem III)
2. **Valor Total: **Caso o usuário preencher um valor total a pagar menor do que a soma dos titulos, automaticamente deve ser marcada a opção "Aplicar pagamento parcial".
3. As opções são excludentes, caso seja selecionada uma opção, a outra deve ser desmarcada.
4. Caso o usuário desmarque a opção selecionada, deve reverter as ações em tela renderizando os títulos e seus respectivos valores originais.
5. Deve ser utilizado o botão "recalcular" para redefinir os valores em tela, renderizando em seus estados originais.
6. **Desc/Cliente:** Deve mostrar o cliente/beneficiário do título. Deve permitir ordenação asc/desc.
7. **Nº Documento:** Deve mostrar o numero do título financeiro. Deve permitir ordenação asc/desc.
8. **Valor original:** Deve mostrar o campo de valor do título. Deve permitir ordenação asc/desc.
9. **Multa/Juros:** Campo deve mostrar o valor de multa e juros do título e também permitir o preenchimento pelo usuário caso não esteja no fluxo de ação global. Deve permitir ordenação asc/desc. Não permitir uso caso fluxo for com diferentes clientes/fornecedores.
10. **Desconto:** Campo deve mostrar o valor de desconto do título e também permitir o preenchimento pelo usuário caso não esteja no fluxo de ação global. Deve permitir ordenação asc/desc.Não permitir uso caso fluxo for com diferentes clientes/fornecedores.
11. **Valor Pagamento:** Campo deve renderizar com o valor total do título e permitir o preenchimento pelo usuário caso não esteja no fluxo de ação global. Deve permitir ordenação asc/desc.
12. **Botão Cancelar:** O evento do cliente deve encerrar a *Dialog.*
13. **Botão Pagar:** Ao ser confirmada a operação, deve ser exibida a mensagem de confirmação conforme a situação selecionada. (Imagem II e Imagem IV)
- - - Caso o Usuário selecione a opção cancelar na *Dialog* de confirmação, deve ser retornada a tela anterior.
- Caso selecione "Confirmar Quitação Parcial" ou "Quitar com desconto", se possível deve ser exibida a mensagem:
Quitação realizada!
- - - Pagamento total abaixo do valor, sem fluxo global selecionado e sem desconto:
Valor "Total a Pagar" abaixo da soma total, selecione uma opção global.
14\. Totalizadores:
- **Total Bruto:** Deve ser a soma dos títulos selecionados
- **Descontos:** Deve ser calculado com base nos descontos individuais caso não esteja no fluxo global de desconto ou então no desconto da diferença do valor pago se esse for abaixo e se estiver no fluxo de desconto global
- **Acréscimos:** Deve ser calculado com base nos acréscimos individuais caso não esteja no fluxo global ou então no acréscimo da diferença do valor pago se esse for acima.
- **Total a Pagar:** Valor da intenção de pagamento do usuário, ou o valor liquido da diferença do valor total dos títulos - desconto + acréscimos.
- **Saldo a Pagar:** Diferença caso o valor de pagamento esteja abaixo e seja com a opção de pagamento parcial.
##### ***Regras de Negócio:***
***Considerar o valor liquido = valor original + multa/juros - desconto;***
**1. Não deve permitir o fluxo de pagamento global para clientes/fornecedores diferentes.**
**2. Botão Pagar:** Deve validar o valor "Total a Pagar" com a soma de duplicatas listadas, caso o valor esteja abaixo e não possua uma opção global selecionada ou desconto individual, não deve ser dado sequência nas baixas. Caso contrario, seguir as validações abaixo:
***3. Baixa com desconto global:***
- - Ao utilizar esta opção, a diferença entre o valor pago e o valor total liquido dos títulos selecionados será considerada como o valor de desconto a ser aplicado.
- O desconto deverá ser rateado proporcionalmente entre os títulos selecionados, com base no valor de cada documento, garantindo que nenhum título receba um desconto superior ao seu respectivo valor.
***4. Baixa parcial*** ***global (Fluxo padrão caso o valor total esteja abaixo):***
- - Ao selecionar esta opção, o valor total pago deverá ser abatido sequencialmente dos lançamentos, iniciando pelo mais antigo até o mais recente.
- Caso o valor pago seja suficiente para quitar integralmente os lançamentos processados, não deverá ser gerada duplicata com valor remanescente.
- Se o valor pago não for suficiente para quitar integralmente o último lançamento, deve ser alterado o valor da duplicata em aberto para o valor restante a pagar e ser lançado um pagamento parcial com o valor pago em caixa.
- A duplicada de valor pago deve manter os mesmos dados da duplicata original, mantendo cliente/fornecedor, carteira ou conta financeira. Deve ser adicionado a frase "pagamento parcial ref" ao inicio do histórico.
***5. *Baixa com valor acima da soma de títulos:****
- - Nesta situação, o valor de diferença superior deve ser aplicado proporcionalmente em cada título como multa/acréscimo.
##### ***Questões Técnicas:***
***1.*** **As informações devem ser consultadas e salvas nas tabelas já existentes: gerencieaqui.receita e gerencieaqui.despesas**
**2. schemas de cores:**
**GerencieAqui**:
Botão "Pagar": #044572
Botão "Cancelar" (texto): #044572
Título da dialog: #242424
Placeholders: #50505080 (50%)
Label dos Campos: #044572
Inputs e textos nos grids: #000000
"TOTAL A PAGAR": #044572
"DESCONTOS" e "ACRÉSCIMOS": #00000080
"PAGO": #009966
"SALDO A PAGAR": #FFB300
**AplicativoEmpresarial**:
Botão "Pagar": #621FA4
Botão "Pagar" (texto): #621FA4
Título da dialog: #242424
Placeholders: #50505080 (50%)
Label dos Campos: #621FA4
Inputs e textos nos grids: #000000
"TOTAL A PAGAR": #044572
"DESCONTOS" e "ACRÉSCIMOS": #00000080
"PAGO": #009966
"SALDO A PAGAR": #FFB300
©SOFTEN SISTEMAS 2026