API Reference11. Indicadores PJ - Credify Núclea

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) e Sku (array de SKUs). O opcional MesReferencia (AAAAMM) define o mês da carga — se omitido, a API usa a última disponível; o histórico acessível é de 12 meses. Cada consulta abaixo tem um testador embutido — clique para expandir, preencha CpfCnpj, Sku e (opcionalmente) MesReferencia, informe seu token e execute.

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.

IdSolucaoConsultaO que medeNó em INDICADORES_PJ
643Concentração PJ BoletoConcentração de pagamentos/recebimentos em boletosCONCENTRACAO_PJ_V1
645Autoliquidação Grupo Econômico PJ BoletoAutoliquidação dentro do mesmo grupo econômicoAUTO_LIQUIDACAO_GRUPO_ECONOMICO_PJ_V1
647Autoliquidação PJ Boleto% de boletos emitidos liquidados pela própria empresaAUTO_LIQUIDACAO_PJ_V1_1
649Concentração em Credenciadores PJ CartãoConcentração de recebimentos em cartão por credenciador🚧 Em desenvolvimento
651Liquidez Vencimento PJ BoletoBoletos liquidados até 5 dias após o vencimentoLIQUIDEZ_VENCIMENTO_PJ_V1_1
653Valor Histórico Transacionado PJValor movimentado em boletos, cartões e TEDsVALOR_HISTORICO_TRANSACIONADO_PJ_V3
655Valor Transacionado em Faixas PJValor transacionado classificado em faixas fixasVALOR_TRANSACIONADO_FAIXA_PJ_V1
657Predição de Valor Transacionado PJPredição do valor a ser transacionadoPREDICAO_VALOR_TRANSACIONADO_PJ_V1
659Liquidez por Setor PJ BoletoLiquidez do CNPJ comparada ao seu setor🚧 Em desenvolvimento
661Share Boletos por CNAEs PJ BoletoParticipação dos boletos nos principais CNAEs🚧 Em desenvolvimento
663Score Materialidade Evolução PJScore de materialidade/evolução (90 dias)🚧 Em desenvolvimento

Cada SKU combina uma segmentação (o recorte medido) com uma janela temporal (período acumulado) e o nível de documento:

JanelaPeríodo acumulado
1M1 mês
3M3 meses
6M6 meses
12M12 meses

O sufixo Completo indica o nível de documento CNPJ completo (matriz e filiais), em oposição ao Radical (apenas a raiz do CNPJ).

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.

CódigoSignificado
0Sucesso.
1Sucesso com valor.
16Resultado nulo.
23Segmentação inexistente.
24Indicador não encontrado para o mês.
25Não contratada.
99Sem resultados para o mês.

🎯 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.

SKUSegmentaçãoJanela
200171Pagamento · maior percentual1M
200173Pagamento · maior percentual3M
200174Pagamento · maior percentual6M
200175Pagamento · maior percentual12M
200155Pagamento · percentual ponderado12M
200165Recebimento · maior percentual12M
200144Recebimento · percentual ponderado6M
200145Recebimento · percentual ponderado12M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "11111",
4    "DATAHORA": "06/07/2026 09:25:51",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "CONCENTRACAO_PJ_V1": {
12        "SEGMENTACAO": [
13          {
14            "SKU": "200175",
15            "CODIGO_RETORNO": "1",
16            "EVENTO_TARIFAVEL": "",
17            "INDICADOR": "0.41828951769440154",
18            "SEGMENTACAO_DESC": "boletoPagamentoMaiorPercentual12MCompleto",
19            "MENSAGEM": "Consulta realizada com sucesso."
20          },
21          {
22            "SKU": "200171",
23            "CODIGO_RETORNO": "1",
24            "EVENTO_TARIFAVEL": "",
25            "INDICADOR": "0.41176546112636314",
26            "SEGMENTACAO_DESC": "boletoPagamentoMaiorPercentual1MCompleto",
27            "MENSAGEM": "Consulta realizada com sucesso."
28          }
29        ]
30      }
31    }
32  }
33}

🏢 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.

