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
ou registre-se para receber as últimas notícias sobre nossa API