Créditos para automóveis

Importante:
Este recurso está disponível apenas para Brasil.

O recurso /vis/loans permite ao vendedor identificar créditos pré-aprovados pelos bancos em caso de negociação com o comprador.

Conteúdos

→Consultar créditos disponibilizados para os itens do vendedor
→Detalhes do crédito disponibilizado
→Possíveis erros



Consultar créditos disponibilizados para os itens do vendedor

O primeiro recurso que disponibilizamos para o vendedor é o de consultar todos os créditos que já estão disponíveis por suas negociações, com a possibilidade de paginar usando parâmetro offset com um limite máximo de 100 itens por página.
A variação de tempo máxima entre a data inicial até a data final da pesquisa deve ser de no máximo 3 meses.


Para obter os dados de testes, utilize o header 'x-sandbox: true'

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/vis/loans/search?seller_id=$SELLER_ID&date_from=AAAA-MM-DDTHH:MM:SS&date_to=AAAA-MM-DDTHH:MM:SS

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/vis/loans/search?seller_id=707775316&date_from=2020-12-10T00:00:00&date_to=2021-01-01T00:00:00

Resposta:

{
  "results": [{
    "id": "14b556e2-85dc-11eb-8436-2753cb1f9665",
    "item_id": "MLB5903538649",
    "down_payment_amount": 9012.0,
    "installments_number": 9,
    "installments_amount": 1001.0,
    "seller_id": 707775316,
    "buyer_id": 65979,
    "date_created": "2020-12-19T14:00:59",
    "financial_entity_id": "VOTORANTIM",
    "expired": false
  }],
  "paging": {
    "offset": 0,
    "limit": 10,
    "total": 1
  },
  "date_from": "2020-12-10T00:00:00",
  "date_to": "2021-01-01T00:00:00"
}

Além dos parâmetros do recurso, estão disponíveis os seguintes filtros complementares:
item_id
financial_entity_id: VOTORANTIM, ITAU ou SANTANDER.


Campos de resposta

  • ID: id de crédito.
  • item_id: id Item.
  • down_payment_amount:: valor do adiantamento.
  • installments_number: quantidade de taxas.
  • installments_amount: valor da taxa.
  • seller_id: id do vendedor.
  • buyer_id: id do comprador.
  • date_created: data de criação de crédito.
  • financial_entity_id: id banco.
  • expired: true or false.


Detalhes do crédito disponibilizado

Com o ID do crédito, é possível acessar os detalhes da proposta, incluindo os dados de contato do comprador.


Para obter os dados de testes, utilize o header 'x-sandbox: true'.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/vis/loans/$CREDIT_ID?seller_id=$SELLER_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/vis/loans/14b52fd8-85dc-11eb-8436-2753cb1f9665?seller_id=707775316

Resposta:

{
  "id": "14b52fd8-85dc-11eb-8436-2753cb1f9665",
  "item_id": "MLB3450596169",
  "down_payment_amount": 3575.0,
  "installments_number": 21,
  "installments_amount": 170.0,
  "seller_id": 707775316,
  "date_created": "2021-03-08T04:41:39",
  "financial_entity_id": "VOTORANTIM",
  "buyer": {
    "id": 7165,
    "full_name": "Natália Costa",
    "email": "Bernardo.Silva@example.com",
    "phone": "(46) 6501-4768"
  }
}

Campos de resposta

  • buyer.id: id do comprador.
  • buyer.full_name: nome do comprador.
  • buyer.email: e-mail do comprador.
  • buyer.phone: número de telefone de contato do comprador.


Possíveis erros

Erros na busca por créditos:

Error_code Tipo Mensaje del error Solución
401 Unauthorized Unauthorized Sem access token
400 Bad Request Value of seller_id parameter must match value obtained from auth token Access token não pertence ao vendedor
400 Bad Request Invalid date_from format. It must follow ISO format Formato da data inválido
400 Bad Request Date range cannot exceed 3 months Período de busca maior a 3 meses
400 Bad Request Invalid financial entity Banco não existe
400 Bad Request item_id value must match M[A-Z]{2}[0-9]+$ Item inválido


Erros para obter os detalhes do crédito:

Error_code Tipo Mensaje del error Solución
401 Unauthorized Unauthorized Sem access token
400 Bad Request Value of seller_id parameter must match value obtained from auth token Access token não pertence ao vendedor
400 Bad Request id value must match [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12} like an uuid Identificador inválido
404 Not Found Detail not found for credit with id Crédito inexistente
410 The resource is expired Gone Crédito expirado

Conheça mais sobre Crédito.

ou registre-se para receber as últimas notícias sobre nossa API