Balanço Gerencial

Alcance e período

FiliaisAs do modelo (balanco_modelo_filial) que o usuário alcança; as sem acesso saem com aviso. Modelo sem filial: todas as do usuário.

Moeda localAs filiais têm de ter a mesma idmoeda_local; senão recusa.

Faixa>= 1º dia do mês AND < corte + 1 dia (meio-aberta). Títulos pela emissão, baixas pela data da baixa.

Tipos de linha do modelo

EMISSAOTítulos emitidos no mês: valor_parcela × IF(valor_cambio>0, valor_cambio, 1), pelos centros de custo da linha (o mesmo critério do 311).

BAIXABaixas do mês: fb.valor × câmbio da baixa (o 315). Exige título vivo.

PENDENTESaldo em aberto no corte pela conta do 221 (descontado fora; só saldo > 0,005): o 313.

PROVISAOBaixas do mês − provisão anterior + pendente atual (+ manual). O valor levado ao mês seguinte é pendente + manual. A provisão anterior vem do fechamento validado do mês anterior; sem ele, é o pendente do sistema no último dia do mês anterior mais o manual do mês anterior (e a prévia avisa).

AJUSTE_BAIXA(acréscimo + juros − desconto − devolução − retenção) × câmbio da baixa.

DIF_CAMBIALfb.diferenca_cambial da baixa, já em moeda local.

SALDO_BANCOSaldo das contas do modelo (ou todas as das filiais) no corte pelo MovimentacaoBancariaSql (a view movimentacao_bancaria), só o movimento na moeda da conta, × cotação mais recente até o corte; conta de moeda sem cotação fica fora com aviso.

MANUALSó o valor digitado no mês.

PERCENTUALpercentual% do total de outra linha (codigoBase); sem o sinal da base.

ACUMULADOValor fechado do mês anterior desta linha + o total da linha base no mês; sem fechamento validado, começa em zero e avisa.

FORMULASoma/subtração (+ − ( ) sobre códigos de linha, sem divisão); cada código entra como sinal × total.

TITULOSó rótulo (cabeçalho de bloco).

DIF_CAMBIAL_BANCO, VARIACAO_ALMOXAinda não implementados (etapa 2b): valem 0, com aviso.

Natureza, sinal e valor manual

NaturezaR: só títulos a receber, positivo. P: só a pagar, positivo. A (ambos): receber − pagar.

Sinal da linha±1; só se aplica quando outra linha soma esta (na FORMULA). Nos tipos de sistema o valor da linha sai com o sinal da natureza.

ManualToda linha de sistema (e MANUAL) soma também o valor digitado do mês: Total = Sistema + Manual. FORMULA e PERCENTUAL não aceitam.

Escala3 casas decimais.

Conversão (versão em dólar)

Cotação1) a digitada no mês (balanco_periodo.cotacao_digitada); 2) moeda de conversão = moeda local → 1; 3) a do sistema: moeda_valores mais recente até o corte.

ContaConvertido = Total ÷ cotação (linha TITULO fica em branco). Sem cotação e sem digitada: aviso “A moeda de conversão não tem cotação até …: a versão convertida não foi calculada.”

Centros de custo com movimento sem linha no modelo

Aviso“Centro de custo N (descrição) tem movimento no mês sem linha no modelo: emitido a receber …; emitido a pagar …; baixado a receber …; baixado a pagar ….” — esses valores não entram no balanço. Título sem centro aparece como “Centro de custo 0 (títulos sem centro de custo)”.

QuandoSó considera EMISSAO/BAIXA/PENDENTE/PROVISAO/AJUSTE/DIF_CAMBIAL: um centro que só aparece numa linha de outro tipo conta como coberto pelo critério de títulos.

Mês validado e manuais

Estadobalanco_periodo.situacao = A (aberto) ou V (validado). O período só nasce ao gravar manuais; sem período a situação vem vazia.

ValidadoNão aceita alteração de manual nem de cotação: “Mês validado — reabra antes de alterar.”

HistóricoCada mudança de valor manual grava balanco_manual_historico (valor anterior, novo, usuário, data); valor nulo ou zero apaga o manual.

Nenhuma filial do modelo está entre as filiais do usuário.

