💰 OndeVou Caixas
Sistema completo para gestão de caixas, borderôs e movimentações financeiras. Controle total de entradas, saídas, transferências e livro caixa com QR Code para acesso rápido e integração com romaneios de viagem.
🎯 Visão Geral do Módulo
💰 O que é o Módulo de Caixas?
O módulo de Caixas (App 0027) é um sistema completo de gestão de caixas e movimentações financeiras que permite controlar entradas e saídas de dinheiro, transferências entre caixas, borderôs e extrato detalhado (livro caixa).
- 🏦 Abertura/Fechamento de caixas - controle por romaneio, membro ou ponto de venda
- 💰 Movimentações - entradas e saídas com suporte a juros, multa e desconto
- 🔄 Transferências - entre caixas com dois lançamentos automáticos
- 📋 Borderôs - agrupamento de movimentações em lotes
- 📒 Livro Caixa - extrato completo com saldo corrente
🔢 QR Code - Identificação Única
Cada caixa e bordero possui um QR Code único para acesso rápido via aplicativo coletor:
- 🔢 Prefixo cx: Caixa (ex: cx12345)
- 🔢 Prefixo bf: Bordero (ex: bf12345)
- 🔢 Prefixo rv: Romaneio de viagem
- 📱 Leitura via app: O aplicativo coletor lê o QR Code e abre a operação correspondente
📋 Rotinas do App 0027 - Caixas
21 rotinas para gestão completa de caixas, borderôs e movimentações
📋 Resumo das Rotinas do App 0027
| Rotina | Nome | ID | Tipo | URL Amiga |
|---|---|---|---|---|
| 277 | Caixas | 219 | Listagem | caixas |
| 278 | Incluir caixa | 220 | Inclusão | caixas_incluir_caixa |
| 286 | Alterar caixa | 229 | Alteração | caixas_alterar_caixa |
| 662 | Recalcular saldo inicial | 611 | Utilitário | caixas_recalcular_saldo_inicial |
| 288 | Borderôs | 231 | Listagem | caixas_borderos |
| 279 | Registrar entrada | 222 | Inclusão | caixas_registrar_entrada |
| 289 | Alterar registro de entrada | 232 | Alteração | caixas_alterar_registro_de_entrada |
| 280 | Excluir registro de entrada | 223 | Exclusão | caixas_excluir_registro_de_entrada |
| 281 | Registrar saída | 224 | Inclusão | caixas_registrar_saida |
| 290 | Alterar registro de saída | 233 | Alteração | caixas_alterar_registro_de_saida |
| 282 | Excluir registro de saída | 225 | Exclusão | caixas_excluir_registro_de_saida |
| 649 | Registrar entrada por transferência | 598 | Inclusão | caixas_registrar_entrada_por_transferencia |
| 650 | Alterar entrada por transferência | 599 | Alteração | caixas_alterar_registro_de_entrada_por_transferencia |
| 651 | Excluir entrada por transferência | 600 | Exclusão | caixas_excluir_registro_de_entrada_por_transferencia |
| 652 | Registrar saída por transferência | 601 | Inclusão | caixas_registrar_saida_por_transferencia |
| 653 | Alterar saída por transferência | 602 | Alteração | caixas_alterar_registro_de_saida_por_transferencia |
| 654 | Excluir saída por transferência | 603 | Exclusão | caixas_excluir_registro_de_saida_por_transferencia |
| 283 | Livro caixa | 226 | Relatório | caixas_livro_caixa |
| 284 | Finalizar caixa | 227 | Ação | caixas_finalizar_caixa |
| 661 | Reabrir caixa | 610 | Ação | caixas_reabrir_caixa |
🏦 Caixas
Caixas por romaneio, membro (motorista/vendedor) ou ponto de venda
📊 Ciclo de Vida do Caixa
🔓 Abertura (Rotina 278)
- Saldo inicial informado
- Vinculação a romaneio ou membro
- Geração de QR Code único
- Situação: Aberto
🔒 Fechamento (Rotina 284)
- Saldo final calculado
- Conciliação das movimentações
- Situação: Fechado
- Possibilidade de reabertura (Rotina 661)
📋 Campos da Tabela caixas
| Campo | Descrição | Observação |
|---|---|---|
| id_caixa | Identificador único | Chave primária |
| qr_code | QR Code único | Prefixo "cx" + número |
| saldo_inicial | Saldo na abertura | Valor monetário |
| saldo_final | Saldo no fechamento | Atualizado na rotina 284 |
| id_romaneio | Vinculação com viagem | Opcional |
| id_membro | Vinculação com motorista/vendedor | Opcional |
| situacao | Aberto/Fechado | Controla movimentações |
📋 Borderôs - Lotes de Movimentações
Agrupa movimentações em lotes, facilitando a gestão de recebimentos e pagamentos
📋 Tipos de Bordero (borderos_tipo)
🎯 Diferencial: Cada bordero possui QR Code único (prefixo "bf") para acesso rápido via aplicativo coletor.
💰 Movimentações - Entradas e Saídas
Registro de todas as movimentações financeiras dos caixas
📥 Entradas (Tipo 1)
- Rotina 279: Registrar entrada
- Rotina 289: Alterar entrada
- Rotina 280: Excluir entrada
- Valor positivo: Aumenta saldo do caixa
📤 Saídas (Tipo 2)
- Rotina 281: Registrar saída
- Rotina 290: Alterar saída
- Rotina 282: Excluir saída
- Valor negativo: Diminui saldo do caixa
📊 Campos da Liquidação (vendas_duplicatas_liquidacao)
| Campo | Descrição | Observação |
|---|---|---|
| valor_inicial | Valor base da liquidação | Obrigatório |
| valor_juros | Juros aplicados | Positivo |
| valor_multa | Multa aplicada | Positivo |
| valor_desconto | Desconto concedido | Positivo (reduz o total) |
| valor_total | inicial + juros + multa - desconto | Calculado |
| valor_sinalizado | Positivo (entrada) / Negativo (saída) | Conforme tipo bordero |
🔄 Transferências Entre Caixas
Toda transferência entre caixas gera DOIS lançamentos automáticos: saída de um caixa e entrada no outro.
🏦 Caixa de Origem
652 Saída Transferência
Efeito: - R$ Valor
Tipo Bordero: 4 (Saída Transferência)
🏦 Caixa de Destino
649 Entrada Transferência
Efeito: + R$ Valor
Tipo Bordero: 3 (Entrada Transferência)
🎯 Importante: O sistema gera DOIS lançamentos automaticamente! O usuário só precisa informar a transferência uma vez.
📋 Rotinas de Transferência
| Operação | Rotina | Tipo Bordero | Efeito no Caixa |
|---|---|---|---|
| Saída Transferência | 652 | 4 | ➖ Diminui saldo (origem) |
| Entrada Transferência | 649 | 3 | ➕ Aumenta saldo (destino) |
| Alterar Saída Transferência | 653 | 4 | 🔧 Ajusta saldos |
| Excluir Saída Transferência | 654 | 4 | 🗑️ Reverte saldos |
📒 Livro Caixa - Extrato Financeiro
View consolidada que apresenta todas as movimentações com saldo corrente
📊 View: view_livro_caixa
View que unifica todas as movimentações (entradas, saídas e transferências) com cálculo de saldo corrente.
📋 Campos Calculados
valor_total= inicial + juros + multa - descontovalor_sinalizado= positivo para entrada (tipos 1/3), negativo para saída (tipos 2/4)
📊 Saldo Corrente
saldo_atual_caixa= SUM(valor_sinalizado) OVER (PARTITION BY id_caixa ORDER BY data)saldo_atual= SUM(valor_sinalizado) OVER (PARTITION BY participante ORDER BY data)
🎯 Diferencial: Utiliza window functions do PostgreSQL para calcular saldo acumulado em tempo real, sem necessidade de processamento adicional.
📋 Exemplo de Livro Caixa
| Data | Histórico | Tipo | Valor | Saldo do Caixa |
|---|---|---|---|---|
| 01/05/2026 | Abertura do caixa | - | R$ 1.000,00 | R$ 1.000,00 |
| 02/05/2026 | Saída Transferência (abastecimento) | Saída | R$ 250,00 | R$ 750,00 |
| 03/05/2026 | Entrada (recebimento cliente) | Entrada | R$ 500,00 | R$ 1.250,00 |
| 05/05/2026 | Fechamento do caixa | - | R$ 1.250,00 | R$ 1.250,00 |
🚚 Fluxo Completo de Viagem (Caixa do Romaneio)
Demonstração completa de como o sistema gerencia viagens, desde o suprimento até a conciliação final das notas fiscais.
🏢 Caixa Escritório (Origem)
Antes: R$ 10.000,00
652 Saída Transferência: - R$ 1.000,00
Depois: R$ 9.000,00
🚚 Caixa Romaneio (Destino)
Antes: R$ 0,00
649 Entrada Transferência: + R$ 1.000,00
Depois: R$ 1.000,00
🚚 Caixa Romaneio
Antes: R$ 1.000,00
652 Saída Transferência: - R$ 250,00
Depois: R$ 750,00
🏢 Caixa Escritório
Saldo: R$ 9.000,00
❌ NENHUM EFEITO
O dinheiro físico já está com o motorista!
🚚 Caixa Romaneio
Antes: R$ 750,00
652 Saída Transferência: - R$ 750,00
Depois: R$ 0,00
🏢 Caixa Escritório
Antes: R$ 9.000,00
649 Entrada Transferência: + R$ 750,00
Depois: R$ 9.750,00
📊 Resultado líquido para o escritório: R$ 10.000 - R$ 9.750 = R$ 250,00 gastos ✅
Quando a nota fiscal do gasto chega ao escritório, a transferência é convertida para Saída Normal (tipo 2), liquidando a duplicata sem movimentar dinheiro novamente.
Antes da conversão:
- id_tipo_bordero = 4 (Saída Transferência)
- id_duplicata_vinculada = NULL
Depois da conversão:
- id_tipo_bordero = 2 (Saída Normal)
- id_duplicata_vinculada = ID da duplicata
- Duplicata marcada como Paga
🎯 Regra de Ouro: A conversão NÃO movimenta dinheiro! O gasto já foi registrado durante a viagem. Apenas altera o tipo do lançamento e liquida a duplicata.
🗂️ Tabelas do Sistema de Caixas
📊 Tabelas Principais
caixas- Caixas por romaneio/membro/ponto de vendaborderos- Lotes de movimentaçõesvendas_duplicatas_liquidacao- Movimentações financeirasview_livro_caixa- View consolidada com saldo corrente
🔧 Tabelas Auxiliares
borderos_tipo- Tipos de bordero (1-4)caixas_situacao- Situação do caixa (Aberto/Fechado)financeiro_movimento- Tipo de movimentofinanceiro_documento- Tipo de documentofinanceiro_portador- Conta/Caixa
🏆 Propriedade Intelectual
Marca Registrada
OndeVou.com®
Propriedade Intelectual Assegurada
908765967
ONDEVOU TECNOLOGIA LTDA
17.058.605/0001-36
Classe 42 - Serviços de TI