# Manual do módulo Financeiro

O Financeiro controla contas a pagar e receber, saldos, pagamentos, recebimentos, recorrências e despesas originadas na operação. Cada tenant possui seus próprios lançamentos e cadastros.

## Dashboard financeiro

O dashboard apresenta:

- saldo atual das contas bancárias e caixas ativos;
- saldo projetado, considerando valores a receber e a pagar;
- valores em aberto;
- valores pagos e recebidos no mês;
- fluxo financeiro dos últimos meses;
- distribuição das contas por status;
- contas vencidas e próximos vencimentos.

O saldo atual é formado pelo saldo inicial das contas, somado às baixas de recebimentos e subtraído das baixas de pagamentos.

## Cadastros financeiros

Antes de iniciar os lançamentos, configure:

- **Contas bancárias/caixa:** banco, caixa ou carteira e seu saldo inicial;
- **Centros de custo:** área responsável pelo lançamento, como Operacional ou Administrativo;
- **Categorias:** classificação financeira da receita ou despesa;
- **Tipos de serviço:** detalhamento do serviço relacionado;
- **Formas de pagamento:** PIX, boleto, transferência, dinheiro e outras formas utilizadas.

Prefira inativar um cadastro que já tenha sido utilizado. Isso preserva os relatórios anteriores.

### Cadastro rápido por modal

Os cadastros de **Centros de custo**, **Categorias**, **Tipos de serviço**, **Formas de pagamento** e **Regras de motoristas** são administrados diretamente na listagem:

1. Clique no botão de novo cadastro para abrir o formulário em modal;
2. Preencha os campos necessários e salve sem sair da página;
3. Use os três pontinhos no final da linha para editar, ativar, desativar ou excluir;
4. Use o filtro de status para localizar registros ativos ou inativos.

Prefira **Desativar** quando o cadastro já tiver sido utilizado em lançamentos ou fechamentos. A exclusão deve ficar reservada para registros criados por engano e ainda sem uso.

Nas regras de motoristas, somente uma regra ativa pode existir para o mesmo motorista. Uma regra ativa sem motorista selecionado funciona como padrão do tenant.

A remuneração também pode utilizar um **percentual sobre o valor das notas fiscais**. O percentual pode ser a única forma de pagamento da regra ou funcionar como complemento de diária, saída, romaneio, entrega e coleta. O sistema calcula e bloqueia o percentual por NF, evitando que a mesma nota seja remunerada novamente em outro fechamento ativo.

### Regras de custos e pagamentos

A tela **Regras de custos e pagamentos** centraliza a entrada das configurações, mas mantém duas naturezas separadas:

- **Custo operacional do veículo:** combustível, seguro, manutenção, pneus, rastreador, pedágio e demais custos que alimentam os indicadores de margem e performance;
- **Pagamento do motorista:** diária, saída, romaneio, entrega, coleta e percentual das NFs que compõem o fechamento e podem gerar conta a pagar.

Nas regras de pagamento, o motorista e o tipo de veículo são opcionais. A prioridade utilizada pelo fechamento é: motorista com tipo de veículo, motorista para qualquer veículo, tipo de veículo para qualquer motorista e, por último, regra padrão do tenant. Essa separação evita somar o pagamento do motorista duas vezes no custo operacional.

## Criar uma conta

Em **Contas a pagar/receber**, clique em **Novo lançamento** e informe:

1. Se é uma conta a pagar ou receber;
2. Cliente, destinatário, fornecedor ou motorista, quando aplicável;
3. Descrição e número do documento;
4. Datas de emissão e vencimento;
5. Valor;
6. Classificações financeiras;
7. Conta bancária e observações, quando já forem conhecidas.

### Prevenção de duplicidade

O sistema verifica lançamentos semelhantes usando pessoa, tipo, valor, documento e período de vencimento. O alerta não bloqueia um lançamento legítimo: confira os registros indicados e marque a confirmação somente quando tiver certeza.

## Baixas e recebimentos

Use a ação **Baixar** para informar o valor, a data, o banco/caixa, a forma de pagamento e uma observação.

- Uma baixa menor que o saldo deixa a conta como **Parcial**;
- Ao completar o saldo, a conta vira **Paga** ou **Recebida**;
- Cada baixa gera um registro próprio no **Histórico de baixas**;
- O valor da baixa não pode superar o saldo da conta.

