No Credere, o cliente representa a parte interessada na aquisição de um veículo por meio de uma proposta de financiamento. Ele é composto por várias informações pessoais, tais como: informações de identificação, informações de contatos, informações profissionais, informações bancárias, endereços, dentre outros.

O cadastro do cliente é uma etapa fundamental no processo de criação e envio de propostas aos bancos.

Se o cliente não existir, ele pode ser criado conforme descrito nesse manual.

📘
Dados obrigatórios do cliente
Devido ao fato de cada banco possuir seus próprios critérios de análise, a obrigatoriedade dos dados do cliente varia de banco para banco.
Sendo assim, recomenda-se a leitura do documento campos obrigatórios por banco no cadastro do cliente, para identificar as informações exigidas por cada banco no processo de análise de propostas.

🚧
Domínio dos campos utilizados no JSON
Os campos:

address_type_id (domínio: address_type)

another_income_type_id (domínio: another_income_type)

cnh_type_id (domínio: cnh_type)

company_activity_id (domínio: company_activity)

document_type (domínio: document_type)

education_id (domínio: education)

genre_id (domínio: genre)

marital_status_id (domínio: marital_status)

phone_type_id (domínio: phone_type)

profession_id (domínio: profession)

professional_ocupation_id (domínio: professional_ocupation)

property (domínio: property)

relationship (domínio: relationship)

rg_state_id (domínio: states)

state_id (domínio: states)

state_of_birth_id (domínio: states)

Devem ser preenchidos com um ID existente no respectivo domínio. Todos os domínios do cliente (customer) podem ser obtidos na listagem de domínios do cliente.

🚧
Identificador (ID) de banco utilizados no JSON
Os campos:

previous_funding_bank_id

bank_id

Devem ser preenchidos com o ID de um banco cadastrado. Todos os bancos cadastrados podem ser obtidos na listagem de bancos.

Validação das informações obrigatórias para determinados bancos

Devido ao fato de cada banco exigir um conjunto específico de informações do cliente, é possível validar o preenchimento de todas as informações obrigatórias para um conjunto de bancos específicos. Quando a isso, segue os recursos disponíveis:

1. Validando para banco(s) específico(s)

Para validar as informações do cliente para um conjunto de bancos específicos, adicione o campo bank_validations.bank_codes com o(s) código(s) do(s) banco(s) desejado(s) no JSON enviado no corpo da requisição.

Exemplo:

{
  "bank_validations": {
  	"bank_codes": [
      "341",
      "655",
      "M22"
    ]
  }
  "customer": {
    // (...) Informações do cliente (customer)
  }
}

Para verificar os códigos aceitos no campo bank_validations.bank_codes, consulte o guia campos obrigatórios por banco no cadastro do cliente. O código de cada banco pode ser obtido no endpoint de listagem de bancos.

2. Validando para todos os bancos integrados a determina loja

Para validar as informações do cliente para todos os bancos integrados a determinada loja, adicione o campo bank_validations.store_id com o identificador (ID) da loja no JSON enviado no corpo da requisição.

Exemplo:

{
  "bank_validations": {
  	"store_id": 1
  }
  "customer": {
    // (...) Informações do cliente (customer)
  }
}

3. Validando para todos os bancos integrados ao Credere

Para validar as informações do cliente para todos os bancos integrados ao Credere, não adicione o campo bank_validations no JSON enviado no corpo da requisição.

Exemplo:

{
  "customer": {
    // (...) Informações do cliente (customer)
  }
}

🚧
Prioridade na escolha dos critérios bancários para validação das informações do cliente
Devido a existência de várias maneiras de especificar os bancos que serão considerados na validação dos dados do cliente, a definição dos bancos segue a seguinte prioridade:

Validar para banco(s) específico(s);

Validar para todos os bancos integrados a determina loja;

Validar para todos os bancos integrados ao Credere;

Sendo assim, a escolha dos bancos utilizados como critério de validação segue o primeiro método que tenha seus requisitos cumpridos.

🚧
Erros de validação
Durante a utilização desse endpoint, o Credere valida os dados enviados.
Se existir(em) inconsistência(s) nas informações enviadas, a API responde com um erro de validação, destacando o(s) problema(s) identificado(s).
Caso tenha recebido um erro e encontre dificuldade de compreendê-lo, recomenda-se a leitura do guia de erros. O guia pode ajudá-lo a compreender a(s) inconsistência(s) identificada(s) na validação de dados.

🚧
Caracteres especiais
Para evitar incompatibilidade com os sistemas de processamento de propostas dos bancos, limitamos o uso de alguns caracteres especiais no preenchimento das informações do cliente, são eles:
! # $ % ^ &* ( ) + \ - = [ ] { } ; ' : " / | < > ? ` ~

Exemplo de corpo da requisição

