Dicionário de Indicadores e Regras de Negócio¶

Sistema: Drexies Agro | Responsável: Equipe de Dados Sonar

Este dicionário reúne os indicadores, classificações e cálculos identificados no código da Drexies Agro. Os itens estão organizados por assunto e descrevem o comportamento implementado na plataforma.

Escopo

As fórmulas abaixo representam o que está implementado no código analisado. Regras financeiras que dependem de confirmação da área responsável estão explicitamente sinalizadas como Ponto a validar.

1. Mercado e carteira¶

Indicador	Definição e finalidade	Regra identificada	Formato
Mercado total	Quantidade total de produtores no contexto selecionado, incluindo clientes e não clientes	Soma dos produtores classificados como clientes e não clientes nas categorias do dashboard	Quantidade
Carteira de clientes	Produtores identificados como pertencentes à carteira	Soma dos clientes nas classes A, B, C e D e nos segmentos exibidos	Quantidade
Não clientes	Produtores que não pertencem à carteira atual	Soma dos não clientes nas classes e segmentos exibidos	Quantidade
Potencial a explorar	Leitura da parcela do mercado ainda não atendida	No dashboard, corresponde aos produtores classificados como não clientes e é apresentado por segmento	Quantidade
Participação da carteira	Representatividade dos clientes dentro do mercado total	`Carteira ÷ Mercado total × 100`	Percentual
Classe A na carteira	Clientes da carteira classificados como Classe A	Contagem de clientes Classe A	Quantidade
Participação da Classe A	Representatividade dos clientes Classe A no total da Classe A do mercado	`Classe A da carteira ÷ Classe A do mercado × 100`	Percentual

Quando o denominador necessário ao cálculo percentual é zero, a interface evita uma divisão válida e apresenta o comportamento de ausência ou valor neutro definido pelo componente.

2. Segmentação de produtores por área¶

A categoria de porte é determinada a partir do total de hectares usado para o produtor.

Segmento	Regra
Top Farmer	701 ha ou mais
Top Standard	17 a 700 ha
Standard	5 a 16 ha
Small	2 a 4 ha
Micro Farmer	Menos de 2 ha

Total de hectares do produtor¶

O código aplica a seguinte prioridade:

Soma todas as áreas plantadas das propriedades do produtor.
Se nenhuma propriedade possuir plantio declarado, soma a área agricultável das propriedades.

Hectares do produtor =
  área plantada total, quando maior que zero;
  caso contrário, área agricultável total

Unidade: hectares (ha).

3. Classes A, B, C e D¶

Interpretação exibida¶

Classe	Identificação na interface	Interpretação exibida
A	Premium	Utiliza tecnologia, apresenta boa saúde financeira e não possui restrições socioambientais
B	Potencial	Apresenta boa saúde financeira e não possui restrições socioambientais, mas ainda não utiliza tecnologia
C	Atenção	Apresenta situação financeira negativa ou restrição socioambiental
D	Risco	Apresenta situação financeira negativa e restrição socioambiental

Regra de distribuição implementada¶

Na carteira detalhada, os produtores são:

agrupados pelo segmento de área;
ordenados do maior para o menor potencial padrão;
distribuídos entre A, B, C e D conforme as proporções de clientes observadas no dashboard para o mesmo segmento.

A quantidade destinada a cada classe é calculada proporcionalmente e ajustada para que a soma corresponda ao número de produtores do segmento. Empates de potencial são desfeitos pelo identificador do produtor.

Quando não existe distribuição de referência no dashboard, o código utiliza um fallback em quartis. Eventuais produtores remanescentes são classificados como D.

Ponto a validar

Confirmar com a área de negócio se a distribuição proporcional e o fallback em quartis representam a política oficial de classificação ou apenas um mecanismo técnico para manter coerência entre as telas.

4. Índice de saúde da carteira¶

Definição¶

Índice ponderado, de 0 a 100, que resume a composição dos clientes entre as classes A, B, C e D.

Pesos¶

Classe	Peso
A	100
B	70
C	40
D	0

Fórmula¶

Índice de saúde =
  (Quantidade A × 100
   + Quantidade B × 70
   + Quantidade C × 40
   + Quantidade D × 0)
  ÷ Total de clientes

O resultado é arredondado para um número inteiro. Quando não existem clientes, o índice retorna zero.

Classificação¶

Resultado	Classificação
70% a 100%	Risco baixo
50% a 69%	Risco moderado
30% a 49%	Risco alto
Abaixo de 30%	Risco crítico

A interface também calcula a participação conjunta das classes A e B:

Participação A+B = (Quantidade A + Quantidade B) ÷ Total × 100

5. Áreas agrícolas¶

Indicador	Definição	Regra identificada	Unidade
Área agricultável	Área da propriedade apta ao cultivo	Soma do campo de área agricultável das propriedades consideradas	ha
Área plantada	Área declarada para as culturas no período	Soma das áreas de soja verão, milho verão, milho inverno, feijão inverno, trigo inverno, arroz verão e cana perene	ha
Área da carteira	Área associada aos produtores identificados como clientes	Soma das áreas das propriedades da carteira dentro dos filtros aplicados	ha

A área plantada pode superar a área agricultável quando o mesmo terreno possui mais de uma safra no período.

6. Potencial econômico¶

Potencial padrão¶

Estimativa financeira calculada para um produtor, conjunto de propriedades, cultura ou região.

Potencial padrão =
  soma, para cada cultura, de:
  área da cultura × valor de referência por hectare

Formato: moeda brasileira (R$).

A penetração não faz parte do potencial padrão bruto. Ela é aplicada separadamente para obter o valor capturável.

Origem do valor por hectare¶

O código utiliza esta ordem:

Manejo cadastrado: valorizado pelos produtos, com a soma das doses multiplicadas pelos preços do nível selecionado; por padrão, é utilizado o preço-alvo.
Referência de mercado: produtividade esperada em sacas por hectare multiplicada pela cotação por saca.
Valor padrão configurado.
Fallback técnico: R$ 2.500 por hectare quando não existe manejo, referência de mercado nem valor padrão configurado disponível.

Custo do manejo por hectare =
  soma(dose do produto × preço do produto)

Referência de mercado por hectare =
  produtividade em sc/ha × cotação em R$/sc

Fallback técnico

O valor de R$ 2.500/ha é um fallback final identificado no código. Ele não deve ser interpretado como parâmetro oficial de negócio sem validação.

Potencial total¶

Valor bruto estimado para todas as propriedades e culturas do contexto analisado.

Potencial total =
  soma(área por cultura × valor por hectare da cultura)

Formato: R$.

Potencial da carteira¶

Parcela do potencial total associada exclusivamente às propriedades de produtores identificados como clientes.

Potencial da carteira =
  soma do potencial bruto das propriedades da carteira

Formato: R$.

Potencial simulado¶

Valor construído manualmente para um produtor por meio dos itens da simulação.

Potencial simulado =
  soma dos valores totais dos itens configurados

Cada item considera quantidade, dose ou parâmetros de semente, área, unidade e preço. Quando existe uma simulação personalizada, ela é exibida separadamente do potencial padrão.

Originação agrícola¶

Para referências baseadas em produtividade e cotação, o código também permite obter:

Sacas = área × produtividade em sc/ha
Valor = sacas × cotação em R$/sc

Unidades: sacas e R$.

7. Penetração e valor capturável¶

Penetração¶

Percentual do potencial considerado capturável no cenário analisado.

Opções disponíveis:

5%;
10%;
15%;
25%;
50%;
75%;
100%;
percentual personalizado.

O código limita o percentual usado no cálculo ao intervalo entre 0% e 100%.

Valor capturável¶

Valor capturável =
  potencial bruto × (penetração ÷ 100)

Formato: R$.

A penetração é aplicada ao potencial pelo consumidor do cálculo. Ela não altera o valor bruto armazenado ou retornado como potencial padrão.

Potencial capturado por produto¶

Quando o potencial é aberto por produto:

Consumo total = área × consumo por hectare
Potencial financeiro = consumo total × preço
Potencial capturado = potencial financeiro × percentual de penetração

8. Planejamento comercial¶

Indicador	Definição	Regra identificada	Formato
Meta em hectares	Meta física definida no plano	Valor em hectares informado no plano; nenhuma fórmula adicional foi identificada no código	ha
Meta financeira	Valor financeiro esperado para o período	Valor definido no planejamento e distribuído pelos meses selecionados	R$
Projeção	Valor previsto a partir dos planos e itens comerciais	Soma dos valores projetados no contexto do plano e do período	R$
Realizado	Valor registrado como concretizado	Soma dos valores realizados por mês	R$
Diferença da meta	Quanto falta ou excede em relação à meta	`Meta − Realizado`	R$
% de atingimento	Percentual alcançado da meta	`Realizado ÷ Meta × 100`	Percentual
Gap	Diferença usada para comparar meta e projeção	`Meta − Projeção`	R$

Quando a meta mensal é zero, o percentual de atingimento retorna zero no cálculo implementado.

Situação da meta¶

Situação	Critério
Superado	Realizado igual ou superior à meta
No prazo	Realizado a partir de 85% da meta e abaixo de 100%
Atrasado	Realizado abaixo de 85% da meta

9. Comissões¶

Comissão linear¶

Aplica um percentual único sobre o valor total ou sobre os itens mensais do plano.

Comissão do vendedor =
  valor-base × percentual da comissão ÷ 100

Percentual padrão identificado: 2,5%.

No cálculo do plano, cada item contribui para o mês correspondente e a comissão total é a soma das comissões mensais.

Comissão por categoria¶

Aplica percentuais específicos conforme a categoria detectada para cada produto.

Comissão da categoria =
  valor-base dos itens da categoria × percentual da categoria ÷ 100

Percentuais padrão identificados:

Categoria	Percentual
Inoculantes	3%
Biológicos	7%
Adjuvantes	3%
Bioestimulante	7%
Sementes	1,5%
Tratamento de Sementes	3%
Fertilizantes Foliares	3%
Complexos Nutricionais	3%
Condicionador de Solo	3%
Outros	3%

A categoria é inferida a partir do nome e do segmento do produto. Quando existe uma configuração linear junto com configurações por categoria, o percentual linear pode funcionar como fallback para itens sem percentual específico.

Sem configuração de comissão, o cálculo retorna modalidade não configurada, com valores mensais e total iguais a zero.

Comissão gerencial¶

Percentual adicional calculado sobre o valor-base informado.

Comissão gerencial =
  valor-base × percentual do gerente ÷ 100

Percentual padrão identificado na configuração: 1%.

Comissão total¶

Na configuração exibida para o produtor:

Comissão total =
  comissão do vendedor + comissão gerencial

Formato: R$.

Os percentuais e valores-base podem ser configurados e persistidos por produtor.

10. Over Price e seguro agrícola¶

Over Price¶

Valor adicional calculado sobre a comissão mensal.

Over Price mensal =
  comissão mensal × percentual de Over Price ÷ 100

Percentual padrão identificado: 50% da comissão.

É calculado para cada um dos 12 meses.
Pode receber ajuste manual por mês.
Quando não existe ajuste, prevalece o valor calculado automaticamente.
O sistema registra se houve ajuste manual, data e usuário quando essas informações estão disponíveis.

Formato: R$.

Seguro agrícola¶

Informação comercial calculada sobre o valor total do plano.

Seguro agrícola =
  valor total do plano × 3%

Percentual padrão identificado: 3%.
Pode ser distribuído mensalmente de forma proporcional ao valor do plano no mês.
O código o identifica explicitamente como informativo.
Não compõe a DRE implementada.

Formato: R$.

11. Indicadores da DRE¶

A DRE apresenta valores mensais, total, média e participação. Os componentes identificados incluem:

Vendas e metas¶

Indicador	Cálculo implementado
Meta de Venda	Valores mensais definidos no planejamento
Realizado	Valores mensais registrados
Diferença da Meta	`Meta − Realizado`
% Atingimento	`Realizado ÷ Meta × 100`
Composição por Produto	Abertura do realizado por cultura e categoria

Resultado¶

