Criação de Proposta com Processamento Automático

Informações necessárias para completar o cadastro da proposta para um processamento automático de análise de crédito.

As solicitações de empréstimo com imóvel em garantia com processamento automático, incluem além dos dados básicos conforme Criação da proposta com garantia.

Essa seção descreve os demais campos para criação de propostas aptas a processamento automático.



Como enviar uma solicitação de empréstimo

As informações enviadas devem seguir o request headers e request body a seguir:

Request HTTP POST

Tipo de RequisiçãoURLExemplo
POST{{url_base}}/proposals/homehttps://stg-api.creditas.io/b2b/proposals/home

Request Headers

Necessário utilizar o header com token de autenticação. Consulte como funciona a autenticação Creditas.

CampoTipoObrigatórioDescrição
productTypestringSimHOME_REFI
purposestringSimMotivos para solicitação de empréstimo.
Consulte os motivos de empréstimo.
borrowerobjectSimDados pessoais do solicitante do empréstimo.
Consulte o objeto do borrower
intendedCreditobjectSimInformações sobre a proposta de empréstimo.
Consulte o objeto do intendedCredit
conditionsobjectSimCondições de parcelamento do empréstimo.
Consulte o objeto do conditions
collateralobjectSimDados da garantia do solicitante do empréstimo.
Consulte o objeto do collateral

Request Response

CampoTipoDescrição
idstringId da proposta
productTypestringProduto referente a proposta enviada

Exemplo de Request e Response

curl --location --request POST '{{url_base}}/proposals/home' \
--header 'Accept: application/vnd.creditas.v1+json' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer {{access_token}}' \
--data-raw '{
    "purpose": "GOODS_ACQUISITION",
    "borrower": {
        "cpf": "59853249073",
        "fullName": "Lucas Ramos",
        "email": "[email protected]",
        "birthDate": "1990-10-10",
        "cellphone": "234567898",
        "cellphoneCode": "11",
        "maritalStatus": "MARRIED",
        "stableUnion": true,
        "optIns": {
            "email": false,
            "whatsApp": false,
            "sms": false
        },
        "authorizationTerms": "O cliente autorizou a consulta de informações a seu respeito mantidas no Sistema de Informações (SCR) organizado pelo Banco Central do Brasil.",
        "nationality": "Brasil",
        "professionalInfo": {
            "professionalStatus": "CLT",
            "monthlyIncome": 100000,
            "description": "Descricao",
            "jobTitle": "Adestrador(a)",
            "startedAt": "2020-10-01"
        },
        "spouse": {
            "fullName": "Joseane Campos",
            "email": "[email protected]",
            "birthDate": "1990-10-10",
            "cellphone": "345678987",
            "cellphoneCode": "12",
            "cpf": "48313729007",
            "nationality": "Brasil",
            "isCosigner": true,
            "professionalInfo": {
                "professionalStatus": "CLT",
                "monthlyIncome": 100000,
                "description": "Descricao",
                "jobTitle": "Adestrador(a)",
                "startedAt": "2020-10-01"
            }
        },
        "residence":{
            "address":"Avenida Leonardo da Vinci",
            "number":"123",
            "city":"São Paulo",
            "complement": "Casa",
            "state":"SP",
            "neighborhood":"Vila Guarani (Z Sul)",
            "postalCode":"04313001",
            "country":"BR"
        }
    },
    "intendedCredit": {
        "currency": "BRL",
        "amount": 100000
    },
    "conditions": {
        "installment": {
            "term": 60
        }
    },
    "collateral": {
        "owners": [
            "BORROWER",
            "SPOUSE"
        ],
        "value": 1000000,
        "realEstateType": "APARTMENT",
        "address": "Avenida Leonardo da Vinci",
        "number": "123",
        "city": "São Paulo",
        "state": "SP",
        "neighborhood": "Vila Guarani (Z Sul)",
        "postalCode": "04313-001",
        "country": "BR",
        "hasDeed": "YES"
    }
}'
HTTP/1.1 201 OK
Content-Type: application/json; charset=UTF-8
Accept-Version: v1

{
    "id": "B2B-DBC79D7F-E5D7-45B9-B9DD-A60C2561EA06",
    "productType": "HOME_REFI"
}