💰 OndeVou Financeiro

Sistema completo para gestão financeira de empresas. Controle total de contas a pagar, contas a receber, liquidações, caixas e borderos com integração total às notas fiscais e gestão de viagens.

🚀 4 Módulos 💰 2 Movimentos 📄 9 Documentos 🏦 4 Tipos de Caixa 📋 4 Tipos de Bordero 📅 Fluxo em Aberto 📱 App 0016

⚡ Diferenciais Tecnológicos

Tecnologia de ponta para gestão financeira

Importação XML NF-e

Duplicatas geradas automaticamente a partir do XML da nota fiscal.

Cálculo Automático

Saldo aberto = valor - soma das liquidações. Suporte a juros, multa e desconto.

Saldo Corrente

Views com window functions calculam saldo acumulado em tempo real.

📊 Conceitos Fundamentais

💰 Movimentos Financeiros

Toda transação financeira é classificada por tipo de movimento:

1 = Pagar 2 = Receber 3 = Entrada Transferência 4 = Saída Transferência

📋 Situações do Título

1 = Aberto 2 = Pago 3 = Cancelado 4 = Negociado 5 = Transferência

📄 Tipos de Documento

1=Duplicata 2=Cheque 3=Nota promissória 4=Nota débito 5=Boleto bancário 6=Caixa 7=Pix 8=Transferência bancária 9=Dinheiro

🏦 Portadores

Onde o dinheiro está: contas bancárias, caixas físicos, carteiras digitais.

Banco do Brasil • Sicoob • Itaú • Caixa (dinheiro) • Stone • Pagbank • Nubank

⚙️ Configuração Financeira por Natureza da Operação

Sistema inteligente que aprende com as escolhas do usuário e automatiza o lançamento de duplicatas

🧠

Sistema Inteligente de Configuração

O sistema aprende com as escolhas do usuário e automatiza lançamentos futuros

O OndeVou Financeiro permite configurar padrões automáticos para o lançamento de duplicatas com base na natureza da operação da nota fiscal.

🌐 Configuração Padrão

id_participante = NULL

Aplica-se a TODOS os participantes para aquela natureza de operação.

id_participante: NULL

🎯 Configuração Específica

id_participante = ID do Cliente/Fornecedor

Aplica-se APENAS àquele participante específico.

id_participante: 673184
graph TD A[Nota Fiscal Importada] --> B{Existe configuração
para este PARTICIPANTE?} B -->|SIM| C[✅ Usa configuração ESPECÍFICA] B -->|NÃO| D{Existe configuração PADRÃO?} D -->|SIM| E[✅ Usa configuração PADRÃO] D -->|NÃO| F[⚠️ Usuário preenche manualmente] C --> G[Preenche tabela Financeiro Configurações] E --> G F --> G G --> H[Clique em GERAR DUPLICATAS] H --> I[Duplicatas criadas com os valores configurados] style C fill:#22c55e,color:#000 style E fill:#22c55e,color:#000 style I fill:#8b5cf6,color:#000

📌 Lógica de Busca (Prioridade):

-- Prioridade 1: Configuração específica do cliente/fornecedor SELECT * FROM financeiro_configuracoes WHERE participante = @minha_empresa AND id_natureza_operacao = @natureza AND id_participante = @cliente -- Prioridade 2: Configuração padrão (caso não encontre específica) SELECT * FROM financeiro_configuracoes WHERE participante = @minha_empresa AND id_natureza_operacao = @natureza AND (id_participante IS NULL OR id_participante = '')

💰 Contas - Títulos a Pagar e Receber

Tabela principal que armazena todos os títulos financeiros

💰

1. Contas (vendas_duplicatas)

📊 Transição de Estados

Criação: 📄 Aberto
Liquidação Total: ✅ Pago
Liquidação Parcial: 📄 Aberto

📋 Regras

✅ Geração automática: Duplicatas criadas a partir do XML da NF-e
✅ Geração manual: Botão "Gerar Duplicatas" cria parcelas (30/60/90 dias)
📌 Saldo aberto: valor - SUM(valor_inicial_das_liquidações)

💵 Liquidações - Baixas de Títulos

Registro de pagamentos e recebimentos, com suporte a juros, multa e desconto

💵

2. Liquidações (vendas_duplicatas_liquidacao)

📊 Transição de Estados

Antes: 📄 Aberto
Depois: ✅ Pago