SKUSegmentaçãoJanela
201742Cedente = Portador (mesmo grupo)1M
201744Cedente = Portador (mesmo grupo)3M
201745Cedente = Portador (mesmo grupo)6M
201746Cedente = Portador (mesmo grupo)12M
201738Cedente = Sacado (mesmo grupo)2M
201739Cedente = Sacado (mesmo grupo)3M
201740Cedente = Sacado (mesmo grupo)6M
201741Cedente = Sacado (mesmo grupo)12M
201757Cruzado entre empresas do grupo1M
201759Cruzado entre empresas do grupo3M
201760Cruzado entre empresas do grupo6M
201761Cruzado entre empresas do grupo12M
201762Intra empresas do grupo1M
201764Intra empresas do grupo3M
201765Intra empresas do grupo6M
201766Intra empresas do grupo12M
201751Portador = Sacado (mesmo grupo)12M
201756Sacado = Sócio (mesmo grupo)12M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "111111111",
4    "DATAHORA": "27/07/2026 11:44:50",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "AUTO_LIQUIDACAO_GRUPO_ECONOMICO_PJ_V1": {
12        "SEGMENTACAO": [
13          {
14            "SKU": "201742",
15            "CODIGO_RETORNO": "1",
16            "EVENTO_TARIFAVEL": "",
17            "INDICADOR": "Zero",
18            "SEGMENTACAO_DESC": "boletoCedentePortadorMesmoGrupo1MCompleto",
19            "MENSAGEM": "Consulta realizada com sucesso."
20          },
21          {
22            "SKU": "201746",
23            "CODIGO_RETORNO": "1",
24            "EVENTO_TARIFAVEL": "",
25            "INDICADOR": "Entre 0% e 5%",
26            "SEGMENTACAO_DESC": "boletoCedentePortadorMesmoGrupo12MCompleto",
27            "MENSAGEM": "Consulta realizada com sucesso."
28          }
29        ]
30      }
31    }
32  }
33}

🔁 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.

SKUSegmentaçãoJanela
200005Cedente = Portador1M
200025Cedente = Portador3M
200035Cedente = Portador6M
200045Cedente = Portador12M
200003Cedente = Sacado1M
200023Cedente = Sacado3M
200033Cedente = Sacado6M
200043Cedente = Sacado12M
200007Sacado ≠ Portador1M
200027Sacado ≠ Portador3M
200037Sacado ≠ Portador6M
200047Sacado ≠ Portador12M
200009Sacado = Sócio1M
200029Sacado = Sócio3M
200039Sacado = Sócio6M
200049Sacado = Sócio12M
200011Portador = Sócio1M
200031Portador = Sócio3M
200041Portador = Sócio6M
200051Portador = Sócio12M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "11111",
4    "DATAHORA": "06/07/2026 09:26:10",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "AUTO_LIQUIDACAO_PJ_V1_1": {
12        "SEGMENTACAO": [
13          {
14            "SKU": "200045",
15            "CODIGO_RETORNO": "1",
16            "EVENTO_TARIFAVEL": "",
17            "INDICADOR": "Entre 0% e 5%",
18            "SEGMENTACAO_DESC": "boletoCedenteMesmoPortador12MCompleto",
19            "MENSAGEM": "Consulta realizada com sucesso."
20          },
21          {
22            "SKU": "200005",
23            "CODIGO_RETORNO": "1",
24            "EVENTO_TARIFAVEL": "",
25            "INDICADOR": "Entre 0% e 5%",
26            "SEGMENTACAO_DESC": "boletoCedenteMesmoPortador1MCompleto",
27            "MENSAGEM": "Consulta realizada com sucesso."
28          }
29        ]
30      }
31    }
32  }
33}

💳 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.

SKUSegmentaçãoJanela
200900Crédito recebimento · percentual ponderado1M
200902Crédito recebimento · percentual ponderado3M
200903Crédito recebimento · percentual ponderado6M
200904Crédito recebimento · percentual ponderado12M

💧 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.

