Link de Simulação

Com o objetivo de proporcionar uma experiência mais completa aos nossos usuários que fazem parte da iniciativa de Créditos Prendários no Mercado Livre Brasil e utilizam ferramentas de gestão de terceiros em seu dia a dia, apresentamos a seguir a documentação técnica associada à iniciativa de disponibilizar um “Link de Simulação” em nossa API de Pessoas interessadas.

Contexto da iniciativa

Existem 3 entidades principais que hoje permitem a venda de um veículo através de crédito:

Comprador

Usuário do Mercado Livre que deve ter uma linha de crédito prendário ativa. Esse tipo de usuário tem uma experiência diferenciada no site, permitindo que encontre veículos financiáveis e simule diferentes condições de crédito. Nem todos os compradores fazem parte dessa iniciativa.

Vendedor

Usuário do Mercado Livre que deve participar da iniciativa de Créditos Prendarios para oferecer e vender seus veículos a compradores com uma linha de crédito ativa. Nem todos os vendedores fazem parte dessa iniciativa.

Item

Neste caso é o veículo que um vendedor oferece e um comprador deseja financiar. Existem certos requisitos para um veículo ser financiado, por isso nem todos os veículos de um vendedor são financiáveis. Apenas os veículos “financiáveis” são apresentados ao comprador no site com uma experiência diferenciada, e somente esses veículos o vendedor pode usar para simular e vender na ferramenta de Créditos Prendarios disponível no site.

Link de simulação

Hoje, um vendedor ativo na iniciativa de Créditos Prendários tem acesso a duas ferramentas principais no site:

1. Um painel para a gestão de seus leads.
2. Um simulador e gestor de créditos.

Para cada lead apresentado na primeira ferramenta, existe a opção de ir para “Simular” para aquele comprador e veículo em particular.

Uma vez que o vendedor clica na ação de “Simular”, ele é redirecionado para a segunda ferramenta, onde pode realizar a simulação das condições. Nesta tela, o vendedor pode ajustar o preço do veículo, valor de entrada, número de parcelas, entre outros. Todos os dados necessários para a simulação são preenchidos automaticamente(dados do comprador e do veículo).

Esta é a experiência que buscamos levar aos nossos vendedores.

Mudanças de API

Estaremos impactando as mudanças nos 2 endpoints disponíveis do API de pessoas interessadas para disponibilizar um novo atributo chamado “simulador_url”.

Endpoint: pesquisa de leads

Exemplo

Chamada:

  curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/users/$USER_ID/leads/buyers?offset=$OFFSET&limit=$LIMIT&date_from=$DATE_FROM&date_to=$DATE_TO&contact_types=$CONTACT_TYPES

Resposta atual:

  {
    "results": [
        {
            "id": 2678328,
            "item_id": "MLA1430828018",
            "name": "John Doe",
            "email": "jhon@example.com",
            "phone": "+5491198765432",
            "leads": [
                {
                    "id": "6b4aebf8-5570-47b8-9224-c1c177621575",
                    "contact_type": "question",
                    "created_at": "2024-05-14T14:15:39Z",
                    "external_id": "12776297658",
                    "item_id": "MLA1430828018",
                    "buyer_id": 2678328,
                    "status": "active"
                }
            ]
        }
    ],
    "paging": {
        "offset": 0,
        "limit": 10,
        "total": 1
    },
    "date_from": "2024-05-14",
    "date_to": "2024-05-24"
}

Nova Resposta

  {
    "results": [
        {
            "id": 2678328,
            "item_id": "MLA1430828018",
            "name": "John Doe",
            "email": "jhon@example.com",
            "phone": "+5491198765432",
            "simulator_url": "https://www.mercadolivre.com.br/......", // NEW ATTRIBUTE
            "leads": [
                {
                    "id": "6b4aebf8-5570-47b8-9224-c1c177621575",
                    "contact_type": "question",
                    "created_at": "2024-05-14T14:15:39Z",
                    "external_id": "12776297658",
                    "item_id": "MLA1430828018",
                    "buyer_id": 2678328,
                    "status": "active"
                }
            ]
        }
    ],
    "paging": {
        "offset": 0,
        "limit": 10,
        "total": 1
    },
    "date_from": "2024-05-14",
    "date_to": "2024-05-24"
}

Endpoint: pesquisa de detalhes do lead

Exemplo

Chamada:

  curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/leads/$LEAD_ID

Resposta atual:

  {
    "id": "44115522",
    "item_id": "MLB4037459422",
    "created_at": "2024-02-14T00:00:00Z",
    "contact_type": "whatsapp",
    "external_id": "13864821",
    "status": "active",
    "buyer_id": 1091441589,
    "name": "Test Test",
    "email": "john@example.com",
    "phone": "+55 01 1111-1111"
}

Nova Resposta

  {
    "id": "44115522",
    "item_id": "MLB4037459422",
    "created_at": "2024-02-14T00:00:00Z",
    "contact_type": "whatsapp",
    "external_id": "13864821",
    "status": "active",
    "buyer_id": 1091441589,
    "name": "Test Test",
    "email": "john@example.com",
    "phone": "+55 01 1111-1111",
    "simulator_url": "https://www.mercadolivre.com.br/......" // NEW ATTRIBUTE
}