Especificação de Relatórios Belite

Este documento define os relatórios de acompanhamento do Belite. Ele serve tanto para quem vai desenvolver os relatórios quanto para quem vai usá-los ou validá-los, então descreve primeiro o que cada relatório faz em linguagem de negócio e reúne no final uma seção técnica com fórmulas e comportamentos.

Como ler este documento

• A Seção 1 é o Dicionário de Termos. Todos os nomes usados no restante do documento seguem esse dicionário, sem exceção.
• A Seção 2 traz as regras comuns a todos os relatórios (fontes de dados, filtros, comparações, objetivos e exportação).
• As Seções 3, 4 e 5 descrevem cada relatório.
• A Seção 6 é a referência de implementação, voltada ao desenvolvedor, com fórmulas, comportamentos especiais e os pontos que ainda precisam de confirmação.

---

1. Dicionário de Termos

Regra geral: use sempre o termo padrão. Os termos da coluna "Nunca usar" descrevem a mesma coisa de forma errada e não devem aparecer em nenhum relatório, tela, coluna ou rótulo.

Termo padrão	O que é	Nunca usar
Simulação	Etapa anterior à Operação, quando ainda não foi salva.	Operação, Ficha, Proposta
Operação	Agrupamento de envios que contempla uma possibilidade de venda. Cada Operação só pode virar um Contrato.	Ficha, Proposta, Contrato
Envios	Disparos unitários para análise de crédito em bancos diversos que compõem uma Operação. Uma Operação pode ter N envios.	Ficha, Proposta, Contrato, Operação
Contrato	Ficha de financiamento que já está faturada ou paga.	Vol. Financiado, Ficha, Operação, Proposta
Fabricante	Montadora à qual uma Empresa está vinculada. Sem Fabricante vinculado, a Empresa é MULTIMARCAS.	Marca (quando se refere à montadora)
Marca	Marca associada a um modelo de veículo específico. Só quando se refere a um veículo, não a uma montadora.	Fabricante, Montadora (quando se refere ao veículo)
Lojas	Nome de uma loja no sistema. Toda loja está vinculada a uma Empresa.	PDV, Ponto de venda
Banco	Instituição que opera o crédito de financiamento.	IF, Instituição Financeira

Regra prática de Fabricante x Marca: no nível da Empresa ou da Loja, o termo é Fabricante. No nível do veículo ou modelo, o termo é Marca.

Hierarquia de produção: Simulação → Operação → Envios → Contrato. A Simulação acontece antes de salvar. Ao salvar, vira Operação. Cada Operação gera um ou mais Envios aos bancos. Quando faturada ou paga, a Operação vira Contrato.

Hierarquia de organização: Fabricante → Empresa → Lojas. A Empresa é um grupo de lojas de um mesmo Fabricante, mas nos relatórios ela já está representada pelo Fabricante, então não é citada diretamente.

---

2. Regras comuns a todos os relatórios

2.1 Fontes de dados

• FANDI: dados de financiamento (operações, envios, contratos, rentabilidade, retorno, plus, bônus, comissões, bancos, taxas).
• DMS: dados de venda do veículo (quantidade de vendas, modalidade de venda, valor de compra, valor de venda).
• Emplacamento: dados de licenciamento de veículos no mercado. Usados como referência da evolução do Fabricante na régua de comparação.

2.2 Filtros mínimos

Todo relatório traz, no mínimo, este conjunto de filtros: Mês, Período, Fabricante, Departamento, Loja e Banco. Cada relatório pode ter filtros adicionais próprios (por exemplo, o seletor de títulos do Relatório de Títulos).

O filtro Departamento assume três valores: Novos, Seminovos e Venda Direta.

2.3 Régua de comparação

Nos relatórios que usam comparação (Monitor F&I e One Page), cada número é comparado com três referências, e cada referência aparece só quando existe o dado:

• Mês anterior: o mesmo período do mês anterior.
• Objetivo: a meta cadastrada para aquele indicador, quando houver (ver 2.4).
• Evolução do Fabricante: o movimento do Fabricante no mercado, com base no Emplacamento, quando houver.

