BarberBot Software BarberBotDocumentação Técnica Visão geral
DOCUMENTAÇÃO DE MÓDULO

Financeiro

Registrar vendas, compras, contas a pagar e receber, baixas, formas de pagamento, caixa e reflexos de serviços, produtos, clientes, fornecedores e comissões.

MóduloFinanceiro
Status Produção
ResponsávelJacy Cordeiro
Última revisão02/08/2026
01
OBJETIVO

Finalidade do módulo

Registrar vendas, compras, contas a pagar e receber, baixas, formas de pagamento, caixa e reflexos de serviços, produtos, clientes, fornecedores e comissões.

02
LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/vendas.php
sistema/painel/paginas/vendas/
sistema/painel/paginas/compras.php
sistema/painel/paginas/compras/
sistema/painel/paginas/pagar.php
sistema/painel/paginas/pagar/
sistema/painel/paginas/receber.php
sistema/painel/paginas/receber/
sistema/painel/paginas/caixas.php
03
PERSISTÊNCIA

Tabelas relacionadas

vendas
compras
pagar
receber
caixas
formas_pgto
clientes
fornecedores
produtos
servicos
usuarios
comissoes
04
FLUXO

Sequência operacional observada

1Selecionar operação financeira
2Informar pessoa, descrição, valor e vencimento
3Definir forma e situação do pagamento
4Salvar lançamento
5Baixar quando pago
6Atualizar caixa, estoque ou comissão conforme o fluxo
05
ENTRADAS

Dados recebidos

  • Vendas/compras: produto, quantidade, pessoa, valor, vencimento, pagamento e status.
  • Pagar/receber: descrição, pessoa, valor, datas, forma de pagamento, serviço ou produto.
  • Sessão: usuário responsável pela operação e baixa.
  • Filtros: data inicial/final e status.
06
SAÍDAS

Resultados produzidos

  • Lançamentos em vendas, compras, pagar e receber.
  • Movimentos ou vínculo com caixa aberto.
  • Atualização de estoque em vendas/compras.
  • Registro de usuário de lançamento e baixa quando o endpoint o utiliza.
  • Listagens filtradas e mensagens de baixa/sucesso.
07
REGRAS DE NEGÓCIO

Comportamentos comprovados no código

A baixa diferencia lançamento pago e pendente pelas datas e status.

A venda não deve consumir quantidade maior que o estoque disponível.

Formas de pagamento podem aplicar taxa conforme a configuração do sistema.

Alguns fluxos geram comissão ou lançamentos relacionados automaticamente.

08
PONTOS DE ATENÇÃO

Cuidados antes de alterar

O financeiro é acoplado à agenda, produtos, assinaturas e comissões.

Revisar transações e rollback antes de alterar operações que gravam mais de uma tabela.

Valores, datas e status precisam ser testados em pago e pendente.

Consultas legadas com concatenação devem ser revisadas ao receber dados externos.

09
TESTE MÍNIMO

Validação após manutenção

  1. Criar conta a pagar e conta a receber.
  2. Baixar cada conta e conferir usuário, data e caixa.
  3. Registrar compra e confirmar entrada de estoque.
  4. Registrar venda e confirmar saída e bloqueio por saldo insuficiente.
  5. Concluir um serviço pela agenda e verificar o reflexo financeiro.
  6. Testar filtros por período e status.
Fonte da documentação

Conteúdo conferido no snapshot agenda.barberbot(1).zip e no esquema barberbotcom_agenda(1).sql. Quando o código não comprova um comportamento, ele não é apresentado como regra.

Evidências principais: vendas/salvar.php • compras/salvar.php • pagar/salvar.php • receber/salvar.php • agenda/inserir-servico.php

10
REFERÊNCIA COMPLETA

Documentação detalhada existente

Financeiro — visão consolidadaVendas, compras, pagar, receber e comissões. Relatórios financeirosConsultas e saídas relacionadas.