### Baixa em lote

Selecione várias contas abertas e use **Baixar selecionadas**. A operação baixa o saldo integral de cada conta usando a mesma data, conta e forma de pagamento. Contas concluídas ou canceladas são ignoradas e informadas ao final.

## Estornar uma baixa

Abra **Histórico de baixas**, localize a movimentação e use **Estornar**. Informe obrigatoriamente o motivo. O saldo e o status da conta serão recalculados, preservando quem realizou o estorno e quando.

## Cancelar uma conta

O cancelamento substitui a exclusão física:

- exige um motivo;
- registra usuário, data e hora;
- mantém a conta nos relatórios;
- não é permitido quando existe valor baixado — estorne primeiro.

## Contas recorrentes e parcelas

Ao criar uma conta, ative **Conta recorrente**, escolha o intervalo e a data final. O sistema cria um grupo identificado e numera as parcelas, por exemplo `1/12` e `2/12`.

As ações disponíveis são:

- **Parcelas:** consulta todo o grupo;
- **Editar:** altera somente a parcela selecionada;
- **Alterar esta e próximas:** altera vencimentos e, opcionalmente, valor e descrição das parcelas futuras;
- **Cancelar esta e próximas:** cancela apenas as parcelas ainda não realizadas.

Parcelas pagas, recebidas ou parcialmente baixadas são preservadas nas ações coletivas.

## Relatório financeiro

O relatório permite filtrar por:

- emissão, vencimento ou pagamento;
- período;
- pagar ou receber;
- status;
- pessoa, CPF/CNPJ ou documento;
- banco/caixa;
- centro de custo;
- categoria;
- tipo de serviço;
- forma de pagamento.

Apresenta valores a receber, recebidos, a pagar, pagos, resultados realizado e projetado, cancelamentos e quantidade de registros. A impressão considera a visualização e a exportação CSV considera todos os registros filtrados.

## Despesas adicionais da operação

Uma despesa adicional nasce no detalhe de uma entrega ou coleta.

1. A despesa é criada como **Pendente**;
2. Ao aprovar, o sistema gera uma conta a pagar com referência `DESP-ID`;
3. O modal apresenta o link da conta financeira;
4. O pagamento deve ser feito no Financeiro;
5. Quando a conta é quitada, a despesa muda para **Paga**;
6. Se a baixa for estornada, a despesa volta para **Aprovada**;
7. Uma despesa com baixa não pode ser reprovada antes do estorno.

O vínculo é único: clicar novamente em aprovar não cria outra conta. Para despesas aprovadas antes dessa funcionalidade, use **Gerar financeiro**.

## Fechamento de motoristas

Em **Financeiro > Fechamento de motoristas**, informe o período. O sistema lista as operações encontradas e cruza dias operacionais, saídas registradas, romaneios, entregas e coletas com a regra específica do motorista ou, na falta dela, com a regra padrão do tenant.

A tela também lista romaneios aguardando encerramento. Os filtros separam operações aguardando encerramento, com impedimentos e disponíveis para fechamento. Quando não houver movimentos, ocorrências ou despesas pendentes, o próprio usuário do financeiro pode encerrar o romaneio e continuar a conferência sem sair da página. O encerramento não efetua baixas operacionais.

1. Confira a prévia e os itens já fechados anteriormente;
2. Informe adiantamentos, descontos, acréscimos e observações;
3. Gere o rascunho e revise a memória de cálculo;
4. Marque como conferido;
5. Aprove para criar a conta a pagar.

Cada item operacional possui uma trava própria. Assim, uma diária, saída, romaneio, entrega ou coleta não entra duas vezes em fechamentos ativos. O cancelamento é auditado e libera os itens para um novo fechamento, desde que não exista pagamento; havendo baixa, ela deve ser estornada primeiro.

O pagamento da conta a pagar muda o fechamento para **pago**. Se o pagamento for estornado, ele retorna para **aprovado**. Uma saída representa uma saída física registrada e pode conter mais de um romaneio; o sistema não presume que cada romaneio seja uma nova saída.

Uma saída não é presumida a partir de um romaneio: ela terá registro próprio de início e fim e poderá conter mais de um romaneio. Isso evita pagar duas saídas quando houve apenas uma.