📋 Regras

✅ Múltiplas baixas: Uma duplicata pode ter várias liquidações
✅ Campos: valor_inicial, valor_juros, valor_multa, valor_desconto
📌 Valor total: inicial + juros + multa - desconto

🏦 Caixas

Caixas por romaneio, membro (motorista/vendedor) ou ponto de venda

🏦

3. Caixas (caixas)

📊 Transição de Estados

Abertura: 🔓 Aberto
Fechamento: 🔒 Fechado

📋 Regras

✅ QR Code único: Cada caixa tem um QR Code
✅ Vinculação: Caixa pode estar vinculado a um romaneio ou membro
📌 Rotinas: 278 (Abrir), 284 (Fechar), 661 (Reabrir), 662 (Consultar saldo)

📋 Borderos - Lotes de Movimentações

Agrupa liquidações em lotes, facilitando a gestão de recebimentos e pagamentos

📋

4. Borderos (borderos)

📋 Tipos de Bordero (borderos_tipo)

1 = Entrada 2 = Saída 3 = Entrada transferência 4 = Saída transferência

📋 Regras

✅ Agrupamento: Bordero agrupa várias liquidações em um lote
✅ QR Code: Cada bordero tem QR Code

🔄 Transferências Entre Caixas

Toda transferência entre caixas gera DOIS lançamentos automáticos

graph LR subgraph ORIGEM["🏦 CAIXA DE ORIGEM"] C1[("💰 Caixa A")] SAIDA[("📤 Saída Transferência")] end subgraph DESTINO["🏦 CAIXA DE DESTINO"] ENTRADA[("📥 Entrada Transferência")] C2[("💰 Caixa B")] end subgraph AUTOMATICO["🔄 LANÇAMENTOS AUTOMÁTICOS"] L1[("1. Saída do Caixa A")] L2[("2. Entrada no Caixa B")] end C1 --> SAIDA SAIDA --> L1 L1 --> C1 SAIDA --> L2 L2 --> ENTRADA ENTRADA --> C2 style ORIGEM fill:#1e293b,stroke:#ef4444 style DESTINO fill:#1e293b,stroke:#22c55e style AUTOMATICO fill:#1e293b,stroke:#8b5cf6
🔴 Caixa Origem 🟢 Caixa Destino 🟣 Sistema

📋 Rotinas de Transferência

OperaçãoRotinaEfeito
Saída Transferência652➖ Diminui saldo
Entrada Transferência649➕ Aumenta saldo

🚚 Fluxo Completo de Viagem (Caixa do Romaneio)

Demonstração completa de como o sistema gerencia viagens

📤 Etapa 1: Suprimento do Caixa do Romaneio

🏢 Caixa Escritório

Antes: R$ 10.000,00

652 Saída: - R$ 1.000,00

Depois: R$ 9.000,00

🚚 Caixa Romaneio

Antes: R$ 0,00

649 Entrada: + R$ 1.000,00

Depois: R$ 1.000,00

🎯 O sistema gera DOIS lançamentos automaticamente!

⛽ Etapa 2: Gasto na Estrada (Motorista)

🚚 Caixa Romaneio

Antes: R$ 1.000,00

652 Saída: - R$ 250,00

Depois: R$ 750,00

🏢 Caixa Escritório

Saldo: R$ 9.000,00

❌ NENHUM EFEITO

↩️ Etapa 3: Devolução do Saldo Remanescente

🚚 Caixa Romaneio

Antes: R$ 750,00

652 Saída: - R$ 750,00

Depois: R$ 0,00

🏢 Caixa Escritório

Antes: R$ 9.000,00

649 Entrada: + R$ 750,00

Depois: R$ 9.750,00

📊 Resultado líquido: R$ 10.000 - R$ 9.750 = R$ 250,00 gastos ✅

🔄 Conversão: Transferência → Saída Normal

Quando a nota fiscal chega, a transferência de gasto é convertida para Saída Normal

