Indicadores PJ - Credify Núclea
Indicadores PJ - Credify Núclea
Os Indicadores PJ entregam métricas e scores sobre uma empresa a partir do seu comportamento transacional — boletos, cartões e TEDs. A partir de um CNPJ, é possível avaliar concentração de pagamentos/recebimentos, autoliquidação, liquidez no vencimento e volume transacionado, apoiando decisões de concessão e monitoramento de crédito PJ, gestão de risco de carteira e prevenção à fraude.
Todas as consultas desta seção usam o mesmo endpoint — POST https://api.credify.com.br/indicadorespj — variando apenas o IdSolucao e os Sku.
Parâmetros comuns a todas as consultas: IdConsulta (ID de controle da requisição), CpfCnpj (apenas números), IdSolucao (a solução consultada), Sku (array de SKUs) e MesReferencia (o mês da carga). O histórico acessível é de 12 meses. Cada consulta abaixo tem um testador embutido — clique para expandir, preencha CpfCnpj, Sku e MesReferencia, informe seu token e execute.
Mês de referência (MesReferencia) — o que é e qual mês escolher
O MesReferencia é o campo (AAAAMM) que define qual mês da carga será consultado. Já que a API trabalha com os dados já contabilizados, não é possível consultar um mês que ainda não tenha sido fechado.
O fechamento de cada mês acontece entre os dias 15 e 20 do mês seguinte — período necessário para que todas as informações sejam consolidadas e contabilizadas corretamente.
Dessa forma, a disponibilidade de consulta de cada mês fica condicionada à conclusão do respectivo fechamento, que ocorre sempre no mês seguinte. Em resumo: informe em MesReferencia um mês já fechado, no formato AAAAMM (ex.: 202608 para agosto de 2026).
O retorno vem dentro de RESPOSTA.INDICADORES_PJ, em um nó cujo nome muda conforme o IdSolucao (ex.: 643 → CONCENTRACAO_PJ_V1). A estrutura interna (SEGMENTACAO) é a mesma em todas as soluções; ela vem como array quando há vários SKUs e como objeto quando há apenas um.
Catálogo de soluções
Anatomia do SKU
Cada SKU combina uma segmentação (o recorte medido) com uma janela temporal (período acumulado) e o nível de documento:
O sufixo Completo indica o nível de documento CNPJ completo (matriz e filiais), em oposição ao Radical (apenas a raiz do CNPJ).
Códigos de retorno por SKU — CODIGO_RETORNO
Cada SKU dentro de SEGMENTACAO traz seu próprio CODIGO_RETORNO. A requisição pode ser bem-sucedida (CODIGO: "1") e ainda assim conter SKUs com retorno individual de erro ou nulo.
🎯 643 · Concentração PJ Boleto
Mede a concentração dos boletos: o quanto os pagamentos ou recebimentos do CNPJ se concentram em poucas contrapartes. INDICADOR é uma proporção de 0 a 1 (ex.: 0.4182 ≈ 41,82%). Nó de resposta: CONCENTRACAO_PJ_V1.
SKUs disponíveis
Resposta de exemplo — Concentração PJ Boleto
🏢 645 · Autoliquidação Grupo Econômico PJ Boleto
Mede a autoliquidação dentro do grupo econômico: boletos emitidos e liquidados entre empresas do mesmo grupo — sinal de movimentação “casada” para inflar o histórico. Nó de resposta: AUTO_LIQUIDACAO_GRUPO_ECONOMICO_PJ_V1.
SKUs disponíveis
Resposta de exemplo — Autoliquidação Grupo Econômico PJ Boleto
🔁 647 · Autoliquidação PJ Boleto
Mede a autoliquidação: a proporção de boletos emitidos pela empresa que são liquidados por ela mesma — indício de possível “falsa” movimentação para obter crédito. INDICADOR é uma faixa percentual textual (ex.: "Entre 0% e 5%", "Entre 90% e 95%"). As segmentações cruzam os papéis do boleto (cedente, sacado, portador, sócio). Nó de resposta: AUTO_LIQUIDACAO_PJ_V1_1.
SKUs disponíveis
Resposta de exemplo — Autoliquidação PJ Boleto
💳 649 · Concentração em Credenciadores PJ Cartão 🚧
Mede a concentração dos recebimentos em cartão de crédito de um CNPJ por credenciador — o quanto o recebimento está concentrado em poucos credenciadores.
🚧 Em desenvolvimento. Esta solução ainda não está disponível para consumo. Os SKUs abaixo seguem a planilha oficial.
SKUs previstos
💧 651 · Liquidez Vencimento PJ Boleto
Mede a liquidez no vencimento: o valor de boletos a pagar/receber que é efetivamente liquidado em até 5 dias após o vencimento. INDICADOR varia de 0 a 1. Nó de resposta: LIQUIDEZ_VENCIMENTO_PJ_V1_1.
SKUs disponíveis
🚧 Em desenvolvimento. Os SKUs de Recebimento · PF (201098, 201100, 201101, 201097) ainda não foram implementados pela Nuclea.
Resposta de exemplo — Liquidez Vencimento PJ Boleto
📈 653 · Valor Histórico Transacionado PJ
Mede o valor transacionado pelo CNPJ no período, somando boletos, cartões e TEDs recebidos/pagos. INDICADOR é um valor monetário (em reais). Nó de resposta: VALOR_HISTORICO_TRANSACIONADO_PJ_V3.
SKUs disponíveis
Resposta de exemplo — Valor Histórico Transacionado PJ
📊 655 · Valor Transacionado em Faixas PJ
Mesma base do valor transacionado, mas classificado em faixas fixas (de A1 a E1) em vez de valor absoluto. Nó de resposta: VALOR_TRANSACIONADO_FAIXA_PJ_V1.
Como interpretar o código da faixa (ex.: B12, C1)
O valor transacionado pelo CNPJ não é retornado em número absoluto — ele é classificado em uma faixa fixa, identificada por uma letra (grupo) e um número (posição dentro do grupo):
- A letra indica o grupo de valor (ex.:
B= entreR$ 30 mileR$ 4 M). - O número é a posição ordinal da faixa dentro daquele grupo, sempre crescente — quanto maior o número, mais perto do limite superior do grupo. Ex.:
B12é a 12ª de 20 faixas do grupo B;C1é a 1ª de 25 faixas do grupo C (a mais baixa dentro do grupo C, mas ainda maior que qualquer faixa do grupo B, já que os grupos não se sobrepõem). - As faixas são anônimas: não expõem o valor exato de corte de cada uma, e os ranges entre faixas de um mesmo grupo não são necessariamente do mesmo tamanho. A única garantia é a ordem crescente de valor.
SKUs disponíveis
Resposta de exemplo — Valor Transacionado em Faixas PJ
🔮 657 · Predição de Valor Transacionado PJ
Estima (predição) o valor a ser transacionado por um CNPJ — boletos, TEDs e cartões recebidos — para o período seguinte. INDICADOR é um valor monetário (em reais). Nó de resposta: PREDICAO_VALOR_TRANSACIONADO_PJ_V1.
SKUs disponíveis
Resposta de exemplo — Predição de Valor Transacionado PJ
🏭 659 · Liquidez por Setor PJ Boleto
Relatório de liquidez comparada ao setor: posiciona a liquidez de pagamento/recebimento do CNPJ frente aos principais CNAEs (setores de atividade) das contrapartes, com um indicador individual por CNAE. Nó de resposta: LIQUIDEZ_POR_SETOR_PJ_BOLETO.
SKUs disponíveis
Como interpretar o relatório por CNAE — CONTEUDO_RELATORIO
Diferente das demais soluções, aqui cada SKU não retorna um único INDICADOR — ele vem dentro de CONTEUDO_RELATORIO.ITEM, um array com um indicador de liquidez por CNAE das contrapartes:
O exemplo abaixo mostra apenas alguns CNAEs — a resposta real traz um item para cada CNAE relevante encontrado.
Resposta de exemplo — Liquidez por Setor PJ Boleto
📎 661 · Share Boletos por CNAEs PJ Boleto
Traz a participação (share) dos boletos pagos/recebidos por um CNPJ nos principais CNAEs (setores de atividade) das contrapartes, ordenados por ranking. Nó de resposta: INDICADOR_SHARE_BOLETOS_CNAE_PJ.
SKUs disponíveis
Como interpretar o relatório por CNAE — CONTEUDO_RELATORIO
Cada SKU retorna o share dentro de CONTEUDO_RELATORIO.ITEM, um array com o percentual de participação por CNAE, ordenado por ranking:
Quando não há CNAE suficiente para preencher uma posição do ranking, CNAE, CNAE_DESC e INDICADOR retornam vazios ("") mesmo com CODIGO_RETORNO: "1" — o RANK continua presente.
🏅 663 · Score Materialidade Evolução PJ
Entrega um score de materialidade/evolução do CNPJ com base em dados de boletos, cartões e TEDs, na janela de 90 dias. Nó de resposta: MATERIALIDADE_EVOLUCAO_90_PJ_V2.
SKUs disponíveis
Diferente das demais soluções, aqui SEGMENTACAO vem como objeto único (há apenas um SKU) e os campos são SCORE e TIPO_CNPJ, em vez de INDICADOR.