O Relatório de Títulos não usa a régua de comparação, por ser uma foto do período para fechamento de comissão.

2.4 Objetivos

O sistema tem um local de cadastro de metas chamado Objetivos. Nele, o administrador cadastra metas que alimentam a comparação por Objetivo da régua acima.

• As metas podem ser cadastradas por Fabricante e por Banco.
• Qualquer indicador pode receber um Objetivo.
• Quando um indicador tem Objetivo cadastrado para o recorte em tela, o relatório mostra a comparação contra a meta. Quando não tem, a comparação por Objetivo simplesmente não aparece.

2.5 Exportação CSV

Todos os relatórios têm a opção de exportar CSV. A exportação respeita os filtros aplicados no momento e reflete a visão que está na tela.

2.6 Nomenclatura na interface

Toda a interface (filtros, abas, títulos de gráfico, cabeçalhos de coluna e rótulos) segue o Dicionário de Termos da Seção 1.

---

3. Relatório 1: Monitor F&I

Objetivo: permitir que o F&I acompanhe a operação e a produção diariamente.

Premissa: facilitar o acompanhamento diário de toda a visão de financiamento, até a granularidade de contrato.

Público: gestor de F&I e analista.

Fonte: FANDI, com valor vendido do DMS.

Status: já construído, em fase de ajuste. As telas atuais servem de base. Os ajustes de nomenclatura estão listados ao final desta seção.

Estrutura

Filtros: os filtros mínimos comuns (Mês, Período, Fabricante, Departamento, Loja, Banco).

Big numbers no topo: Total Financiado (R$), Total Rentabilidade C/ Produto (R$), Clientes (quantidade), Envios (quantidade) e Contratos (quantidade). Cada um segue a régua de comparação (mês anterior, Objetivo, evolução do Fabricante).

Gráfico: Rentabilidade total por Fabricante, em barras horizontais ordenadas do maior para o menor. O gráfico traz duas séries lado a lado por Fabricante, rentabilidade e volume de contratos, para que a leitura de eficiência não se perca no valor absoluto.

Visões (abas): Fabricantes, Bancos, Lojas, Operações. As três primeiras são consolidações; a última desce ao nível da operação individual.

Colunas por visão

Visão Fabricantes: Fabricante, Lojas, Contratos, Bancos Disponíveis, Total Vendido, Total Financiado, Total Retorno, Total Plus, Total Bônus, Total Meta, Total Prod. Banco, Total Prod. Loja, Total Rentabilidade C/ Produto. Linha de Total ao final.

Visão Bancos: Banco, Lojas, Contratos, Total Vendido, Total Financiado, Total Retorno, Total Plus, Total Bônus, Total Meta, Total Prod. Banco, Total Prod. Loja, Total Rentabilidade C/ Produto.

Visão Lojas: Loja, Contratos, Total Vendido, Total Financiado, Total Retorno, Total Plus, Total Bônus, Total Meta, Total Prod. Banco, Total Prod. Loja, Total Rentabilidade C/ Produto.

Visão Operações (nível de contrato): Loja, Cód. Operação, Data, Cliente, Tipo de Pessoa (PF ou PJ), Veículo, Vendido, Financiado, Taxa ao mês, Nome da Tabela, Rentabilidade C/ Produto.

Ajustes de nomenclatura na interface atual

Correções para alinhar as telas existentes ao dicionário:

• Filtro "Marca" passa a "Fabricante".
• Filtro "IF" passa a "Banco".
• Título do gráfico "Rentabilidade total por Marcas" passa a "Rentabilidade total por Fabricante".
• Aba "Marcas" passa a "Fabricantes".
• Aba "IFs" passa a "Bancos".
• Coluna "Marca" passa a "Fabricante".
• Coluna "IF" passa a "Banco".
• Coluna e big number "Vol. Financiado" passam a "Contratos".
• Coluna "IFs Disponíveis" passa a "Bancos Disponíveis".
• Na visão Operações, "ID Op." passa a "Cód. Operação", "Carro" passa a "Veículo" e a coluna "Chassi" é removida.

