Saldos e caixa¶
Para: Fin — Conferido em 2026-10-18.
A tela Saldos e caixa mostra, por moeda, quanto há disponível, quanto está a receber e a pagar, quanto vai sair com os saques já aprovados ou em revisão, e quais saques aprovados ficaram retidos. Ela também guarda o limiar de alerta de caixa baixo. Os números são os do livro do Dracma, não os de uma conta no PSP.
O que é¶
Quem vê: Administrador do tenant, Financeiro e Auditor. Quem define o limiar de alerta: só o Financeiro. O Revisor não abre a tela.
No alto aparece "Operação … · posição de" com a data e a hora da leitura (horário de Brasília). Cada moeda habilitada tem um cartão com cinco linhas:
| Linha | O que é |
|---|---|
| Disponível | O saldo da moeda no livro do Dracma. Inclui o dinheiro já reservado para saques em andamento. |
| A receber | Depósitos que ainda não foram liquidados no livro (pending_in). |
| A pagar | O que já está reservado ou enviado para saques em andamento (pending_out). |
| Saída prevista | A soma dos saques aprovados e em revisão que ainda não foram enviados ao PSP, com a contagem e o valor de cada grupo. |
| Disponível projetado | Disponível menos Saída prevista. Pode ficar negativo. |
As definições de cada saldo, e de caixa livre, estão em Saldos e caixa livre.
Leitura conservadora
A tela calcula o Disponível projetado como Disponível − Saída prevista. Como o Disponível inclui o valor já reservado (A pagar), o caixa que de fato sustenta novos saques é Disponível − A pagar. Para uma conta conservadora, desconte também o A pagar: Disponível − A pagar − Saída prevista. A linha de ajuda "pode ser usado em saques", ao lado do Disponível, não considera o reservado.
Quando usar¶
- Todo dia, antes de liberar a fila de revisão: aprovar saques sem caixa deixa o dinheiro parado em
approved. - Quando um saque não sai: veja se ele está em Saques retidos aguardando despacho.
- Para configurar o aviso de caixa baixo.
- No go-live, para conferir o caixa inicial da operação (veja Checklist de go-live).
Como fazer¶
Ler um cartão¶
- Abra Saldos e caixa no menu Operação.
- Em cada moeda, olhe os avisos em vermelho:
- "A saída prevista passa do disponível: faltam R$ … de caixa." quando o Disponível projetado é negativo;
- "Disponível abaixo do limiar de alerta (R$ …)." quando o Disponível é menor que o limiar definido.
- Compare o Disponível projetado com o seu planejamento do dia e decida se vale aprovar mais saques.
Uma moeda sem movimento aparece zerada. Se a operação não tem moeda habilitada, a tela mostra "Esta operação não tem moeda habilitada."
Definir o limiar de alerta¶
- No cartão da moeda, em Limiar de alerta, digite o valor mínimo desejado para o Disponível (por exemplo
10.000,00). - Clique em Definir limiar. É preciso confirmação recente de identidade.
- Para tirar o limiar, clique em Remover limiar.
O limiar é um valor por moeda e vale ao mesmo tempo para o aviso da tela e para o alerta "Caixa abaixo do limiar" (veja Alertas e e-mails). Quem não é Financeiro vê só a frase "Alerta de caixa: limiar atual …" ou "sem limiar definido".
O limiar compara com o Disponível, que inclui o valor reservado. Se quiser um alerta sobre o caixa realmente livre, defina o limiar já somando o que costuma ficar reservado.
Saques retidos aguardando despacho¶
Esta tabela lista até 50 saques que foram aprovados mas cujo envio ao PSP foi adiado. Colunas: o saque (external_id e identificador), o valor, as tentativas, a próxima tentativa e o motivo provável:
Falta de caixa, quando o valor do saque passa do Disponível da moeda;Janela ou motor de regras, nos demais casos (por exemplo, fora do horário do automático).
O Dracma não grava o motivo do adiamento: "falta de caixa" é uma inferência da tela. Tente de novo mais tarde, ou aumente o caixa recebendo depósitos. Veja Ciclo do saque.
Faixa "Saques em verificação"¶
Se o Dracma colocar os saques novos da operação em verificação, uma faixa aparece no alto de todas as telas da operação: "Os novos saques desta operação estão em verificação desde … e podem demorar mais que o normal para sair. Os depósitos seguem normalmente." A faixa não informa o motivo. Os depósitos e os saques já em andamento não mudam. Se a faixa durar mais do que você esperava, acione o suporte com a hora que ela mostra.
Saldo no PSP e aporte de caixa¶
Não disponível
A tela não mostra o saldo das contas dos PSPs: o Dracma não consulta o saldo da conexão. A seção "Saldo por conexão de PSP" avisa "Indisponível". O caixa da operação é o do livro do Dracma.
Não disponível
O painel não permite aportar caixa. O caixa da operação cresce com os depósitos pagos e com as devoluções. Veja Saldos e caixa livre.
Exemplos¶
Cartão de uma moeda, com dados fictícios:
| Linha | Valor |
|---|---|
| Disponível | R$ 50.000,00 |
| A receber | R$ 4.000,00 |
| A pagar | R$ 12.000,00 |
| Saída prevista | R$ 20.000,00 (2 aprovados: R$ 8.000,00; 3 em revisão: R$ 12.000,00) |
| Disponível projetado | R$ 30.000,00 |
Leitura conservadora do mesmo cartão: 50.000 − 12.000 − 20.000 = R$ 18.000,00 de caixa livre depois de pagar a saída prevista.
Erros e casos de borda¶
| Mensagem | Causa | O que fazer |
|---|---|---|
| "Limiar de caixa definido." / "Limiar de caixa removido." | Sucesso. | Nenhuma. |
| "Valor inválido. Use o formato 1.234,56." | Valor do limiar fora do formato. | Corrija. |
| "Moeda inválida." | Moeda fora do padrão. | Recarregue a tela. |
| "Confirme com o fator forte para concluir." | step_up_required. |
Use Confirmar identidade agora. |
| "Sem permissão para esta ação." | Você não é Financeiro. | Peça a um Financeiro. |
| "Serviço indisponível no momento. Tente de novo em instantes." | O livro do Dracma não respondeu. | Repita em instantes. |
Casos de borda:
- Livro fora do ar. A tela não inventa saldo: ela responde "indisponível" até o livro voltar. Isso não afeta depósitos e saques em andamento.
- Caixa livre negativo. Estornos,
chargebacke depósitosreturnedcom saques reservados podem tornar o caixa livre negativo; novos saques passam a receber422cominsufficient_operation_balance. Veja Saldos e caixa livre. - Valor "projetado" negativo. A tela só avisa. Nada é bloqueado por causa dele.