Erros criação da proposta

Abaixo listamos os possíveis erros retornados ao enviar uma proposta de solicitação de empréstimo.

🚧

Recomendação importante

Para que a integração tenha qualidade e seja possível obter resultados positivos com sua operação, é muito importante ter atenção as dicas descritas ao decorrer deste documento.


Confira abaixo os principais códigos de retorno para mapear na integração:

Code status

Code

Message

Descrição

400

REQUEST_VALIDATION_ERROR

Some fields are not valid

Indica que existem erros em um ou mais campos da sua solicitação. Confira o detalhamento dos principais motivos de erros 400

409

CONFLICT

This CPF and or e-mail has an active lead

Duplicated lead

O lead enviado não é elegível para ser criado por alguns motivos:

  • Inconsistência de dados cadastrais (email ou cpf) de tentativas anteriores e da atual

  • Existência de um outro lead ativo na esteira (usando o mesmo email ou CPF).
    Para minimizar o erro de lead duplicado, antes de fazer a criação da proposta, verifique a elegibilidade do lead através deste endpoint



Principais erros na Criação da Proposta

Ao enviar uma solicitação de empréstimo precisamos que os campos sejam preenchidos corretamente e com valores válidos, caso contrário a solicitação não será concluída com sucesso.

Para garantir que isso não ocorra a dica é garantir que os campos na sua experiência tenham as devidas validações durante o preenchimento do cliente, reduzindo assim um possível erro 400.

Principais erros identificados:

  • Campos sem a devida validação
  • Falta de monitoramento na integração, importante observar os retornos e o detalhe dos erros

Confira alguns exemplos e dicas para garantir a validação de erros 400


Descrição do erro

Mensagem de erro API / Envio incorreto

Formato correto / Como corrigir

Data de aniversário com formato inválido

Invalid date ⚠️


01-08-89

O campo data deve seguir o formato YYYY-MM-DD

Valor do veículo deve ser maior que 0 (zero)

{collateral.value=must be greater than 0} ⚠️


modelYear:"2010"
manufacturingYear:"2020"

modelYear:""
manufacturingYear:""

O campo ANO MODELO (modelYear) não pode ser menor do que o ANO DE FABRICAÇÃO (manufacturingYear)


Os campos devem estar de acordo com as informações do veículo

Placa do veículo com valor inválido

`License plate with invalid format ⚠️


licensePlate: "1234HAJ"

Recomendamos que seja feita uma validação para garantir o correto preenchimento seguindo padrões de placas brasileiras.
Placas antigas (antes de 2019) tinham o formato com 3 letras seguidas por 4 números (ex: XXX9999). Já as placas novas tem o padrão de 4 letras e 3 números.

Exemplo de validação utilizando expressão regular para validar os formatos.

Placa do veículo com quantidade de caracter inválido ou campo vazio

LicensePlate size must be between 7 and 8 ⚠️


licensePlate: ""

O campo placa deve conter entre 7 ou 8 dígitos, não deve ser enviado vazio.

Dados de Bacen faltando no header

Missing headers (X-User-Ip, X-User-Agent, X-Bacen-Authorized-At) ⚠️


Informações não sendo enviadas no header

As informações de header e temos devem seguir as recomendações de autorização bacen

Dados de Bacen com formato inválido

Invalid X-Bacen-Authorized-At header, please send date in format (ISO): YYYY-MM-DDTHH:mm:sssZ. Example: 2021-01-22T09:00 ⚠️


Informações enviadas incorretamente, exemplos:

  • Data com formato inválido
  • IP inválido
  • Texto de consentimento com informação correta

Formato correto da data deve ser ISO

2021-01-22T09:00

CEP com formato inválido ou vazio

Some fields are not valid ⚠️


postalCode: "5947000"
postalCode: ""

O campo CEP deve conter 8 números.

Nome com valor inválido

field contain numbers ⚠️


fullName: "Nome de Teste 32"

O campo nome deve conter apenas letras.

E-mail inválido

must be a well-formed email address ⚠️


email: "[email protected]"

O campo email deve conter o domínio completo e seu um e-mail válido.

Telefone inválido

must be a valid cellphone pattern example: 988888888 ⚠️

O campo telefone deve seguir o formato 988888888, contendo 9 dígitos no total


Temos um processo de monitoramento para garantir a qualidade das integrações e os resultados do negócio e um processo importante dele é o processo de homologação da sua integração. No processo conferimos o formato de envio de cada campo porém, ao subir sua integração para um ambiente de produção, se não garantir as validações na sua experiência do cliente, o volume e tipos diferentes de usuários pode preencher indevidamente os campos e com isso é possível que nosso time técnico identifique erros e seja obrigatória a correção para manter o funcionamento.


👍

Sucesso na integração

Todos os erros mencionados podem ser tratados antecipadamente ao envio, o ponto importante é implementar validação em cada campo, utilizar o recurso de máscara e mensagens de instruções para que dessa forma o cliente possa ter maior assertividade no preenchimento dos campos e com uma conclusão mais positiva.