---

4. Relatório 2: Relatório de Títulos

Objetivo: demonstrar de forma clara o comissionamento da loja, tanto o que ela tem a receber quanto o que tem a pagar, de modo que seja simples baixar uma planilha de comissão da equipe.

Premissa: facilitar o acesso ao arquivo de comissionamento do time.

Público: gestor de F&I e analista.

Fonte: FANDI.

Estrutura

Filtros: os filtros mínimos comuns (Mês, Período, Fabricante, Departamento, Loja, Banco), mais um seletor de títulos. O seletor permite escolher um ou mais tipos de título, e afeta ao mesmo tempo os big numbers, o gráfico e a tabela. Assim é possível, por exemplo, olhar apenas a Comissão Vendedor, ou tirar o Valor Financiado da conta quando for o caso.

Big numbers no topo:

• Títulos a Receber, em R$.
• Títulos a Pagar, em R$.

Receber e Pagar são apresentados lado a lado. Não há saldo entre eles, porque não seguem a mesma base de cálculo.

Composição de cada tipo de título:

Títulos a receber são os valores que a loja tem para receber em cada operação, sempre em R$. Compreendem Valor Financiado, Retorno, Plus, Bônus, Comissão Produto Banco e Comissão Produto Loja.

O Valor Financiado entra na soma do recebível, porque é um valor que a loja vai receber. A exceção é a venda direta: nela o Valor Financiado não entra na conta de títulos a receber. O seletor de títulos é o mecanismo para tratar esses casos, permitindo incluir ou excluir cada tipo de título da visão.

Títulos a pagar são apenas as comissões que a loja tem a pagar, como Comissão Vendedor e Comissão Consultor F&I. Não entram encargos como ILA, IR e afins.

Gráfico: Títulos por Fabricante, em barras empilhadas, com os tipos de título empilhados dentro de cada Fabricante.

Tabela detalhada

Uma linha por título. Colunas:

• Cód. Operação
• Data Faturamento
• Tipo do Título (A Receber ou A Pagar)
• Loja
• Fabricante
• Devedor: quem paga o título. Em um título a receber, é o banco. Em um título a pagar, é a loja.
• Perfil: o tipo de recebedor ou pagador, como vendedor, consultor, banco ou loja.
• Usuário: o nome da pessoa vinculada ao título.
• Valor, em R$

Esta tabela é a base da planilha de comissão. A exportação CSV (ver 2.5) devolve exatamente estas colunas, respeitando os filtros e o seletor de títulos.

---

5. Relatório 3: One Page

Objetivo: dar ao dono e ao diretor uma leitura rápida dos números do grupo, com insights, em uma única página. Este relatório não substitui o relatório de diagnóstico Belite, que traz Belite Score, P90 e benchmark de mercado. Aqui o foco é acompanhar os próprios números, com insights.

Premissa: tudo em uma tela, apenas big numbers, sem tabela e sem abas. A página mostra ao mesmo tempo o número do grupo e as visões por Fabricante e por Banco.

Público: dono e diretor.

Fonte: FANDI, DMS e Emplacamento.

Estrutura

Filtros: os filtros mínimos comuns (Mês, Período, Fabricante, Departamento, Loja, Banco). Servem para o diretor recortar a visão, por exemplo uma loja ou um departamento específico.

Régua de comparação: cada indicador segue a régua comum (mês anterior, Objetivo, evolução do Fabricante), igual ao Monitor F&I.

Blocos da página, todos visíveis na mesma tela, sem abas:

• Grupo: os indicadores consolidados do grupo.
• Por Fabricante: os mesmos indicadores abertos por Fabricante.
• Por Banco: os indicadores abertos por Banco.

Insights: a página destaca observações de acompanhamento junto dos números, apontando variações relevantes, por exemplo penetração em queda ou um banco ganhando share.

