Documentação Técnica

Score Murabei de Risco de Crédito

Descrição

O Score Murabei de Risco de Crédito é um score desenvolvido com técnicas de modelagem estatística e machine learning pela Murabei. O objetivo deste score é de separar, de maneira efetiva empresas com maior e menor risco de crédito (ou seja, de inadimplência em pagamentos nos próximos 180 dias) tomando como base dados estruturados e dados alternativos, mas sem depender diretamente das informações tradicionalmente associadas com o crédito. É especialmente útil em processos de análise de crédito, e pode ser utilizado de forma complementar ou substitutiva aos scores de crédito dos birôs convencionais. Nos testes internos realizados, o modelo apresentou um KS de 0,27 e um AUC de 0,65. O resultado dessa consulta é um score numérico, variando de 0 até 1000. Valores maiores representam um menor risco de crédito, ou seja, um score de 1000 significa que a empresa tem o menor risco possível. O score pode ser calculado para qualquer empresa, e não depende do envio de informações adicionais para o seu cálculo. Os resultados podem ser obtidos enviando apenas o CNPJ. O score foi otimizado para empresas que estão entre 50 mil e 500 milhões de Reais de faturamento anual. Se você quiser conhecer mais sobre o score, e sobre a forma como o mesmo foi construído, veja esse post em nosso blog.

Origem da Informação

O score de crédito é calculado pela Murabei com base em informações contidas nos datasets da BigDataCorp.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,600
10001 - 50000R$ 0,570
50001 - 100000R$ 0,541
100001 - 500000R$ 0,514
500001 - 1000000R$ 0,488
1000001 - 5000000R$ 0,464
5000001 - 10000000R$ 0,441
10000001 - 50000000R$ 0,419
50000001 e acimaR$ 0,398

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCNPJ🛑 Obrigatório
referencedatePeríodo a ser consultadoQualquer data válidaℹ️  Opcional
dateformatFormato da data de referência informadaString de formatação da data, como yyyy-MM-dd ou similarℹ️  Opcional

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "partner_murabei_credit_score_company",
    "q": "doc{CNPJ}"  
}  

Versões disponibilizadas

Essa consulta atualmente suporta o uso de 3 versões diferentes, sendo a segunda a consulta padrão no momento. Na tabela abaixo você pode conferir todas as versões do dataset de Score de Risco da Murabei. Recomendamos o uso explícito do dataset versionado caso não seja interessante uma atualização implícita da versão do dataset (o que pode vir a ocorrer no nome de dataset simplificado quando novas versões são lançadas - que irá atualizar o nome simplificado para a penúltima), ou quando seja interessante utilizar a versão mais nova disponibilizada (a qual será sempre versionada a fim de preservar o máximo de estabilidade possível para o nome simplificado). Vale lembrar que todas essas versões possuem a mesma precificação de dataset conforme na tabela de preços anterior.

VersãoNome de dataset qualificado/versionadoNome de dataset simplificadoConsulta padrão?
1partner_murabei_credit_score_v1N/ANão
2partner_murabei_credit_score_v2partner_murabei_credit_scoreSim
3partner_murabei_credit_score_v3N/ANão

Descrição dos campos do objeto principal de retorno

CampoDescrição
OriginFonte dos Dados Entregues
InputParametersParâmetros de entrada
QueryRawHTMLResultResultado bruto retornado pela fonte da informação
QueryDateData de realização da consulta
QueryResultData.ScoreNome de acordo com a certidão

Tabela de risco do score

RiscoFaixaDescrição
Alto0-40074% é a taxa média de CNPJs negativados nos próximos 6 meses
Intermediário401-50055% é a taxa média de CNPJs negativados nos próximos 6 meses
Baixo501-70026% é a taxa média de CNPJs negativados nos próximos 6 meses
Muito Baixo701-100014% é a taxa média de CNPJs negativados nos próximos 6 meses

Retornos Especiais

Este dataset contém uma mensagem de retorno especial, relacionada à casos aonde não possuímos informações suficientes para realizar o cálculo do score para o CNPJ consultado. Nesse caso, o campo de "Status" será preenchido com o seguinte valor: NOT ENOUGH DATA TO GENERATE OUTPUT. No caso deste valor ser retornado, o cliente não será cobrado pela consulta.

Language
Credentials
Click Try It! to start a request and see the response here!