O financiamento de veículos é uma modalidade de crédito que permite a aquisição de automóveis de forma parcelada, oferecendo uma alternativa acessível para pessoas jurídicas (CNPJ) de obter um veículo sem a necessidade de pagamento à vista. Esse tipo de financiamento é amplamente utilizado por consumidores que buscam flexibilidade financeira, permitindo a escolha de prazos e condições ajustáveis ao perfil do comprador. Para minimizar os riscos de inadimplência e tornar a operação mais segura tanto para o cliente quanto para a instituição financeira, o próprio veículo financiado é utilizado como garantia da operação. Além disso, diferentes condições de crédito podem ser aplicadas, considerando fatores como histórico do cliente, valor de entrada e taxa de juros. Este documento explora o funcionamento do financiamento de veículos, abordando suas modalidades, critérios de análise e os benefícios que essa solução oferece para parceiros BMP. Abaixo segue o passo a passo para utilização do caso de uso:
Antes de utilizar este serviço, é necessário configurar a autenticação. Consulte as instruções de autenticação para orientações detalhadas.

​
1 - Simulações

O primeiro passo para a contratação de crédito na modalidade Financiamento de Veículos é a simulação. A simulação pode ser realizada de duas formas:

​
2 - Onboarding

Após a simulação, é necessário realizar o cadastro dos dados e endereço do cliente. Essa etapa é chamada de onboarding. O onboarding é realizado em duas etapas:

​
3 - Contratação

Após a simulação e o onboarding, é necessário realizar a requisição de contratação do crédito. Chamamos essa etapa de Inclusão de Proposta.

​
4 - Inclusão de Dados do Veículos

Após a requisição de contratação, é necessário realizar a inclusão dos dados do veículo.

​
5 - Inclusão de documentos do Veículo

Nesta etapa o parceiro poderá encaminhar os documentos do veículo através do endpoint abaixo: 
curl --location 'https://api.bmpdigital.moneyp.dev.br/Proposta/IncluirDocumento' \
--header 'IdempotencyKey: GUID UNICO PARA CADA CHAMADA' \
--header 'Content-Type: application/json' \
--data '{
  "dto": { // Apenas um dos campos abaixo deve ser informado
    "codigoProposta": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Colocar GUID da proposta gerado no response da inclusão da proposta
    "codigoOperacao": "string" // Colocar codigo da operação utilizado na inclusão da proposta
  },
  "documento": {
    "codigo": "3fa85f64-5717-4562-b3fc-2c963f66afa6", // Código da proposta gerado no response da criação da proposta | OBRIGATÓRIO
    "tipoDocumento": 0, // Tipo de documento do seu cliente (caso queira informar, verifique a tabela de enum no email) | OBRIGATÓRIO
    "nomeArquivo": "string", // Nome do arquivo | OBRIGATÓRIO
    "extensao": "string", // Extensão do arquivo (ex: jpg, pdf, png) | OBRIGATÓRIO
    "dtValidade": "2023-05-23T20:57:08.922Z", // Data de validade do arquivo | OBRIGATÓRIO
    "arquivo": "string" // Arquivo desejado codificado em BASE64 | OBRIGATÓRIO
  }
}'

​
6 - Coleta de Assinaturas

Após informar os dados do veículo, é necessário coletar as assinaturas dos envolvidos na proposta. Para saber mais sobre os modelos de assinatura, acesse o documento de Assinaturas. A assinatura pode ser realizada de três formas:

​
7 - Liberação de proposta (Opcional)

Este é o último passo do processo de contratação do crédito na modalidade Financiamento de Veículos. O parceiro pode liberar a proposta para a fila de pagamento após receber o status de proposta “finalizada”, sendo o processo de desembolso de responsabilidade da BMP. Nesta etapa, é necessário realizar a liberação da proposta por meio da integração com nossa URL de Liberação da proposta para pagamento para validação do modelo após a assinatura.
Em casos de utilização do gravame automático, não é necessário chamar o endpoint de liberação de proposta. O processo ocorre automaticamente conforme a vinculação do gravame ao financiamento.

​
Endpoints e documentos auxiliares

Para esta jornada, é muito importante que o parceiro conheça o Procedimento Técnico de Callback do CaaS e tenha uma URL de callbacks configurada. Também podem ser úteis os seguintes endpoints: