Classifique pessoas por capacidade financeira usando dados reais: valor venal de imóveis, veículos, aeronaves, capital social de empresas e remuneração formal. Ideal para crédito, seguros, investimentos e marketing direcionado. O scoring é calculado automaticamente pelo endpoint POST /leads/enriquecer — basta enviar os CPFs e receber a faixa de renda de cada um.

​
As Faixas

FaixaScoreClassificaçãoPerfil típico
A>= 70Ultra-alta rendaImóveis >R2M,aeronave,capital>R2M, aeronave, capital >R1M
B>= 45Alta rendaImóveis R$500k-2M, veículos, empresa com capital
C>= 25Média-altaImóvel, veículo, remuneração >R$10k
D>= 10Média1 veículo ou remuneração R$5-10k
E< 10Não identificadaSem sinais patrimoniais detectados

​
Sinais e Pesos

O score é composto por 6 consultas paralelas ao ClickHouse:
SinalFonteCondiçãoPontos
Imóveis alto valorPropriedades por documentoValor venal > R$2M+30
Imóveis médio valorValor R500k−R500k - R2M+20
Imóveis baixo valorValor R100k−R100k - R500k+10
Frota 3+ veículosVeículos por CPF3 ou mais veículos+10
1-2 veículos1 ou 2 veículos+5
AeronaveAeronaves por CPFPossui aeronave registrada+30
Capital altoSócios + EstabelecimentosCapital social > R$1M+15
Capital medioCapital R100k−R100k - R1M+10
Remuneração altaFuncionários (emprego ativo)Salário > R$20k+15
Remuneração média-altaSalário R10k−R10k - R20k+10
Remuneração médiaSalário R5k−R5k - R10k+5
Benefício socialAuxílio Brasil / Bolsa Família / BPCRecebe benefício-20
Score máximo teórico: ~115 pontos

​
Exemplos Comparativos

​
Maria — Faixa B (Score 45)

SinalDetalhePontos
2 imóveis, valor R$850kValor entre R500k−R500k-R2M+20
1 veículo+5
Empresa com capital R$500kCapital entre R100k−R100k-R1M+10
Remuneração R$12kSalário entre R10k−R10k-R20k+10
TotalFaixa B — Alta renda45

​
Carlos — Faixa A (Score 70)

SinalDetalhePontos
3 imóveis, valor R$3.5MValor > R$2M+30
3 veículos3+ veículos+10
Empresa com capital R$2MCapital > R$1M+15
Remuneração R$25kSalário > R$20k+15
TotalFaixa A — Ultra-alta renda70

​
Ana — Faixa D (Score 10)

SinalDetalhePontos
Sem imóveis0
1 veículo+5
Remuneração R$6kSalário entre R5k−R5k-R10k+5
TotalFaixa D — Média10

​
Pedro — Faixa E (Score 0)

SinalDetalhePontos
Sem patrimônio detectado0
Recebe Bolsa FamíliaBenefício social-20
Total (min 0)Faixa E — Não identificada0

​
Roberto — Faixa A (Score 100)

SinalDetalhePontos
5 imóveis, valor R$8MValor > R$2M+30
4 veículos3+ veículos+10
Aeronave registrada+30
Empresa com capital R$5MCapital > R$1M+15
Remuneração R$50kSalário > R$20k+15
TotalFaixa A — Ultra-alta renda100

​
Como usar na prática

​
Segmentar uma base de CPFs

import requests

# Enviar ate 100 CPFs de uma vez
cpfs = ["12345678901", "98765432100", "11122233344"]

response = requests.post(
    "https://221b-api.sherlocker.com.br/api/v1/leads/enriquecer",
    params={"token": "SEU_TOKEN"},
    json={
        "contatos": [{"cpf": cpf} for cpf in cpfs],
        "campos": ["renda"]  # so o scoring, mais rapido
    }
)

data = response.json()

# Agrupar por faixa
faixas = {"A": [], "B": [], "C": [], "D": [], "E": []}
for r in data["resultados"]:
    if r["status"] == "ok":
        faixa = r["score_renda"]["faixa"]
        faixas[faixa].append(r["cpf"])

for faixa, cpfs in faixas.items():
    print(f"Faixa {faixa}: {len(cpfs)} leads")

​
Lote grande (ate 1.000)

# Usar endpoint assincrono
response = requests.post(
    "https://221b-api.sherlocker.com.br/api/v1/leads/async/enriquecer",
    params={"token": "SEU_TOKEN"},
    json={
        "contatos": [{"cpf": cpf} for cpf in lista_grande],
        "campos": ["renda"]
    }
)

job = response.json()
# Poll GET /leads/jobs/{jobId} ate completar

​
APIs utilizadas

Enriquecer

Scoring via campo renda

Imóveis

Valor venal de propriedades

Veículos

Frota registrada

Aeronaves

Aeronaves e drones

Empresas

Capital social

Benefícios

Programas sociais

​
Considerações

  • O score é conservador: indica poder aquisitivo mínimo detectável, não renda exata
  • Benefício social é negativo (-20): indica alta probabilidade de renda baixa
  • Faixa E não significa renda baixa — pode ser ausência de dados
  • Todas as consultas são executadas em paralelo para performance
  • Use campos: ["renda"] quando só precisa do scoring — reduz tempo de resposta