SKUSegmentaçãoJanela
200125Pagamento · valor baixa1M
200127Pagamento · valor baixa3M
200128Pagamento · valor baixa6M
200962Pagamento · valor baixa12M
201098Recebimento · PF1M
201100Recebimento · PF3M
201101Recebimento · PF6M
201097Recebimento · PF12M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "11111",
4    "DATAHORA": "06/07/2026 09:26:33",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "LIQUIDEZ_VENCIMENTO_PJ_V1_1": {
12        "SEGMENTACAO": [
13          {
14            "SKU": "200962",
15            "CODIGO_RETORNO": "1",
16            "EVENTO_TARIFAVEL": "",
17            "INDICADOR": "0.3531",
18            "SEGMENTACAO_DESC": "boletoPagamentoValorBaixa12MCompleto",
19            "MENSAGEM": "Consulta realizada com sucesso."
20          },
21          {
22            "SKU": "200125",
23            "CODIGO_RETORNO": "1",
24            "EVENTO_TARIFAVEL": "",
25            "INDICADOR": "0.2144",
26            "SEGMENTACAO_DESC": "boletoPagamentoValorBaixa1MCompleto",
27            "MENSAGEM": "Consulta realizada com sucesso."
28          }
29        ]
30      }
31    }
32  }
33}

📈 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.

SKUSegmentaçãoJanela
201330Boleto + Cartão + TED · recebimento3M
201331Boleto + Cartão + TED · recebimento6M
201329Boleto + Cartão + TED · recebimento12M
201348Boleto + TED · pagamento3M
201349Boleto + TED · pagamento6M
201347Boleto + TED · pagamento12M
201354Cartão antecipação · recebimento3M
201355Cartão antecipação · recebimento6M
201353Cartão antecipação · recebimento12M
201372Cartão total · recebimento3M
201373Cartão total · recebimento6M
201371Cartão total · recebimento12M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "11111",
4    "DATAHORA": "06/07/2026 09:26:58",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "VALOR_HISTORICO_TRANSACIONADO_PJ_V3": {
12        "SEGMENTACAO": [
13          {
14            "SKU": "201329",
15            "CODIGO_RETORNO": "1",
16            "EVENTO_TARIFAVEL": "",
17            "INDICADOR": "12180651653.41",
18            "SEGMENTACAO_DESC": "boletoCartaoTEDRecebimentoValor12MCompleto",
19            "MENSAGEM": "Consulta realizada com sucesso."
20          },
21          {
22            "SKU": "201347",
23            "CODIGO_RETORNO": "1",
24            "EVENTO_TARIFAVEL": "",
25            "INDICADOR": "3718448116.76",
26            "SEGMENTACAO_DESC": "boletoTEDPagamentoValor12MCompleto",
27            "MENSAGEM": "Consulta realizada com sucesso."
28          }
29        ]
30      }
31    }
32  }
33}

📊 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.

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):

GrupoQt. FaixasMínimoMáximo
A14R$ 0,01R$ 30 mil
B20R$ 30 milR$ 4 M
C25R$ 4 MR$ 700 M
D25R$ 700 MR$ 900 bi
E1R$ 900 biinfinito
  • A letra indica o grupo de valor (ex.: B = entre R$ 30 mil e R$ 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.
SKUSegmentaçãoJanela
200950Boleto + Cartão + TED · recebimento1M
200952Boleto + Cartão + TED · recebimento3M
200953Boleto + Cartão + TED · recebimento6M
200955Boleto + Cartão + TED · recebimento12M
201257Boleto + TED · pagamento1M
201263Boleto + TED · pagamento3M
201266Boleto + TED · pagamento6M
201272Boleto + TED · pagamento12M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "11111",
4    "DATAHORA": "06/07/2026 09:27:20",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "VALOR_TRANSACIONADO_FAIXA_PJ_V1": {
12        "SEGMENTACAO": [
13          {
14            "SKU": "200950",
15            "CODIGO_RETORNO": "1",
16            "EVENTO_TARIFAVEL": "",
17            "INDICADOR": "B12",
18            "SEGMENTACAO_DESC": "boletoCartaoTEDRecebimentoValor1MCompleto",
19            "MENSAGEM": "Consulta realizada com sucesso."
20          },
21          {
22            "SKU": "200952",
23            "CODIGO_RETORNO": "1",
24            "EVENTO_TARIFAVEL": "",
25            "INDICADOR": "B16",
26            "SEGMENTACAO_DESC": "boletoCartaoTEDRecebimentoValor3MCompleto",
27            "MENSAGEM": "Consulta realizada com sucesso."
28          },
29          {
30            "SKU": "200953",
31            "CODIGO_RETORNO": "1",
32            "EVENTO_TARIFAVEL": "",
33            "INDICADOR": "C1",
34            "SEGMENTACAO_DESC": "boletoCartaoTEDRecebimentoValor6MCompleto",
35            "MENSAGEM": "Consulta realizada com sucesso."
36          },
37          {
38            "SKU": "200955",
39            "CODIGO_RETORNO": "1",
40            "EVENTO_TARIFAVEL": "",
41            "INDICADOR": "C4",
42            "SEGMENTACAO_DESC": "boletoCartaoTEDRecebimentoValor12MCompleto",
43            "MENSAGEM": "Consulta realizada com sucesso."
44          },
45          {
46            "SKU": "201257",
47            "CODIGO_RETORNO": "1",
48            "EVENTO_TARIFAVEL": "",
49            "INDICADOR": "B6",
50            "SEGMENTACAO_DESC": "boletoTEDPagamentoValor1MCompleto",
51            "MENSAGEM": "Consulta realizada com sucesso."
52          },
53          {
54            "SKU": "201263",
55            "CODIGO_RETORNO": "1",
56            "EVENTO_TARIFAVEL": "",
57            "INDICADOR": "B9",
58            "SEGMENTACAO_DESC": "boletoTEDPagamentoValor3MCompleto",
59            "MENSAGEM": "Consulta realizada com sucesso."
60          },
61          {
62            "SKU": "201266",
63            "CODIGO_RETORNO": "1",
64            "EVENTO_TARIFAVEL": "",
65            "INDICADOR": "B16",
66            "SEGMENTACAO_DESC": "boletoTEDPagamentoValor6MCompleto",
67            "MENSAGEM": "Consulta realizada com sucesso."
68          },
69          {
70            "SKU": "201272",
71            "CODIGO_RETORNO": "1",
72            "EVENTO_TARIFAVEL": "",
73            "INDICADOR": "B17",
74            "SEGMENTACAO_DESC": "boletoTEDPagamentoValor12MCompleto",
75            "MENSAGEM": "Consulta realizada com sucesso."
76          }
77        ]
78      }
79    }
80  }
81}

🔮 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.

SKUSegmentaçãoJanela
100021Boleto + TED + Cartão · recebimento1M
1{
2  "CONSULTA": {
3    "CODIGORESPOSTA": "11111",
4    "DATAHORA": "06/07/2026 09:27:55",
5    "LOGON": "11111",
6    "IDCONSULTA": "750"
7  },
8  "RESPOSTA": {
9    "CODIGO": "1",
10    "INDICADORES_PJ": {
11      "PREDICAO_VALOR_TRANSACIONADO_PJ_V1": {
12        "SEGMENTACAO": {
13          "SKU": "100021",
14          "CODIGO_RETORNO": "1",
15          "EVENTO_TARIFAVEL": "",
16          "INDICADOR": "342955162.52",
17          "SEGMENTACAO_DESC": "boletoTEDCartaoRecebimentoValor12MCompleto",
18          "MENSAGEM": "Consulta realizada com sucesso."
19        }
20      }
21    }
22  }
23}

🏭 659 · Liquidez por Setor PJ Boleto 🚧

Relatório de liquidez comparada ao setor: posiciona a liquidez de pagamento/recebimento do CNPJ frente ao seu setor de atuação.

🚧 Em desenvolvimento. Esta solução ainda não está disponível para consumo. Os SKUs abaixo seguem a planilha oficial.

SKUSegmentaçãoJanela
201450Pagamento · valor baixa12M
201455Recebimento · valor baixa12M

📎 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.

🚧 Em desenvolvimento. Esta solução ainda não está disponível para consumo. Os SKUs abaixo seguem a planilha oficial.

SKUSegmentaçãoJanela
200689Pagamento · share top CNAE12M
200693Recebimento · share top CNAE12M

🏅 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.

🚧 Em desenvolvimento. Esta solução ainda não está disponível para consumo. Os SKUs abaixo seguem a planilha oficial.

SKUSegmentaçãoJanela
100013Boletos + Cartões + TED90D