QuandoO usuário não alcança nenhuma das filiais do modelo.

As filiais do balanço estão sem moeda local cadastrada. / As filiais do modelo têm moedas locais diferentes ([…]): um balanço só soma filiais com a mesma moeda local.

Quandofilial.idmoeda_local vazio, ou duas moedas locais entre as filiais do modelo.

Mês inválido: use AAAA-MM.

QuandoMês fora do formato (só por chamada direta).

Modelo de balanço não encontrado. / Linha não encontrada no modelo.

QuandoId de modelo inexistente, ou composição de linha que não é do modelo.

Referência circular na linha X. / X: a linha "Y" não existe no modelo. / Fórmula inválida perto de "…".

QuandoModelo mal configurado no 17M (o cadastro valida na gravação, mas a prévia revalida na conta).

Você não tem permissão para digitar valores do balanço (regra BALANCO_MANUAL).

QuandoGravar manuais sem a regra (master passa).

A cotação digitada tem de ser maior que zero. / Linha N não pertence ao modelo. / A linha do tipo X não aceita valor manual. / A observação passa de 255 caracteres.

QuandoValidações da gravação dos manuais.

Mês validado — reabra antes de alterar.

QuandoGravar manual num período com situação V.

Centro de custo … tem movimento no mês sem linha no modelo

O que fazerIncluir o centro numa linha do modelo (17M) ou confirmar que fica de fora. Enquanto isso o balanço não fecha com o financeiro.

O mês anterior não tem fechamento validado…

EfeitoA provisão anterior usa o pendente do sistema no último dia do mês anterior (mais o manual daquele mês) e os acumulados começam em zero. Como ainda não existe a tela de validar, sempre aparece.

O tipo de linha DIF_CAMBIAL_BANCO / VARIACAO_ALMOX ainda não foi implementado: as linhas desse tipo valem 0.

EfeitoO modelo da transportadora tem 1 linha DIF_CAMBIAL_BANCO: ela sai zerada com o aviso (a variação cambial dos bancos é digitada à mão numa linha MANUAL).

Filiais do modelo sem acesso para este usuário ficaram de fora: […]. / A moeda N não tem cotação até …: as contas dessa moeda ficaram fora da linha X.

EfeitoO balanço de dois usuários com acessos diferentes não é o mesmo; conta bancária de moeda sem cotação sai do saldo.

Resultado guardado por 5 minutos, por usuário

EfeitoAlterações no modelo (17M) não invalidam o resultado guardado: só gravar manuais invalida (o mês e o seguinte). Use Recalcular depois de mexer no modelo.

Regime do modelo não muda a conta

EfeitoO campo Regime (Competência/Caixa) do cadastro existe, mas a prévia não o lê: cada linha vale pelo seu tipo (EMISSAO = competência, BAIXA = caixa).

T1 — Emissão, baixa e pendente de um centro contra SQL

ComoModelo “Balanço Transportadora” no fjfrigo_concep_transp, mês 08/2026. Abra a composição de uma linha EMISSAO P do centro 1116, uma BAIXA P do 1116 e uma PENDENTE P do 1140 (julho).

EsperadoCada linha igual à SQL (e a soma da composição = o valor da linha). Referência medida em 04/10/2026: EMISSAO P cc 1116 ago/2026 = 24.826.000,000; BAIXA P cc 1116 ago/2026 = 21.473.000,000; PENDENTE P cc 1140 em 31/07/2026 = 595.070,000. Confere com a conferência de 28/09.

SELECT 'EMISSAO P cc 1116 ago/2026' AS conferencia,
       ROUND(SUM(fe.valor_parcela * IF(fe.valor_cambio > 0, fe.valor_cambio, 1)), 3) AS valor_local
  FROM financeiro_emissao fe
 WHERE fe.excluido <> 'T' AND fe.tipo_emissao = 'P' AND fe.idcentro_custo = 1116 AND fe.idfilial = 1
   AND fe.data_emissao >= '2026-08-01' AND fe.data_emissao < DATE_ADD('2026-08-31', INTERVAL 1 DAY)