Boletim Diário: o One Page tem a opção de envio diário automático, chamado Boletim Diário. Quando ativado, envia o resumo da página uma vez por dia por e-mail, com as informações no corpo do e-mail.

Indicadores

Indicador	Descrição	Fonte
Vendas	Quantidade de vendas, todas as modalidades	DMS
Contratos	Quantidade de vendas financiadas	FANDI
Total Financiado	Valor financiado, em R$	FANDI
RPUV	Rentabilidade por unidade vendida	FANDI e DMS
RPUF	Rentabilidade por unidade financiada	FANDI
Rentabilidade C/ Produto	Rentabilidade do financiado, incluindo produtos, em R$	FANDI
Penetração	Contratos ÷ Vendas	FANDI e DMS
Share por banco	Total Financiado no banco ÷ Total Financiado geral, incluindo financiamento externo	FANDI e DMS
Margem por carro	(Valor de venda menos valor de compra) ÷ valor de compra, em %	DMS

Observação de layout: Share por banco é uma distribuição. Para manter a premissa de uma página sem tabela, pode ser um elemento visual compacto, como donut ou barra.

---

6. Referência de implementação

Seção voltada ao desenvolvedor. Reúne fórmulas, comportamentos especiais e pontos a confirmar.

6.1 Fórmulas dos indicadores

Para cálculos de rentabilidade por unidade, usar sempre contratos faturados, não o total de operações ou envios.

• Penetração = Contratos ÷ Vendas. Contratos vem do FANDI, Vendas vem do DMS.
• RPUF (Rentabilidade por Unidade Financiada) = Rentabilidade C/ Produto ÷ Contratos. Usar o total da rentabilidade dividido pelo total de contratos faturados, não a média simples de uma coluna de RPUF por linha.
• RPUV (Rentabilidade por Unidade Vendida) = Rentabilidade C/ Produto ÷ Vendas.
• Share por banco = Total Financiado no banco ÷ Total Financiado geral. O denominador inclui o financiamento externo (financiamentos que não passaram pelo FANDI), para refletir o mercado real do grupo.
• Margem por carro = (Valor de venda menos Valor de compra) ÷ Valor de compra, apresentada em percentual.
• Rentabilidade S/ Produto = Retorno + Plus + Bônus + Meta.
• Rentabilidade C/ Produto = Retorno + Plus + Bônus + Meta + Produto Loja + Produto Banco. Ou seja, a Rentabilidade S/ Produto somada às duas comissões de produto.

O componente Meta (coluna Total Meta) é um tipo de rentabilidade: um valor recebido de um banco atrelado ao atingimento de uma meta. Não tem relação com o módulo Objetivos.

6.2 Comportamentos especiais

• Venda direta: no Relatório de Títulos, operações de venda direta não somam o Valor Financiado em Títulos a Receber. Os demais títulos da operação continuam contando. A venda direta é identificada pelo filtro Departamento (valor Venda Direta).
• Seletor de títulos: no Relatório de Títulos, os big numbers, o gráfico e a tabela recalculam conforme os tipos de título selecionados. Com nenhum tipo selecionado, considerar todos.
• Régua de comparação por disponibilidade de dado: cada uma das três comparações (mês anterior, Objetivo, evolução do Fabricante) só aparece quando o dado existe para o recorte em tela. A ausência de um deles não bloqueia os outros.
• Emplacamento sem correspondência: quando não há dado de emplacamento para o Fabricante ou período, a comparação de evolução do Fabricante fica oculta.

6.3 Recursos transversais

• Exportar CSV: disponível em todos os relatórios, respeita filtros e, no Relatório de Títulos, também o seletor de títulos.
• Objetivos: módulo de cadastro de metas. Admin cadastra por Fabricante e por Banco, e qualquer indicador pode ter meta. As metas alimentam a comparação por Objetivo da régua.
• Boletim Diário: envio diário automático do One Page por e-mail, com as informações no corpo do e-mail.