Transparência — como você confere os números você mesmo

Nível 1 — Integridade: o dado fecha? (25)

• V01 — V01 · O texto é número + faixa numérica + comparação; nenhum adjetivo de julgamento entra, e o modo 'adjetivo' da configuração está DESLIGADO.
• V02 — V02 · Uma frase, ≤ 35 palavras, sempre igual para a mesma entrada.
• V03 — V03 · Lucro negativo, EBITDA negativo, caixa líquido, banco, empresa nova sem histórico, dado defasado — cada um com o texto certo, nunca um número inventado.
• V04 — V04 · Verde sem nada; amarelo com ressalva em número central, reapresentação relevante recente ou balanço velho; vermelho quando o retrato pode enganar (reapresentação grande do próprio ano; a CVM já tem balanço mais novo).
• V05 — V05 · Os nomes do arquivo de configuração existem de fato: cada marca listada nasce em precos.
• V06 — V06 · Rodando para TODAS as companhias que negociam: nenhum termo proibido em texto algum; toda frase ≤ 35 palavras; a bandeira não é uniforme (se 90%+ fossem da mesma cor, não informaria nada); e o mesmo papel dá o mesmo veredito duas vezes.
• V07 — V07 · O corte "abaixo da Selic" do ROIC liga e desliga pelo arquivo de configuração: desligado, vale a faixa fixa; ligado e com a Selic média do exercício, a faixa diz abaixo/acima com o ano e a taxa; ligado e sem a Selic do ano, volta à faixa fixa (nunca inventa a taxa).
• V08 — V08 · Cada corte do arquivo de configuração tem o lado declarado: o limite inferior da faixa pertence a ela (5% é "entre 5% e 15%"); ROIC zero com a Selic ligada é "abaixo", não "negativo"; a própria história entra com 3 anos e não com 2; reapresentação conta dentro dos últimos 3 exercícios, a partir de 5% exatos, e só com diferença conhecida; vermelho exige MAIS de 10% no próprio ano (10% exatos não) e amarelo por idade exige MAIS de 15 meses; sem data de hoje, a idade não entra.
• V09 — V09 · A frase de topo só é encurtada quando PASSA do limite de palavras, e o corte tira exatamente o trecho "; setor X" (depois, o motivo do vermelho) — nada além; dívida líquida zero é "dívida 0,0x", não caixa líquido; margem zero com ressalva não vira "prejuízo"; número com RESSALVA não é narrado como "não se aplica" (nem "EBITDA negativo").
• V10 — V10 · O texto da bandeira diz a data do recebimento e quantos dos números centrais saíram publicados com o valor exato — e o motivo da reapresentação cita o corte como está no arquivo ("5%", não "5,0%").
• V11 — V11 · O veredito sai nas duas línguas: frase do topo, as seis linhas, as perguntas, a bandeira (texto e motivos) e a nota têm versão inglesa com os MESMOS números em formato inglês (ponto decimal), sem palavra portuguesa; toda faixa, marca "não se aplica", nota e faixa da Selic da configuração tem tradução; "não se aplica" de banco e ressalva também; nenhum termo proibido em inglês.
• V12 — V12 · A frase de topo diz de que dia é o preço do P/L ("com o preço de 25/02/2026, quando o balanço saiu"), traz o P/L com o último fechamento ("com o fechamento de 22/10/2026") e a mediana do setor, em português e inglês, com até 35 palavras.
• V13 — V13 · O P/L com o último fechamento é o múltiplo guardado × fechamento atual ÷ preço do balanço × o fator de ações dos eventos conferidos entre as duas datas (desdobramento 2 para 1 dobra as ações, o preço cai à metade, o P/L fica igual).
• I-V01 — `fatos_as_of` devolve, para cada período, a MAIOR versão cujo dt_receb é <= as_of, com `versao` e `dt_receb` em cada linha: 01/04 devolve a v1 (lucro 100), 01/05 devolve a v2 (lucro 80), e o dia exato do recebimento já vale a versão que chegou nele (<=, não <).
• I-V02 — Se a versão vigente em `as_of` existiu mas seus valores não foram guardados (a CVM só publica a mais recente), o período vem em `periodos` com `valores: "nao_arquivados"` e SEM linhas — nunca com os números da versão seguinte, que é o vazamento do futuro que o as_of existe para evitar.
• I-V03 — `trimestral=True` aplica a mesma regra por (ano, trimestre): a ITR do 1T/2023 com v1 em 10/05 e v2 em 20/06; as_of antes da v2 devolve a v1 arquivada, depois dela a v2, e a linha leva `trimestre`.
• I-V05 — Num CSV mínimo no formato da CVM com duas versões do mesmo documento: a v2 vence em `conta` e em `documento`; a v1 vai para `conta_versao` SÓ nas contas-chave (a conta que não alimenta item nenhum não é guardada); `documento_versao` guarda as duas versões com o ID_DOC e a data de cada uma; reingerir a v2 não arquiva de novo, e uma v1 que chega depois da v2 não sobrescreve nem arquiva.
• I-V07 — `conta_chave` aceita toda conta que `padronizar` lê (as fixas das duas tabelas de itens, o caixa das operações pelo método direto, as filhas da 3.02, D&A e capex da DFC, o PL e o lucro de banco pelo rótulo) e recusa o que nenhum item usa — é o que decide o que vai ao banco, e conta esquecida aqui some do passado em silêncio.
• I-V08 — O build que nasce do zero não perde as versões: (1) o que o banco ANTERIOR ainda guarda numa versão menor que a daqui vai para `conta_versao` (`capturar_do_banco_anterior`, só ordem U e só conta-chave, DFP e ITR); (2) o que o anterior já tinha em `conta_versao` vem junto na herança (`herdar_series_externas`); (3) sem banco anterior, ou com um que não tem as tabelas, devolve 0 sem levantar; (4) `conta_versao` está entre as contagens vigiadas do encolhimento.
• I-V10 — A versão antiga lida do XML do RAD entra em `conta_versao` na MESMA convenção das linhas da versão atual: só o exercício corrente (ordem U), consolidado/individual, escala aplicada, os dois formatos de número ("19.245.764" e "1552654" / "5741398,00"), DFC pelo método, DMPL só no PL total do exercício corrente, ITR só no trimestre isolado, conta-modelo (zero sem descrição) fora, `INSERT OR IGNORE` sem sobrescrever, e o que não bate vai para uma contagem por motivo em vez de quebrar.
• I-V11 — A versão antiga lida do `InfoFinaDFin.
• I-V12 — O caixa operacional de 2017 da WEGE3 (conta 6.01): 1,290 bi publicado na DFP 2017 (28/02/2018) e 1,107 bi republicado como comparativo na DFP 2018 v2 (10/04/2019).
• I-V13 — O comparativo NÃO substitui o original quando: o rótulo da conta mudou (quebra de série), o lado republicado veio zerado ("sem valor no arquivo"), a razão é de ~mil (escala), só existe em outra agregação, ou o próprio exercício foi REENTREGUE depois do comparativo (a versão mais nova do documento próprio vence).
• I-V14 — GET /empresas/{t}/fatos?as_of=: expõe `valor_origem`/`publico_em`/`documento_fonte` e o total `itens_republicados`; sem `as_of` o fato é o ORIGINAL (o que sustenta indicadores, múltiplos e a página), sem campo novo.
• I-V15 — Três republicações reais da tabela `reapresentacao` (PETR4, BBDC4 — plano de banco — e VALE3): o dia anterior ao recebimento da DFP seguinte devolve o original, o dia do recebimento devolve o republicado, nos dois tipos de plano de contas.

Nível 2 — Semântica: a conta significa o que o cálculo supõe? (3)

• I-V04 — Os itens montados a partir de `conta_versao` são os MESMOS que `padronizar` grava quando recebe as mesmas contas: empresa comum (conta exata, custo pela soma das filhas, sinal do custo, D&A e capex só de folhas e sem custo de dívida, ponte do PL) e banco (PL e lucro pelo rótulo).
• I-V06 — `listar_versoes`: cada documento com todas as versões, a data, o link do original e o que há de valores por versão (na_base / arquivados / nao_arquivados); entre duas versões com valores guardados, só as contas que MUDARAM (antes → depois), o lucro de 100 para 80 e a conta que não mudou fora; `so_reenviados` esconde o documento de uma versão só.
• I-V09 — GET /empresas/{t}/fatos: sem `as_of` devolve a última versão, exatamente como antes (sem `versao` nas linhas); com `as_of` devolve a vigente com `versao`/`dt_receb`; `as_of` inválido (formato errado, 30 de fevereiro, vazio) é 422 e não consulta o banco; ticker desconhecido é 404. GET /empresas/{t}/versoes lista o documento com as duas versões e `reenviados=true` filtra.

Nível 3 — Econômico: o resultado é possível no mundo real? (0)

Outros testes do produto (0)

Gate comercial, navegação e o conector MCP — testam se o produto funciona, não se um número está certo, então não entram nos 3 níveis acima por natureza. Contados e listados do mesmo jeito: