Validação

Antes de gerar seu modelo financeiro, a aplicação executa um conjunto abrangente de verificações estruturais e de completude na sua especificação. A validação detecta problemas de configuração antecipadamente, prevenindo falhas na geração e garantindo que o modelo Excel gerado seja internamente consistente.

Pense na validação como uma lista de verificação pré-voo. Assim como um piloto verifica instrumentos, combustível e controles antes da decolagem, a validação verifica que a especificação do seu modelo está completa e coerente antes que o processo de geração comece.

Níveis de Severidade

Cada achado de validação é classificado em um dos três níveis de severidade:

Erros

Erros representam problemas que devem ser corrigidos antes da geração. O processo de geração não será iniciado se houver erros presentes. Erros indicam problemas estruturais que produziriam um modelo Excel quebrado ou incorreto.

Exemplos de erros:

Um prefixo obrigatório de Conta Mestre está ausente.
Uma conta referencia um pai que não existe.
Códigos de conta duplicados estão definidos.
Nenhum período de projeção está configurado.

Avisos

Avisos indicam problemas potenciais que não bloqueiam a geração mas podem resultar em saída inesperada. O modelo pode ser gerado com avisos presentes, mas você deve revisá-los para decidir se requerem atenção.

Exemplos de avisos:

Uma conta está definida mas não é referenciada por nenhum pai (conta órfã).
Um link de Premissas-Chave está habilitado mas nenhuma conta elegível existe.
Um gráfico referencia um código de conta que não possui dados.
A taxa de crescimento na perpetuidade está próxima da taxa de desconto.

Informações

Achados informacionais fornecem contexto e sugestões sem indicar nenhum problema. Eles ajudam você a entender a configuração do modelo e podem sugerir melhorias.

Exemplos de achados informativos:

O modelo contém um grande número de contas (nota de desempenho).
Certos recursos opcionais não estão configurados.
Estatísticas resumidas sobre a especificação.

Erros de Validação Comuns e Como Resolvê-los

Contas Mestre Ausentes

Mensagem: "O prefixo da Demonstração de Resultado não está definido" (ou similar para outras demonstrações).

Causa: Um ou mais prefixos de Contas Mestre não foram definidos.

Correção: Navegue até a seção de Contas Mestre e atribua um prefixo numérico a cada categoria de demonstração financeira. Todos os cinco prefixos (Demonstração de Resultado, Ativos, Passivos, Demonstração de Fluxo de Caixa, Fluxo de Caixa Livre) devem ser definidos.

Referências de Contas Órfãs

Mensagem: "A conta 3150 referencia o pai 3100, que não existe."

Causa: O código pai de uma conta aponta para uma conta que não está definida no plano de contas.

Correção: Crie a conta pai ausente ou atualize a referência pai da conta filha para apontar para uma conta existente.

Códigos de Conta Duplicados

Mensagem: "O código de conta 3100 é usado por múltiplas contas."

Causa: Duas ou mais contas compartilham o mesmo código. Códigos de conta devem ser únicos.

Correção: Altere um dos códigos duplicados para um valor único. Revise seu esquema de numeração para prevenir colisões futuras.

Períodos Ausentes

Mensagem: "Nenhum período de projeção está definido."

Causa: O modelo não possui períodos de tempo configurados, portanto não há nada para projetar.

Correção: Navegue até a seção de Períodos e defina pelo menos um período de projeção com datas de início e término.

Referências Circulares

Mensagem: "Dependência circular detectada envolvendo as contas 3100, 3200, 3300."

Causa: Uma cadeia de referências de contas forma um loop (A referencia B, B referencia C, C referencia A).

Correção: Revise os relacionamentos pai-filho e as referências de fórmulas das contas sinalizadas. Quebre o ciclo alterando a referência de uma conta.

Código de Conta FCF ou EBITDA Inválido

Mensagem: "O Código de Conta FCF 5100 não corresponde a nenhuma conta existente."

Causa: O código de conta especificado nas Contas Mestre para FCF ou EBITDA não corresponde a uma conta definida.

Correção: Crie a conta referenciada ou atualize a configuração das Contas Mestre para apontar para um código de conta existente.

A Tela de Validação

A interface de validação apresenta os achados em um layout organizado:

Cartões de Resumo

No topo, cartões de resumo mostram a contagem de erros, avisos e itens informativos. A codificação por cores (vermelho para erros, âmbar para avisos, azul para informações) fornece uma percepção imediata da saúde da especificação.

Cartões de Problemas

Abaixo do resumo, cada achado é exibido como um cartão clicável. Os cartões incluem:

Ícone de severidade — erro, aviso ou informação.
Mensagem — uma descrição clara do achado.
Conta ou seção afetada — identifica onde o problema se origina.

Clicar em um cartão de problema navega diretamente para a seção ou conta afetada no editor, para que você possa corrigir o problema sem precisar procurá-lo manualmente.

Quando a Validação é Executada

A validação é executada automaticamente:

Antes de cada geração — o endpoint de geração executa exatamente a mesma rotina de validação do botão Validar (um único portão compartilhado, de modo que os dois nunca podem divergir). Se erros forem encontrados, a geração é recusada e os achados são retornados.
Sob demanda — você pode acionar a validação a qualquer momento a partir da seção de Validação para verificar a saúde da sua especificação sem iniciar uma geração.
Ao abrir e importar — abrir uma especificação Excel ou importar YAML também executa o portão e relata o resultado, de modo que você vê a saúde de um arquivo no momento em que ele é carregado.

A validação não modifica sua especificação. É uma verificação somente leitura que relata achados para sua revisão.

Boas Práticas

Valide frequentemente durante o desenvolvimento do modelo, não apenas antes de gerar. Detectar problemas cedo é mais rápido do que depurá-los depois de criar muitas contas.
Corrija os erros primeiro, depois revise os avisos. Erros bloqueiam a geração; avisos são consultivos.
Não ignore avisos. Embora não impeçam a geração, eles frequentemente indicam problemas reais que produzirão saída confusa.
Use o recurso de clique para navegar nos cartões de problemas para ir diretamente aos problemas em vez de percorrer a especificação manualmente.