{
  "bank_validations": {
  	"bank_codes": [
      "033",
      "341",
      "342",
      "394",
      "422",
      "623",
      "655",
      "fontecred",
      "M22",
      "moneyplus"
    ],
    "store_id": 1
  },
  "customer": {
    "cpf": "000.000.000-00",
    "name": "Nome do cliente",
    "nickname": "Apelido do cliente",
    "born_at": "01/01/2000",
    "have_bank_account": true,
    "accountant": {
      "name": "Nome do contador",
      "city": "Cidade do contador",
      "phone": {
        "code": 84,
        "number": 999999999,
        "phone_type_id": 1,
        "phone_confirmation_id": null
      }
    },
    "address": {
      "address_type_id": 1,
      "city": "Natal",
      "number": "3700, Sala 409 Bloco A",
      "street": "Avenida Amintas Barros",
      "zip_code": "59075-810",
      "complement": "Edifício Corporate Tower Center-Trade",
      "state_id": 20,
      "neighborhood": "Lagoa Nova",
      "set_time_year": 1,
      "set_time_month": 0,
      "build_type_id": 3,
      "rent_value_cents": 100000
    },
    "has_made_funding": true,
    "previous_funding_bank_id": 1,
    "accept_boleto": true,
    "note": "Observação",
    "emails": [
      {
        "address": "cliente@email.com"
      }
    ],
    "phones": [
      {
        "code": 84,
        "number": 999999999,
        "phone_type_id": 1,
        "phone_confirmation_id": null
      },
      {
        "code": 84,
        "number": 999999999,
        "phone_type_id": 2,
        "phone_confirmation_id": null
      }
    ],
    "bank_references": [
      {
        "bank_id": 1,
        "overdraft": true,
        "agency": "0000-0",
        "open_at": "01/01/2000",
        "account_number": "00000",
        "digit": "0"
      }
    ],
    "addresses": [
      {
        "address_type_id": 2,
        "city": "Natal",
        "number": "3700, Sala 409 Bloco A",
        "street": "Avenida Amintas Barros",
        "zip_code": "59075-810",
        "complement": "Edifício Corporate Tower Center-Trade",
        "state_id": 20,
        "neighborhood": "Lagoa Nova",
        "set_time_year": 1,
        "set_time_month": 0,
        "build_type_id": 3,
        "rent_value_cents": 100000
      },
      {
        "address_type_id": 3,
        "city": "Natal",
        "number": "3700, Sala 409 Bloco A",
        "street": "Avenida Amintas Barros",
        "zip_code": "59075-810",
        "complement": "Edifício Corporate Tower Center-Trade",
        "state_id": 20,
        "neighborhood": "Lagoa Nova"
      }
    ],
    "attachments": [],
    "mother": "Nome da mãe",
    "father": "Nome do pai",
    "document_type": "RG",
    "rg": "000000000",
    "rg_date": "01/01/2000",
    "rg_state_id": 20,
    "rg_issuing": "SSP",
    "has_cnh": true,
    "cnh": "00000000000",
    "cnh_type_id": 1,
    "marital_status_id": 1,
    "spouse_name": "Nome do cônjuge",
    "spouse_born_at": "01/01/2000",
    "spouse_cpf": "000.000.000-00",
    "nationality": "Brasileira",
    "place_of_birth": "Natal",
    "state_of_birth_id": 20,
    "genre_id": 1,
    "education_id": 5,
    "property": 4,
    "public_person": true,
    "job_reference": {
      "address": {
        "address_type_id": 4,
        "city": "Natal",
        "number": "3700, Sala 409 Bloco A",
        "street": "Avenida Amintas Barros",
        "zip_code": "59075-810",
        "complement": "Edifício Corporate Tower Center-Trade",
        "state_id": 20,
        "neighborhood": "Lagoa Nova"
      },
      "joined_at": "01/01/2010",
      "income_cents": 1000000,
      "another_income_cents": 100000,
      "another_income_type_id": 2,
      "detail": "",
      "first_job": false,
      "professional_ocupation_id": 6,
      "profession_id": 2,
      "department": "Nome do departamento",
      "name": "Nome da empresa",
      "cnpj": "00.000.000/0000-00",
      "company_activity_id": 2,
      "phone": {
        "code": 84,
        "number": 999999999,
        "phone_type_id": 3,
        "phone_confirmation_id": null
      },
      "previous_work": "Nome da empresa",
      "previous_work_start_at": "01/01/2000",
      "previous_work_end_at": "01/01/2000",
      "previous_job_phone": {
        "code": 84,
        "number": 999999999,
        "phone_type_id": 5,
        "phone_confirmation_id": null
      }
    },
    "have_credit_card": true,
    "credit_cards": "Mastercard",
    "personal_references": [
      {
        "name": "Nome do contato de referência",
        "city": "Natal",
        "phone": {
          "code": 84,
          "number": 999999999,
          "phone_type_id": 2,
          "phone_confirmation_id": null
        },
        "relationship": "Pai"
      }
    ]
  }
}

201201

400400

401401

422422