Credit Risk Pro | ClearSale Docs

Introdução

O Credit Risk Pro é o produto de modelos customizados para análise de crédito. Esse produto oferece scores a partir da construção de modelos complexos e customizados utilizando a tecnologia de Machine Learning.

Transação

Envio

Este método é utilizado para fazer o envio de uma transação para a API do Credit Risk Pro.

Requisição

POST https://productsapi.clearsale.com.br/v1/creditriskpro/transaction HTTP/1.1
Content-Type: application/json
Accept:application/json
Authorization: Bearer {Token}
{
    "document":"12345678901",(obrigatório)
    "criterion": 1 (obrigatório)

}

POST https://hmlproductsapi.clearsale.com.br/v1/creditriskpro/transaction HTTP/1.1
Content-Type: application/json
Accept:application/json
Authorization: Bearer {Token}
{
    "document":"12345678901",(obrigatório)
    "criterion": 1 (obrigatório)

}

Resposta

HTTP/1.1 200 Ok
Content-Type: application/json; charset=utf-8
{
    "id": "5f67fb47f8e74ff6a9f3dab49c04389a",
    "document": "12345678901",
    "criterion": 1,
    "creationDateUtc": "2022-01-18T14:30:37.5152808Z",
    "scores": [
        {
            "name": "Score Geral",
            "value": "500"
        }
    ]
}

HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "detail": "Please refer to the errors property for additional details",
    "instance": "/Transaction/",
    "errors": {
        "Document": [
            "'Document' must not be empty.",
            "Document CPF is invalid!",
            "The lenght of 'Document' must be at least 11 characters."
        ],
        "Criterion": [
            "'Criterion' must not be empty."
        ]
    }
}

HTTP/1.1 204 No Content

HTTP/1.1 500 Internal Server Error
{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.6.1",
    "title": "Internal server error.",
    "status": 500,
    "detail": "The server encountered an unexpected condition that prevented it from fulfilling the request.",
    "instance": "/Transaction/"
}

HTTP/1.1 401 Unauthorized

HTTP/1.1 403 Forbidden

Dicionário de variáveis

Transaction

Nome	Descrição	Tipo	Tamanho	Obrigatório
Document	CPF para consulta	String	11	Sim
Criterion	Id do modelo customizado	Int	-	Sim

Results

Nome	Descrição	Tipo	Tamanho
Id	Código da transação	String	32
Document	CPF consultado	String	11
Criterion	Id do modelo customizado de consulta	Int	-
CreationDateUtc	Data de criação da transação no padrão UTC	DateTime	-
Scores	Lista com os scores retornados	Array	-

Scores

Nome	Descrição	Tipo	Tamanho
Name	Nome do score retornado	String	-
Value	Valor do score retornado	String	-

Homologação

Para realizar testes e validações dos possíveis retornos, esteja atento às considerações listadas abaixo:

Considerações:

O campo Document é obrigatório e deverá ter um CPF válido.
Para o ambiente de Homologação, o valor do campo Criterion deverá ser 1.
Para o ambiente de Homologação, o score gerado será um valor aleatório.