# PROC002 – Registro de Pagamento em Dinheiro

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
[![image-1762776253666.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762776253666.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">GERENCIAMENTO DE PROJETOS</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
PROC002 – Registro de Pagamento em Dinheiro</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Jalile Cornachioni</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">11/11/2025</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

Este documento especifica o comportamento da tela Registrar Pagamento quando a Forma de Pagamento for Dinheiro. Define campos, fluxo, regras de interface, regras de negócio e questões técnicas. Dinheiro é a forma default e o modal não pode abrir sem uma forma selecionada.

##### <span style="color: #000000;">**2. Processo (adicionar fluxograma exemplo)**</span>

[![image-1762881221265.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762881221265.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762881221265.png)

\-- Fluxograma PROC002 – Registro de Pagamento em Dinheiro --

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" style="width: 100%;" width="100%"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 19%;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr><td style="width: 27%;">PROC002 - Registro de Pagamento em Dinheiro</td><td style="width: 19%;">Operador do caixa</td><td style="width: 27%;">Valor recebido</td><td style="width: 27%;">Troco calculado, valor quitado e parcela registrada</td></tr><tr><td style="width: 27%;">PROC001 -Aplicar desconto/acréscimo</td><td style="width: 19%;">Operador do caixa</td><td style="width: 27%;">Valor do desconto ou acréscimo</td><td style="width: 27%;">Total líquido recalculado e resumo atualizado</td></tr><tr><td style="width: 27%;">PROC010- Excluir pagamento já lançado</td><td style="width: 19%;">Operador do caixa</td><td style="width: 27%;">Identificação do pagamento selecionado</td><td style="width: 27%;">Pagamento removido e saldo recalculado</td></tr><tr><td style="width: 27%;">PROC011 - Quitar Restante</td><td style="width: 19%;">Operador do caixa</td><td style="width: 27%;">Saldo pendente e forma de pagamento selecionada</td><td style="width: 27%;">Campo preenchido automaticamente com o valor restante</td></tr><tr><td style="width: 27%;">PROC012 - Finalizar Pagamento</td><td style="width: 19%;">Operador do caixa</td><td style="width: 27%;">Todos os pagamentos registrados e saldo zerado</td><td style="width: 27%;">Venda concluída e registros financeiros emitidos</td></tr><tr><td style="width: 27%;">PROC013 - Cancelar</td><td style="width: 19%;">Operador do caixa</td><td style="width: 27%;">Ação do usuário</td><td style="width: 27%;">Modal fechado sem registrar alterações</td></tr></tbody></table>

#### **Processos Relacionados** 

- - - - - -

- [Pagamento Unificado](https://docs.softensistemas.com.br/books/financeiro/page/pagamento-unificado)
- [PROC001 – Aplicar desconto/acréscimo](https://docs.softensistemas.com.br/books/financeiro/page/proc001-aplicar-descontoacrescimo)
- [PROC002 – Registro de Pagamento em Dinheiro](https://docs.softensistemas.com.br/books/financeiro/page/proc002-registro-de-pagamento-em-dinheiro)
- [PROC003 – Registro de Pagamento em Cartão de Crédito](https://docs.softensistemas.com.br/books/financeiro/page/proc003-registro-de-pagamento-em-cartao-de-credito)
- [PROC004 – Registro de Pagamento em Cartão de Débito](https://docs.softensistemas.com.br/books/financeiro/page/proc004-registro-de-pagamento-em-cartao-de-debito)
- [PROC005 – Registro de Pagamento em Boleto](https://docs.softensistemas.com.br/books/financeiro/page/proc005-registro-de-pagamento-em-boleto)
- [PROC006 – Registro de Pagamento via PIX](https://docs.softensistemas.com.br/books/financeiro/page/proc006-registro-de-pagamento-via-pix)
- [PROC007 – Registro de Pagamento em Outros Métodos](https://docs.softensistemas.com.br/books/financeiro/page/proc007-registro-de-pagamento-em-outros-metodos)
- [PROC008 – Adicionar múltiplas formas de pagamento](https://docs.softensistemas.com.br/books/financeiro/page/proc008-adicionar-multiplas-formas-de-pagamento)
- [PROC012 – Finalizar Pagamento](https://docs.softensistemas.com.br/books/financeiro/page/proc012-finalizar-pagamento)

#### **Especificação Funcional**

- - - - - -

#### **PROC001 EXEMPLO:**

##### ***Protótipo de Tela:***

[![image-1762879023922.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762879023922.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762879023922.png)

##### ***Descrição dos Campos:***

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-tipo-tamanho-o" style="width: 843px; height: 70px;"><tbody><tr style="height: 35px;" valign="top"><td bgcolor="#acb9ca" style="width: 167.988px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Campo**</span>

</td><td bgcolor="#acb9ca" style="width: 101.992px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tipo**</span>

</td><td bgcolor="#acb9ca" style="width: 87.9883px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tamanho**</span>

</td><td bgcolor="#acb9ca" style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Obrig. ?**</span>

</td><td bgcolor="#acb9ca" style="width: 118.984px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Máscara**</span>

</td><td bgcolor="#acb9ca" style="width: 200.996px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Observações**</span>

</td></tr><tr style="height: 35px;"><td style="width: 167.988px; border-style: solid; border-color: black; height: 35px;">Forma de Pagamento

</td><td style="width: 101.992px; border-style: solid; border-color: black; height: 35px;">Enum (Dinheiro, Crédito, Débito, Boleto, PIX, Outros

</td><td style="width: 87.9883px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">100</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 118.984px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 200.996px; border-style: solid; border-color: black; height: 35px;">Default obrigatório: Dinheiro

</td></tr><tr><td style="width: 167.988px; border-style: solid; border-color: black;"><span style="color: #000000;">Valor Recebido</span>

</td><td style="width: 101.992px; border-style: solid; border-color: black;"><span style="color: #000000;">Moeda (2 casas, ≥0)</span>

</td><td style="width: 87.9883px; border-style: solid; border-color: black;"><span style="color: #000000;"> </span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">Sim</span>

</td><td style="width: 118.984px; border-style: solid; border-color: black;"></td><td style="width: 200.996px; border-style: solid; border-color: black;">Valor a ser pago, atribuir o valor total, foco inicia neste campo, usuário pode editar para realizar pagamento parcial

</td></tr><tr><td style="width: 167.988px; border-style: solid; border-color: black;"><span style="color: #000000;">Troco</span>

</td><td style="width: 101.992px; border-style: solid; border-color: black;"><span style="color: #000000;">Moeda (2 casas)</span>

</td><td style="width: 87.9883px; border-style: solid; border-color: black;"><span style="color: #000000;"> </span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">Não</span>

</td><td style="width: 118.984px; border-style: solid; border-color: black;"></td><td style="width: 200.996px; border-style: solid; border-color: black;">Somente leitura. Calculado em tempo real

</td></tr><tr><td style="width: 167.988px; border-style: solid; border-color: black;"><span style="color: #000000;">Total Líquido da Venda</span>

</td><td style="width: 101.992px; border-style: solid; border-color: black;"><span style="color: #000000;">Moeda</span>

</td><td style="width: 87.9883px; border-style: solid; border-color: black;"><span style="color: #000000;"> </span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;"> - </span>

</td><td style="width: 118.984px; border-style: solid; border-color: black;"></td><td style="width: 200.996px; border-style: solid; border-color: black;">Valor base da venda

</td></tr><tr><td style="width: 167.988px; border-style: solid; border-color: black;"><span style="color: #000000;">Resumo de Pagamentos (Total a Pagar, Saldo a Pagar, Pago, Troco)</span>

</td><td style="width: 101.992px; border-style: solid; border-color: black;"><span style="color: #000000;">Moeda</span>

</td><td style="width: 87.9883px; border-style: solid; border-color: black;"><span style="color: #000000;"> </span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;"> - </span>

</td><td style="width: 118.984px; border-style: solid; border-color: black;"></td><td style="width: 200.996px; border-style: solid; border-color: black;">Soma dos valores imputados

</td></tr><tr><td style="width: 167.988px; border-style: solid; border-color: black;">Vencimento <span style="color: #000000;"> </span>

</td><td style="width: 101.992px; border-style: solid; border-color: black;"><span style="color: #000000;">Data</span>

</td><td style="width: 87.9883px; border-style: solid; border-color: black;"><span style="color: #000000;"> </span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">Sim</span>

</td><td style="width: 118.984px; border-style: solid; border-color: black;"></td><td style="width: 200.996px; border-style: solid; border-color: black;"></td></tr></tbody></table>

##### ***Regras de Interface:***

- O sistema deve abrir o modal com Dinheiro já selecionado.
- O sistema deve posicionar o foco em Valor Recebido ao abrir.
- O sistema deve renderizar a seção condicional quando Dinheiro estiver selecionado, exibindo Valor Recebido e Troco.
- O sistema deve habilitar o botão Adicionar Pagamento somente quando Valor Recebido &gt; 0.
- O sistema deve habilitar o botão Finalizar Pagamento somente quando Saldo a Pagar = 0.
- O sistema deve exibir Vencimento preenchido com data atual.
- O sistema não deve permitir abrir o modal sem uma forma de pagamento selecionada.

##### ***Regras de Negócio:***

- O sistema deve calcular o troco em tempo real.
- O sistema deve atualizar o Saldo a Pagar e o Resumo de Pagamentos após cada inclusão/edição/exclusão.
- O sistema deve espelhar o troco do lancamento ao Troco exibido no resumo.
- O sistema deve aceitar múltiplos lançamentos de Dinheiro na mesma venda.
- O sistema não deve aceitar Valor Recebido ≤ 0.
- O sistema não deve permitir alterar a data de vencimento.
- O sistema não deve permitir valores negativos.
- O sistema deve rejeitar caracteres não numéricos, exceto separadores válidos.
- O sistema deve impedir finalização com saldo pendente.
- O sistema deve considerar possíveis falhas e retornar mensagem tratada ao usuário:  
    
    - “Existem valores pendentes. Finalize somente após quitar o saldo.”
    - “Valor inválido. O valor não pode ser negativo.”
    - “Falha ao registrar o pagamento. Tente novamente.”

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