Validações do BI Contábil: Prontidão, Controle e Qualidade

B1. Não fecha: a conta do 251

RegraMesma do AsientoService.exigirFechamento: balance B não confere; T (Solo IFRS) confere pela moeda do lançamento (valor); os demais por valor_ml. Diferença = |Σ(débito) − Σ(crédito)| por asiento, arredondada a 2 casas.

TolerânciaAté 1 unidade da última casa por linha da moeda local da primeira filial do recorte = arredondamento (amarelo, e marcado "arredondamento" na lista). A diferença em dólar não tem tolerância (qualquer ≥ 0,01 é vermelho).

ListaA lista da checagem traz também os de arredondamento (dif > 0): o total da lista pode ser maior que o número vermelho da grade.

SELECT ca.numelan, ca.ano, ABS(ROUND(SUM(IF(ca.deb_cre='D',1,-1) * IF(ca.ifrs='T', ca.valor, COALESCE(ca.valor_ml,0))),2)) dif
FROM contabilidade_analitico ca
WHERE ca.excluido <> 'T' AND ca.data >= :ini AND ca.data < :fim
GROUP BY ca.numelan, ca.ano
HAVING MAX(ca.ifrs) <> 'B' AND dif > 0
ORDER BY dif DESC LIMIT 20;

B2. Conta inválida e sem dólar

Conta inválidaLEFT JOIN ct_plano_conta; inválida se plc.id IS NULL OR plc.analitica <> 'T' OR plc.excluido = 'T'. Na grade conta-se asientos; a lista é de linhas (até 300), com o motivo INEXISTENTE, EXCLUIDA ou SINTETICA.

Sem dólar (25F)valor <> 0 AND COALESCE(valor_us,0) = 0 AND ifrs NOT IN ('L','B') AND somente_conversao <> 'T'. Só vale em base IFRS (TEM_IFRS = 1 ou o 25G rodou no ano ou no anterior).

SELECT ca.numelan, ca.ano, ca.idplconta, plc.numero, plc.analitica, plc.excluido
FROM contabilidade_analitico ca LEFT JOIN ct_plano_conta plc ON plc.id = ca.idplconta
WHERE ca.excluido <> 'T' AND ca.data >= :ini AND ca.data < :fim
  AND (plc.id IS NULL OR plc.analitica <> 'T' OR plc.excluido = 'T') LIMIT 50;

B3. 25E / 25G: a rodada e o "depois"

RodadaLinhas vivas tabela = 'cie' AND somente_conversao = 'T' no último dia do mês, fora encerramento e resultado_ex (259). A hora da rodada = a primeira data_inclusao dessas linhas; 25E = ifrs <> 'T', 25G = ifrs = 'T'. São da base, não da filial.

DepoisAsientos cuja última data_inclusao (ignorando cie e o histórico "Redondeo de IFRS...") é posterior à rodada: o fechamento não os viu. Ressincronização do mês (252) apaga e regrava, então um mês reprocessado mostra dezenas de milhares de "depois".

Asientos excluídos depoisNão entram: a contagem custava ~60 s e repetia os incluídos.

B4. Sincronização por módulo (252)

MédiaAsientos automáticos (manual <> 'T', contados por numelan) de cada sigla nos 3 meses anteriores (inclusive os do ano anterior, por uma contagem leve à parte).

QuedaMês passado, sigla não vazia, média ≥ 10 e automáticos do mês < média ÷ 2.

Parou cedoMês passado e a última inclusão automática da sigla é anterior ao último dia do mês.

Foracie e ape não entram. O painel não diz qual documento ficou sem asiento: só a simulação do 252 diz (uma rodada de mês leva horas).

B5. Detalhe do mês e rastros

DetalheMódulos do mês (sigla, descrição, automáticos, manuais, média anterior, última automática), datas de fechamento por filial (udf, udf_fat, udf_cont de parametros, por filial_ativa — nunca filial.udf) e a lista da checagem.

Conferir rastrosSob pedido: ConferenciaContabilService.conferir do mês (contabilizado duas vezes, asiento apagado, documento excluído com asiento vivo, data alterada). Pode demorar; é a mesma conferência do relatório de conferência contábil.

Erros"Informe o mês."; "Checagem desconhecida: X" (a checagem vai na URL e é um enum, nunca vira SQL).

C1. "Manual" e o resumo do asiento

Cada asiento manual é resumido por GROUP BY numelan, ano: data = menor data; filial = menor idfilial_dado; débito = Σ valor_ml das linhas D; conferido = maior idusuario_conferiu; banco = alguma linha em conta bancária; excluído = alguma linha excluido = 'T'. Os incluídos usam data_inclusao no período; os excluídos usam data_exclusao.

Observação: o débito soma valor_ml para todos; o 38B usa valor (a moeda do lançamento) nos asientos "Solo IFRS" (ifrs = 'T'). Um manual "Solo IFRS" pode aparecer com débito local zero aqui.

C2. A exclusão e o índice data_exclusao

Por que é pesadoA consulta de excluídos só tinha o índice (excluido, data): varre todas as linhas excluídas do alcance (as ressincronizações excluem milhões) e, de uma vez, a conexão caía (Can not read response from server ... EOFException em manuaisExcluidos, 03/10).

HojeSem o índice data_exclusao: varre em fatias de um mês de data (de início − 186 dias até o fim do período) e junta o mesmo asiento. Com o índice (aprovado em 03/10; o usuário o cria em cada base e reinicia o backend, porque IndicesDaTabela guarda o schema em cache): uma consulta só com FORCE INDEX.

FalhaSe a leitura das exclusões falhar, o controle sai sem elas, com o aviso "Os asientos manuais excluídos não puderam ser lidos (o banco não respondeu a tempo)..." e excluidosIndisponiveis: true; não vai ao cache (tentar de novo com Atualizar).

C3. Quadros: por usuário, mapa dia × hora, contas fora do padrão

Por usuárioManuais incluídos, débito somado, já excluídos, quantos ele excluiu e os alertas dele (autoconferência não conta). Ordenado pelo valor.

MapaQuadradinho = dia da semana × hora da inclusão dos manuais; a borda marca o fora do horário.

Contas fora do padrão (sob pedido, botão Analisar, mês aaaa-mm)Movimento líquido do mês (D − C, valor_ml) por conta × os 12 meses anteriores; meses sem movimento contam zero; desvio-padrão com n−1; entra a conta com |z| ≥ 3 (conta sem histórico é "nova"). Com valor informado, só desvio absoluto ≥ ele. Fora: contas analíticas de emitente (ct_plano_conta.idemitente), cie, encerramento e resultado do exercício. Até 100 contas. Erro "Informe o mês (aaaa-mm).". ~60 s em fjfrigo_concepcion.

Erros do período

"Informe a data inicial." / "Data final inválida: ..." / "A data final é anterior à inicial." / "Escolha um período de até três meses." (mais de 93 dias) / "Hora inválida: ..." (só pela API).

D1. Origem do asiento

RegraConsidera só o asiento vivo (alguma linha excluido <> 'T'): automático = manual <> 'T'; mexido ("retrabalho" no JSON) = tem sigla e manual = 'T' (a sincronização gravou e alguém alterou no 251); digitado = sem sigla e manual.

Foratabela IN ('cie','ape') (fechamento cambial e apertura), encerramento = 'T' e resultado_ex = 'T' (259): não são contabilização de documento.

D2. Prazo até contabilizar

RegraDias entre a maior data do asiento e a primeira data_inclusao (mínimo 0). A regravação do 252 reaproveita o numelan e marca as linhas antigas excluido='T', então a primeira inclusão está nas excluídas — por isso a consulta lê as excluídas e só conta asiento com linha viva.

Faixasaté 5, 6–15, 16–30, mais de 30 dias. Em fjfrigo_concepcion, julho/2026: 8,6 dias pela primeira inclusão, 25,6 pela versão atual.

Por móduloEm vermelho, módulo com mais de 20% contabilizado depois de 30 dias (regra do front).

D3. Regravações e conferência