UNION ALL
SELECT 'BAIXA P cc 1116 ago/2026', ROUND(SUM(fb.valor * IF(fb.valor_cambio > 0, fb.valor_cambio, 1)), 3)
  FROM financeiro_baixas fb JOIN financeiro_emissao fe ON fe.id = fb.idfinanceiro_emissao
 WHERE fb.excluido <> 'T' AND fe.excluido <> 'T' AND fe.tipo_emissao = 'P' AND fe.idcentro_custo = 1116 AND fe.idfilial = 1
   AND fb.data_baixa >= '2026-08-01' AND fb.data_baixa < DATE_ADD('2026-08-31', INTERVAL 1 DAY)
UNION ALL
SELECT 'PENDENTE P cc 1140 em 31/07/2026', ROUND(SUM(t.pend * t.cambio), 3) FROM (
  SELECT fe.id, IF(fe.valor_cambio > 0, fe.valor_cambio, 1) AS cambio,
         fe.valor_parcela - IFNULL((SELECT SUM(b.valor)-SUM(b.valor_acrescimo)-SUM(b.valor_juros)+SUM(b.valor_desconto)+SUM(b.valor_devolucao)+SUM(b.valor_retencao)
                                      FROM financeiro_baixas b WHERE b.idfinanceiro_emissao = fe.id AND b.excluido <> 'T'
                                       AND b.data_baixa < DATE_ADD('2026-07-31', INTERVAL 1 DAY)), 0) AS pend
    FROM financeiro_emissao fe
   WHERE fe.excluido <> 'T' AND fe.tipo_emissao = 'P' AND fe.idcentro_custo = 1140 AND fe.idfilial = 1
     AND fe.data_emissao < DATE_ADD('2026-07-31', INTERVAL 1 DAY)) t
 WHERE t.pend > 0.005

T2 — Provisão anterior sem fechamento

ComoGere 08/2026 (julho não validado). Veja a composição de uma linha PROVISAO.

EsperadoItens: baixas do mês, pendente no corte e um item ANTERIOR (id 0, negativo) = pendente em 31/07 + manual de julho. Total = baixas − anterior + pendente + manual; o valor levado ao mês seguinte = pendente + manual. Aviso “O mês anterior não tem fechamento validado…”. Conferido: manual de 1.000.000 na PROVISAO do CC 1140 em julho soma exatamente, e a provisão anterior de agosto leva o manual de julho (diferença de 1.500.000).

T3 — Manual soma e histórico

ComoEm Valores manuais digite um valor numa linha de sistema e outro numa MANUAL. Recalcule.

EsperadoTotal = Sistema + Manual; a linha MANUAL tem Sistema vazio e Total = digitado. O histórico mostra valor anterior/novo; zerar apaga. Usuário sem BALANCO_MANUAL recebe a recusa da seção D.

T4 — Conversão

ComoMês 08/2026, modelo com U$ (cotação digitada 5.903).

EsperadoConvertido = Total ÷ 5.903. Sem a cotação digitada, a do sistema do último dia até o corte (a faixa mostra a data). Sem nenhuma: aviso e coluna em branco.

T5 — Fórmula e percentual

ComoConfira uma FORMULA (ex. total de receitas) e a PERCENTUAL (aguinaldo = 8,33333333% de SUELDOS).

EsperadoA fórmula soma sinal × total das linhas citadas; o percentual usa o total da base sem sinal. Conferência de 28/09: agosto = −496.787.268,25 contra a planilha −496.787.420,57 (diferença de 152,32, do percentual com poucas casas, que o decimal(12,8) deve reduzir a centavos). Julho difere da planilha porque ela congela a provisão de junho — some com junho validado.

T6 — Centro de custo sem linha

ComoLance um título num centro de custo que nenhuma linha usa e gere o mês.

EsperadoAviso com id, descrição e os quatro valores; o balanço não muda.

T7 — Filiais

ComoCom um usuário que não alcança uma filial do modelo, gere o mês.

EsperadoAviso “Filiais do modelo sem acesso … ficaram de fora”; valores menores. Sem nenhuma filial: recusa.

T8 — Tipos pendentes

ComoGere o mês do modelo da transportadora.

EsperadoAviso do tipo DIF_CAMBIAL_BANCO (a linha vale 0).