Componente	Comportamento identificado
Volume de Venda	Utiliza os valores de meta exibidos no componente
Fixo Mensal	Repete o valor fixo ou utiliza substituição manual por mês
Comissão	Utiliza comissão calculada ou substituição manual; quando ausente, pode calcular `Realizado × percentual`
Over	Utiliza ajuste mensal quando informado; caso contrário, usa o valor automático
RDV	Soma os lançamentos mensais e permite abertura por categoria
Bonificação	Usa ajuste manual ou `Realizado × percentual de bonificação`
Marketing/Brindes	Usa ajuste manual ou `Realizado × percentual de marketing`
Manutenção de Veículos	Usa o valor mensal informado
Resultado Líquido	Subtrai do realizado os componentes de custo considerados pelo código

Fórmula técnica implementada¶

Resultado líquido mensal =
  Realizado
  − Fixo mensal
  − Comissão
  − Over
  − RDV
  − Marketing/Brindes
  − Bonificação
  − Manutenção de Veículos

A participação de um componente é calculada em relação ao total de vendas usado como referência quando esse total é maior que zero.

Ponto a validar — DRE

A fórmula acima descreve estritamente o cálculo técnico encontrado no componente atual. Confirmar com a área financeira se os componentes, sinais, nomes, bases de cálculo, médias e participação representam a DRE oficial da Drexies Agro antes de tratá-los como regra contábil definitiva.

12. Análise de Risco e conformidade¶

Os dados abaixo são indicadores retornados ou consolidados pelas consultas de risco. O código apresenta e persiste essas informações, mas os critérios de geração pertencem às fontes externas.

Grupo	Indicadores e informações
Consulta	Produto consultado, data, situação, histórico e erros
Crédito	Pontuações de crédito e informações financeiras retornadas
Restritivos	Valor total de restrições, dívidas e demais ocorrências negativas
Protestos	Quantidade, valores, datas e resumo de protestos
Processos	Processos judiciais e informações relacionadas
Recuperação judicial	Indicação ou dados de recuperação judicial
Conformidade socioambiental	Ocorrências e resultados de conformidade
PEP	Indicação relacionada a Pessoa Politicamente Exposta
Trabalho Escravo	Indicação de ocorrência nas fontes consultadas
Imóveis rurais	Propriedades, áreas e resumo rural
Relacionamentos	Grupo econômico, grupo familiar e vínculos do produtor
Cadastro e contatos	Documentos, telefones, e-mails e endereços
Endividamento	Informações de endividamento retornadas pela análise

Observações¶

Os resultados dependem da disponibilidade de documento válido para o produtor.
Consultas podem apresentar erro ou permanecer sem dados.
Resultados são persistidos no Supabase para consulta posterior.
O enriquecimento cadastral e de contatos utiliza integração distinta da consulta principal de risco.

Ponto a validar

Os métodos, faixas e critérios usados pelos fornecedores externos para produzir scores, restritivos e indicadores de conformidade não estão integralmente definidos no repositório. Eles devem ser confirmados nos contratos e manuais vigentes das integrações.

13. Formatos e convenções¶

Tipo	Formato utilizado
Valores financeiros	Real brasileiro (R$)
Participações e taxas	Percentual (%)
Áreas	Hectares (ha)
Produtividade	Sacas por hectare (sc/ha)
Cotação	Reais por saca (R$/sc)
Quantidades de produtores e propriedades	Número inteiro
Indicadores mensais	Janeiro a dezembro, com total e, quando aplicável, média

Pontos a validar¶

Confirmar se a distribuição proporcional das classes A–D e o fallback em quartis representam a política oficial de classificação.
Confirmar se o fallback técnico de R$ 2.500/ha deve continuar sendo utilizado e qual referência de negócio deve substituí-lo quando necessário.
Validar com a área financeira os componentes, sinais, bases, percentuais e fórmula oficial da DRE.
Confirmar a interpretação oficial de Volume de Venda, médias e participação dentro da DRE.
Confirmar nos fornecedores externos as faixas, metodologias e critérios dos scores e indicadores de risco e conformidade.

Referências¶

Telas e Funcionalidades — onde os indicadores e regras são utilizados
Fontes de Dados e Linhagem — origens e estruturas que sustentam os cálculos
Glossário — definições dos termos de negócio e técnicos