Créditos para vehículos

Importante:
Este recurso está disponible solo para Brasil.

El recurso de /vis/loans permite al vendedor identificar créditos pre-aprobados por los bancos en caso de negociación con el comprador.

Contenidos

→Consultar créditos disponibilizados para los ítems del vendedor
→Detalles del crédito disponibilizado
→Posibles errores



Consultar créditos disponibilizados para los ítems del vendedor

Ahora, el vendedor puede consultar todos los créditos disponibles por sus negociaciones, con la posibilidad de paginarlos con el parámetro offset y con un límite máximo de 100 ítems por página.Los datos estarán disponibles en un período máximo de consulta de 3 meses.

Para obtener los datos de pruebas, utilice el header 'x-sandbox: true'

Llamada:

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

Ejemplo:

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

Respuesta:

{
  "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"
}

Parámetros disponibles:
item_id
financial_entity_id: VOTORANTIM, ITAU o SANTANDER.


Campos de respuesta

ID: id de crédito.

item_id: id Item.

down_payment_amount: monto de entrada de crédito.

installments_number: cantidad de cuotas.

installments_amount: monto de la cuota.

seller_id: id del vendedor.

buyer_id: id del comprador.

date_created: fecha de creación del crédito.

financial_entity_id: id banco.

expired: true or false.


Detalles del crédito disponibilizado

Con el ID del crédito, puedes acceder a los detalles incluidos los datos de contacto del comprador.

Para obtener los datos de pruebas, utilice el header 'x-sandbox: true'.

Llamada:

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

Ejemplo:

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

Respuesta:

{
           "id": "14b52fe8-85dc-11eb-8436-2753cb1f9665",
           "item_id": "MLB4331451298",
           "down_payment_amount": 430.0,
           "installments_number": 20,
           "installments_amount": 22.0,
           "seller_id": 707775316,
           "buyer_id": 26208,
           "proposal_id": "40962",
           "status": "approved",
           "date_created": "2020-12-30T12:34:54",
           "financial_entity_id": "ITAU",
           "expired": false
       }

Campos de respuesta

buyer.id: id del comprador.

buyer.full_name: nombre del comprador.

buyer.email: e-mail del comprador.

buyer.phone: eléfono contacto del comprador.


Posibles errores

Errores en la búsqueda por créditos:

Error_code Tipo Mensaje del error Solución
401 Unauthorized Unauthorized Sin access token
400 Bad Request "Value of seller_id parameter must match value obtained from auth token" Access token no pertenece al vendedor:
400 Bad Request Invalid date_from format. It must follow ISO format Formato de la fecha inválido
400 Bad Request Date range cannot exceed 3 months Periodo de búsqueda mayor a 3 meses
400 Bad Request Invalid financial entity Banco no existe
400 Bad Request item_id value must match M[A-Z]{2}[0-9]+$ tem inválido


Errores para obtener los detalles del crédito:

Error_code Tipo Mensaje del error Solución
401 Unauthorized Unauthorized Sin access token
400 Bad Request Value of seller_id parameter must match value obtained from auth token Access token no pertenece al 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
o regístrate para recibir las últimas novedades sobre nuestra API