Regravações (versões)Horas distintas (%Y%m%d%H) de data_inclusao das linhas automáticas do asiento (cada rodada do 252 grava numa hora). Uma versão = gravado uma vez. Asiento só manual tem 0 versões. "Regravados" = mais de 1 versão.

ConferênciaAsiento vivo com idusuario_conferiu; prazo = da data_inclusao atual até data_conferido. Por conferente: conferidos por mês e dias médios.

Atenção ao lerEm homologação as rodadas de validação do porte regravam tudo (11,1 versões por asiento em 2026 no concepcion); em produção o número deve ficar perto de 1 e é o que vale vigiar.

T1. 38B — asientos que não fecham

PassosAbrir o 38B no ano e clicar na célula "não fecham" de um mês.

EsperadoO número vermelho = asientos com diferença acima da tolerância; a lista traz também os de arredondamento (marcados). Concepcion, 2026: 32 a 146 por mês (685 no ano) + 145 de arredondamento; julho: os 6 maiores são reversões de provisão de exportação (fvxr) só com crédito.

ConferirConsulta de B1 (acima) para o mesmo mês.

T2. 38B — mês fechado e anteriores

PassosComparar a linha "Mês fechado" com a 421 (Fechamento) e parametros.

EsperadoTODAS quando udf_cont >= último dia em todas as filiais do recorte. Em concepcion/2026 tudo aberto (udf_cont = 31/12/2025 nas 34 filiais).

Conferir

SELECT f.id_filial, p.udf, p.udf_fat, p.udf_cont FROM filial f
LEFT JOIN parametros p ON p.filial_ativa = f.id_filial ORDER BY f.id_filial;

T3. 38B — 25E/25G e módulos

PassosVer a linha do 25E e a tabela "Módulos no mês" de um mês passado.

EsperadoRodada = primeira inclusão do cie do último dia; "N depois" = incluídos depois. Sigla com automáticos < metade da média dos 3 meses anteriores marcada como queda.

Conferir

SELECT MIN(IF(ifrs <> 'T', data_inclusao, NULL)) t25e, MIN(IF(ifrs = 'T', data_inclusao, NULL)) t25g
FROM contabilidade_analitico
WHERE excluido <> 'T' AND tabela = 'cie' AND somente_conversao = 'T' AND encerramento <> 'T' AND resultado_ex <> 'T'
  AND data = LAST_DAY(:ult_dia_do_mes);

T4. 38B — filial

PassosTrocar "Todas" por uma filial; comparar os totais.

EsperadoO asiento entra se alguma linha for da filial; asiento entre filiais não aparece como "não fecha" por causa de uma linha só. Filial fora do acesso: mensagem.

T5. 38G — manual em mês fechado e reabertura

PassosPeríodo de um mês em que a U.D.F. foi trocada. Abrir os alertas Reaberturas e Em mês já fechado.

EsperadoReabertura mostra de que data para qual, quanto tempo e quantos manuais; "em mês já fechado" lista o manual com data ≤ maior U.D.F. do log naquela hora.

Conferir

SELECT data, idfilial, DATE(udf_cont) ate, idusuario, motivo_alteracao FROM udf_log
WHERE udf_cont IS NOT NULL AND data >= :ini AND data < :fim ORDER BY data;

T6. 38G — valor alto, exclusão, horário

PassosSem informar o limite, ver o "sugerido"; informar um valor menor; ver Manual excluído e Fora do horário.

EsperadoLimite sugerido = p99 dos manuais do período (nulo com menos de 20). Valor ≥ 10× o limite é alta. Excluído: asiento manual com data_exclusao no período. Fora do horário: antes das 6h, depois das 20h, sábado ou domingo.

Conferir

SELECT ca.numelan, ca.ano, MIN(ca.data_inclusao) quando, SUM(IF(ca.deb_cre='D', COALESCE(ca.valor_ml,0), 0)) debito
FROM contabilidade_analitico ca
WHERE ca.manual = 'T' AND ca.data_inclusao >= :ini AND ca.data_inclusao < :fim
GROUP BY ca.numelan, ca.ano ORDER BY debito DESC LIMIT 20;

T7. 38G — exclusões indisponíveis

PassosEm base sem o índice data_exclusao, período longo; se o banco estiver lento, ver o aviso.

EsperadoPainel completo sem os excluídos + aviso; "Atualizar" tenta de novo (o resultado incompleto não fica em cache).

T8. 38K — origem, prazo e regravações

PassosAbrir o 38K do ano; conferir janeiro (mês com maior prazo) e um módulo.

EsperadoConcepcion, jan–ago/2026: 380.060 asientos, 98,4% automáticos; 4.980 mexidos; 1.063 digitados; prazo médio 12,8 dias; 11,1 versões por asiento. Janeiro bate com o 38B (1.549 de 57.600).

Conferir

SELECT COUNT(*) FROM (SELECT ca.numelan, ca.ano FROM contabilidade_analitico ca
 WHERE ca.data >= :ini AND ca.data < :fim AND (ca.tabela IS NULL OR ca.tabela NOT IN ('cie','ape'))
   AND ca.encerramento <> 'T' AND ca.resultado_ex <> 'T'
 GROUP BY ca.numelan, ca.ano HAVING MAX(ca.excluido <> 'T') = 1) x;

Status

PARCIAL em docs/status-porte.csv (03/10/2026) para os três: falta teste na tela real (endpoints novos: reiniciar o backend). Telas vistas só numa prévia temporária com o JSON real.

Tempo de resposta

38B: a passada do ano leva ~30 s com o servidor livre e 95 a 240 s com restore/consultas pesadas no mesmo servidor (concepcion, 380 mil asientos); a lista do mês ~6 s. A chamada é cancelável. Se pesar em produção: guardar por mais tempo os meses já fechados e reapurar só os abertos. 38G: julho/2026 35 s; agosto 106 s antes de encurtar o alcance das exclusões para 186 dias; contas fora do padrão ~64 s. 38K: 38 s o ano.

Achados do histórico (concepcion/2026), ainda sem decisão

Reversões de provisão de exportação (fvxr) só com crédito (débito zero, 1,9 a 2,3 bi de G$ cada) incluídas em 28/08/2026 por uma rodada do porte (252): suspeita de defeito no SincVendaExportacao — não investigado.

386 manuais excluídos em 28/08 às 23:24 pelo usuário da regravação do porte (252) apagando asientos com manual='T': vale conferir se o legado faz o mesmo — não investigado.

Conta inválida em junho: 1.061 linhas de baixas (fba) nas contas 144 "CHEQUES EMITIDOS" e 117 "RECAUDACIONES A DEPOSITAR", que estão analitica='F' no plano.

25E desatualizado em junho (28.568 asientos incluídos depois do fechamento por ressincronização); 25G só rodou em julho em 2026 (TEM_IFRS = 0 mas o painel trata a base como IFRS por causa das linhas do 25G); 25E com data 31/12/2026 gravado em 13/02/2026 aparece em "mês futuro".

Conferência: 4,9% dos asientos conferidos no ano; setembro sem movimento (cópia de homologação parada em agosto): todas as siglas acusam queda.

Pontos a saber

38B não diz qual documento ficou sem asiento (sinal indireto por sigla); o 421 (FechamentoChecklistService) diz no javadoc que o checklist contábil "fica para depois" — o 38B é candidato a alimentá-lo (não feito).

38G: MES_JA_FECHADO manual e automático comparam a data do lançamento com a U.D.F. (corrigido em 04/10/2026: o automático comparava o último dia do mês; em fjfrigo_concepcion, inclusões de 2025-01 a 2026-06, +913 alertas e +1,02 mi asientos).

38G: o limite sugerido pelo percentil dos 12 meses anteriores foi descartado (passou de 150 s). O percentil é do próprio período.

Os painéis 38B/38G/38K usam idfilial_dado da linha; o asiento entre filiais entra nos dois recortes.

As siglas novas do 252 que não estão no dicionário aparecem com a própria sigla no lugar da descrição.