Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade
Última actualización 22/10/2024

Publica vehículos

Los anuncios clasificados son los únicos donde la información de contacto es pública. Por lo que, cuando los usuarios están navegando y tienen interés en una publicación, pueden ponerse en contacto de inmediato. Básicamente no hay ningún tipo de transacciones o intercambios realizados en nuestro sitio para este tipo de artículos, pero estará exponiendo su perfil a cada usuario que esté navegando en la sección "Clasificados" de nuestra plataforma.


Consultar vehículo

Solo debes conocer el item_id asociado al producto y, como es público, puedes obtenerlo en la página Detalles del artículo en la parte superior de la página, como en la imagen del ejemplo. Debes agregar el site_id antes del número y listo. Llamada:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl  -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB1045563828

Respuesta:

{
  "id": "MLB1045563828",
  "site_id": "MLB",
  "title": "Anuncio Teste Prova Carro - Nao Comprar",
  "subtitle": null,
  "seller_id": 307415664,
  "category_id": "MLB76395",
  "official_store_id": null,
  "price": 100000,
  "base_price": 100000,
  "original_price": null,
  "currency_id": "BRL",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "sale_terms": [
    {
      "id": "RESERVATION_PRICE",
      "name": "Valor de reserva",
      "value_id": null,
      "value_name": "1000 BRL",
      "value_struct": {
        "number": 1000,
        "unit": "BRL"
      }
    }
  ],
  "buying_mode": "classified",
  "listing_type_id": "silver",
  "start_time": "2018-06-07T19:03:11.000Z",
  "stop_time": "2018-06-09T14:15:56.000Z",
  "condition": "used",
  "permalink": "https://carro.mercadolivre.com.br/MLB-1045563828-anuncio-teste-prova-carro-nao-comprar-_JM",
  "thumbnail": "",
  "secure_thumbnail": "",
  "pictures": [
  ],
  "video_id": null,
  "descriptions": [
    {
      "id": "MLB1045563828-1704138112"
    }
  ],
  "accepts_mercadopago": true,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
    "mode": "not_specified",
    "methods": [
    ],
    "tags": [
    ],
    "dimensions": null,
    "local_pick_up": false,
    "free_shipping": false,
    "logistic_type": null,
    "store_pick_up": false
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "comment": "",
    "address_line": "Rua Dantas Bião 43",
    "zip_code": "48030030",
    "city": {
      "id": "TUxCQ0FMQTlkMWUy",
      "name": "Alagoinhas"
    },
    "state": {
      "id": "BR-BA",
      "name": "Bahia"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "search_location": {
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TUxCQ0FMQTlkMWUy",
        "name": "Alagoinhas"
      },
      "state": {
        "id": "TUxCUEJBSEFlYmEx",
        "name": "Bahia"
      }
    },
    "latitude": -23.605724,
    "longitude": -46.66427,
    "id": 801390510
  },
  "seller_contact": {
    "contact": "",
    "other_info": "",
    "country_code": "",
    "area_code": "",
    "phone": "",
    "country_code2": "",
    "area_code2": "",
    "phone2": "",
    "email": "",
    "webpage": ""
  },
  "location": {
    "address_line": "Avenida Jurucë, 436",
    "zip_code": "04080011",
    "neighborhood": {
      "id": "",
      "name": ""
    },
    "city": {
      "id": "TVhYQXRpYmFpYVRVeENVRk5CVDA4NU4yRTQ",
      "name": "Atibaia"
    },
    "state": {
      "id": "TUxCUFNBT085N2E4",
      "name": "São Paulo"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "open_hours": "",
    "latitude": "",
    "longitude": ""
  },
  "geolocation": {
    "latitude": "",
    "longitude": ""
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "ITEM_CONDITION",
      "name": "Condição do item",
      "value_id": "2230581",
      "value_name": "Usado",
      "value_struct": null,
      "attribute_group_id": "",
      "attribute_group_name": ""
    },
    {
      "id": "CONTACT_SCHEDULE",
      "name": "Horário de contato",
      "value_id": null,
      "value_name": "Me procurar a tarde",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "SINGLE_OWNER",
      "name": "Único dono",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "STEERING",
      "name": "Direção",
      "value_id": "405719",
      "value_name": "Elétrica",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "TRANSMISSION",
      "name": "Transmissão",
      "value_id": "370876",
      "value_name": "Automática",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "VEHICLE_BODY_TYPE",
      "name": "Tipo",
      "value_id": "452753",
      "value_name": "Minivan",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "HAS_AIR_CONDITIONING",
      "name": "Ar-condicionado",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_AUTOPILOT",
      "name": "Piloto automático",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_ELECTRIC_MIRRORS",
      "name": "Retrovisores elétricos",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
      "name": "Banco motorista com regulagem de altura",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_LEATHER_UPHOLSTERY",
      "name": "Bancos em couro",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_LIGHT_ON_REMINDER",
      "name": "Alarme de luzes acesas",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_ONBOARD_COMPUTER",
      "name": "Computador de bordo",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_PARKING_SENSOR",
      "name": "Sensor de estacionamento",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_POWER_DOOR_LOCKS",
      "name": "Travas elétricas",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_POWER_WINDOWS",
      "name": "Vidros elétricos",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_RAIN_SENSOR",
      "name": "Sensor de chuva",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_REAR_FOLDING_SEAT",
      "name": "Banco traseiro retrátil",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_SLIDING_ROOF",
      "name": "Teto solar",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "DISTANCE_BETWEEN_AXES",
      "name": "Distância entre eixos",
      "value_id": null,
      "value_name": "2570 mm",
      "value_struct": {
        "number": 2570,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "FUEL_CAPACITY",
      "name": "Tanque de combustível",
      "value_id": null,
      "value_name": "54 L",
      "value_struct": {
        "number": 54,
        "unit": "L"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "GEAR_NUMBER",
      "name": "Número de velocidades",
      "value_id": null,
      "value_name": "6",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "HEIGHT",
      "name": "Altura",
      "value_id": null,
      "value_name": "1625 mm",
      "value_struct": {
        "number": 1625,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "LENGTH",
      "name": "Comprimento",
      "value_id": null,
      "value_name": "4140 mm",
      "value_struct": {
        "number": 4140,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "LICENSE_PLATE",
      "name": "Placa",
      "value_id": null,
      "value_name": "EWP5306",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "PASSENGER_CAPACITY",
      "name": "Quantidade de pessoas",
      "value_id": null,
      "value_name": "8",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "VALVES_PER_CYLINDER",
      "name": "Válvulas por cilindro",
      "value_id": null,
      "value_name": "4",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "WIDTH",
      "name": "Largura",
      "value_id": null,
      "value_name": "1800 mm",
      "value_struct": {
        "number": 1800,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "HAS_WINDSCREEN_WIPER",
      "name": "Limpador traseiro",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "BRAND",
      "name": "Marca",
      "value_id": "374002",
      "value_name": "Kia",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "DOORS",
      "name": "Portas",
      "value_id": null,
      "value_name": "4",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "FUEL_TYPE",
      "name": "Tipo de combustível",
      "value_id": "372589",
      "value_name": "Gasolina",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "KILOMETERS",
      "name": "Quilômetros",
      "value_id": null,
      "value_name": "92000 km",
      "value_struct": {
        "number": 92000,
        "unit": "km"
      },
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MODEL",
      "name": "Modelo",
      "value_id": "235012",
      "value_name": "Soul",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "TRIM",
      "name": "Versão",
      "value_id": null,
      "value_name": "XRS",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "VEHICLE_TYPE",
      "name": "Tipo de veículo",
      "value_id": "398351",
      "value_name": "Carros e caminhonetes",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "VEHICLE_YEAR",
      "name": "Ano",
      "value_id": null,
      "value_name": "2012",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "COLOR",
      "name": "Cor",
      "value_id": "52049",
      "value_name": "Preto",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "ARMORED",
      "name": "Blindado",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_ABS_BRAKES",
      "name": "Freios ABS",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_ALARM",
      "name": "Alarme",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_ALLOY_WHEELS",
      "name": "Rodas de liga leve",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_CURTAIN_AIRBAG",
      "name": "Airbag de cortina",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_FOG_LIGHT",
      "name": "Farol de neblina",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_PASSENGER_AIRBAG",
      "name": "Airbag passageiro",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_REAR_FOGLIGHTS",
      "name": "Faróis de neblina traseiros",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "TRACTION_CONTROL",
      "name": "Controle de tração",
      "value_id": "493979",
      "value_name": "Dianteira",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_AMFM_RADIO",
      "name": "AM/FM",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_AUXILIARY_PORT",
      "name": "Entrada auxiliar",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_MP3_PLAYER",
      "name": "MP3 player",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_STEERING_WHEEL_CONTROL",
      "name": "Controle de som no volante",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_USB",
      "name": "Entrada USB",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "closed",
  "sub_status": [
  ],
  "tags": [
    "test_item",
    "immediate_payment"
  ],
  "warranty": null,
  "catalog_product_id": null,
  "domain_id": "MLB-CARS_AND_VANS",
  "parent_item_id": null,
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2018-06-07T19:03:12.000Z",
  "last_updated": "2018-07-11T23:01:48.000Z",
  "health": null
}


Atributos

Ten en cuenta lo siguiente:
Cuando creas un artículo, algunos atributos son obligatorios, mientras que otros puedes omitir. En determinadas situaciones y basándose en el catálogo de vehículos de MercadoLibre, la plataforma completará aquellos atributos del ítem que el vendedor haya omitido, con el propósito de proporcionar información adicional al comprador, siempre y cuando el vehículo esté dentro de nuestro catálogo. Si el vendedor introduce un valor diferente al registrado en nuestro catálogo, prevalecerá la información proporcionada por el vendedor.

Además, ten presente que estos atributos definirán cómo se muestra el artículo, cómo pueden comprarlo los compradores y la posición en los resultados de la búsqueda, entre otras variables.

Nota:
Al realizar el POST debes especificar el channel al cual estás publicando, asegurate de enviar marketplace para no obtener error al publicar un ítem clasificado. Además puedes ver el campo en el ejemplo del POST.


Título

Un buen título debe ser conciso, pero debe contener la marca, la versión y la cantidad de puertas del vehículo. Las palabras del título son muy importantes, dado que son estas las que coinciden con las palabras buscadas por los usuarios; por lo tanto, cuanto mayor sea la coincidencia de estas palabras, mayor será la devolución. Aconsejamos a los integradores que ya auto-completen el título para su cliente, a fin de ya sugerir un título mejor para la publicación que se incluirá. Ejemplo: Chevrolet Astra Hatch Advantage 2.0 4P


Placa

Importante:
A partir de octubre de 2024, actualice sus sistemas para incluir la PLACA y los últimos 6 caracteres del CHASSI al registrar o actualizar vehículos en el sitio MLA. Es fundamental utilizar correctamente ambos campos,para asegurar que el vehículo sea verificado y garantizar la precisión de la información en la plataforma.

Las siguientes recomendaciones de formato de placa (LICENSE_PLATE) se aplican a Brasil y Argentina:

  • La placa debe corresponder al vehículo publicado (marca, modelo, año y versión).
  • La placa no debe estar repetida en otra publicación.
  • El número permitido de caracteres es 7 (sin guion) o 8 caracteres (con guion).

Formatos para Brasil:

  • AAAnnnn: formato antiguo, máximo 7 caracteres, letras e números sem separação por guion.
  • AAA-nnnn: formato antigo, máximo 8 caracteres, letras e números separados por guion.
  • AAAnAnn: formato Mercosur.

Formatos para Argentina:

  • AA-nnn-nn: formato atual, 7 caracteres en total, con letras y números separados por guion.

Asegúrese de que la placa sea correcta y esté conforme con los formatos establecidos para garantizar la verificación adecuada del vehículo.


Chasis

El campo "VIN_LAST_DIGITS" es esencial para la verificación del vehículo, junto con la placa. Para garantizar que la información del vehículo sea validada correctamente, es necesario completar este campo con los últimos 6 dígitos del chasis. Aunque esta información permanezca oculta en el anuncio, es crucial para la validación del ítem. La correcta inserción de los últimos dígitos contribuye a la integridad de los datos y a la confianza en el proceso de compra y venta de vehículos en la plataforma. Asegúrese de incluir esta información al publicar un vehículo para garantizar que se realicen todas las verificaciones necesarias.


Descripción

Nota:
Para crear la descripción, antes debes crear la publicación sin descripción y luego enviar la descripción mediante un POST al recurso /items/$ITEM_ID/description.

Conoce cómo agregar la descripción al ítem publicado.


Nota:
La descripción del producto deberá ser en texto sin formato. Tampoco enviar información de contacto, como teléfono, dirección y sitio en este campo. En caso de que se envíe, aceptaremos la publicación, pero será penalizada o moderada y tendrá un mal clasificado en las búsquedas. Para consultar las publicaciones moderadas consulta Gestiona moderaciones.

Conoce cómo consultar una descripción mediante un GET al recurso /items/$ITEM_ID/description.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/description

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLA932485344/description

Respuesta:

{
	"text": "",
	"plain_text": "Texto TEST".
	"date_created": "2021-08-20T22:58:02.000Z",
	"snapshot": {}
}


Imágenes

Las buenas imágenes pueden hacer que un artículo sea más atractivo y ofrecer a los compradores una idea más certera de su aspecto. Básicamente, deberías agregar un conjunto de hasta seis imágenes URL en el JSON.

{
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

Te recomendamos no utilizar servidores lentos para alojar tus imágenes porque pueden generar desventajas al momento de publicar. También puedes agregar o cambiar las imágenes de tu artículo aquí más adelante. Por favor, lee más sobre este tema para conocer qué tipo de imágenes se permiten y cómo trabajar con ellas.


Categoría

Previo a publicar ítems, los vendedores deben definir una categoría en el sitio de Mercado Libre y esta acepta un ID preestablecido. Por ende, te recomendamos utilizar el predictor de categorías para obtener la categoría adecuada y recuerda que marca y modelo son actualmente atributos obligatorios. A continuación, ilustramos el cambio en el flujo de publicación de ítems vehículos:


Nota:
En la imagen derecha puedes ver un ejemplo de los 2 niveles disponibles y los atributos obligatorios marca y modelo.

Para las categorías de Motocicletas y Náutica, que antes tenían un nivel más que las otras para especificar el tipo de vehículo, también pasan a tener 2 niveles y un nuevo atributo para especificar el tipo: moto_type y vehicle_type.


Precio

Este atributo es obligatorio. Al definir un nuevo anuncio, este debe tener un precio. Si ya definiste un precio, pero no estás satisfecho con él, podrás modificarlo posteriormente.


Moneda

Además del precio, deberás definir una moneda. Este atributo también es obligatorio. La moneda deberá ser definida usando una ID predefinida. Ve ejemplos del recurso de la moneda aquí.

Nota:
En Venezuela sólo está permitido publicar en dólares los productos y vehículos disponibles. Para hacer la conversión de la moneda, se toma la cotización del día según el Banco Central de Venezuela.


Listing Type

Básicamente es el plan contratado por su cliente. Se trata de otro caso de un atributo obligatorio que solo admite valores predefinidos y es muy importante. Existen diferentes tipos de publicación disponibles para cada sitio. Debes realizar una llamada mixta a través de los sitios y de los recursos listing_types para saber cuáles son los listing_types admitidos. Sigue nuestra guía para saber qué tipo de publicación es más conveniente para tu anuncio.


Ubicación

Al publicar un anuncio clasificado, es obligatorio enviar su ubicación. La ubicación de Mercado Libre posee 4 niveles: country, state, city y neighborhood. Debes enviar como mínimo, city o neighborhood. Ejemplo:

  location: {
    address_line: "Avenida Jurucê, 436",
    zip_code: "04080011",
    neighborhood: {
      id: "TUxCQklORHduMDB0"
    },
    "city": {
      "id": "TUxCQ1NQLTkxMjE",
    },
    "state": {
    "id": "TUxCUFNBT085N2E4",
    },
    "country": {
    "id": "BR",
    },
  },

Siempre recuerde enviar la id de cada ubicación enviada, según el ejemplo precedente. Para el campo “address_line”, siempre envíe la calle seguida del número (el número de la calle siempre debe ser la última información enviada en este campo. Ejemplo correcto: Avenida Jurucê, 436 Ejemplo incorrecto: Avenida Jurucê, 436 Moema Para saber cómo consultar los códigos de ubicación de Mercado Libre, visita este enlace.


Contactos del vendedor

Son los datos de contacto del vendedor propietario del anuncio. Estos valores son opcionales y si no se los informa, Mercado Libre utilizará los datos de la cuenta del vendedor. Ejemplo:

  seller_contact: {
    contact: "Nome Contato Teste",
    area_code: "11",
    phone: "4444-5555",
    area_code2: "21",
    phone2: "1111-3333",
    email: "contact-email@somedomain.com",
  },
Nota:
Cuando hay preguntas de compradores en los anuncios, Mercado Libre las envía al correo electrónico del vendedor (consignado en el campo seller_contact.email). En caso de que no sea informado, Mercado Libre utilizará el correo electrónico de la cuenta del vendedor en el sitio.
En caso de que el campo este como "seller_contact": "not_allowed" la categoría no permitirá cargar información al respecto.
Los campos country_code2, area_code2, phone2 pueden ser usados para que el vendedor reciba contactos por WhatsApp.


Available_quantity

Siempre debe enviarse “1”. Representa la cantidad de artículos de este anuncio. En Mercado Libre, los anuncios clasificados no funcionan con existencias, cada anuncio representa un registro de inmueble / vehículo / servicio único.


Condition

Puede ser “new” o “used” según la condición del anuncio que se enviará.


Publica un vehículo

Estás listo para publicar tu primer artículo.

Recuerda que necesitarás un access_token para hacerlo. Si tienes preguntas sobre cómo obtener tu access token, por favor regresa al tutorial de autenticación.

También te recomendamos utilizar usuarios de test para publicar artículos de prueba. Si no estás familiarizado con los mismos, por favor consulta la sección generar usuarios de test aquí.

Además, te recomendamos validar el JSON que envías antes de realizar la solicitud POST; por eso, será mejor que consultes este tutorial de validación de artículos, que es fácil y rápido. Puedes crear un JSON para tu artículo en base al ejemplo a continuación o simplemente envíalo así y estarás publicando un vehículo de muestra en el site:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d 
{
  "title": "ANUNCIO TESTE PROVA CARRO - NAO COMPRAR",
  "description": "Veículo em ótimo estado",
  "channels": 
[
"marketplace" 
], 
  "pictures": [
    {
      "source":"https://cdn.pixabay.com/photo/2017/06/15/04/13/car-2404064__340.png"
    },
    {
      "source":"https://cdn.pixabay.com/photo/2018/03/06/19/44/mercedes-benz-3204364__340.png"
    },
  ],
  "video_id": "sJLCxVgshzY"
  "category_id": "MLB76395",
  "price": "100000",
  "currency_id": "BRL",
  "listing_type_id": "silver",
  "available_quantity": "1",

  "location": {
    "address_line": "Avenida Juruce, 436",
    "zip_code": "04080011",
    "city": {
      "id": "BR-SP-56"
    }
  },
  
  
  "attributes": [
    {
      "id": "BRAND",
      "value_name": "Kia"
    },    
    {
      "id": "MODEL",
      "value_name": "Soul"
    },
    {
      "id": "VEHICLE_YEAR",
      "value_name": "2012"
    },
    {
      "id": "DOORS",
      "value_name": "4"
    },
    {
      "id": "KILOMETERS",
      "value_name": "92000km"
    },
    {
      "id": "FUEL_TYPE",
      "value_name": "Gasolina"
    },
    {
      "id": "COLOR",
      "value_name": "Preto"
    },
    {
      "id": "STEERING",
      "value_name": "Elétrica"
    },
    {
      "id": "CONTACT_SCHEDULE",
      "value_name": "Me procurar a tarde"
    },
    {
      "id": "TRANSMISSION",
      "value_name": "Automática"
    },
    {
      "id": "TRACTION_CONTROL",
      "value_name": "Dianteira"
    },
    {
      "id": "ARMORED",
      "value_name": "Sim"
    },
    {
      "id": "HAS_ABS_BRAKES",
      "value_name": "Sim"
    },
    {
      "id": "HAS_AIR_CONDITIONING",
      "value_name": "Sim"
    },
    {
      "id": "HAS_ALARM",
      "value_name": "Sim"
    },
    {
      "id": "HAS_ALLOY_WHEELS",
      "value_name": "Sim"
    },
    {
      "id": "HAS_AMFM_RADIO",
      "value_name": "Sim"
    },
    {
      "id": "HAS_AUXILIARY_PORT",
      "value_name": "Sim"
    },
    {
      "id": "ITEM_CONDITION",
      "value_name": "Novo"
    },
    {
      "id": "LICENSE_PLATE",
      "value_name": "EWP5306"
    },
    {
      "id": "PASSENGER_CAPACITY",
      "value_name": "8"
    },
        {
      "id": "TRIM",
      "value_name": "XRS"
    },
    {
      "id": " SINGLE_OWNER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_WINDSCREEN_WIPER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_USB",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_STEERING_WHEEL_CONTROL",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_POWER_DOOR_LOCKS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_POWER_WINDOWS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_RAIN_SENSOR",
      "value_name": "Sim"
    },
    {
      "id": " HAS_REAR_FOGLIGHTS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
      "value_name": "Sim"
    },
    {
      "id": " HAS_SLIDING_ROOF",
      "value_name": "Sim"
    },
    {
      "id": " HAS_LEATHER_UPHOLSTERY",
      "value_name": "Sim"
    },
    {
      "id": " HAS_LIGHT_ON_REMINDER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_MP3_PLAYER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_ONBOARD_COMPUTER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_PARKING_SENSOR",
      "value_name": "Sim"
    },
    {
      "id": " HAS_PASSENGER_AIRBAG",
      "value_name": "Sim"
    },
    {
      "id": " TRANSMISSION",
      "value_name": "Automática"
    },
    {
      "id": " VEHICLE_BODY_TYPE",
      "value_name": "Minivan"
    },
    {
      "id": " HEIGHT",
      "value_name": "1625 mm"
    },
    {
      "id": " WIDTH",
      "value_name": "1800 mm"
    },
    {
      "id": " DISTANCE_BETWEEN_AXES",
      "value_name": "2570 mm"
    },
    {
      "id": " FUEL_CAPACITY",
      "value_name": "54 L"
    },
    {
      "id": " LENGTH",
      "value_name": "4140 mm"
    }
    ,
    {
      "id": " VALVES_PER_CYLINDER",
      "value_name": "4"
    }
    ,
    {
      "id": " GEAR_NUMBER",
      "value_name": "6"
    }
    ,
    {
      "id": " HAS_CURTAIN_AIRBAG",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_FOG_LIGHT",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_REAR_FOLDING_SEAT",
      "value_name": "Sim"
    },
    {
      "id": " HAS_ELECTRIC_MIRRORS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_AUTOPILOT",
      "value_name": "Sim"
    }
  ]
}
https://api.mercadolibre.com/items
Nota:
Para publicar un ítem con video de Youtube debes usar el campo video_id en la publicación, compuesto por un string, informando el id del recurso multimedia y un identificador del proveedor o la plataforma relacionada. Así, por ejemplo: “video_id”:“gqkEN9poKM;youtube”.

Observe que el ejemplo anterior solo funciona en MLB y MLA. En caso de que estés trabajando en cualquier otro país, deberás sustituir los valores de category_id, currency_id y talvez listing_type_id. Al realizar el POST anterior, la API de Mercado Libre te enviará el JSON de retorno con la información del artículo creado. Uno de los campos retornados es el permalink, que contiene el enlace a la página de detalles del anuncio recién creado. Ejemplo de respuesta

{
    "id": "MLB1045563828",
    "site_id": "MLB",
    "title": "Anuncio Teste Prova Carro - Nao Comprar",
    "subtitle": null,
    "seller_id": 307415664,
    "category_id": "MLB1744",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "currency_id": "BRL",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "RESERVATION_PRICE",
            "name": "Valor de reserva",
            "value_id": null,
            "value_name": "1000 BRL",
            "value_struct": {
                "number": 1000,
                "unit": "BRL"
            }
        }
    ],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2018-06-07T19:03:11.349Z",
    "stop_time": "2018-06-10T04:00:00.000Z",
    "end_time": "2018-06-10T04:00:00.000Z",
    "expiration_time": null,
    "condition": "used",
    "permalink": "http://carro.mercadolivre.com.br/MLB-1045563828-anuncio-teste-prova-carro-nao-comprar-_JM",
    "pictures": [
        {
            "id": "825249-MLB27519106301_062018",
            "url": "http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "secure_url": "https://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        },
        {
            "id": "632976-MLB27519106300_062018",
            "url": "http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "secure_url": "https://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": "sJLCxVgshzY",
    "descriptions": [
        {
            "id": "MLB1045563828-1704138112"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 801390510,
        "comment": "",
        "address_line": "Rua Dantas Bião 43",
        "zip_code": "48030030",
        "city": {
            "id": "TUxCQ0FMQTlkMWUy",
            "name": "Alagoinhas"
        },
        "state": {
            "id": "BR-BA",
            "name": "Bahia"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "latitude": -23.6091318,
        "longitude": -46.6616978,
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "TUxCQ0FMQTlkMWUy",
                "name": "Alagoinhas"
            },
            "state": {
                "id": "TUxCUEJBSEFlYmEx",
                "name": "Bahia"
            }
        }
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "Avenida Jurucë, 436",
        "zip_code": "04080011",
        "neighborhood": {
            "id": "",
            "name": ""
        },
        "city": {
            "id": "BR-SP-56",
            "name": "Atibaia"
        },
        "state": {
            "id": "BR-SP",
            "name": "São Paulo"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "latitude": "",
        "longitude": "",
        "open_hours": ""
    },
    "geolocation": {
        "latitude": "",
        "longitude": ""
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230581",
            "value_name": "Usado",
            "value_struct": null,
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "STEERING",
            "name": "Direção",
            "value_id": "405719",
            "value_name": "Elétrica",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "CONTACT_SCHEDULE",
            "name": "Horário de contato",
            "value_id": null,
            "value_name": "Me procurar a tarde",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "TRANSMISSION",
            "name": "Transmissão",
            "value_id": "370876",
            "value_name": "Automática",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "SINGLE_OWNER",
            "name": "Único dono",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "VEHICLE_BODY_TYPE",
            "name": "Tipo",
            "value_id": "452753",
            "value_name": "Minivan",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "HAS_AIR_CONDITIONING",
            "name": "Ar-condicionado",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_POWER_DOOR_LOCKS",
            "name": "Travas elétricas",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_POWER_WINDOWS",
            "name": "Vidros elétricos",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_RAIN_SENSOR",
            "name": "Sensor de chuva",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
            "name": "Banco motorista com regulagem de altura",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_SLIDING_ROOF",
            "name": "Teto solar",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_LEATHER_UPHOLSTERY",
            "name": "Bancos em couro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_LIGHT_ON_REMINDER",
            "name": "Alarme de luzes acesas",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_ONBOARD_COMPUTER",
            "name": "Computador de bordo",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_PARKING_SENSOR",
            "name": "Sensor de estacionamento",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_REAR_FOLDING_SEAT",
            "name": "Banco traseiro retrátil",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_ELECTRIC_MIRRORS",
            "name": "Retrovisores elétricos",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_AUTOPILOT",
            "name": "Piloto automático",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "LICENSE_PLATE",
            "name": "Placa",
            "value_id": null,
            "value_name": "EWP5306",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PASSENGER_CAPACITY",
            "name": "Quantidade de pessoas",
            "value_id": null,
            "value_name": "8",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "HEIGHT",
            "name": "Altura",
            "value_id": null,
            "value_name": "1625 mm",
            "value_struct": {
                "number": 1625,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WIDTH",
            "name": "Largura",
            "value_id": null,
            "value_name": "1800 mm",
            "value_struct": {
                "number": 1800,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DISTANCE_BETWEEN_AXES",
            "name": "Distância entre eixos",
            "value_id": null,
            "value_name": "2570 mm",
            "value_struct": {
                "number": 2570,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "FUEL_CAPACITY",
            "name": "Tanque de combustível",
            "value_id": null,
            "value_name": "54 L",
            "value_struct": {
                "number": 54,
                "unit": "L"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "LENGTH",
            "name": "Comprimento",
            "value_id": null,
            "value_name": "4140 mm",
            "value_struct": {
                "number": 4140,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "VALVES_PER_CYLINDER",
            "name": "Válvulas por cilindro",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "GEAR_NUMBER",
            "name": "Número de velocidades",
            "value_id": null,
            "value_name": "6",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "HAS_WINDSCREEN_WIPER",
            "name": "Limpador traseiro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "VEHICLE_YEAR",
            "name": "Ano",
            "value_id": null,
            "value_name": "2012",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "DOORS",
            "name": "Portas",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "KILOMETERS",
            "name": "Quilômetros",
            "value_id": null,
            "value_name": "92000 km",
            "value_struct": {
                "number": 92000,
                "unit": "km"
            },
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FUEL_TYPE",
            "name": "Tipo de combustível",
            "value_id": "372589",
            "value_name": "Gasolina",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TRIM",
            "name": "Versão",
            "value_id": null,
            "value_name": "XRS",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "374002",
            "value_name": "Kia",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": "235012",
            "value_name": "Soul",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "VEHICLE_TYPE",
            "name": "Tipo de veículo",
            "value_id": "398351",
            "value_name": "Carros e caminhonetes",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COLOR",
            "name": "Cor",
            "value_id": "52049",
            "value_name": "Preto",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "TRACTION_CONTROL",
            "name": "Controle de tração",
            "value_id": "493979",
            "value_name": "Dianteira",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "ARMORED",
            "name": "Blindado",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_ABS_BRAKES",
            "name": "Freios ABS",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_ALARM",
            "name": "Alarme",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_ALLOY_WHEELS",
            "name": "Rodas de liga leve",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_REAR_FOGLIGHTS",
            "name": "Faróis de neblina traseiros",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_PASSENGER_AIRBAG",
            "name": "Airbag passageiro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_CURTAIN_AIRBAG",
            "name": "Airbag de cortina",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_FOG_LIGHT",
            "name": "Farol de neblina",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_AMFM_RADIO",
            "name": "AM/FM",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_AUXILIARY_PORT",
            "name": "Entrada auxiliar",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_USB",
            "name": "Entrada USB",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_STEERING_WHEEL_CONTROL",
            "name": "Controle de som no volante",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_MP3_PLAYER",
            "name": "MP3 player",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://www.mercadolibre.com/jm/img?s=STC&v=I&f=proccesing_image_pt.jpg",
    "secure_thumbnail": "https://www.mercadolibre.com/jm/img?s=STC&v=I&f=proccesing_image_pt.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item",
        "immediate_payment"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": "MLB-CARS_AND_VANS",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2018-06-07T19:03:12.010Z",
    "last_updated": "2018-06-07T19:03:12.010Z",
    "health": null
}


Anuncios duplicados

Cada publicación debe incluirse solo una vez. Mercado Libre posee mecanismos para identificar posibles anuncios duplicados, por eso es importante. No enviar publicaciones duplicadas. En caso de que se considere que una publicación fue duplicada, esta se incluirá vía API, pero quedará con el estado “under review”.


Ítems penalizados

Son los ítems penalizados necesitan de la atención del vendedor para que vuelvan a tener una buena exposición o, en casos graves, no sean pausados. Para identificar estos ítems para los dominios de Vehículos e Inmuebles, disponibilizamos 2 tags con los siguientes motivos de penalización:

  • misplaced_personal_data: ítem penalizado por datos personales en campos no indicados.
  • moderation_penalty : Ítem penalizado. En este caso, por ser un tag genérico, es necesario hacer una consulta al recurso /infractions para conocer el motivo.

Para listar los ítems en esta condición, es posible utilizar el GET:

Llamada:

curl --location --request GET 'https://api.mercadolibre.com/users/$USER_ID/items/search?tags=$TAG' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl --location --request GET 'https://api.mercadolibre.com/users/705332753/items/search?tags=misplaced_personal_data' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Respuesta:

{

   "seller_id": "705332753",
   "query": null,
   "paging": {
       "limit": 50,
       "offset": 0,
       "total": 1
   },
   "results": [
       "MLB1790900231"
   ],
   "orders": [
       {
           "id": "stop_time_asc",
           "name": "Order by stop time ascending"
       }
   ],
   "available_orders": [
       {
           "id": "stop_time_asc",
           "name": "Order by stop time ascending"
       },
       {
           "id": "stop_time_desc",
           "name": "Order by stop time descending"
       },
       {
           "id": "start_time_asc",
           "name": "Order by start time ascending"
       },
       {
           "id": "start_time_desc",
           "name": "Order by start time descending"
       },
       {
           "id": "available_quantity_asc",
           "name": "Order by available quantity ascending"
       },
       {
           "id": "available_quantity_desc",
           "name": "Order by available quantity descending"
       },
       {
           "id": "sold_quantity_asc",
           "name": "Order by sold quantity ascending"
       },
       {
           "id": "sold_quantity_desc",
           "name": "Order by sold quantity descending"
       },
       {
           "id": "price_asc",
           "name": "Order by price ascending"
       },
       {
           "id": "price_desc",
           "name": "Order by price descending"
       },
       {
           "id": "last_updated_desc",
           "name": "Order by lastUpdated descending"
       },
       {
           "id": "last_updated_asc",
           "name": "Order by last updated ascending"
       },
       {
           "id": "total_sold_quantity_asc",
           "name": "Order by total sold quantity ascending"
       },
       {
           "id": {
               "id": "total_sold_quantity_desc",
               "field": "sold_quantity",
               "missing": "_last",
               "order": "desc"
           },
           "name": "Order by total sold quantity descending"
       },
       {
 
          "id": {
               "id": "inventory_id_asc",
               "field": "inventory_id",
               "missing": "_last",
               "order": "asc"
           },
           "name": "Order by inventory id ascending"
       }
   ]
}
}


Marca, modelo y versión

Marca y modelo son atributos obligatorios (obtén más información sobre las categorías y atributos) pero la versión es un atributo denominado “TRIM”. Este atributo también es obligatorio y debe enviarse junto con los otros atributos en la matriz “attributes”. Este es un campo de texto abierto y el integrador debe enviar la versión como tipo texto. En el ejemplo anterior, TRIM = XRS.


Tiendas Oficiales para Vehículos e Inmuebles

Consulta la siguiente guía sobre Tiendas Oficiales para Vehículos e Inmuebles.


Publicar en la categoría Motos transaccionales

Nota:
En los sites México, Argentina, Colombia, Brasil y Uruguay publicar motos transaccionales estará permitido sólo para vendedores autorizados.

Los category_id de Motos transaccionales son: MLM455863, MLA455863, MCO455863, MLB455863 y MLU455863 respectivamente según el site. En caso de que el vendedor no esté autorizado, recibirás el error: moderations.seller_id.not_authorized - Seller is not authorized for this brand and category. En caso que el cliente no esté autorizado, debe contactarse con el ejecutivo comercial de Mercado Libre que le fue asignado.



Configurar paquete para usuario de prueba

Para añadir un paquete para publicaciones de prueba, cargue los datos de su usuario de test en el formulario.


Siguiente: Sincroniza publicaciones.