graph TD subgraph VIAGEM["🚚 DURANTE A VIAGEM"] GASTO[("💸 Transferência (652)
R$ 250")] end subgraph ESCRITORIO["🏢 APÓS A VIAGEM"] DUP[("📋 Duplicata
Aberta R$ 250")] end subgraph CONVERSAO["🔄 CONVERSÃO"] OPCAO[("🔗 Vincular e Converter")] DUP_PAGA[("✅ Duplicata Paga")] end GASTO --> OPCAO DUP --> OPCAO OPCAO --> DUP_PAGA style VIAGEM fill:#1e293b,stroke:#f97316 style ESCRITORIO fill:#1e293b,stroke:#3b82f6 style CONVERSAO fill:#1e293b,stroke:#8b5cf6

🎯 Regra de Ouro: A conversão NÃO movimenta dinheiro! Apenas altera o tipo do lançamento e liquida a duplicata.

📒 Livro Caixa - Extrato Financeiro

View consolidada que apresenta todas as movimentações com saldo corrente

📒

5. view_livro_caixa

📋 Campos Calculados

📊valor_total: inicial + juros + multa - desconto
📊valor_sinalizado: positivo para entrada, negativo para saída
📊saldo_atual_caixa: SUM(valor_sinalizado) OVER (PARTITION BY id_caixa)
📊saldo_atual: SUM(valor_sinalizado) OVER (PARTITION BY participante)

📅 Fluxo de Caixa em Aberto

Projeção do saldo dia a dia com base nos títulos em aberto. Mostra como o caixa vai evoluir nos próximos vencimentos.

📒 Livro Caixa

Passado — o que já aconteceu.

  • ✅ Baseado em vendas_duplicatas_liquidacao
  • ✅ Mostra títulos já liquidados
  • ✅ Saldo calculado sobre movimentações reais

📅 Fluxo em Aberto

Futuro — o que ainda vai acontecer.

  • ✅ Baseado em vendas_duplicatas
  • ✅ Mostra títulos em aberto
  • ✅ Saldo projetado por vencimento
📊

Estrutura do Relatório

Três blocos que contam a história do caixa

1️⃣ Saldo Inicial do Período

Ponto de partida do cálculo. Mostra todos os caixas e bancos anteriores à data inicial do relatório, com seus saldos e a composição do valor acumulado.

📋 O que mostra

🏦 Caixas anteriores: cada caixa/bordero com saldo inicial, final, variação e acumulado
💰 Total do saldo inicial: soma acumulada que serve de base para a projeção
📌 Consulta: view_caixas WHERE data < data_inicial

💡 Por que existe: sem o saldo inicial correto, toda a projeção fica errada. É o ponto de conferência com o extrato real dos bancos e caixas.

2️⃣ Fluxo Dia a Dia (Extrato Projetado)

Para cada data de vencimento (ordenada ASC), o relatório mostra: o saldo inicial do dia, os valores a receber, os valores a pagar, o saldo final do dia, e todos os títulos individuais que compõem aquele dia.

📋 Estrutura de cada dia

📅 Data: agrupamento por nfe_data_vencimento
📊 Saldo Inicial do dia: = Saldo Final do dia anterior
📥 A Receber: soma dos saldo_aberto com movimento = 2
📤 A Pagar: soma dos saldo_aberto com movimento = 1
💰 Saldo Final do dia: = Saldo Inicial + A Receber - A Pagar
📋 Títulos do dia: detalhamento com ID, participante, documento, valor, saldo corrido

💡 Saldo Corrido: cada título tem seu saldo acumulado após sua inclusão, permitindo visualizar como o caixa evolui título por título.

3️⃣ Resumos Importantes

Visões agregadas que permitem análise estratégica sem precisar ler o extrato completo. Cada resumo responde uma pergunta do gestor.

📊 Resumo do Período

"Quanto tenho a receber, a pagar e qual o saldo projetado?"

  • A Receber (projeção de entradas)
  • A Pagar (projeção de saídas)
  • Saldo Projetado (receber - pagar)
  • Saldo Final (inicial + projetado)
  • Títulos (quantidade)

📂 Categorias

"De onde vêm / para onde vão os valores?"

  • Vendas, Sem valor, etc.
  • A Receber / A Pagar / Saldo Proj.

🏦 Portadores

"Onde está o dinheiro?"

  • Banco do Brasil, Caixa Geral, etc.
  • A Receber / A Pagar / Saldo Proj.

🛣️ Rotas

"Qual rota está gerando mais receita?"

  • JOÃO PESSOA, PATOS, CAMPINA GRANDE, etc.
  • A Receber / A Pagar / Saldo Proj.

📦 Romaneios

"Qual viagem/carga tem mais títulos pendentes?"

  • Agrupamento por romaneio de viagem
  • A Receber / A Pagar / Saldo Proj.

👤 Participantes

"Quais clientes/fornecedores movimentam mais?"

  • Todos os clientes e fornecedores
  • A Receber / A Pagar / Saldo Proj.

🖼️ Modelo Visual do Relatório

Exemplo real de como o relatório aparece na tela e no PDF exportado.

Fluxo de Caixa em Aberto
Projeção por vencimento
161 títulos
Gerado em 10/09/2026 16:40
RESUMO DO PERÍODO
A Receber
208.273,11
projeção de entradas
A Pagar
3.610,79
projeção de saídas
Saldo Projetado
204.662,32
receber - pagar
Saldo Final
230.502,90
inicial + projetado
Títulos
161
no período
📄 No PDF fica assim (tabela):
Indicador Valor Descrição
A Receber 208.273,11 projeção de entradas
A Pagar 3.610,79 projeção de saídas
Saldo Projetado 204.662,32 receber - pagar
Saldo Final 230.502,90 inicial + projetado
Títulos 161 no período
SALDO INICIAL DO PERÍODO 1 caixa anterior
SALDO INICIAL DO PERÍODO
25.840,58
Caixa Descrição Situação Data Saldo Inicial Saldo Final Variação Acumulado
#36 Viagem a patos em 21/08/2025 Aberto 05/09/25 09:09 25.840,58 — 0,00 25.840,58
TOTAL DO SALDO INICIAL 25.840,58
EXTRATO EM ABERTO (Por Vencimento)
161 títulos · Total: R$ 208.273,11
▸ 10/09/2026 54 títulos
Saldo Inicial: 25.840,58 Receber: 69.005,74 Pagar: 910,00 Saldo Final: 93.936,32
Id Id Venda Nome/Razão Social Movimento Situação Documento N.Docto Emissão Vencimento Cobrança Portador Categoria Valor Saldo
93704 226117 FUNDO MUNICIPAL DE SAUDE DE TEIXEIRA Receber Aberto Duplicata 310316 11/08/2026 10/09/2026 Carteira Caixa Geral Vendas 93,00 25.933,58
93709 226124 FUNDO MUN DE SAUDE DE LIVRAMENTO Receber Aberto Duplicata 310320 11/08/2026 10/09/2026 Carteira Caixa Geral Vendas 808,00 26.741,58
93836 226360 HOSPITAL DE CLINICAS DE CAMPINA GRANDE Receber Aberto Duplicata 208373 11/08/2026 10/09/2026 Carteira Caixa Geral Vendas 11.824,40 38.565,98
... mais 51 títulos
▸ 11/09/2026 47 títulos
Saldo Inicial: 93.936,32 Receber: 55.822,58 Pagar: 2.080,79 Saldo Final: 147.678,11
▸ 12/09/2026 60 títulos
Saldo Inicial: 147.678,11 Receber: 83.445,00 Pagar: 620,00 Saldo Final: 230.502,90
RESUMOS POR DIMENSÃO
📂 Categorias
Categoria A Receber A Pagar Saldo Proj.
Sem valor 0,00 251,43 -251,43
Vendas 208.273,11 3.359,36 204.913,75
🏦 Portadores
Portador A Receber A Pagar Saldo Proj.
Banco do Brasil 6.730,00 3.359,36 3.370,64
Caixa Geral 201.543,11 0,00 201.543,11
Sem valor 0,00 251,43 -251,43
🛣️ Rotas
Rota A Receber A Pagar Saldo Proj.
BREJO 4.805,78 0,00 4.805,78
JOAO PESSOA 37.562,04 0,00 37.562,04
PATOS 15.028,01 0,00 15.028,01
... mais 5 rotas
👤 Participantes (Top 4)
Participante A Receber A Pagar Saldo Proj.
SES COMPLEXO DE SAUDE DE CRUZ DAR ARMAS 14.243,20 0,00 14.243,20
FUNDO MUN DE SAUDE DE ALAGOA GRANDE 14.240,00 0,00 14.240,00
HOSPITAL DE TRAUMA SENADOR HUMBERTO LUCE 16.037,15 0,00 16.037,15
... mais 85 participantes
A Receber: 208.273,11 A Pagar: 3.610,79 Projeção: 204.662,32 Saldo Final: 230.502,90 161 títulos 10/09/2026 16:40

🔄 Fluxo de Dados do Relatório

graph TD A[vendas_duplicatas
Títulos em aberto] --> B{Agrupar por
data_vencimento} B --> C[Ordenar ASC] C --> D[Calcular saldo inicial
via view_caixas] D --> E[Percorrer títulos
acumulando saldo] E --> F[Agrupar por dia] F --> G[Detalhar títulos
do dia] F --> H[Totalizar por
Categoria] F --> I[Totalizar por
Portador] F --> J[Totalizar por
Rota] F --> K[Totalizar por
Romaneio] F --> L[Totalizar por
Participante] G --> M[📅 Extrato Dia a Dia] H --> N[📂 Resumos] I --> N J --> N K --> N L --> N style A fill:#1e293b,stroke:#22d3ee style M fill:#8b5cf6,stroke:#8b5cf6,color:#fff style N fill:#22c55e,stroke:#22c55e,color:#000

🎛️ Filtros Disponíveis

Filtro Tipo Efeito
Apenas títulos abertos Checkbox Mostra só títulos com id_financeiro_situacao = 1
Apenas receber Checkbox Mostra só id_financeiro_movimento = 2
Apenas pagar Checkbox Mostra só id_financeiro_movimento = 1
Data vencimento inicial Date Filtra nfe_data_vencimento >= data
Data vencimento final Date Filtra nfe_data_vencimento <= data
Não limitar quantidade Checkbox Remove o LIMIT da consulta
🎯

Casos de Uso

Quando usar o Fluxo de Caixa em Aberto

📅 Planejamento Semanal

Filtre por próximos 7 dias e veja se o caixa aguenta os pagamentos da semana.

🏦 Conferência com Extrato

Use o saldo inicial para bater com o saldo real do banco antes de começar a semana.

🛣️ Análise por Rota

Veja quais rotas têm mais valores a receber e priorize a cobrança.

👤 Cobrança Direcionada

Use o resumo por Participante para saber quem cobrar primeiro.

📤 Programação de Pagamentos

Filtre apenas pagar para saber quanto precisa estar disponível em cada dia.

📊 Análise Gerencial

Exporte para PDF e apresente em reuniões com a diretoria.

📄 Exportação para PDF

O relatório pode ser exportado em PDF com layout profissional, contendo:

  • ✅ Cabeçalho: logo, empresa, filtros aplicados, data/hora, usuário
  • ✅ Resumo do Período: tabela com os totais consolidados
  • ✅ Saldo Inicial: tabela com caixas anteriores (renderizada uma única vez)
  • ✅ Extrato Dia a Dia: todos os títulos agrupados por vencimento
  • ✅ Resumos: Categorias, Portadores, Rotas, Romaneios, Participantes
  • ✅ Paginação automática: cabeçalho repetido em cada página
  • ✅ Colunas numéricas: alinhadas à direita automaticamente

⚠️ Importante: O relatório é uma projeção. Os valores só se confirmam quando os títulos forem efetivamente liquidados. Para conferência do realizado, use o Livro Caixa ou o Fluxo Realizado.

🗂️ Tabelas do Sistema Financeiro

📊 Tabelas Principais

  • vendas_duplicatas - Contas a pagar/receber
  • vendas_duplicatas_liquidacao - Baixas/liquidações
  • borderos - Lotes de movimentações
  • caixas - Caixas por romaneio/membro
  • financeiro_configuracoes - Configurações

🔧 Tabelas Auxiliares

  • financeiro_movimento - Tipo (Pagar/Receber)
  • financeiro_situacao - Status (Aberto/Pago)
  • financeiro_documento - Tipo de documento
  • financeiro_cobranca - Forma de cobrança
  • financeiro_portador - Conta/Caixa
  • financeiro_categoria - Classificação
  • borderos_tipo - Tipo de bordero

📱 QR Code - Identificação Única

qr_code_scanner

Caixas e Borderos com QR Code

  • 🔢 Prefixo cx: Caixa (ex: cx12345)
  • 🔢 Prefixo bf: Bordero (ex: bf12345)
  • 🔢 Prefixo rv: Romaneio de viagem

🏆 Propriedade Intelectual

ONDEVOU Marca Registrada

Marca Registrada

OndeVou.com®

Propriedade Intelectual Assegurada

Processo INPI:
908765967
Titular:
ONDEVOU TECNOLOGIA LTDA
CNPJ:
17.058.605/0001-36
Classificação:
Classe 42
🏆
10+
anos de proteção