Gestiona reservas

Una orden es una solicitud que realiza un cliente con intención de reservar un automóvil y puede terminar en una venta según el acuerdo con el vendedor.
Estas condiciones se detallan en la orden, que también se replicará para las cuentas del comprador y del vendedor. En la orden encontrarás gran cantidad de información para completar sobre el producto como así también la posibilidad de reservar y/o descontar stock.
Nota: esta funcionalidad sólo está disponible en Argentina y Brasil en fase inicial es decir, la reserva es notificada al vendedor vía e-mail por tiempo limitada.

Contenidos:

Beneficios

  • Mejora posicionamiento: Por cada reserva exitosa, las reservas estarán mejor posicionadas en el listado.
  • El vendedor contará con reputación: Si brinda una buena experiencia se diferenciará de los competidores.
  • No tiene costos adicionales.

Para conocer en detalle cómo funciona esta nueva funcionalidad en los vendedores te invitamos a hacer clic acá.

Recibe una orden

Una vez que se crea una nueva orden en el usuario, se puede consultar los detalles al realizar una solicitud al recurso de órdenes:

Ejemplo

curl https://api.mercadolibre.com/orders/$ORDER_ID?access_token=$ACCESS_TOKEN

Respuesta

{ 
 "id": 768570754, 
 "status": "paid", 
 "status_detail": null, 
 "date_created": "2013-05-27T10:01:50.000-04:00", 
 "date_closed": "2013-05-27T10:04:07.000-04:00", 
 "order_items": - [ 
- { 
       "item": - { 
 "id": "MLB12345678", 
 "title": "Nissan March MARCH 1.0 S 12V FLEX 4P MANUAL", 
"category_id": "MLB1234", 
 "variation_id": null, 
 "variation_attributes": [], 
 }, 
 "quantity": 1, 
 "unit_price": 499, 
"full_unit_price": 25000, 
 "currency_id": "BRL", 
} 
 ], 
 "total_amount": 499, 
 "currency_id": "BRL", 
 "buyer": - { 
"id": "123456789", 
"nickname": "COMPRADORTESTE", 
"email": "b@b.com", 
"phone": - { 
 "area_code": "11", 
 "number": "12345678", 
 "extension": null, 
}, 
"first_name": "Comprador de testes", 
"last_name": "da Silva", 
"billing_info": - { 
 "doc_type": "CPF", 
 "doc_number": "12345678910", 
}, 
 }, 
 "seller": - { 
"id": "123456789", 
"nickname": "VENDEDORTESTES", 
"email": "a@a.com", 
"phone": - { 
 "area_code": null, 
 "number": "11 12345678", 
 "extension": "11", 
}, 
"first_name": "Vendedor de Testes", 
"last_name": "testes de documentacao", 
 }, 
 "payments": - [ 
- { 
 "id": "596707837", 
 "transaction_amount": 499, 
 "currency_id": "BRL", 
 "status": "approved", 
 "date_created": null, 
 "date_last_modified": null, 
}, 
 ], 
 "feedback": - { 
"purchase": null, 
"sale": null, 
 }, 
 "shipping": - { 
"status": "to_be_agreed" 
 }, 
 "tags": - [ 
"reservation", 
"paid", 
"not_delivered"], 
}

Existen gran cantidad de atributos conforme a una orden. A continuación veremos una descripción de los campos más importantes.
id Identificador único de la orden.
date_created Fecha de creación de la orden
date_closed Fecha de confirmación de la orden. Se define cuando una orden cambia por primera vez al estado: confirmed / paid y se descuenta el stock del ítem.
expiration_date Fecha límite que tiene el usuario para calificar porque, luego de la misma, se vuelve visible el feedback, se emiten los pagos (si hubiese) y se crean los cargos.
status Estado de la orden.
status_detail Detalle del estado, en caso de cancelación de la orden.
code Código del estado.
description Descripción del estado.
comprador Información del comprador.
vendedor Información del vendedor.
order_items Publicaciones en la orden.
unit_price Precio de la reserva.
full_unit_price Precio total del item.
payments Pagos relacionados con la orden.
feedback Información de feedback relacionada con la orden.
total_amount Monto total de la orden.
currency_id ID de moneda.
tags Lista de los tags seleccionados por el vendedor, tales como entregado, pagado, además del tag “reservation” que marca la orden como reserva.

Nota: Del mismo modo que ocurre cada vez que se actualiza la información de una orden, en caso que se descubra que la compra fue fraudulenta, la marcaremos con el tag “fraud_risk_detected” y enviaremos una notificación con el topic “orders” y el ID de dicha orden.

Búsqueda de órdenes

El recurso de búsqueda de órdenes te ayudará a buscar cada orden que pertenece a usuarios para quienes tienen un token válido.

https://api.mercadolibre.com/orders/search?buyer=buyer_id&access_token={...}

Dentro del seach a orders están disponibles los campos “available_filters” y “available_sorts”.
Ten en cuenta que el search no muestra aquellas órdenes en estado Payment_required.

¿Cómo filtrar?

Para filtrar tus órdenes con status “paid” encontrarás entre los “available_filters” disponibles el ID “order.status” y dentro de éste el value con ID “paid”.

https://api.mercadolibre.com/orders/search?seller=seller_id&order.status=paid&access_token={...} 

En el caso de querer filtrar tus órdenes por fecha deberás hacerlo de la siguiente
manera:

https://api.mercadolibre.com/orders/search?seller=&order.date_created.from=2015-07-01T00:00:00.000-00:00&order.date_created.to=2015-07-31T00:00:00.000-00:00&access_token= 

Nota: ten en cuenta que para filtrar por fecha sólo se utiliza hasta la hora. Se descarta la información de los minutos, segundos y milisegundos.

¿Cómo ordenar?

En este caso deberás agregar “sort” con el ID disponible del orden que quieras aplicar, por ejemplo: “date_desc”

https://api.mercadolibre.com/orders/search?seller={seller_id}&order.status=paid&sort=date_desc&access_token={...}

Nota: Por defecto ya viene con una orden date_asc aplicada. La fecha por la que se ordena es:

  • Sellers por date_closed.
  • Buyers por date_created.

Órdenes Recientes

Las órdenes recientes son las más nuevas generadas para un usuario. La respuesta incluirá órdenes en los que la fecha actual es anterior a la expiration_date y aún no has marcado como entregado el vehículo.

Búsqueda de las órdenes recientes de un vendedor:

https://api.mercadolibre.com/orders/search/recent?seller=seller_id&access_token={...} 

Búsqueda de las órdenes recientes de un comprador:

https://api.mercadolibre.com/orders/search/recent?buyer=buyer_id&access_token={...} 

Órdenes Archivadas

Si buscas una orden con expiration_date posterior a la fecha actual o que fue calificada por ambas partes, puedes utilizar el recurso de búsqueda en órdenes archivadas:

Búsqueda de las órdenes archivadas de un vendedor:

https://api.mercadolibre.com/orders/search/archived?seller=seller_id&access_token={..
.} 

Búsqueda de las órdenes archivadas de un comprador:

https://api.mercadolibre.com/orders/search/archived?buyer=buyer_id&access_token={...} 

Órdenes Pendientes

Esta búsqueda recuperará todas las órdenes en estado “pendiente” y omitirá las canceladas automáticamente.
Si deseas ver las órdenes de un vendedor, envía el seller_id:

https://api.mercadolibre.com/orders/search/pending?seller=seller_id&access_token={...} 

Para buscar por comprador, reemplaza los parámetros como se indica a continuación:

https://api.mercadolibre.com/orders/search/pending?buyer=user_id&access_token={...} 

Estado de la orden

Los estados de la orden son los siguientes:

payment_required
Es necesario que se confirme el pago de la orden necesita para mostrar la información
del usuario.
payment_in_process
Existe un pago relacionado con la orden, pero aún no se acreditó.
partially_paid
La orden tiene un pago asociado acreditado, pero no es suficiente.
paid
La orden tiene un pago asociado acreditado.
cancelled
Por alguna razón, la orden no se completó.*
*Notas: Una orden puede ser cancelada por los siguiente motivos:

  • Se requería el pago, pero después de cierto tiempo no se abonó, por eso se cancela automáticamente.
  • Luego de efectuarse una transacción, por alguna razón el vendedor queda prohibido en el site.
  • En caso que el vendedor devuelva la reserva, la orden pasará a “status = cancelled” y status_detail.code = feedback. En caso de existir un pago aprobado
    este se devolverá automáticamente.
  • Si el vendedor confirma que entregó el vehículo y el comprador dice que no lo tiene, la orden toma el “status = cancelled” y status_detail.code = buyer. En caso de existir un pago aprobado este se devolverá automáticamente.
  • Otra opción se debe a que la orden expira por lo tanto, también se tomará como “status = cancelled” y status_detail.code = expired_order. En caso de existir un pago aprobado este se devolverá automáticamente.

Flujo de Mercado Pago obligatorio (sólo para países con MP)

¿Cómo saber si un site tiene Mercado Pago activo?

Para obtener esa información deberás realizar la siguiente llamada:

curl https://api.mercadolibre.com/sites/MLA

Si obtienes “MLAMP” como respuesta dentro de los “payment_method_ids” podrás trabajar sin problemas con este flujo.
Aclaración: MLAMP es el ID del método de pago Mercado Pago:

url https://api.mercadolibre.com/payment_methods/MLAMP

Dentro de nuestra plataforma encontrarás orders que pueden entrar por el flujo obligatorio de Mercado Pago como único medio de pago y otras que no.

Los escenarios que se presentan a continuación son en los que podrás encontrar esta opción de manera obligatoria:

  • Todas las órdenes de MLB.
  • Todas las órdenes de MLA y MLM por venta de productos con “condition”: “new”.
  • Publicaciones de Tiendas Oficiales en todos los países con Mercado Pago.
  • Categorías con Mercado Pago como única opción.
  • Usuario marcado automáticamente para que sus operaciones vayan por este flujo, con la marca “immediate_payment” en la API de users.
  • Vendedor “auto” marcado para que sus ventas vayan por este flujo.

Ahora explicamos cómo es el funcionamiento general de las órdenes ya sea que ingresen por este flujo o no:
1) Las órdenes que entran por este flujo se crean en estado “payment_required”.
En ese momento tienen las siguientes características:

  • No son visibles para el seller.
  • No se descuenta el stock de item.
  • No tienen establecido el campo date_closed.
  • No tienen datos de la contraparte.
  • Se envía sólo la notificación del topic “created_orders”.

2) Cuando el pago se acredita por el monto de la reserva, que es distinto del monto total
del item, la orden pasa del estado “payment_required” a “paid”. En ese momento:

  • Se hacen visibles para el seller.
  • Se establece el campo date_closed.
  • Se agregan los datos de la contraparte.
  • Comienzan a enviarse además las notificaciones del topic “orders”.

¿Cómo tu app toma conocimiento de una compra?

La creación de una orden es un evento que se produce del lado de Mercado Libre, por eso deberás suscribirte a nuestro feed de orders para tomar conocimiento en tiempo real cuando ese evento ocurre.
Dirígete a nuestro Administrador de Aplicaciones y edita las Configuraciones de Notificaciones de tu aplicación. Para más información sobre crear y configurar una
nueva aplicación, por favor consulta este link.

Debes seleccionar un Callback URL: configura el URL público del dominio donde deseas recibir todas las notificaciones de Mercado Libre. Por ejemplo:
https://backend.soleorigami.com/notification”.
Nota: Si quieres tomar la orden de la reserva selecciona la opción “orders_v2”.

Esta configuración te permite interactuar con las notificaciones de Mercado Libre. Todos los eventos (como pagos y envío) relacionados con un orden serán notificados a tu callback URL.

Recibir una Notificación

Mercado Libre te enviará notificaciones a través de un mensaje POST con información en el cuerpo de publicación. El atributo más importante del mensaje es el user_id, que está relacionado con la notificación, y el segundo en importancia es el recurso. El recurso es el elemento que fue actualizado o creado.

{ 
 "user_id": 1234, 
 "resource": "/orders/731867397", 
 "topic": "orders", 
 "received": "2011-10-19T16:38:34.425Z", 
 "application_id" : 14529 
 "sent" : "2011-10-19T16:40:34.425Z", 
 "attempts" : 0 
}

Después de recibir la notificación, debes enviar un acuse de recibo [acknowledgment] (ACK 200) a Mercado Libre para dejar de recibirla.

Pagos

Mercado Pago es la plataforma de pagos de Mercado Libre. Si deseas integrar una solución de pagos en tu plataforma, debes consultar el sitio de desarrolladores de Mercado Pago.

Escenario de pagos múltiples

En algunos casos, cuando se rechaza el pago por llegar al límite de la tarjeta de crédito, permitimos a los usuarios agregar otro pago con una segunda tarjeta de crédito.

¿Cómo puedo saber si existen dos pagos?

Cuando realizas una solicitud GET a la API de órdenes, verás que dentro del conjunto de pagos habrá dos ID con los detalles de cada pago.
Ejemplo

curl -X GET https://api.mercadolibre.com/orders/893431118?access_token=&ACCESS_TOKEN 

Respuesta

{ 
"buyer": { 
 "alternative_phone": { 
 "area_code": null, 
 "extension": null, 
 "number": "" 
 }, 
 "billing_info": { 
 "doc_number": "67045427794", 
 "doc_type": "CPF" 
 }, 
 "email": "test_user_21963158@testuser.com", 
 "first_name": "Test", 
 "id": 160903317, 
 "last_name": "Test", 
 "nickname": "TETE2022123", 
 "phone": { 
 "area_code": "01", 
 "extension": null, 
 "number": "1111-1111" 
 } 
}, 
"coupon": { 
 "amount": 0, 
 "id": null 
   }, 
"currency_id": "BRL", 
"date_closed": null, 
"date_created": "2014-10-26T22:46:18.000-04:00", 
"feedback": { 
 "purchase": null, 
 "sale": null 
}, 
"id": 893431118, 
"last_updated": "2014-10-26T22:50:10.000-04:00", 
   "mediations": [], 
"order_items": [ 
 { 
 "currency_id": "BRL", 
 "item": { 
 "id": "MLB600034093", 
 "title": "Item De Testeo, Por Favor No Ofertar --kc:off", 
"category_id": "MLB1234", 
 "variation_attributes": [], 
 "variation_id": null 
 }, 
 "quantity": 1, 
 "unit_price": 591, 
"full_unit_price": 25000, 
 } 
], 
"paid_amount": 591, 
"payments": [ 
 { 
 "activation_uri": null, 
 "atm_transfer_reference": { 
 "company_id": null, 
               "transaction_id": null 
 }, 
           "available_actions": [], 
 "card_id": null, 
 "collector": { 
 "id": 169648308 
 }, 
 "coupon_amount": 0, 
 "coupon_id": null, 
 "currency_id": "BRL", 
 "date_created": "2014-10-26T22:48:46.000-04:00", 
           "date_last_modified": "2014-10-27T00:51:53.000-04:00", 
 "id": 885920310, 
 "installments": 1, 
 "issuer_id": "25", 
 "operation_type": "regular_payment", 
 "order_id": 893431118, 
 "overpaid_amount": 0, 
 "payer_id": 160903317, 
           "payment_method_id": "visa", 
 "payment_type": "credit_card", 
 "reason": "Item De Testeo, Por Favor No Ofertar --kc:off", 
 "shipping_cost": 0, 
 "site_id": "MLB", 
 "status": "approved", 
 "status_code": null, 
 "status_detail": "accredited", 
           "total_paid_amount": 296, 
           "transaction_amount": 296 
 }, 
 { 
 "activation_uri": null, 
           "atm_transfer_reference": { 
 "company_id": null, 
               "transaction_id": null 
 }, 
           "available_actions": [], 
 "card_id": null, 
 "collector": { 
 "id": 169648308 
 }, 
 "coupon_amount": 0, 
 "coupon_id": null, 
 "currency_id": "BRL", 
       "date_created": "2014-10-26T22:50:10.000-04:00", 
           "date_last_modified": "2014-10-26T22:50:21.000-04:00", 
 "id": 885920410, 
 "installments": 3, 
 "issuer_id": "25", 
 "operation_type": "regular_payment", 
 "order_id": 893431118, 
 "overpaid_amount": 0, 
 "payer_id": 160903317, 
           "payment_method_id": "visa", 
 "payment_type": "credit_card", 
 "reason": "Item De Testeo, Por Favor No Ofertar --kc:off", 
 "shipping_cost": 0, 
 "site_id": "MLB", 
 "status": "approved", 
 "status_code": null, 
 "status_detail": "accredited", 
           "total_paid_amount": 315.62, 
           "transaction_amount": 295 
 } 
], 
"seller": { 
 "alternative_phone": { 
 "area_code": null, 
 "extension": null, 
 "number": "" 
 }, 
 "email": "test_user_70385259@testuser.com", 
 "first_name": "Test", 
   "id": 169648308, 
 "last_name": "Test", 
 "nickname": "TETE6072468", 
 "phone": { 
 "area_code": "01", 
 "extension": null, 
 "number": "1111-1111" 
 } 
}, 
"shipping": { 
 "status": "to_be_agreed" 
}, 
"status": "paid", 
"status_detail": null, 
"tags": [ 
 "not_delivered", 
 "paid" 
], 
"total_amount": 591, 
   "total_amount_with_shipping": 591 
} 

¿Cómo obtener información de un pago?

Para obtener información del pago de un comprador utilizando el token deberás recurrir al recurso “payments”.
Ejemplo

https://api.mercadolibre.com/payments?access_token= 

¿Cómo obtener información del pago siendo vendedor?

Para obtener información del pago desde el rol del vendedor, el recurso que deberás acudir con el payment_id es “collections”.
Ejemplo

https://api.mercadolibre.com/collections/{collection_id}?access_token= 

Notas de órdenes

Una nota es una anotación que los vendedores pueden agregar a las órdenes. Las notas pueden tener hasta 300 caracteres cada una y, una vez que publicas una nota,
puedes modificarla o eliminarla.

¿Cómo agregar una nota a una orden?

curl -X POST -H "Content-Type: application/json" -d '{  
 "note": "test", 
}' 
https://api.mercadolibre.com/orders/{order_Id}/notes?access_token=$ACCESS_TOKEN 

Visualiza notas de órdenes

curl -X GET https://api.mercadolibre.com/orders/{order_Id}/notes?access_token=$ACCESS_TOKEN

Cómo modificar una nota

curl -X PUT -H "Content-Type: application/json" -d '{ 
 "note": "test2", 
}' 
https://api.mercadolibre.com/orders/{order_Id}/notes/{note_Id}?access_token=$ACCESS_TOKEN 

Elimina notas

curl -X DELETE https://api.mercadolibre.com/orders/{order_Id}/notes/{note_Id}?access_token=$ACCESS_TOKEN 

Bloquea ofertas

Aunque contamos con una prestación y flujos de prevención de fraude para mantener la seguridad de los compradores y vendedores, en algunas ocasiones puedes encontrar usuarios que, por algún motivo ofertan en las publicaciones. Estos casos pueden ser enviados a la lista negra para evitarles la posibilidad de ofertar.

¿Cómo bloqueo ofertas de un usuario específico?

Realiza una solicitud POST con el cust_id del usuario que deseas bloquear en el JSON y el tuyo en el url, como muestra el siguiente ejemplo:

curl -X POST -H "Content-Type: application/json" -d { user_id: {cust_id} } https://api.mercadolibre.com/users/{cust_Id}/order_blacklist?access_token=$ACCESS_TOKEN 

Consulta tu lista negra

Si deseas saber cuáles son los usuarios de tu lista negra, realiza una solicitud GET a la API con tu cust_id en el url:

curl -X GET https://api.mercadolibre.com/users/{cust_id}/order_blacklist?access_token=$ACCESS_TOKEN 

Elimina a un usuario de tu lista negra

Si ya no deseas bloquear a un usuario para que realice ofertas, puedes eliminarlo de tu lista negra al realizar una solicitud DELETE a la API con tu cust_id y el cust_id del usuario.

curl -X DELETE https://api.mercadolibre.com/users/{your_cust_id}/order_blacklist/{cust_id} 

Please rate this

Publica Vehículos

Ahora que ya analizamos autenticación, usuarios y categorías, creemos que estás listo para realizar tu primera publicación. Sigue este tutorial para aprender cómo hacerlo.

Contenidos:

Puntos básicos

En la API de MercadoLibre, 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 que 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.

Resultados de publicaciones

Cada artículo que publicas aparecerá en los resultados de publicaciones de la búsqueda de un producto determinado. Por ejemplo, cuando un usuario busca la consulta “camioneta”, obtendrá como resultado una lista de todos los artículos relacionados. Tu artículo puede estar en esa lista.
Cuando alguien hace clic en un artículo, se muestra la página Detalles del artículo con toda la información sobre el artículo que fue ingresada al momento de la publicación.

Página Detalles del vehículo

Cuando un usuario selecciona un artículo del resultado, esta página muestra los siguientes detalles del artículo:

  • Item_id
  • Título
  • Ciudad
  • Imágenes
  • Precio
  • Información de contacto
  • Formulario de contacto
  • Atributos
  • Descripción detallada
  • Campos del artículo

    Veamos un artículo común en detalle. Esto es fácil, porque 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. Ahora puedes llamar al recurso Artículos para obtener toda la información relacionada:

    Llamada:

    curl - X GET https://api.mercadolibre.com/items/{Item_id}

    Ejemplo:

    curl  -X GET https://api.mercadolibre.com/items/MLA599268216

    Respuesta:

    {
      "id": "MLA599268216",
      "site_id": "MLA",
      "title": "Peugeot 208 - $38.000",
      "subtitle": null,
      "seller_id": 153559604,
      "category_id": "MLA119052",
      "official_store_id": null,
      "price": 38000,
      "base_price": 38000,
      "original_price": null,
      "currency_id": "ARS",
      "initial_quantity": 1,
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "classified",
      "listing_type_id": "gold",
      "start_time": "2016-01-08T16:55:56.000Z",
      "stop_time": "2016-03-01T18:56:53.000Z",
      "condition": "not_specified",
      "permalink": "http://auto.mercadolibre.com.ar/MLA-599268216-peugeot-208-38000-sin-sorteo-ni-licitacion-_JM",
      "thumbnail": "http://mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-I.jpg",
      "secure_thumbnail": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-I.jpg",
      "pictures": [
        {
          "id": "22262-MLA20226682909_012015",
          "url": "http://mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-O.jpg",
          "size": "500x351",
          "max_size": "1000x703",
          "quality": ""
        },
        {
          "id": "22238-MLA20226683506_012015",
          "url": "http://mla-s1-p.mlstatic.com/22238-MLA20226683506_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22238-MLA20226683506_012015-O.jpg",
          "size": "500x353",
          "max_size": "1000x707",
          "quality": ""
        },
        {
          "id": "22224-MLA20226683429_012015",
          "url": "http://mla-s1-p.mlstatic.com/22224-MLA20226683429_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22224-MLA20226683429_012015-O.jpg",
          "size": "500x321",
          "max_size": "1000x643",
          "quality": ""
        },
        {
          "id": "22285-MLA20226683480_012015",
          "url": "http://mla-s2-p.mlstatic.com/22285-MLA20226683480_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22285-MLA20226683480_012015-O.jpg",
          "size": "500x318",
          "max_size": "1000x636",
          "quality": ""
        },
        {
          "id": "22222-MLA20226684012_012015",
          "url": "http://mla-s2-p.mlstatic.com/22222-MLA20226684012_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22222-MLA20226684012_012015-O.jpg",
          "size": "500x353",
          "max_size": "1000x707",
          "quality": ""
        },
        {
          "id": "22251-MLA20226682930_012015",
          "url": "http://mla-s1-p.mlstatic.com/22251-MLA20226682930_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22251-MLA20226682930_012015-O.jpg",
          "size": "500x316",
          "max_size": "1000x633",
          "quality": ""
        },
        {
          "id": "22283-MLA20226708119_012015",
          "url": "http://mla-s1-p.mlstatic.com/22283-MLA20226708119_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22283-MLA20226708119_012015-O.jpg",
          "size": "500x280",
          "max_size": "703x394",
          "quality": ""
        },
        {
          "id": "22217-MLA20226708129_012015",
          "url": "http://mla-s2-p.mlstatic.com/22217-MLA20226708129_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22217-MLA20226708129_012015-O.jpg",
          "size": "500x272",
          "max_size": "726x396",
          "quality": ""
        },
        {
          "id": "22216-MLA20226707252_012015",
          "url": "http://mla-s2-p.mlstatic.com/22216-MLA20226707252_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22216-MLA20226707252_012015-O.jpg",
          "size": "500x300",
          "max_size": "703x422",
          "quality": ""
        },
        {
          "id": "22212-MLA20226708164_012015",
          "url": "http://mla-s1-p.mlstatic.com/22212-MLA20226708164_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22212-MLA20226708164_012015-O.jpg",
          "size": "500x243",
          "max_size": "900x439",
          "quality": ""
        },
        {
          "id": "22225-MLA20226708173_012015",
          "url": "http://mla-s1-p.mlstatic.com/22225-MLA20226708173_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22225-MLA20226708173_012015-O.jpg",
          "size": "499x244",
          "max_size": "899x440",
          "quality": ""
        },
        {
          "id": "22242-MLA20226708183_012015",
          "url": "http://mla-s2-p.mlstatic.com/22242-MLA20226708183_012015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22242-MLA20226708183_012015-O.jpg",
          "size": "500x251",
          "max_size": "884x444",
          "quality": ""
        }
      ],
      "video_id": null,
      "descriptions": [
        {
          "id": "MLA599268216-1004133312"
        }
      ],
      "accepts_mercadopago": false,
      "non_mercado_pago_payment_methods": [
      ],
      "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [
        ],
        "dimensions": null,
        "tags": [
        ]
      },
      "international_delivery_mode": "none",
      "seller_address": {
        "id": 131655971,
        "comment": "",
        "address_line": "juan b justo 27",
        "zip_code": "1669",
        "city": {
          "id": "TUxBQ1BJTDQ3NDE",
          "name": "Pilar"
        },
        "state": {
          "id": "AR-B",
          "name": "Buenos Aires"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": -34.45636084,
        "longitude": -58.90555502,
        "search_location": {
          "neighborhood": {
            "id": "",
            "name": ""
          },
          "city": {
            "id": "TUxBQ1BJTGFyMTIz",
            "name": "Pilar"
          },
          "state": {
            "id": "TUxBUEdSQWU4ZDkz",
            "name": "Bs.As. G.B.A. Norte"
          }
        }
      },
      "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
      },
      "location": {
        "address_line": "",
        "zip_code": "",
        "neighborhood": {
          "id": "TUxBQkdSQTMyNTla",
          "name": "Grand Bourg"
        },
        "city": {
          "id": "TUxBQ01BTHZpbmFz",
          "name": "Malvinas Argentinas"
        },
        "state": {
          "id": "TUxBUEdSQWU4ZDkz",
          "name": "Bs.as. G.b.a. Norte"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": "",
        "longitude": "",
        "open_hours": ""
      },
      "geolocation": {
        "latitude": "",
        "longitude": ""
      },
      "coverage_areas": [
      ],
      "attributes": [
        {
          "id": "MLA1743-HORPREF",
          "name": "Horario de contacto",
          "value_id": "",
          "value_name": "9 a 19 hs.",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-COLOREXT",
          "name": "Color",
          "value_id": "MLA1744-COLOREXT-OTRO",
          "value_name": "Otro",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-DIREC",
          "name": "Dirección",
          "value_id": "MLA1744-DIREC-ASISTIDA",
          "value_name": "Asistida",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-OWNER",
          "name": "Único dueño",
          "value_id": "MLA1744-OWNER-SI",
          "value_name": "Sí",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-AIRACON",
          "name": "Aire acondicionado",
          "value_id": "MLA1744-AIRACON-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ALARMLUC",
          "name": "Alarma de luces encendidas",
          "value_id": "MLA1744-ALARMLUC-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-APERBAUL",
          "name": "Apertura remota de baúl",
          "value_id": "MLA1744-APERBAUL-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ASIENELEC",
          "name": "Asientos eléctricos",
          "value_id": "MLA1744-ASIENELEC-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ASREBAT",
          "name": "Asiento trasero rebatible",
          "value_id": "MLA1744-ASREBAT-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ASREGULA",
          "name": "Asiento conductor regulable en altura",
          "value_id": "MLA1744-ASREGULA-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-BLQCNTDOOR",
          "name": "Cierre centralizado de puertas",
          "value_id": "MLA1744-BLQCNTDOOR-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-CLIMAUT",
          "name": "Climatizador automático",
          "value_id": "MLA1744-CLIMAUT-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-COMPABO",
          "name": "Computadora de abordo",
          "value_id": "MLA1744-COMPABO-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-CTRLVEL",
          "name": "Control de velocidad de crucero",
          "value_id": "MLA1744-CTRLVEL-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ESPELEC",
          "name": "Espejos eléctricos",
          "value_id": "MLA1744-ESPELEC-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ESTACIONAM",
          "name": "Sensor de estacionamiento",
          "value_id": "MLA1744-ESTACIONAM-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-FAROREG",
          "name": "Faros regulables desde el interior",
          "value_id": "MLA1744-FAROREG-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-GPS",
          "name": "GPS",
          "value_id": "MLA1744-GPS-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-SENSLL",
          "name": "Sensor de lluvia",
          "value_id": "MLA1744-SENSLL-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-SENSLUZ",
          "name": "Sensor de luz",
          "value_id": "MLA1744-SENSLUZ-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-TAPCUERO",
          "name": "Tapizado de cuero",
          "value_id": "MLA1744-TAPCUERO-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-TECHOCORR",
          "name": "Techo corredizo",
          "value_id": "MLA1744-TECHOCORR-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-VIDELEC",
          "name": "Cristales eléctricos",
          "value_id": "MLA1744-VIDELEC-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-LIMPIA_LAV",
          "name": "Limpia/lava luneta",
          "value_id": "MLA1744-LIMPIA/LAV-N",
          "value_name": "No",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-LLANALEAC",
          "name": "Llantas de aleación",
          "value_id": "MLA1744-LLANALEAC-Y",
          "value_name": "Sí",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-PARAGOLPES",
          "name": "Paragolpes pintados",
          "value_id": "MLA1744-PARAGOLPES-N",
          "value_name": "No",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-VIDPOLARIZ",
          "name": "Vidrios polarizados",
          "value_id": "MLA1744-VIDPOLARIZ-Y",
          "value_name": "Sí",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA119052-VERS",
          "name": "Versión",
          "value_id": "",
          "value_name": "208 ACTIVE 1.5 5PTAS",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-COMBUS",
          "name": "Combustible",
          "value_id": "MLA1744-COMBUS-NAFTA",
          "value_name": "Nafta",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-DOOR",
          "name": "Cant. de puertas",
          "value_id": "MLA1744-DOOR-5",
          "value_name": "5",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-KMTS",
          "name": "Kilómetros",
          "value_id": "",
          "value_name": "0",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-MARC",
          "name": "Marca",
          "value_id": "MLA1744-MARC-PEUGEOT",
          "value_name": "Peugeot",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-MODL",
          "name": "Modelo",
          "value_id": "MLA1744-MODL-208",
          "value_name": "208",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-TRANS",
          "name": "Transmisión",
          "value_id": "MLA1744-TRANS-MANUAL",
          "value_name": "Manual",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-YEAR",
          "name": "Año",
          "value_id": "a9f0a06",
          "value_name": "2015",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-3LUZSTOP",
          "name": "Tercer stop",
          "value_id": "MLA1744-3LUZSTOP-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-ABS",
          "name": "Frenos ABS",
          "value_id": "MLA1744-ABS-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIR1",
          "name": "Airbag conductor",
          "value_id": "MLA1744-AIR1-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIR2",
          "name": "Airbag pasajero",
          "value_id": "MLA1744-AIR2-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIR3",
          "name": "Airbag laterales",
          "value_id": "MLA1744-AIR3-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIRBAGCORT",
          "name": "Airbag de cortina",
          "value_id": "MLA1744-AIRBAGCORT-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-ALAR",
          "name": "Alarma",
          "value_id": "MLA1744-ALAR-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-APCABEZA",
          "name": "Apoya cabeza en asientos traseros",
          "value_id": "MLA1744-APCABEZA-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-BLIND",
          "name": "Blindado",
          "value_id": "MLA1744-BLIND-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-CNTTRACC",
          "name": "Control de tracción",
          "value_id": "MLA1744-CNTTRACC-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-CONTR",
          "name": "Control de estabilidad",
          "value_id": "MLA1744-CONTR-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-DOBTRACC",
          "name": "Doble tracción",
          "value_id": "MLA1744-DOBTRACC-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-FARANTI",
          "name": "Faros antinieblas delanteros",
          "value_id": "MLA1744-FARANTI-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-FAROXEN",
          "name": "Faros de xenón",
          "value_id": "MLA1744-FAROXEN-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-INMOVMOT",
          "name": "Inmovilizador de motor",
          "value_id": "MLA1744-INMOVMOT-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-ISOFIX",
          "name": "Isofix",
          "value_id": "MLA1744-ISOFIX-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-NEBLTRAS",
          "name": "Faros antinieblas traseros",
          "value_id": "MLA1744-NEBLTRAS-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-REPFUERZA",
          "name": "Repartidor electrónico de fuerza de frenado",
          "value_id": "MLA1744-REPFUERZA-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AM_FM",
          "name": "AM/FM",
          "value_id": "MLA1744-AM/FM-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-BLUETOOTH",
          "name": "Bluetooth",
          "value_id": "MLA1744-BLUETOOTH-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-CAJACD",
          "name": "Caja de CD",
          "value_id": "MLA1744-CAJACD-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-CARGADORCD",
          "name": "Cargador de CD",
          "value_id": "MLA1744-CARGADORCD-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-CASET",
          "name": "Pasacassette",
          "value_id": "MLA1744-CASET-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-COMANDOSAT",
          "name": "Comando satelital de stereo",
          "value_id": "MLA1744-COMANDOSAT-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-DVD",
          "name": "DVD",
          "value_id": "MLA1744-DVD-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-ENTAUXILIA",
          "name": "Entrada auxiliar",
          "value_id": "MLA1744-ENTAUXILIA-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-MP3",
          "name": "MP3",
          "value_id": "MLA1744-MP3-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-REPRODCD",
          "name": "CD",
          "value_id": "MLA1744-REPRODCD-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-TARJETASD",
          "name": "Tarjeta SD",
          "value_id": "MLA1744-TARJETASD-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-USB",
          "name": "Entrada USB",
          "value_id": "MLA1744-USB-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        }
      ],
      "warnings": [
      ],
      "listing_source": "",
      "variations": [
      ],
      "status": "active",
      "sub_status": [
      ],
      "tags": [
        "dragged_visits"
      ],
      "warranty": null,
      "catalog_product_id": null,
      "parent_item_id": "MLA595529146",
      "differential_pricing": null,
      "deal_ids": [
      ],
      "automatic_relist": false,
      "date_created": "2016-01-08T16:55:57.000Z",
      "last_updated": "2016-01-29T18:59:04.000Z"
    }

    Definición de atributos

    Cuando creas un artículo, algunos de los campos son obligatorios, mientras que otros se pueden omitir o los agregaremos automáticamente. 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.

    Título

    El título es un atributo obligatorio y la clave para que los compradores encuentren tu vehículo; por eso, debes ser lo más específico posible.
    La mejor forma de armar un título es nombre + marca + modelo + especificaciones técnicas y características + servicios adicionales. Separa las palabras con espacios y no utilices símbolos ni signos de puntuación.

    Descripción

    La información detallada mejorará tus posibilidades de vender un producto y te ahorrará tiempo al no tener que responder preguntas. Al trabajar con descripciones, existen algunas consideraciones; por ejemplo, no se permite publicar una descripción con información de contacto. Si te interesa conocer más sobre este tema, consulta nuestra guía Descripciones de Artículos.

    Nota: Ten en cuenta que la descripción del producto deberá ser en texto sin formato.

    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

    Los vendedores deben definir una categoría en el site de MercadoLibre. Este atributo es obligatorio y solo acepta ID preestablecidos. Para más información, lee la guía de categorías. Para acceder a una sugerencia de categorías, lee este artículo.

    {
     ....
      "category_id":"MLA12683",
     ...
    }

    Precio

    Éste es un atributo obligatorio: cuando defines un nuevo artículo, debe tener precio. Te sugerimos que busques artículos similares en nuestro mercado para conocer el mejor precio para tus productos y aumentar tu competitividad. Si definiste un precio, pero no estás contento con el mismo, puedes cambiarlo más tarde; aprende cómo modificar artículos.

    Moneda

    Además del precio, debes definir una moneda. Este atributo también es obligatorio. Debes definirla utilizando un ID preestablecido. Sabrás qué ID enviar llamando a nuestro recurso Monedas.

    Seller custom field

    Si bien el Seller custom field no es obligatorio, es muy útil porque no existen valores preestablecidos y puedes enviar lo que desees como una String [cadena]. La mayoría de los vendedores utilizan este campo para asociar sus propios SKU a sus productos y así identificar el producto vendido en el pedido.

    Ejemplo para modificar este campo en un item:

    curl -X PUT -d '{"seller_custom_field": "21000093"}' https://api.mercadolibre.com/items/MLA599074368?access_token=¢ACCESS_TOKEN

    Tipos de publicación

    Es otro caso de un atributo obligatorio que solo acepta valores predefinidos y es muy importante que lo entiendas.
    Existen diferentes tipos de publicación disponibles para cada país. Debes realizar una llamada mixta a través de los sites y recursos listing_types para conocer los listing_types soportados.

    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 "Content-Type: application/json" -d '{
        "site_id": "MCO",
        "title": "Item De Testeo",
        "category_id": "MCO64499",
        "official_store_id": null,
        "price": 1200000,
        "currency_id": "COP",
        "available_quantity": 1,
        "buying_mode": "classified",
        "listing_type_id": "free",
        "condition": "used",
        "pictures": [
            {
                "id": "10792-MCO20033261630_012014",
                "url": "http://mco-s2-p.mlstatic.com/10792-MCO20033261630_012014-O.jpg",
                "secure_url": "https://a248.e.akamai.net/mco-s2-p.mlstatic.com/10792-MCO20033261630_012014-O.jpg",
                "size": "250x250",
                "max_size": "250x250",
                "quality": ""
            }
        ],
        "video_id": null,
        "accepts_mercadopago": false,
        "non_mercado_pago_payment_methods": [],
        "shipping": {
            "profile_id": null,
            "mode": "not_specified",
            "local_pick_up": false,
            "free_shipping": false,
            "methods": [],
            "dimensions": null
        },
        "seller_address": {
            "id": null,
            "comment": "",
            "address_line": "Test Address 123",
            "zip_code": "",
            "city": {
                "id": "",
                "name": "Bogota"
            },
            "state": {
                "id": "CO-DC",
                "name": "Bogota D.C."
            },
            "country": {
                "id": "CO",
                "name": "Colombia"
            },
            "latitude": "",
            "longitude": "",
            "search_location": {
                "neighborhood": {
                    "id": "",
                    "name": ""
                },
                "city": {
                    "id": "",
                    "name": ""
                },
                "state": {
                    "id": "",
                    "name": ""
                }
            }
        },
        "seller_contact": {
            "contact": "",
            "other_info": "",
            "area_code": "",
            "phone": "121312",
            "area_code2": "",
            "phone2": "",
            "email": "",
            "webpage": ""
        },
        "location": {
            "address_line": "",
            "zip_code": "",
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "TUNPQ0FCRTg3MTJl",
                "name": "Abejorral"
            },
            "state": {
                "id": "TUNPUEFOVGFiZWI3",
                "name": "Antioquia"
            },
            "country": {
                "id": "CO",
                "name": "Colombia"
            },
            "latitude": "",
            "longitude": ""
        },
        "coverage_areas": [],
        "attributes": [
            {
                "id": "MCO1744-ABS",
                "name": "Frenos ABS",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-AIRACON",
                "name": "Aire Acondicionado",
                "value_id": "MCO1744-AIRACON-SI",
                "value_name": "Sí",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-AIRBAG",
                "name": "Airbag",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-ASIENTOS",
                "name": "Asientos",
                "value_id": "MCO1744-ASIENTOS-CUERO",
                "value_name": "Cuero",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-CILIND",
                "name": "Nro. de cilindros",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-DIREC",
                "name": "Dirección",
                "value_id": "MCO1744-DIREC-ASISTIDA",
                "value_name": "Asistida",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-FINANC",
                "name": "Doy financiamiento",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-MOTOR",
                "name": "Motor",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-NEGOC",
                "name": "Negociable",
                "value_id": "MCO1744-NEGOC-SI",
                "value_name": "Sí",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-RMOTOR",
                "name": "Motor recién reparado",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-SONIDO",
                "name": "Sonido",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-TRAC",
                "name": "Camp",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-TRANS",
                "name": "Transmisión",
                "value_id": "MCO1744-TRANS-AUTOMATICA",
                "value_name": "Automática",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-VID",
                "name": "Vidrios",
                "value_id": "MCO1744-VID-MANUALES",
                "value_name": "Manuales",
                "attribute_group_id": "ADICIONALES",
                "attribute_group_name": "Características generales"
            },
            {
                "id": "MCO1744-BLOQUEOCEN",
                "name": "Bloqueo central",
                "value_id": "MCO1744-BLOQUEOCEN-N",
                "value_name": "No",
                "attribute_group_id": "EQUIPAMIENTO",
                "attribute_group_name": "Accesorios Internos"
            },
            {
                "id": "MCO1744-FORDELVOL",
                "name": "Forro del volante",
                "value_id": "MCO1744-FORDELVOL-N",
                "value_name": "No",
                "attribute_group_id": "EQUIPAMIENTO",
                "attribute_group_name": "Accesorios Internos"
            },
            {
                "id": "MCO1744-FORROSAS",
                "name": "Forros de asientos",
                "value_id": "MCO1744-FORROSAS-N",
                "value_name": "No",
                "attribute_group_id": "EQUIPAMIENTO",
                "attribute_group_name": "Accesorios Internos"
            },
            {
                "id": "MCO1744-VOLANDEP",
                "name": "Volante deportivo",
                "value_id": "MCO1744-VOLANDEP-N",
                "value_name": "No",
                "attribute_group_id": "EQUIPAMIENTO",
                "attribute_group_name": "Accesorios Internos"
            },
            {
                "id": "MCO1744-ESTRIBOS",
                "name": "Estribos",
                "value_id": "MCO1744-ESTRIBOS-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-FORROLLAN",
                "name": "Forro llanta de repuesto",
                "value_id": "MCO1744-FORROLLAN-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-LANTINIEB",
                "name": "Luces anti niebla",
                "value_id": "MCO1744-LANTINIEB-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-LLANTASN",
                "name": "Llantas nuevas",
                "value_id": "MCO1744-LLANTASN-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-PELICUSEG",
                "name": "Película de Seguridad",
                "value_id": "MCO1744-PELICUSEG-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-RETROELEC",
                "name": "Retrovisores eléctricos",
                "value_id": "MCO1744-RETROELEC-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-REVISION",
                "name": "Revision tecnomecánica",
                "value_id": "MCO1744-REVISION-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-RINES",
                "name": "Rines de lujo",
                "value_id": "MCO1744-RINES-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-ROOF",
                "name": "Sun Roof (Quemacoco)",
                "value_id": "MCO1744-ROOF-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-SPOILER",
                "name": "Spoiler",
                "value_id": "MCO1744-SPOILER-N",
                "value_name": "No",
                "attribute_group_id": "EXTERIOR",
                "attribute_group_name": "Exterior"
            },
            {
                "id": "MCO1744-COLOREXT",
                "name": "Color",
                "value_id": "MCO1744-COLOREXT-AZUL",
                "value_name": "Azul",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-COMBUS",
                "name": "Combustible",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-KMTS",
                "name": "Recorrido",
                "value_id": "",
                "value_name": "9999999999",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-MARC",
                "name": "Marca",
                "value_id": "MCO1744-MARC-OTRAS_MARCAS",
                "value_name": "Otras Marcas",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-MODL",
                "name": "Modelo",
                "value_id": "MCO1744-MODL-OTROS_MODELOS",
                "value_name": "Otros Modelos",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-OWNER",
                "name": "Único dueño",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-PLACAS",
                "name": "Placa",
                "value_id": "",
                "value_name": "11111",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO1744-YEAR",
                "name": "Año",
                "value_id": "MCO1744-YEAR-1969",
                "value_name": "1969",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha técnica"
            },
            {
                "id": "MCO64499-VERS",
                "name": "Versión",
                "value_id": "",
                "value_name": "",
                "attribute_group_id": "FIND",
                "attribute_group_name": "Ficha Técnica"
            },
            {
                "id": "MCO1743-CMG_SITE",
                "name": "sitio de origen",
                "value_id": "",
                "value_name": "TUC",
                "attribute_group_id": "HIDDEN",
                "attribute_group_name": ""
            },
            {
                "id": "MCO1744-ALARCCTRL",
                "name": "Alarma con control",
                "value_id": "MCO1744-ALARCCTRL-N",
                "value_name": "No",
                "attribute_group_id": "SECURITY",
                "attribute_group_name": "Seguridad"
            },
            {
                "id": "MCO1744-ASEGURADO",
                "name": "Asegurado",
                "value_id": "MCO1744-ASEGURADO-N",
                "value_name": "No",
                "attribute_group_id": "SECURITY",
                "attribute_group_name": "Seguridad"
            },
            {
                "id": "MCO1744-RASTREO",
                "name": "Rastreo satelital",
                "value_id": "MCO1744-RASTREO-N",
                "value_name": "No",
                "attribute_group_id": "SECURITY",
                "attribute_group_name": "Seguridad"
            },
            {
                "id": "MCO1744-CAJACD",
                "name": "Caja de CDs",
                "value_id": "MCO1744-CAJACD-N",
                "value_name": "No",
                "attribute_group_id": "SONIDO",
                "attribute_group_name": "Sonido"
            },
            {
                "id": "MCO1744-DVD",
                "name": "DVD",
                "value_id": "MCO1744-DVD-N",
                "value_name": "No",
                "attribute_group_id": "SONIDO",
                "attribute_group_name": "Sonido"
            },
            {
                "id": "MCO1744-PLANTA",
                "name": "Planta",
                "value_id": "MCO1744-PLANTA-N",
                "value_name": "No",
                "attribute_group_id": "SONIDO",
                "attribute_group_name": "Sonido"
            },
            {
                "id": "MCO1744-SUBBUFFER",
                "name": "Sub-Buffer (Bajos)",
                "value_id": "MCO1744-SUBBUFFER-N",
                "value_name": "No",
                "attribute_group_id": "SONIDO",
                "attribute_group_name": "Sonido"
            }
        ],
        "variations": [],
        "status": "active",
        "warranty": null,
        "catalog_product_id": null,
        "automatic_relist": false
    }' https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN



    Siguiente:
    Sincroniza publicaciones.

    Please rate this

    Categorías y Atributos

    Las categorías son un conjunto jerárquico de grupos en los cuales se enumeran los publicaciones de naturaleza similar, denominados “Árbol de Categorías”. Las categorías ayudan a los usuarios a buscar fácilmente el tipo de publicación que desean.
    Cada sitio tiene su propio conjunto de categorías, es decir que Argentina tendrá un conjunto único de categorías, diferente de las que encontrarás en Brasil, porque cada país tiene sus propias particularidades en el mercado clasificados. https://api.mercadolibre.com/sites/MLB/categories
    Antes de publicar un publicación, debes explorar la estructura de categorías y elegir en cuál deseas publicar. Para ayudarte, puedes descargar la jerarquía completa de categorías con ID y nombres fáciles desde nuestra API.
    Para publicar un vehículo, deberás seleccionar el category_id según el tipo de operación y propiedad.

    Contenidos:

    Categorías por Site

    El recurso Sites puede ofrecerte la estructura de categorías para un país en particular, en este caso Argentina.

    https://api.mercadolibre.com/sites/MLA/categories
    "categories": [
    {
    "id": "MLA5725",
    "name": "Accesorios para Vehiculos",
    },
    {
    "id": "MLA1071",
    "name": "Animales y Mascotas",
    },
    {
    "id": "MLA1367",
    "name": "Antigüedades",
    },
    {
    "id": "MLA1743",
    "name": "Autos, Motos y Otros",
    },

    Para categorías de segundo nivel o información relacionada con categorías específicas, debes utilizar el recurso Categorías y enviar el ID de categoría como parámetro URL.
    Veamos qué encontramos en la categoría “Vehículos”:

    https://api.mercadolibre.com/categories/MLA1743
    {
      "id": "MLA24272",
      "name": "Ecosport",
      "picture": null,
      "permalink": null,
      "total_items_in_this_category": 2806,
      "path_from_root": [
        {
          "id": "MLA1743",
          "name": "Autos, Motos y Otros"
        },
        {
          "id": "MLA1744",
          "name": "Autos y Camionetas"
        },
        {
          "id": "MLA3180",
          "name": "Ford"
        },
        {
          "id": "MLA24272",
          "name": "Ecosport"
        }
      ],
      "children_categories": [
      ],
      "attribute_types": "attributes",
      "settings": {
        "adult_content": false,
        "buying_allowed": false,
        "buying_modes": [
          "classified"
        ],
        "coverage_areas": "not_allowed",
        "currencies": [
          "USD",
          "ARS"
        ],
        "fragile": false,
        "immediate_payment": "optional",
        "item_conditions": [
          "new",
          "not_specified",
          "used"
        ],
        "items_reviews_allowed": false,
        "max_description_length": 50000,
        "max_pictures_per_item": 15,
        "max_sub_title_length": 70,
        "max_title_length": 60,
        "price": "required",
        "restrictions": [
        ],
        "rounded_address": false,
        "seller_contact": "optional",
        "shipping_modes": [
          "not_specified",
          "custom"
        ],
        "shipping_options": [
        ],
        "shipping_profile": "not_allowed",
        "show_contact_information": true,
        "simple_shipping": "not_allowed",
        "stock": "required",
        "tags": [
        ],
        "vip_subdomain": "auto",
        "mirror_category": null,
        "listing_allowed": true,
        "maximum_price": null,
        "minimum_price": null
      },
      "meta_categ_id": 30745,
      "attributable": false
    }

    Categorías JSON

    Realizar una llamada a una categoría en particular te permitirá conocer sus atributos. A continuación encontrarás una descripción de algunos de estos atributos. Al realizar una solicitud GET al category_id, encontrarás todos los atributos disponibles y puedes saber si son obligatorios u opcionales para publicar en la categoría.

    {
      "id": "MLA1743",
      "name": "Autos, Motos y Otros",
      "picture": "http://resources.mlstatic.com/category/images/e1a43666-ad57-4b8b-b405-f9d04dbbd8fc.png",
      "permalink": "http://www.mercadolibre.com.ar/vehiculos/",
      "total_items_in_this_category": 173701,
      "path_from_root": [
        {
          "id": "MLA1743",
          "name": "Autos, Motos y Otros"
        }
      ],
      "children_categories": [
        {
          "id": "MLA1745",
          "name": "Autos de Colección",
          "total_items_in_this_category": 1885
        },
        {
          "id": "MLA1744",
          "name": "Autos y Camionetas",
          "total_items_in_this_category": 109286
        },
        {
          "id": "MLA58254",
          "name": "Camiones",
          "total_items_in_this_category": 4319
        },
        {
          "id": "MLA51547",
          "name": "Colectivos",
          "total_items_in_this_category": 524
        },
        {
          "id": "MLA80579",
          "name": "Motorhomes",
          "total_items_in_this_category": 548
        },
        {
          "id": "MLA1763",
          "name": "Motos",
          "total_items_in_this_category": 33521
        },
        {
          "id": "MLA1785",
          "name": "Náutica",
          "total_items_in_this_category": 7538
        },
        {
          "id": "MLA1907",
          "name": "Otros Vehículos",
          "total_items_in_this_category": 8144
        },
        {
          "id": "MLA1784",
          "name": "Planes de Ahorro",
          "total_items_in_this_category": 7326
        },
        {
          "id": "MLA93430",
          "name": "Semirremolques",
          "total_items_in_this_category": 598
        }
      ],
      "attribute_types": "attributes",
      "settings": {
        "adult_content": false,
        "buying_allowed": false,
        "buying_modes": [
          "classified"
        ],
        "coverage_areas": "not_allowed",
        "currencies": [
          "ARS",
          "USD"
        ],
        "fragile": false,
        "immediate_payment": "optional",
        "item_conditions": [
          "new",
          "not_specified",
          "used"
        ],
        "items_reviews_allowed": false,
        "max_description_length": 50000,
        "max_pictures_per_item": 15,
        "max_sub_title_length": 70,
        "max_title_length": 60,
        "price": "required",
        "restrictions": [
        ],
        "rounded_address": false,
        "seller_contact": "optional",
        "shipping_modes": [
          "not_specified",
          "custom"
        ],
        "shipping_options": [
        ],
        "shipping_profile": "not_allowed",
        "show_contact_information": true,
        "simple_shipping": "not_allowed",
        "stock": "required",
        "tags": [
        ],
        "vip_subdomain": "vehiculo",
        "mirror_category": null,
        "listing_allowed": false,
        "maximum_price": null,
        "minimum_price": null
      },
      "meta_categ_id": null,
      "attributable": false
    }

    Ahora veamos la llamada de una categoría:

    Ejemplo:

    https://api.mercadolibre.com/categories/MLA1743

    Respuesta:

    {
      "id": "MLA24272",
      "name": "Ecosport",
      "picture": null,
      "permalink": null,
      "total_items_in_this_category": 2806,
      "path_from_root": [
        {
          "id": "MLA1743",
          "name": "Autos, Motos y Otros"
        },
        {
          "id": "MLA1744",
          "name": "Autos y Camionetas"
        },
        {
          "id": "MLA3180",
          "name": "Ford"
        },
        {
          "id": "MLA24272",
          "name": "Ecosport"
        }
      ],
      "children_categories": [
      ],
      "attribute_types": "attributes",
      "settings": {
        "adult_content": false,
        "buying_allowed": false,
        "buying_modes": [
          "classified"
        ],
        "coverage_areas": "not_allowed",
        "currencies": [
          "USD",
          "ARS"
        ],
        "fragile": false,
        "immediate_payment": "optional",
        "item_conditions": [
          "new",
          "not_specified",
          "used"
        ],
        "items_reviews_allowed": false,
        "max_description_length": 50000,
        "max_pictures_per_item": 15,
        "max_sub_title_length": 70,
        "max_title_length": 60,
        "price": "required",
        "restrictions": [
        ],
        "rounded_address": false,
        "seller_contact": "optional",
        "shipping_modes": [
          "not_specified",
          "custom"
        ],
        "shipping_options": [
        ],
        "shipping_profile": "not_allowed",
        "show_contact_information": true,
        "simple_shipping": "not_allowed",
        "stock": "required",
        "tags": [
        ],
        "vip_subdomain": "auto",
        "mirror_category": null,
        "listing_allowed": true,
        "maximum_price": null,
        "minimum_price": null
      },
      "meta_categ_id": 30745,
      "attributable": false
    }

    Atributos específicos de las categorías

    Para conocer los atributos específicos y valores posibles de las categorías que debes enviar para publicar un publicación, consulta el recurso atributos.
    Ejemplo:

     https://api.mercadolibre.com/categories/MLA24272/attributes

    Respuesta:

     {
        "id": "MLA1744-MARC",
        "name": "Marca",
        "value_type": "list",
        "tags": {
          "fixed": true,
          "required": true
        },
        "values": [
          {
            "id": "MLA1744-MARC-FORD",
            "name": "Ford"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-MODL",
        "name": "Modelo",
        "value_type": "list",
        "tags": {
          "fixed": true,
          "required": true
        },
        "values": [
          {
            "id": "MLA1744-MODL-ECOSPORT",
            "name": "Ecosport"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-DOOR",
        "name": "Cant. de puertas",
        "value_type": "list",
        "tags": {
          "required": true
        },
        "values": [
          {
            "id": "MLA1744-DOOR-2",
            "name": "2"
          },
          {
            "id": "MLA1744-DOOR-3",
            "name": "3"
          },
          {
            "id": "MLA1744-DOOR-4",
            "name": "4"
          },
          {
            "id": "MLA1744-DOOR-5",
            "name": "5"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-COMBUS",
        "name": "Combustible",
        "value_type": "list",
        "tags": {
          "required": true
        },
        "values": [
          {
            "id": "MLA1744-COMBUS-DIESEL",
            "name": "Diesel"
          },
          {
            "id": "MLA1744-COMBUS-NAFTA",
            "name": "Nafta"
          },
          {
            "id": "MLA1744-COMBUS-NAFTAGNC",
            "name": "Nafta/Gnc"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-KMTS",
        "name": "Kilómetros",
        "value_type": "number",
        "value_max_length": 60,
        "tags": {
          "required": true
        },
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-YEAR",
        "name": "Año",
        "value_type": "list",
        "tags": {
          "required": true
        },
        "values": [
          {
            "id": "MLA1744-YEAR-95192c",
            "name": "2016"
          },
          {
            "id": "a9f0a06",
            "name": "2015"
          },
          {
            "id": "MLA1744-YEAR-2014",
            "name": "2014"
          },
          {
            "id": "MLA1744-YEAR-2013",
            "name": "2013"
          },
          {
            "id": "MLA1744-YEAR-2012",
            "name": "2012"
          },
          {
            "id": "MLA1744-YEAR-2011",
            "name": "2011"
          },
          {
            "id": "MLA1744-YEAR-2010",
            "name": "2010"
          },
          {
            "id": "MLA1744-YEAR-2009",
            "name": "2009"
          },
          {
            "id": "MLA1744-YEAR-2008",
            "name": "2008"
          },
          {
            "id": "MLA1744-YEAR-2007",
            "name": "2007"
          },
          {
            "id": "MLA1744-YEAR-2006",
            "name": "2006"
          },
          {
            "id": "MLA1744-YEAR-2005",
            "name": "2005"
          },
          {
            "id": "MLA1744-YEAR-2004",
            "name": "2004"
          },
          {
            "id": "MLA1744-YEAR-2003",
            "name": "2003"
          },
          {
            "id": "MLA1744-YEAR-2002",
            "name": "2002"
          },
          {
            "id": "MLA1744-YEAR-2001",
            "name": "2001"
          },
          {
            "id": "MLA1744-YEAR-2000",
            "name": "2000"
          },
          {
            "id": "MLA1744-YEAR-1999",
            "name": "1999"
          },
          {
            "id": "MLA1744-YEAR-1998",
            "name": "1998"
          },
          {
            "id": "MLA1744-YEAR-1997",
            "name": "1997"
          },
          {
            "id": "MLA1744-YEAR-1996",
            "name": "1996"
          },
          {
            "id": "MLA1744-YEAR-1995",
            "name": "1995"
          },
          {
            "id": "MLA1744-YEAR-1994",
            "name": "1994"
          },
          {
            "id": "MLA1744-YEAR-1993",
            "name": "1993"
          },
          {
            "id": "MLA1744-YEAR-1992",
            "name": "1992"
          },
          {
            "id": "MLA1744-YEAR-1991",
            "name": "1991"
          },
          {
            "id": "MLA1744-YEAR-1990",
            "name": "1990"
          },
          {
            "id": "MLA1744-YEAR-1989",
            "name": "1989"
          },
          {
            "id": "MLA1744-YEAR-1988",
            "name": "1988"
          },
          {
            "id": "MLA1744-YEAR-1987",
            "name": "1987"
          },
          {
            "id": "MLA1744-YEAR-1986",
            "name": "1986"
          },
          {
            "id": "MLA1744-YEAR-1985",
            "name": "1985"
          },
          {
            "id": "MLA1744-YEAR-1984",
            "name": "1984"
          },
          {
            "id": "MLA1744-YEAR-1983",
            "name": "1983"
          },
          {
            "id": "MLA1744-YEAR-1982",
            "name": "1982"
          },
          {
            "id": "MLA1744-YEAR-1981",
            "name": "1981"
          },
          {
            "id": "MLA1744-YEAR-1980",
            "name": "1980"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-CAJACD",
        "name": "Caja de CD",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CAJACD-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CAJACD-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA24272-VERS",
        "name": "Versión",
        "value_type": "list",
        "tags": {
        },
        "values": [
          {
            "id": "MLA0150027005-MLA24272",
            "name": "1.4 TDI XL Plus % MP3"
          },
          {
            "id": "MLA0150027033-MLA24272",
            "name": "1.4 TDI XL Plus MP3 (L08)"
          },
          {
            "id": "MLA0150027006-MLA24272",
            "name": "1.4 TDI XLS MP3"
          },
          {
            "id": "MLA0150027034-MLA24272",
            "name": "1.4 TDI XLS MP3 (L08)"
          },
          {
            "id": "d4de20c",
            "name": "1.6 Nafta S MT5 (110cv)"
          },
          {
            "id": "MLA0150027001-MLA24272",
            "name": "1.6 XL Plus % MP3"
          },
          {
            "id": "MLA0150027010-MLA24272",
            "name": "1.6 XL Plus 2ABG"
          },
          {
            "id": "MLA0150027009-MLA24272",
            "name": "1.6 XL Plus ABG"
          },
          {
            "id": "MLA0150027027-MLA24272",
            "name": "1.6 XL Plus MP3 (L08)"
          },
          {
            "id": "MLA0150027002-MLA24272",
            "name": "1.6 XLS % MP3"
          },
          {
            "id": "MLA0150027011-MLA24272",
            "name": "1.6 XLS ABG"
          },
          {
            "id": "MLA0150027028-MLA24272",
            "name": "1.6 XLS MP3 (L08)"
          },
          {
            "id": "MLA0150027014-MLA24272",
            "name": "1.6 XLS MP3 ABS"
          },
          {
            "id": "MLA0150027022-MLA24272",
            "name": "1.6 XLT"
          },
          {
            "id": "MLA0150027015-MLA24272",
            "name": "1.6 XLT Free Style"
          },
          {
            "id": "MLA0150027038-MLA24272",
            "name": "1.6 XLT Free Style (L08) DICONTINUO"
          },
          {
            "id": "MLA0150027037-MLA24272",
            "name": "1.6 XLT Plus MP3 (L08)"
          },
          {
            "id": "MLA0150027023-MLA24272",
            "name": "1.6 XLT SVP HE - Edic. Limitada"
          },
          {
            "id": "MLA0150027024-MLA24272",
            "name": "1.6 XLT SVP SHE - Edic. Limitada"
          },
          {
            "id": "MLA0150027029-MLA24272",
            "name": "2.0 XLS (L08)"
          },
          {
            "id": "MLA0150027004-MLA24272",
            "name": "2.0 XLT"
          },
          {
            "id": "MLA0150027035-MLA24272",
            "name": "2.0 XLT (L08)"
          },
          {
            "id": "MLA0150027013-MLA24272",
            "name": "2.0 XLT 2ABG"
          },
          {
            "id": "MLA0150027008-MLA24272",
            "name": "2.0 XLT 4X4"
          },
          {
            "id": "MLA0150027007-MLA24272",
            "name": "2.0 XLT 4X4 Plus Cuero"
          },
          {
            "id": "MLA0150027032-MLA24272",
            "name": "2.0 XLT 4X4 Plus Cuero (L08)"
          },
          {
            "id": "MLA0150027012-MLA24272",
            "name": "2.0 XLT ABG"
          },
          {
            "id": "MLA0150027025-MLA24272",
            "name": "2.0 XLT AT"
          },
          {
            "id": "MLA0150027026-MLA24272",
            "name": "2.0 XLT AT Plus Cuero"
          },
          {
            "id": "MLA0150027036-MLA24272",
            "name": "2.0 XLT Night Running (L08) - Edic. Limitada"
          },
          {
            "id": "MLA0150027031-MLA24272",
            "name": "2.0 XLT Plus AT Cuero (L08)"
          },
          {
            "id": "MLA0150027021-MLA24272",
            "name": "2.0 XLT Plus Cuero"
          },
          {
            "id": "MLA0150027030-MLA24272",
            "name": "2.0 XLT Plus Cuero (L08)"
          },
          {
            "id": "ca9d9bf",
            "name": "FreeStyle 1.6L Sigma"
          },
          {
            "id": "a54e5d5",
            "name": "FreeStyle 2.0L Duratec 4WD"
          },
          {
            "id": "07ebca7",
            "name": "S 1.5L Duratorq TDCi"
          },
          {
            "id": "3ad53d4",
            "name": "S 1.6L Sigma"
          },
          {
            "id": "30a9692",
            "name": "SE 1.5L Duratorq TDCi"
          },
          {
            "id": "f1b7b93",
            "name": "SE 1.6L Sigma"
          },
          {
            "id": "ab9e7ab",
            "name": "SE 2.0L Duratec"
          },
          {
            "id": "5d8133e",
            "name": "Titanium 1.6L Sigma"
          },
          {
            "id": "8d53516",
            "name": "Titanium 2.0L Duratec"
          },
          {
            "id": "41d7238",
            "name": "Titanium 2.0L Duratec AT"
          },
          {
            "id": "acb2185",
            "name": "Otras Versiones"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-AIR1",
        "name": "Airbag conductor",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-AIR1-N",
            "name": "No"
          },
          {
            "id": "MLA1744-AIR1-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-AIRBAGCORT",
        "name": "Airbag de cortina",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-AIRBAGCORT-N",
            "name": "No"
          },
          {
            "id": "MLA1744-AIRBAGCORT-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-AIR3",
        "name": "Airbag laterales",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-AIR3-N",
            "name": "No"
          },
          {
            "id": "MLA1744-AIR3-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-AIR2",
        "name": "Airbag pasajero",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-AIR2-N",
            "name": "No"
          },
          {
            "id": "MLA1744-AIR2-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-AIRACON",
        "name": "Aire acondicionado",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-AIRACON-N",
            "name": "No"
          },
          {
            "id": "MLA1744-AIRACON-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-ALAR",
        "name": "Alarma",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ALAR-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ALAR-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-ALARMLUC",
        "name": "Alarma de luces encendidas",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ALARMLUC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ALARMLUC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-AM_FM",
        "name": "AM/FM",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-AM/FM-N",
            "name": "No"
          },
          {
            "id": "MLA1744-AM/FM-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-APERBAUL",
        "name": "Apertura remota de baúl",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-APERBAUL-N",
            "name": "No"
          },
          {
            "id": "MLA1744-APERBAUL-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-APCABEZA",
        "name": "Apoya cabeza en asientos traseros",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-APCABEZA-N",
            "name": "No"
          },
          {
            "id": "MLA1744-APCABEZA-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-ASREGULA",
        "name": "Asiento conductor regulable en altura",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ASREGULA-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ASREGULA-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-ASREBAT",
        "name": "Asiento trasero rebatible",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ASREBAT-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ASREBAT-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-ASIENELEC",
        "name": "Asientos eléctricos",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ASIENELEC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ASIENELEC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-BLIND",
        "name": "Blindado",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-BLIND-N",
            "name": "No"
          },
          {
            "id": "MLA1744-BLIND-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-BLUETOOTH",
        "name": "Bluetooth",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-BLUETOOTH-N",
            "name": "No"
          },
          {
            "id": "MLA1744-BLUETOOTH-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-CARGADORCD",
        "name": "Cargador de CD",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CARGADORCD-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CARGADORCD-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-REPRODCD",
        "name": "CD",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-REPRODCD-N",
            "name": "No"
          },
          {
            "id": "MLA1744-REPRODCD-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-BLQCNTDOOR",
        "name": "Cierre centralizado de puertas",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-BLQCNTDOOR-N",
            "name": "No"
          },
          {
            "id": "MLA1744-BLQCNTDOOR-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-CLIMAUT",
        "name": "Climatizador automático",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CLIMAUT-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CLIMAUT-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-COLOREXT",
        "name": "Color",
        "value_type": "list",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-COLOREXT-AMARILLO",
            "name": "Amarillo"
          },
          {
            "id": "MLA1744-COLOREXT-AZUL",
            "name": "Azul"
          },
          {
            "id": "MLA1744-COLOREXT-BEIGE",
            "name": "Beige"
          },
          {
            "id": "MLA1744-COLOREXT-BLANCO",
            "name": "Blanco"
          },
          {
            "id": "MLA1744-COLOREXT-BORDO",
            "name": "Bordó"
          },
          {
            "id": "MLA1744-COLOREXT-CELESTE",
            "name": "Celeste"
          },
          {
            "id": "MLA1744-COLOREXT-CHAMPAGNE",
            "name": "Champagne"
          },
          {
            "id": "MLA1744-COLOREXT-GRIS",
            "name": "Gris"
          },
          {
            "id": "MLA1744-COLOREXT-MARRON",
            "name": "Marrón"
          },
          {
            "id": "MLA1744-COLOREXT-NEGRO",
            "name": "Negro"
          },
          {
            "id": "MLA1744-COLOREXT-ORO",
            "name": "Oro"
          },
          {
            "id": "MLA1744-COLOREXT-PLATA",
            "name": "Plata"
          },
          {
            "id": "MLA1744-COLOREXT-ROJO",
            "name": "Rojo"
          },
          {
            "id": "MLA1744-COLOREXT-ROSADO",
            "name": "Rosado"
          },
          {
            "id": "MLA1744-COLOREXT-VERDE",
            "name": "Verde"
          },
          {
            "id": "MLA1744-COLOREXT-OTRO",
            "name": "Otro"
          }
        ],
        "attribute_group_id": "ADICIONALES",
        "attribute_group_name": "Adicionales"
      },
      {
        "id": "MLA1744-COMANDOSAT",
        "name": "Comando satelital de stereo",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-COMANDOSAT-N",
            "name": "No"
          },
          {
            "id": "MLA1744-COMANDOSAT-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-COMPABO",
        "name": "Computadora de abordo",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-COMPABO-N",
            "name": "No"
          },
          {
            "id": "MLA1744-COMPABO-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-CONTR",
        "name": "Control de estabilidad",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CONTR-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CONTR-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-CNTTRACC",
        "name": "Control de tracción",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CNTTRACC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CNTTRACC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-CTRLVEL",
        "name": "Control de velocidad de crucero",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CTRLVEL-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CTRLVEL-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-VIDELEC",
        "name": "Cristales eléctricos",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-VIDELEC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-VIDELEC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-DIREC",
        "name": "Dirección",
        "value_type": "list",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-DIREC-ASISTIDA",
            "name": "Asistida"
          },
          {
            "id": "MLA1744-DIREC-HIDRAULICA",
            "name": "Hidráulica"
          },
          {
            "id": "MLA1744-DIREC-MECANICA",
            "name": "Mecánica"
          }
        ],
        "attribute_group_id": "ADICIONALES",
        "attribute_group_name": "Adicionales"
      },
      {
        "id": "MLA1744-DOBTRACC",
        "name": "Doble tracción",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-DOBTRACC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-DOBTRACC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-DVD",
        "name": "DVD",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-DVD-N",
            "name": "No"
          },
          {
            "id": "MLA1744-DVD-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-ENTAUXILIA",
        "name": "Entrada auxiliar",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ENTAUXILIA-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ENTAUXILIA-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-USB",
        "name": "Entrada USB",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-USB-N",
            "name": "No"
          },
          {
            "id": "MLA1744-USB-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-ESPELEC",
        "name": "Espejos eléctricos",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ESPELEC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ESPELEC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-FARANTI",
        "name": "Faros antinieblas delanteros",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-FARANTI-N",
            "name": "No"
          },
          {
            "id": "MLA1744-FARANTI-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-NEBLTRAS",
        "name": "Faros antinieblas traseros",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-NEBLTRAS-N",
            "name": "No"
          },
          {
            "id": "MLA1744-NEBLTRAS-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-FAROXEN",
        "name": "Faros de xenón",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-FAROXEN-N",
            "name": "No"
          },
          {
            "id": "MLA1744-FAROXEN-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-FAROREG",
        "name": "Faros regulables desde el interior",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-FAROREG-N",
            "name": "No"
          },
          {
            "id": "MLA1744-FAROREG-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-ABS",
        "name": "Frenos ABS",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ABS-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ABS-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-GPS",
        "name": "GPS",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-GPS-N",
            "name": "No"
          },
          {
            "id": "MLA1744-GPS-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1743-HORPREF",
        "name": "Horario de contacto",
        "value_type": "string",
        "value_max_length": 60,
        "tags": {
        },
        "attribute_group_id": "ADICIONALES",
        "attribute_group_name": "Adicionales"
      },
      {
        "id": "MLA1744-INMOVMOT",
        "name": "Inmovilizador de motor",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-INMOVMOT-N",
            "name": "No"
          },
          {
            "id": "MLA1744-INMOVMOT-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-ISOFIX",
        "name": "Isofix",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ISOFIX-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ISOFIX-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-LIMPIA_LAV",
        "name": "Limpia/lava luneta",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-LIMPIA/LAV-N",
            "name": "No"
          },
          {
            "id": "MLA1744-LIMPIA/LAV-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "EXTERIOR",
        "attribute_group_name": "Exterior"
      },
      {
        "id": "MLA1744-LLANALEAC",
        "name": "Llantas de aleación",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-LLANALEAC-N",
            "name": "No"
          },
          {
            "id": "MLA1744-LLANALEAC-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "EXTERIOR",
        "attribute_group_name": "Exterior"
      },
      {
        "id": "MLA1744-MP3",
        "name": "MP3",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-MP3-N",
            "name": "No"
          },
          {
            "id": "MLA1744-MP3-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-PARAGOLPES",
        "name": "Paragolpes pintados",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-PARAGOLPES-N",
            "name": "No"
          },
          {
            "id": "MLA1744-PARAGOLPES-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "EXTERIOR",
        "attribute_group_name": "Exterior"
      },
      {
        "id": "MLA1744-CASET",
        "name": "Pasacassette",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-CASET-N",
            "name": "No"
          },
          {
            "id": "MLA1744-CASET-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-REPFUERZA",
        "name": "Repartidor electrónico de fuerza de frenado",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-REPFUERZA-N",
            "name": "No"
          },
          {
            "id": "MLA1744-REPFUERZA-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-ESTACIONAM",
        "name": "Sensor de estacionamiento",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-ESTACIONAM-N",
            "name": "No"
          },
          {
            "id": "MLA1744-ESTACIONAM-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-SENSLL",
        "name": "Sensor de lluvia",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-SENSLL-N",
            "name": "No"
          },
          {
            "id": "MLA1744-SENSLL-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-SENSLUZ",
        "name": "Sensor de luz",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-SENSLUZ-N",
            "name": "No"
          },
          {
            "id": "MLA1744-SENSLUZ-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-TAPCUERO",
        "name": "Tapizado de cuero",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-TAPCUERO-N",
            "name": "No"
          },
          {
            "id": "MLA1744-TAPCUERO-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-TARJETASD",
        "name": "Tarjeta SD",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-TARJETASD-N",
            "name": "No"
          },
          {
            "id": "MLA1744-TARJETASD-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SONIDO",
        "attribute_group_name": "Sonido"
      },
      {
        "id": "MLA1744-TECHOCORR",
        "name": "Techo corredizo",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-TECHOCORR-N",
            "name": "No"
          },
          {
            "id": "MLA1744-TECHOCORR-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "CONFORT",
        "attribute_group_name": "Confort"
      },
      {
        "id": "MLA1744-3LUZSTOP",
        "name": "Tercer stop",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-3LUZSTOP-N",
            "name": "No"
          },
          {
            "id": "MLA1744-3LUZSTOP-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "SECURITY",
        "attribute_group_name": "Seguridad"
      },
      {
        "id": "MLA1744-TRANS",
        "name": "Transmisión",
        "value_type": "list",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-TRANS-AUTOMATICA",
            "name": "Automática"
          },
          {
            "id": "MLA1744-TRANS-MANUAL",
            "name": "Manual"
          },
          {
            "id": "MLA1744-TRANS-SECUENCIAL",
            "name": "Secuencial"
          }
        ],
        "attribute_group_id": "FIND",
        "attribute_group_name": "Ficha técnica"
      },
      {
        "id": "MLA1744-VIDPOLARIZ",
        "name": "Vidrios polarizados",
        "value_type": "boolean",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-VIDPOLARIZ-N",
            "name": "No"
          },
          {
            "id": "MLA1744-VIDPOLARIZ-Y",
            "name": "Sí"
          }
        ],
        "attribute_group_id": "EXTERIOR",
        "attribute_group_name": "Exterior"
      },
      {
        "id": "MLA1744-OWNER",
        "name": "Único dueño",
        "value_type": "list",
        "tags": {
        },
        "values": [
          {
            "id": "MLA1744-OWNER-SI",
            "name": "Sí"
          },
          {
            "id": "MLA1744-OWNER-NO",
            "name": "No"
          }
        ],
        "attribute_group_id": "ADICIONALES",
        "attribute_group_name": "Adicionales"
      }

    Nombre

    Este atributo muestra un nombre corto. Con solo leer el JSON anterior sabes que, por ejemplo, se trata de una categoría de clasificados que no permite incluir opciones de envío, existen 1332 publicaciones publicados en la misma y puedes incluir el precio en ARS o USD.

    curl https://api.mercadolibre.com/sites/MLA/search?category=MLA5726

    Path_from_root

    Mira como utiliza MercadoLibre sus categorías:

    Captura de pantalla 2016-03-23 a las 11.24.49

    Elige la categoría para vehículo

    Elegir la categoría correcta para tu vehículo determinará la rapidez con que los compradores la encontrarán y mejorará tus posibilidades de venderla. Por este motivo, te recomendamos utilizar nuestra herramienta de predicción de Categorías antes de publicar un publicación.



    Siguiente:
    Publica vehículos.

    Please rate this

    Consulta Usuarios Avanzado

    Ahora que ya sabes como trabajar con usuarios de MercadoLibre, es hora que entremos en características especiales de ellos:

    Contenidos:

    Please rate this

    Autenticación y Autorización

    La plataforma de Mercado Libre te permite trabajar con recursos públicos y privados de la API a través de llamadas HTTP con los verbos GET, PUT, POST, DELETE y OPTIONS.
    El acceso a los recursos públicos, tales como sites y categories disponibles, se puede hacer en forma anónima pero los recursos privados y las acciones propias de los usuarios como publicar un artículo, responder preguntas o ver la información de ventas/compras requieren autorización mediante una aplicación.
    Por tal motivo en la siguiente guía te explicaremos el significado de autenticación y el flujo de autorización que se debe seguir para obtener un access_token (llave de acceso a los recursos privados por cada usuario que autorice la aplicación- válida por 6 horas).
    Por ejemplo:
    Sin access_token (Recurso público)

    https://api.mercadolibre.com/users/226384143/
    
    {
      "id": 226384143,
      "nickname": "TETE9928972",
      "registration_date": "2016-08-25T11:36:00.000-04:00",
      "country_id": "AR",
      "address": {
        "state": "AR-C",
        "city": "Palermo"
      },
      "user_type": "normal",
      "tags": [
        "normal",
        "test_user",
        "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
      "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
          "period": "historic",
          "total": 1,
          "completed": 1,
          "canceled": 0,
          "ratings": {
            "positive": 0,
            "negative": 0,
            "neutral": 1
          }
        }
      },
      "buyer_reputation": {
        "tags": [
        ]
      },
      "status": {
        "site_status": "active"
      }
    }


    Con access_token (Recurso privado)

     
     https://api.mercadolibre.com/users/226384143?access_token=$ACCESS_TOKEN
    
    {
      "id": 226384143,
      "nickname": "TETE9928972",
      "registration_date": "2016-08-25T11:36:00.000-04:00",
      "first_name": "Test",
      "last_name": "Test",
      "country_id": "AR",
      "email": "test_user_38730994@testuser.com",
      "identification": {
        "type": "DNI",
        "number": "1111111"
      },
      "address": {
        "state": "AR-C",
        "city": "Palermo",
        "address": "Test Address 123",
        "zip_code": "1414"
      },
      "phone": {
        "area_code": "01",
        "number": "1111-1111",
        "extension": "",
        "verified": false
      },
      "alternative_phone": {
        "area_code": "",
        "number": "",
        "extension": ""
      },
      "user_type": "normal",
      "tags": [
        "normal",
        "test_user",
        "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
      "shipping_modes": [
        "custom",
        "not_specified"
      ],
      "seller_experience": "ADVANCED",
      "bill_data": {
        "accept_credit_note": null
      },
      "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
          "period": "historic",
          "total": 1,
          "completed": 1,
          "canceled": 0,
          "ratings": {
            "positive": 0,
            "negative": 0,
            "neutral": 1
          }
        }
      },
      "buyer_reputation": {
        "canceled_transactions": 0,
        "transactions": {
          "period": "historic",
          "total": null,
          "completed": null,
          "canceled": {
            "total": null,
            "paid": null
          },
          "unrated": {
            "total": null,
            "paid": null
          },
          "not_yet_rated": {
            "total": null,
            "paid": null,
            "units": null
          }
        },
        "tags": [
        ]
      },
      "status": {
        "site_status": "active",
        "list": {
          "allow": true,
          "codes": [
          ],
          "immediate_payment": {
            "required": false,
            "reasons": [
            ]
          }
        },
        "buy": {
          "allow": true,
          "codes": [
          ],
          "immediate_payment": {
            "required": false,
            "reasons": [
            ]
          }
        },
        "sell": {
          "allow": true,
          "codes": [
          ],
          "immediate_payment": {
            "required": false,
            "reasons": [
            ]
          }
        },
        "billing": {
          "allow": true,
          "codes": [
          ]
        },
        "mercadopago_tc_accepted": true,
        "mercadopago_account_type": "personal",
        "mercadoenvios": "not_accepted",
        "immediate_payment": false,
        "confirmed_email": false,
        "user_type": "simple_registration",
        "required_action": ""
      },
      "credit": {
        "consumed": 101.1,
        "credit_level_id": "MLA1"
      }
    }

    Contenidos:

    Autenticación

    La autenticación es el acto o proceso para el establecimiento o confirmación de algo o alguien como real.
    En el caso de la autenticación de una persona consiste en verificar su identidad en función a uno o varios factores asegurando que los datos de quién los envió sean los correctos.

    Algunos métodos de autenticación son:

    • Biomédicas, por huellas dactilares, retina del ojo, etc.
    • Tarjetas inteligentes que guardan información de los certificados de un usuario.
    • Métodos clásicos basados en contraseña.
    • Por ejemplo, para ingresar a Mercado Libre nos autenticamos a través del login (usuario y contraseña).

    login

    Autorización

    La autorización es el proceso por el cual permitimos a alguien o a algo acceder a recursos privados.
    Dentro de la autorización se deberá definir qué recursos y qué operaciones se pueden realizar ya que no es lo mismo otorgar permisos de sólo lectura, que lectura y escritura.

    ¿Cómo logramos la autorización? A través del Protocolo OAuth 2.0, uno de los más utilizados en plataforma abiertas (Twitter, Facebook, etc.) y método seguro para trabajar con recursos privados.

    OAuth nos brinda:

    • Confidencialidad, el usuario no deberá revelar su clave en ningún momento.
    • Integridad, sólo podrán ver datos privados aquellas aplicaciones que tengan el permiso de hacerlo.
    • Disponibilidad, los datos siempre estarán disponibles en el momento que se necesiten.

    Dentro de este protocolo existen 4 modos de funcionamiento posibles denominados Grant Types:

    – The Authorization Code Grant Type (Server Side)
    – The Implicit Grant Type (Client Side)
    – The Password Credentials Grant Type
    – The Client Credentials Grant Type

    Si bien cada uno de ellos es utilizado para diferentes propósitos dependiendo del servicio que se está construyendo a continuación sólo explicaremos los dos primeros ya que son los que te permitirán trabajar con nuestros recursos y generar herramientas para todos los usuarios de Mercado Libre.

    Client-side

    El flujo de autorización Client side es el adecuado para las aplicaciones que ejecutan código del lado del cliente, por ejemplo aplicaciones desarrolladas en lenguaje javascript/ajax, Angular o aplicaciones mobile.
    Para conocer más detalles sobre este flujo te sugerimos ir al tutorial “Autorización Client-Side

    Server-side

    El flujo de autorización Server side es el más adecuado para las aplicaciones que ejecutan código del lado del servidor, por ejemplo aplicaciones desarrolladas en lenguaje como Java, Grails, Go, etc.

    Nota: Esta opción te será de utilidad para aplicaciones que ejecutan cron jobs para actualizar stock de productos u operar sin que un usuario esté interactuando directamente con la aplicación.
    Si deseas conocer más detalles sobre este flujo te sugerimos ir al tutorial “Autorización Server-Side

    ¡Obtén tu access_token!

    Introduzca el ID de la aplicación que acaba de crear:

    *Please enter a valid Application ID
    Información del usuarioJSON Response

    -

    Uso de nuestros SDK

    Mediante el uso de nuestros SDKs el proceso de autorización será más simple ya que te ahorrará la codificación de todo el protocolo OAuth de cero.
    ¡Nuestra comunidad ya los está utilizando!
    Ofrecemos SDK para:

    Si descubres una mejora o sugerencia puedes brindarla a la comunidad generando un Pull Request dentro de nuestro repositorio GitHub.

    Consideraciones

    Validez y expiración de tokens
    Cuando obtienes un access_token, será válido de inmediato y se podrá utilizar para realizar solicitudes a la API durante un período limitado de 6 horas.
    Existen eventos que pueden invalidar un access_token antes del tiempo de expiración. Por ejemplo: cambio de contraseña por parte del usuario, la actualización del App Secret por parte de una aplicación y, por supuesto, la revocación de permisos a tu aplicación por parte del usuario.

    Referencia de códigos de error

    Error Mensaje de error Posible solución
    invalid_client

    client_id o client_secret inválido.

    El client_id y/o client_secret provisto es inválido. Controla la información de tu aplicación y verifica los parámetros client_id y client_secret
    invalid_grant

    Para crear un access token el usuario {0} debe tener una sesión activa o tu aplicación debe solicitar autorización para el alcance offline_access.

    El otorgamiento de la autorización provista es inválido, expiró, fue revocado o no coincide con el URI de redireccionamiento utilizado en la solicitud de autorización. Verifica que el parámetro redirect_uri sea el mismo configurado en tu aplicación (Administrador de Aplicaciones); si esto no resuelve el problema, realiza una nueva solicitud para obtener un código nuevo.
    invalid_grant

    Error en la validación del otorgamiento. Es posible que tu código de autorización o refresh token haya expirado o que ya haya sido utilizado.

    Expiró o ya fue utilizado. Realiza una nueva solicitud para obtener un nuevo código o refresh_token.
    invalid_grant

    El client_id no coincide con el original.

    El ID de cliente no coincide. No se encontró el parámetro client_id; para obtener tu client_id, consulta tu aplicación (Administrador de Aplicaciones).
    invalid_grant

    El redirect_uri no coincide con el original.

    El URl de redireccionamiento no coincide con el original. El parámetro redirect_uri no es el mismo configurado en tu aplicación; para obtener un redirect_uri, consulta tu aplicación (Administrador de Aplicaciones)
    invalid_scope

    Alcance inválido.

    El alcance solicitado es inválido, desconocido o está mal formado. Los valores permitidos para el parámetro alcance son: “offline_access”,”write”,”read”.
    invalid_request

    Cantidad incorrecta de parámetros con valores duplicados.

    La solicitud no incluye un parámetro obligatorio, incluye un parámetro o valor de parámetro no soportado o está mal formada de otro modo. Verifica que los parámetros enviados sean válidos y no estén duplicados.
    unsupported_grant_type

    Tipo de otorgamiento no soportado: ${0}.

    El server de autorización no soporta el tipo de otorgamiento. Los valores permitidos para grant_type son “authorization_code” o “refresh_token”.
    forbidden

    La llamada no autorizada acceder a este recurso.

    La llamada no autoriza el acceso Se está utilizando el token de otro usuario.



    Siguiente:
    Consulta usuario.


    Artículos relacionados:
    Server side
    Client side

    Please rate this

    Sincroniza publicaciones

    Una vez que tienes publicaciones activas en nuestro marketplace, es probable que debas actualizarlas y modificarlas en forma periódica para sincronizar el stock con otras plataformas con las que trabajas, pausar publicaciones, mejorar descripciones, actualizar precios, etc.
    Sigue esta guía para aprender cómo hacerlo.

    Contenidos:

    Consideraciones

    No todos los campos se pueden actualizar y esto cambiará si el artículo tiene ventas o no. Además, recuerda que tu artículo debe estar activo para poder modificarlo. Puedes modificar los valores para:

    • Título
    • Available_quantity
    • Precio
    • Video
    • Imágenes
    • Descripción*
    • Envío

    *No es posible modificar, sólo agregar un post.
    Cuando el artículo tiene ventas, no podrás cambiar ninguno de los siguientes campos del mismo:

    • Título
    • Estado
    • Modo de compra
    • Métodos de Pago distintos de MercadoPago
    • Dimensiones de envío
    • Garantía

    También recuerda que:

    • La categoría no se puede modificar a través de la API.
    • El tipo de publicación se puede modificar solo una vez.
    • El título no se puede modificar en un artículo con ventas salvo seas parte de las tiendas oficiales de MercadoLibre.

    Actualiza tu artículo

    Veamos un ejemplo básico de actualización del título y el precio de un artículo. Lo único que necesitas es el item_id del producto publicado y, por supuesto, el access_token del vendedor.

    Ejemplo:

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
      "title": "Your new title",
      "price": 1000
    }
    https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

    Bien: el título y precio de tu artículo fueron actualizados y deberías recibir un estado de respuesta con código 200 OK para confirmar que no hubo inconvenientes.
    Recuerda que puede tardar un momento hasta ver la información actualizada.

    Descripciones

    Es muy fácil actualizar una descripción y lo puedes hacer independientemente de que el artículo tenga o no ofertas. Pero como existen ciertas consideraciones que debes recordar al agregar o reemplazar descripciones, consulta nuestro artículo sobre descripciones para asegurarte de entenderlo bien.

    Imágenes

    Siempre puedes agregar o reemplazar imágenes de artículos; consulta nuestro tutorial Trabajar con imágenes para conocer la mejor forma de hacerlo.

    Tipos de publicación

    Cuando quieres más exposición para tu artículo, debes actualizar el tipo de publicación. Conoce los detalles y consideraciones y aprende cómo realizar una actualización en nuestro tutorial Tipos y actualización de publicaciones.

    Cambia el estado de las publicaciones

    Cualquier artículo publicado en nuestro marketplace puede tener diferentes estados; analiza la descripción de cada uno a continuación:

    cerrado: Finaliza tu publicación. Una vez cerrado, no se puede volver a activar, pero se puede volver a publicar.
    pausado: Pausa tu publicación. Una vez pausado, no será visible para otros usuarios de MercadoLibre, pero no se cerrará y se podrá reactivar más tarde.
    activo: Reactiva un artículo previamente pausado.

    Si necesitas realizar cambios en el estado del artículo, debes enviar uno de estos valores para el campo “estado”. Recuerda que el valor distingue entre mayúsculas y minúsculas y se debe enviar en minúscula.

    Para pausar un artículo activo, sigue el ejemplo a continuación:

    Ejemplo:

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
      "status":"paused"
    }
    https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

    ¡Excelente! Tu artículo ha sido pausado. Ahora puedes intentar reactivarlo realizando exactamente la misma llamada, pero enviando “activo” en lugar de “pausado” como valor del estado.
    Si actualmente tu artículo está cerrado y quieres volver a publicarlo, consulta nuestro artículo sobre volver a publicar para hacerlo rápido.
    Para más información sobre el estado del artículo, por favor consulta el artículo sobre el ciclo de vida de las publicaciones.

    Elimina publicaciones

    Después de eliminar una publicación no hay vuelta atrás; por eso, ten cuidado cuando realizas esta acción. Además, recuerda que no es necesario eliminar los artículos cerrados porque serán descartados automáticamente después de cierto tiempo.
    Si aún necesitas eliminar un artículo, por ejemplo artículos en estado: payment_required que no responderán al estado ‘cerrado’, deberás realizar los siguientes PUTs:

    Ejemplo:
    Primer paso

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
    "status": "closed"
    }
    https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

    Segundo paso

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
    "deleted":"true"
    }
    https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

    Notas:

    • En caso que al hacer el segunda PUT obtengas el error:
    • message: item optimistic locking
      error: conflict
      status: 409
      cause: array(0)
      Se debe a que deberás esperar unos segundos hasta que se actualice la información.

    • Una vez eliminada la publicación se continuará viendo en la VIP por un período de tiempo corto bajo la leyenda “publicación finalizada”.

    ¡Eso es! Tu artículo será eliminado.



    Siguiente:
    Gestiona contactos y visitas.

    Please rate this

    Recibe notificaciones

    Algunos eventos se producen del lado de Mercado Libre y la única forma de conocerlos es a través de notificaciones.
    Recibir notificaciones te permite tener un feed en tiempo real de los cambios que se producen en los diferentes recursos de nuestra la API.
    Por ejemplo, si publicaste un artículo y más tarde fue pausado, si alguien formuló una pregunta, si compraron un artículo o incluso lo pagaron y/o solicitó envío.
    ¡Una manera eficiente sin tener que consultar permanentemente nuestra API!

    Contenidos:

    Suscríbete a las notificaciones

    Si quieres comenzar a recibir notificaciones, debes dirigirte a nuestro administrador de aplicaciones, donde creaste tu aplicación por primera vez, editar los detalles y especificar los topics que recibirás.
    Nota: Si aún no creaste tu Aplicación, dirígete a la sección Crea tu aplicación.

    Topics

    – Callback URL de Notificaciones: Configura el URL público del dominio donde quieres recibir notificaciones para los diferentes topics. Por ejemplo: “http://myshoes-app.com/callbacks”.

    – Topics: Selecciona entre diferentes topics para recibir sus notificaciones.
    Aclaración: Ten en cuenta que los topics orders, created_orders y payments no son utilizados para vehículos, inmuebles y servicios ya que no se generan ventas ni pagos.

    Topics Disponibles

    • items – Recibirás notificaciones de cualquier cambio en un artículo que publicaste.
    • orders – Recibirás notificaciones de cualquier cambio que se realice en alguna de tus ventas confirmadas.
    • created_orders – Recibirás notificaciones de tus ventas recién creadas cuando ingresan por el flujo de Mercado Pago obligatorio.
      Sólo obtendrás datos del producto y cantidad de unidades ya que la compra aún no fue confirmada. No debes realizar ninguna acción hasta que no pase a “paid”.
      Sirve únicamente para reservar el stock, ya que si el comprador finalmente paga pero el item ya no tiene stock, el pago se devuelve automáticamente y se cancela la venta.
    • Aclaración: Una vez que la orden esté paga, se comenzarán a enviar las notificaciones al igual que desde “orders”, por lo que sugerimos elegir sólo uno de los topics para evitar eventos duplicados.

    • questions – Recibirás notificaciones de todas las preguntas formuladas o respondidas.
    • payments – Recibirás notificaciones cuando se crea un pago en una orden o el estado del mismo cambia.
    • pictures – Recibirás notificaciones sólo de las imágenes que por algún error no van a poder descargarse.
    • Nota: En paralelo se envía un e-mail automático al vendedor agrupando las imágenes que tuvieron problemas.

    Consideraciones

    • Los mensajes se enviarán y se reintentará enviarlos por un período de 12 horas. Después de ese período, si no son aceptados por la aplicación, serán descartados.
    • Como enviaremos un POST a tu URL, tu aplicación debe acusar recibo con un código de estado HTTP 200; de lo contrario, el mensaje será considerado no entregado y se reintentará enviarlo.
    • Tu aplicación debe enviar una respuesta en 20 segundos; de lo contrario, el límite de tiempo expirará, se considerará no entregada y se reintentará enviarla.

    ¿Qué eventos disparan notificaciones?

    items

    • Cambios en cualquiera de los atributos.
    • Cambios en el estado: La publicación debe ser revisada por un operador y el estado se modifica a “under_review” o se pausa y el estado se modifica a “pausado”.

    orders

    • Reducción de stock: Alguien compra uno de tus artículos y el stock se reduce. Se crea un nuevo pedido.
    • Pago: El comprador agrega un pago al pedido.
    • Envío: Existe nueva información de envío asociada al pedido o el estado del envío cambia a: pendiente, listo para imprimir, en tránsito, entregado, no entregado.
    • Feedback: El comprador te califica como vendedor o envías feedback al comprador. Se recibe un feed en el pedido.
    • Aclaración: orders está compuesto por bloques de otras apis, pero no todos los datos se muestran ya que no son necesarios. Esos bloques independientes pueden tener cambios, lo que genera eventos y posteriores notificaciones sobre la orden, aunque a veces no se vean cambios con respecto al json anterior.

    created_orders

    • Llegará la notificación de created_orders cuando se crea una orden que ingresó por el flujo de Mercado Pago obligatorio. Sirve únicamente para reservar el stock.
    • El resto de las notificaciones una vez que está “paid” la orden, son las mismas que las del topic “orders”. Si están ambos seleccionados, llegan notificaciones de los dos topics.

    questions

    • Recibes una nueva pregunta.
    • Respondes una pregunta.
    • Eliminas una pregunta que consideras inapropiada.

    payments

    • Se genera un pago.
    • El estado del pago cambia.

    pictures

    • Cuando alguna imagen por error no pudo descargarse.



    Aclaración: En caso que recibas notificaciones que consideres duplicadas ten en cuenta que existen eventos internos que no son visibles al integrador pero disparan notificaciones.

    Accede a los detalles

    Después de recibir una notificación sobre un tema, deberás realizar una solicitud GET al recurso para acceder a los detalles y luego, si guardaste el JSON anterior, comparar ambos.

    items

    Notification response:

    {
      "resource": "/items/MLB139876",
      "user_id": 1234,
      "topic": "items",
      "received": "2011-10-19T16:38:34.425Z",
      "sent" : "2011-10-19T16:40:34.425Z",
    }

    Con esta información podrás realizar un GET al recurso de ítems:

    curl -X GET https://api.mercadolibre.com/items/{Item_id}?access_token=ACCESS_TOKEN


    orders y created_orders

    Notification response:

    {
        "resource": "/orders/139876",
        "user_id": 1234,
        "topic": "orders",
        "received": "2011-10-19T16:38:34.425Z",
        "sent" : "2011-10-19T16:40:34.425Z",
    }

    Con esta información podrás realizar un GET al recurso de órdenes:

    curl -X GET https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN


    questions

    Notification response:

    {
      "resource": "/questions/139876",
      "user_id": 1234,
      "topic": "questions",
      "received": "2011-10-19T16:38:34.425Z",
      "sent" : "2011-10-19T16:40:34.425Z",
    }

    Con esta información podrás realizar un GET al recurso de questions:

    curl -X GET https://api.mercadolibre.com/questions/{Question_id}?access_token=ACCESS_TOKEN


    payments

    Notification response:

    {
      "resource": "/collections/1780558484",
      "user_id": 149218964,
      "topic": "payments",
      "application_id": 2470,
      "attempts": 1,
      "sent": "2016 - 01 - 15 T18: 12: 31.313 Z ",
      "received": "2016 - 01 - 15 T18: 12: 31.299 Z "
    }

    Con esta información podrás realizar un GET al recurso de collections:

    curl -X GET https://api.mercadolibre.com/collections/{Payment_id}?access_token=ACCESS_TOKEN


    pictures

    Notification response:

    {
      "messages": [
        {
          "_id": "123aaa456bbb789ccc",
          "application_id": "1234",
          "user_id": "123456789",
          "resource": "/pictures/12345-MLA1234567-20160729"/errors,
          "topic": "pictures",
          "sent": "2016-07-24T11:00:00.836Z",
          "received": "2016-07-24T11:00:00.836Z",
          "attempts": "2",
          "created_at": "2016-07-24T11:00:00.836Z"
        }
      ]
    }

    Con esta información podrás realizar un GET al recurso de picture:

    curl -X GET https://api.mercadolibre.com/pictures/{picture_id}/errors?access_token=ACCESS_TOKEN

    Deberás identificar por qué la imagen no se pudo procesar correctamente. Ver “Consideraciones y mejores prácticas para trabajar con imágenes

    Recurso historial de Feeds

    Guardamos un registro de tu historial de notificaciones y puedes acceder al mismo en cualquier momento llamando a nuestro recurso myfeeds.
    Ejemplo:

    curl -X GET https://api.mercadolibre.com/myfeeds?app_id={App_id}

    Respuesta:

    {
      "messages": [
      {
        "_id": "123aaa456bbb789ccc",
        "application_id": "1234",
        "user_id": "123456789",
        "resource": "/orders/12345678",
        "topic": "orders",
        "sent": "2014-10-24T11:00:00.836Z",
        "received": "2014-10-24T11:00:00.836Z",
        "attempts": "2",
        "http_code": "400",
        "created_at": "2014-10-24T11:00:00.836Z"
      }
    }
    }

    Nota: Ten en cuenta que por defecto sólo se mostrarán 10 notificaciones pero, puedes utilizar LIMIT y OFFSET para modificar la cantidad que quieres recibir tal como se muestra a continuación:

    https://api.mercadolibre.com/myfeeds?app_id=(APP_ID)&offset=1&limit=5



    Siguiente:
    Consultas avanzadas.

    Please rate this

    Gestiona Paquetes (Vehículos)

    Los Paquetes Promocionales son paquetes para publicaciones de Clasificados de Concesionarios de Autos.
    Para que un usuario pueda publicar como concesionaria masivamente mediante acuerdo comercial debe:

    • Configurar el usuario como car dealer.
    • Asignar un paquete de publicaciones.
    • Contratar un paquete de destaque (Opcional – Solo en MLB).

    NOTA: Para realizar pruebas, deberás enviar el usuario de test al canal de soporte para que sea activado como car dealer.

    Contenidos:

    Consultar paquetes por categoría

    Los valores posibles para las categorías classifieds_promotion_packs son diferentes en cada site. Los valores posibles son:
    {site_id}1743: Concesionario de autos.
    Por ejemplo, en Argentina, la categoría de paquetes para Concesionarios de Autos es MLA1743, mientras que en Brasil es MLB1743.
    Realiza una solicitud GET para buscar paquetes en una categoría específica:

    curl -X GET https://api.mercadolibre.com/categories/{category_id}/classifieds_promotion_packs

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/categories/MLA1743/classifieds_promotion_packs

    Respuesta:

    [
      {
        "id": "MPAB",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 15 Básico",
        "price": 819.17,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCAA",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 15
          }
        ]
      },
      {
        "id": "MPAE",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 15 Especial",
        "price": 1157.97,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCAS",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "gold",
            "available_listings": 5
          },
          {
            "listing_type_id": "silver",
            "available_listings": 10
          }
        ]
      },
      {
        "id": "MPAP",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 15 Premium",
        "price": 1629.87,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCAR",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 8
          },
          {
            "listing_type_id": "gold",
            "available_listings": 6
          },
          {
            "listing_type_id": "gold_premium",
            "available_listings": 1
          }
        ]
      },
      {
        "id": "MPBB",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 30 Básico",
        "price": 1242.67,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBA",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 30
          }
        ]
      },
      {
        "id": "MPBE",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 30 Especial",
        "price": 1617.77,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBS",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "gold",
            "available_listings": 10
          },
          {
            "listing_type_id": "silver",
            "available_listings": 20
          }
        ]
      },
      {
        "id": "MPBP",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 30 Premium",
        "price": 2246.97,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBR",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 16
          },
          {
            "listing_type_id": "gold_premium",
            "available_listings": 2
          },
          {
            "listing_type_id": "gold",
            "available_listings": 12
          }
        ]
      },
      {
        "id": "MPCB",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 300 Básico",
        "price": 2839.87,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCEA",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 300
          }
        ]
      },
      {
        "id": "MPCE2",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 300 Especial",
        "price": 5526.07,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCES",
        "max_upgrades": 300,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "gold",
            "available_listings": 90
          },
          {
            "listing_type_id": "silver",
            "available_listings": 210
          }
        ]
      },
      {
        "id": "MPCP2",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 300 Premium",
        "price": 11200.97,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCER",
        "max_upgrades": 300,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 180
          },
          {
            "listing_type_id": "gold",
            "available_listings": 95
          },
          {
            "listing_type_id": "gold_premium",
            "available_listings": 25
          }
        ]
      },
      {
        "id": "MPDB",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 60 Básico",
        "price": 1424.17,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCCA",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 60
          }
        ]
      },
      {
        "id": "MPDE",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 60 Especial",
        "price": 2162.27,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCCS",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "gold",
            "available_listings": 20
          },
          {
            "listing_type_id": "silver",
            "available_listings": 40
          }
        ]
      },
      {
        "id": "MPDP",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 60 Premium",
        "price": 3529.57,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCCR",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 32
          },
          {
            "listing_type_id": "gold_premium",
            "available_listings": 4
          },
          {
            "listing_type_id": "gold",
            "available_listings": 24
          }
        ]
      },
      {
        "id": "MPEB",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 100 Básico",
        "price": 2029.17,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCDA",
        "max_upgrades": 0,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "silver",
            "available_listings": 100
          }
        ]
      },
      {
        "id": "MPEE2",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 100 Especial",
        "price": 3118.17,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCDS",
        "max_upgrades": 300,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "gold",
            "available_listings": 30
          },
          {
            "listing_type_id": "silver",
            "available_listings": 70
          }
        ]
      },
      {
        "id": "MPEP2",
        "category_id": "MLA1743",
        "brand": "MLMOTORS",
        "description": "Paquete 100 Premium",
        "price": 5271.97,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCDR",
        "max_upgrades": 300,
        "quota_type": "reusable",
        "listing_details": [
          {
            "listing_type_id": "gold",
            "available_listings": 30
          },
          {
            "listing_type_id": "silver",
            "available_listings": 60
          },
          {
            "listing_type_id": "gold_premium",
            "available_listings": 10
          }
        ]
      }
    ]

    Consultar paquetes de publicación contratados por un usuario

    Ten en cuenta que actualmente hay dos modelos:
    1 – Paquete plano para publicar en una sola exposición y la opción de contratar un paquete de destaque para aumentar la exposición a demanda (disponible sólo en MLB)
    2- Paquete mixto con varios cupos de exposiciones diferentes, por ejemplo silver, oro y oro_premium, en los cuales el aumento o disminución de la exposición se logra mediante la finalización y relistado de la publicación (disponible en el resto de los sites)

    curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKEN;

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/users/135146148/classifieds_promotion_packs?access_token=$ACCESS_TOKEN;

    Respuesta:

    [
        {
           "id": 754985,
           "user_id": "135146148",
           "promotion_pack_id": "MPAB",
           "category_id": "MLU1743",
           "description": "Paquete 15 Básico",
           "package_type": "rotary",
           "status": "active",
           "date_created": "2013-05-23T15:34:48.498-04:00",
           "date_start": "2013-05-23T15:34:47.544-04:00",
           "date_expires": "2013-06-22T15:34:47.544-04:00",
           "date_stopped": null,
           "last_updated": "2013-05-23T15:35:48.211-04:00",
           "engagement_type": "none",
           "charge_id": 822129921,
           "remaining_listings": 15,
           "used_listings": 0,
           "listing_details": [
                {
                 "listing_type_id": "silver",
                 "available_listings": 15,
                 "used_listings": 0,
                 "remaining_listings": 15
                }
           ]
        }
    ]

    Consultar paquetes de destaque contratados por un usuario

    Recuerda que solo existen paquetes de destaques para MLB.
    De acuerdo con el nivel de exposición que desees para tus artículos, podrás contratar diferentes paquetes de destaque. Para más información te recomendamos leer el siguiente tutorial.

    curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?package_content=upgrades&status=active&access_token=$ACCESS_TOKEN;

    Respuesta:

    [
        {
            "id": 1584151,
            "user_id": "XXXXXX",
            "promotion_pack_id": "IPUPGGP5INT",
            "category_id": "MLA1459",
            "brand": "MLREALESTATE",
            "description": "5 Destaques Oro Premium Interior",
            "package_type": "rotary",
            "status": "active",
            "date_created": "2017-08-31T09:08:29.124-04:00",
            "date_start": "2017-08-31T09:08:29.113-04:00",
            "date_expires": "2017-09-30T09:08:29.113-04:00",
            "date_stopped": null,
            "last_updated": "2017-08-31T09:25:57.860-04:00",
            "engagement_type": "none",
            "package_content": "upgrades",
            "charge_id": 3152387845,
            "bonus_id": null,
            "remaining_listings": 0,
            "used_listings": 5,
            "quota_type": "reusable",
            "next_promotion_pack_id": null,
            "parent_promotion_pack_id": null,
            "listing_details": [
                {
                    "listing_type_id": "gold_premium",
                    "available_listings": 5,
                    "used_listings": 5,
                    "remaining_listings": 0
                }
            ]
        },
        {
            "id": 1584150,
            "user_id": "XXXXXX",
            "promotion_pack_id": "IPUPGG5INT",
            "category_id": "MLA1459",
            "brand": "MLREALESTATE",
            "description": "5 Destaques Oro Interior",
            "package_type": "rotary",
            "status": "active",
            "date_created": "2017-08-31T09:08:28.752-04:00",
            "date_start": "2017-08-31T09:08:28.742-04:00",
            "date_expires": "2017-09-30T09:08:28.742-04:00",
            "date_stopped": null,
            "last_updated": "2017-08-31T09:25:57.747-04:00",
            "engagement_type": "none",
            "package_content": "upgrades",
            "charge_id": 3152387844,
            "bonus_id": null,
            "remaining_listings": 0,
            "used_listings": 5,
            "quota_type": "reusable",
            "next_promotion_pack_id": null,
            "parent_promotion_pack_id": null,
            "listing_details": [
                {
                    "listing_type_id": "gold",
                    "available_listings": 5,
                    "used_listings": 5,
                    "remaining_listings": 0
                }
            ]
        }
    ]

    Descripción de recursos

    atributo descripción
    id Identificador único del paquete.
    user_id ID único del usuario que contrató el paquete.
    category_id Categoría del paquete.
    description nombre del paquete.
    package_type: detalle del paquete.
    status los valores posibles del estado del paquete son:
    activo: el usuario puede utilizar este paquete para publicar. Se descontará una available_listing cuando lo haga.
    pendiente: el paquete aún no está activo.
    finalizado: paquete expirado.
    date_created fecha de creación del paquete.
    date_start: fecha de activación del paquete.
    date_expires fecha de expiración del paquete.
    date_stopped fecha de finalización del paquete.
    last_updated última actualización del paquete.
    engagement_type Los valores posibles son:
    “ninguno”: El paquete se contrató por única vez.
    “recontratación”: Cuando el paquete expira, se recontratará automáticamente un package_type similar.
    charge_id ID único del cargo generado durante la contratación del paquete.
    listing_details información detallada sobre tipos y disponibilidad de publicaciones.
    listing_type_id listing_type asociado con el paquete.
    available_listings cantidad de publicaciones que el usuario obtiene con el paquete.
    used_listings publicaciones ya utilizadas.
    remaining_listings publicaciones restantes disponibles.

    Verificar si un usuario tiene un listing_type específico disponible

    curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/silver?access_token=$ACCESS_TOKEN

    Destaque de un artículo

    Para destacar una publicación (disponible sólo en MLB) deberás realizar el siguiente post, recuerda que para poder realizar esta acción el usuario debe tener un paquete de destaque contratado previamente:

    POST https://api.mercadolibre.com/items/{item_id}/listing_type?access_token=$ACCESS_TOKEN

    Ejemplo:

    curl -X POST 'https://api.mercadolibre.com/items/MLA111111111/listing_type?access_token=$ACCESS_TOKEN' -d '{"id":"listing_type"}'

    Respuesta:

    {
      "id": "MLA111111111",
      "site_id": "MLA",
      "title": "Test 10 No Ofertar",
      "subtitle": null,
      "seller_id": 184854440,
      "category_id": "MLA24337",
      "official_store_id": null,
      "price": 100,
      "base_price": 100,
      "original_price": null,
      "currency_id": "ARS",
      "initial_quantity": 1,
      "available_quantity": 1,
      "sold_quantity": 0,
      "sale_terms": [
      ],
      "buying_mode": "classified",
      "listing_type_id": "gold",
      "start_time": "2017-12-22T19:48:46.000Z",
      "stop_time": "2018-01-25T16:07:12.000Z",
      "condition": "used",
      "permalink": "http://auto.mercadolibre.com.ar/MLA-563940625-test-10-no-ofertar-_JM",
      "thumbnail": "http://mla-s1-p.mlstatic.com/808917-MLA26557857454_122017-I.jpg",
      "secure_thumbnail": "https://mla-s1-p.mlstatic.com/808917-MLA26557857454_122017-I.jpg",
      "pictures": [
        {
          "id": "808917-MLA26557857454_122011",
          "url": "http://mla-s1-p.mlstatic.com/808917-MLA26557857454_122017-O.jpg",
          "secure_url": "https://mla-s1-p.mlstatic.com/808917-MLA26557857454_122017-O.jpg",
          "size": "500x375",
          "max_size": "1024x768",
          "quality": ""
        }
          ],
      "video_id": null,
      "descriptions": [
        {
          "id": "MLA698666322-1525861980"
        }
      ],
      "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": "not_specified",
        "store_pick_up": false
      },
      "international_delivery_mode": "none",
      "seller_address": {
        "comment": "",
        "address_line": "test 2581",
        "zip_code": "5001",
        "city": {
          "id": "TUxBQ0NBUGNiZGQx",
          "name": "Córdoba"
        },
        "state": {
          "id": "AR-X",
          "name": "Córdoba"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "search_location": {
          "neighborhood": {
            "id": "TUxBQk9UUjI3MjVa",
            "name": ""
          },
          "city": {
            "id": "TUxBQ0NBUGNiZGQx",
            "name": "Córdoba"
          },
          "state": {
            "id": "TUxBUENPUmFkZGIw",
            "name": "Córdoba"
          }
        },
        "latitude": -31.386787,
        "longitude": -64.21307,
        "id": 177301981
      },
      "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
      },
      "location": {
        "address_line": "test 2581",
        "zip_code": "",
        "neighborhood": {
          "id": "",
          "name": ""
        },
        "city": {
          "id": "TUxBQ0NBUGNiZGQx",
          "name": "Córdoba"
        },
        "state": {
          "id": "TUxBUENPUmFkZGIw",
          "name": "Córdoba"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "open_hours": "",
        "latitude": -34.48755,
        "longitude": -58.56987
      },
      "geolocation": {
        "latitude": -34.48755,
        "longitude": -58.56987
      },
      "coverage_areas": [
      ],
      "attributes": [
        {
          "id": "COLOR",
          "name": "Color",
          "value_id": "52055",
          "value_name": "Blanco",
          "value_struct": null,
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "STEERING",
          "name": "Dirección",
          "value_id": "370873",
          "value_name": "Asistida",
          "value_struct": null,
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "TRACTION_CONTROL",
          "name": "Control de tracción",
          "value_id": null,
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "HAS_AIR_CONDITIONING",
          "name": "Aire acondicionado",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "HAS_LEATHER_UPHOLSTERY",
          "name": "Tapizado de cuero",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "HAS_ISOFIX",
          "name": "Sistema ISOFIX",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "DFLT",
          "attribute_group_name": "Otros"
        },
        {
          "id": "HAS_ONBOARD_COMPUTER",
          "name": "Computadora de abordo",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "EQUIPAMIENTO",
          "attribute_group_name": "Equipamiento"
        },
        {
          "id": "BRAND",
          "name": "Marca",
          "value_id": "75966",
          "value_name": "Mercedes Benz",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "DOORS",
          "name": "Puertas",
          "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 combustible",
          "value_id": "64364",
          "value_name": "Nafta",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "KILOMETERS",
          "name": "Kilómetros",
          "value_id": null,
          "value_name": "180000 km",
          "value_struct": {
            "number": 180000,
            "unit": "km"
          },
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MODEL",
          "name": "Modelo",
          "value_id": "503625",
          "value_name": "Clase C",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "TRANSMISSION",
          "name": "Transmisión",
          "value_id": "370876",
          "value_name": "Automática",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "TRIM",
          "name": "Versión",
          "value_id": null,
          "value_name": "250 CGI BLUEEFFICIENCY AVANTGARDE AUT",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "VEHICLE_BODY_TYPE",
          "name": "Tipo",
          "value_id": "452758",
          "value_name": "Sedán",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "VEHICLE_TYPE",
          "name": "Tipo de vehículo",
          "value_id": "398351",
          "value_name": "Autos y camionetas",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "VEHICLE_YEAR",
          "name": "Año",
          "value_id": null,
          "value_name": "2011",
          "value_struct": null,
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "HAS_ABS_BRAKES",
          "name": "Frenos ABS",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "HAS_CURTAIN_AIRBAG",
          "name": "Airbag de cortina",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "HAS_FRONT_FOGLIGHTS",
          "name": "Faros antinieblas delanteros",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "HAS_RAIN_SENSOR",
          "name": "Sensor de lluvia",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "HAS_SIDE_IMPACT_AIRBAG",
          "name": "Airbag laterales",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "HAS_STABILITY_CONTROL",
          "name": "Control de estabilidad",
          "value_id": "242085",
          "value_name": "Sí",
          "value_struct": null,
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        }
      ],
      "warnings": [
      ],
      "listing_source": "",
      "variations": [
      ],
      "status": "active",
      "sub_status": [
      ],
      "tags": [
        "only_html_description"
      ],
      "warranty": null,
      "catalog_product_id": "MLA8689901",
      "domain_id": "MLA-CARS_AND_VANS",
      "parent_item_id": null,
      "differential_pricing": null,
      "deal_ids": [
      ],
      "automatic_relist": false,
      "date_created": "2017-12-22T19:48:47.000Z",
      "last_updated": "2017-12-27T01:24:54.000Z"
    }

    Siguiente:
    Categorías y atributos

    Please rate this

    Consultas sobre el usuario

    Si ya lograste registrar tu aplicación, autenticarte y generar un usuario de Test, el siguiente paso a seguir es aprender a trabajar con usuarios (vendedores y compradores):

    Contenidos:

    Registrarme como concesionaria (Opcional)

    Si eres una inmobiliaria, puedes registrar tu usuario como tal para obtener acceso a nuestros paquetes promocionales para inmobiliarias. Para hacerlo, accede a la sección Ayuda > Configuración de mi cuenta > Registrarme como empresa, concesionaria e inmobiliaria.
    Screenshot_4
    Una vez allí, haz clic en la pestaña “Tus datos y registración” y luego, en el link “Registrarme como inmobiliaria”. A este paso no se puede acceder a través de la API, pero podrás verlo una vez que te registres como inmobiliaria.

    Consultar mis datos personales

    Si te encuentras logueado en MercadoLibre y tienes un token podrás hacer la siguiente llamada y conocer qué información se encuentra relacionada a tu usuario:

    Ejemplo:

    curl  - X GET https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN

    Respuesta:

    {
      "id": 202593498,
      "nickname": "TETE2870021",
      "registration_date": "2016-01-06T11:31:42.000-04:00",
      "country_id": "AR",
      "address": {
      "state": "AR-C",
      "city": "Palermo"
      },
      "user_type": "real_estate_agency",
      "tags": [
      "real_estate_agency",
      "test_user",
      "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
      "seller_reputation": {
      "level_id": null,
      "power_seller_status": null,
      "transactions": {
        "period": "historic",
        "total": 0,
        "completed": 0,
        "canceled": 0,
        "ratings": {
          "positive": 0,
          "negative": 0,
          "neutral": 0
        }
      }
      },
      "buyer_reputation": {
      "tags": [
      ]
      },
      "status": {
      "site_status": "active"
      }
    }

    Consultar datos de usuarios terceros

    Si no tienes el id, pero conoces el nickname y el site al que pertenece un usuario, podrás obtenerlo con la siguiente búsqueda:

    Llamada:

    https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

    Ejemplo:

    https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

    Respuesta:

    {
      "site_id": "MLA",
      "seller": {
      "id": 202593498,
      "seller_reputation": {
        "power_seller_status": null
      },
      "real_estate_agency": false,
      "car_dealer": false,
      "tags": [
      ]
      }

    Si deseas consultar los datos de usuarios terceros, podrás identificar dos niveles de información: los datos públicos, aquellos que puedes encontrar navegando el perfil en MercadoLibre de cualquier otro usuario y los datos privados, que no serán visibles a menos que tengas los permisos del usuario y un token válido para trabajar en su nombre.
    En ambos casos, lo primero que deberás conocer es el id del usuario.

    ¿Cómo obtener el Id de un usuario?

    Si no tienes el id, pero conoces el nickname y el site al que pertenece un usuario, podrás obtener su Id con la siguiente búsqueda:

    Llamada:

    https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

    Ejemplo:

    https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

    Respuesta:

    {
      "site_id": "MLA",
      "seller": {
      "id": 202593498,
      "seller_reputation": {
        "power_seller_status": null
      },
      "real_estate_agency": false,
      "car_dealer": false,
      "tags": [
      ]
      },
      "paging": {
      "total": 2,
      "offset": 0,
      "limit": 50
      },
      "results": [
      {
        "id": "MLA598903377",
        "site_id": "MLA",
        "title": "Test Item - Nao Ofertar",
        "subtitle": null,
        "seller": {
          "id": 202593498,
          "power_seller_status": null,
          "car_dealer": false,
          "real_estate_agency": false,
          "tags": [
          ]
        },
        "price": 200,
        "currency_id": "ARS",
        "available_quantity": 1,
        "sold_quantity": 0,
        "buying_mode": "buy_it_now",
        "listing_type_id": "bronze",
        "stop_time": "2016-03-06T17:16:49.000Z",
        "condition": "new",
        "permalink": "http://articulo.mercadolibre.com.ar/MLA-598903377-test-item-nao-ofertar-_JM",
        "thumbnail": "http://mla-s2-p.mlstatic.com/546311-MLA20539702714_012016-I.jpg",
        "accepts_mercadopago": true,
        "installments": {
          "quantity": 6,
          "amount": 42.33,
          "currency_id": "ARS"
        },
        "address": {
          "state_id": "AR-C",
          "state_name": "Capital Federal",
          "city_id": "",
          "city_name": "Palermo"
        },
        "shipping": {
          "free_shipping": false,
          "mode": "not_specified"
        },
        "seller_address": {
          "id": 175597910,
          "comment": "",
          "address_line": "",
          "zip_code": "",
          "country": {
            "id": "AR",
            "name": "Argentina"
          },
          "state": {
            "id": "AR-C",
            "name": "Capital Federal"
          },
          "city": {
            "id": "",
            "name": "Palermo"
         },
          "latitude": -34.571148,
          "longitude": -58.423298
        },
        "attributes": [
        ],
        "original_price": null,
        "category_id": "MLA374515",
        "official_store_id": null
      },
      {
        "id": "MLA599121050",
        "site_id": "MLA",
        "title": "Item De Test - No Ofertar",
        "subtitle": null,
        "seller": {
          "id": 202593498,
          "power_seller_status": null,
          "car_dealer": false,
          "real_estate_agency": false,
          "tags": [
          ]
        },
        "price": 1000,
        "currency_id": "ARS",
        "available_quantity": 1,
        "sold_quantity": 0,
        "buying_mode": "buy_it_now",
        "listing_type_id": "bronze",
        "stop_time": "2016-03-07T20:12:41.000Z",
        "condition": "new",
        "permalink": "http://articulo.mercadolibre.com.ar/MLA-599121050-item-de-test-no-ofertar-_JM",
        "thumbnail": "http://mla-s2-p.mlstatic.com/493311-MLA20538550251_012016-I.jpg",
        "accepts_mercadopago": true,
        "installments": {
          "quantity": 6,
            "amount": 211.65,
          "currency_id": "ARS"
        },
        "address": {
          "state_id": "AR-C",
          "state_name": "Capital Federal",
          "city_id": "",
          "city_name": "Palermo"
        },
        "shipping": {
          "free_shipping": false,
          "mode": "not_specified"
        },
        "seller_address": {
          "id": 175597910,
          "comment": "",
          "address_line": "",
          "zip_code": "",
          "country": {
            "id": "AR",
            "name": "Argentina"
          },
          "state": {
            "id": "AR-C",
            "name": "Capital Federal"
          },
          "city": {
            "id": "",
            "name": "Palermo"
          },
          "latitude": -34.571148,
          "longitude": -58.423298
        },
        "attributes": [
        ],
        "original_price": null,
        "category_id": "MLA90105",
        "official_store_id": null
      }
      ],
      "secondary_results": [
      ],
      "related_results": [
      ],
      "sort": {
      "id": "relevance",
      "name": "More relevant"
      },
      "available_sorts": [
      {
       "id": "price_asc",
        "name": "Lower price"
      },
      {
        "id": "price_desc",
        "name": "Higher price"
      }
      ],
      "filters": [
      ],
      "available_filters": [
      {
        "id": "category",
        "name": "Categories",
        "type": "text",
        "values": [
          {
            "id": "MLA1648",
            "name": "Computación",
            "results": 1
          },
          {
            "id": "MLA1430",
            "name": "Ropa y Accesorios",
            "results": 1
          }
        ]
      },
      {
        "id": "state",
        "name": "Location",
        "type": "text",
        "values": [
          {
            "id": "TUxBUENBUGw3M2E1",
            "name": "Capital Federal",
            "results": 2
          }
        ]
      },
      {
        "id": "accepts_mercadopago",
       "name": "MercadoPago filter",
        "type": "boolean",
        "values": [
          {
            "id": "yes",
            "name": "With MercadoPago",
            "results": 2
          }
        ]
      },
      {
        "id": "installments",
        "name": "Pago",
        "type": "text",
        "values": [
          {
            "id": "yes",
            "name": "Installments",
            "results": 2
          },
          {
            "id": "no_interest",
            "name": "Sin interés",
            "results": 0
          }
        ]
      },
      {
        "id": "condition",
        "name": "Condition filter",
        "type": "text",
        "values": [
          {
            "id": "new",
            "name": "New",
            "results": 2
          }
        ]
      },
      {
        "id": "buying_mode",
        "name": "Buying mode filter",
        "type": "text",
        "values": [
          {
            "id": "buy_it_now",
            "name": "Buy it now",
            "results": 2
          }
        ]
      },
      {
        "id": "has_pictures",
        "name": "Items with images filter",
        "type": "boolean",
        "values": [
          {
            "id": "yes",
            "name": "With pictures",
            "results": 2
          }
        ]
      }
      ]
    }

    Consultar información pública de un usuario

    Muy bien, de ésta manera ya conoces el Id del usuario, por lo cual puedes realizar la llamada al recurso de users de la siguiente manera y obtener la información pública del usuario que deseas:

    Llamada:

    curl GET -X  https://api.mercadolibre.com/users/{User_id}

    Ejemplo:

    GET -X  https://api.mercadolibre.com/users/205159033

    Respuesta:

    {
      "id": 205159033,
      "nickname": "TETE4358231",
      "registration_date": "2016-02-04T13:49:09.000-04:00",
      "country_id": "AR",
      "address": {
      "state": "AR-C",
      "city": "Palermo"
      },
      "user_type": "car_dealer",
      "tags": [
      "car_dealer",
      "test_user",
      "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE4358231",
      "seller_reputation": {
      "level_id": null,
      "power_seller_status": null,
      "transactions": {
        "period": "historic",
        "total": 0,
        "completed": 0,
       "canceled": 0,
        "ratings": {
          "positive": 0,
          "negative": 0,
          "neutral": 0
        }
      }
      },
      "buyer_reputation": {
      "tags": [
      ]
      },
      "status": {
      "site_status": "active"
      }
    }

    Consultar información privada de un usuario que ha aceptado el uso de mi aplicación

    Para obtener los datos privados de un usuario, solo debes apendar el ACCESS_TOKEN del usuario al final de la llamada que realizaste anteriormente.

    Llamada:

    curl GET -X  https://api.mercadolibre.com/users/{User_id}?access_token=¢ACCESS_TOKEN

    Ejemplo:

    curl GET -X  https://api.mercadolibre.com/users/202593498?access_token=¢ACCESS_TOKEN

    Respuesta:

    {
      "id": 202593498,
      "nickname": "TETE2870021",
      "registration_date": "2016-01-06T11:31:42.000-04:00",
      "first_name": "Test",
      "last_name": "Test",
      "country_id": "AR",
      "email": "test_user_50698062@testuser.com",
      "identification": {
      "type": "DNI",
      "number": "1111111"
      },
      "address": {
      "state": "AR-C",
      "city": "Palermo",
      "address": "Test Address 123",
      "zip_code": "1414"
      },
      "phone": {
      "area_code": "01",
      "number": "1111-1111",
      "extension": "",
      "verified": false
      },
      "alternative_phone": {
      "area_code": "",
      "number": "",
      "extension": ""
      },
      "user_type": "real_estate_agency",
      "tags": [
      "real_estate_agency",
      "test_user",
      "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
      "shipping_modes": [
      "custom",
      "not_specified"
      ],
      "seller_experience": "ADVANCED",
      "seller_reputation": {
      "level_id": null,
      "power_seller_status": null,
      "transactions": {
        "period": "historic",
        "total": 0,
        "completed": 0,
        "canceled": 0,
        "ratings": {
          "positive": 0,
          "negative": 0,
          "neutral": 0
        }
      }
      },
      "buyer_reputation": {
      "canceled_transactions": 0,
      "transactions": {
        "period": "historic",
        "total": null,
        "completed": null,
        "canceled": {
          "total": null,
          "paid": null
        },
        "unrated": {
          "total": null,
          "paid": null
        },
        "not_yet_rated": {
          "total": null,
          "paid": null,
          "units": null
        }
      },
      "tags": [
      ]
      },
      "status": {
      "site_status": "active",
      "list": {
        "allow": true,
        "codes": [
        ],
        "immediate_payment": {
          "required": false,
          "reasons": [
          ]
        }
      },
      "buy": {
        "allow": true,
        "codes": [
        ],
        "immediate_payment": {
          "required": false,
          "reasons": [
          ]
        }
      },
      "sell": {
        "allow": true,
        "codes": [
        ],
        "immediate_payment": {
          "required": false,
          "reasons": [
          ]
        }
      },
      "billing": {
        "allow": true,
        "codes": [
        ]
      },
      "mercadopago_tc_accepted": true,
      "mercadopago_account_type": "personal",
      "mercadoenvios": "not_accepted",
      "immediate_payment": false,
      "confirmed_email": false,
      "user_type": "eventual",
      "required_action": ""
      },
      "credit": {
      "consumed": 100,
      "credit_level_id": "MLA1"
      }
    }

    Puedes observar que esta vez obtuviste mayor cantidad de datos del usuario: Su nombre completo, email, teléfono, domicilio, etc. Te solicitamos que no reveles estos datos públicamente ya que pueden comprometer al usuario.

    Actualizar datos de usuario

    Puedes utilizar nuestros recursos para actualizar tu información de usuario después del registro. Es un tema común, porque en esta instancia no se te solicita que completes tu domicilio o identificación personal, pero debes tenerlos completos o no podrás publicar artículos en MercadoLibre.
    Para actualizar tu información de usuario sigue el ejemplo:

    curl -X PUT -H "Content-Type: application/json" -d
    {
    "identification_type": "DNI",
    "identification_number": "33333333",
    "address": "Triunvirato 5555",
    "state":"AR-C",
    "city":"Capital Federal",
    "zip_dode": "1431",
    "phone":{
            "area_code":"011",
            "number":"4444-4444",
            "extension":"001"
          },
    "first_name":"Pedro",
    "last_name": "Picapiedras",
    "company":{
              "corporate_name":"Acme",
              "brand_name":"Acme Company"
            },
    "mercadoenvios": "accepted"
    }
    
    https://api.mercadolibre.com/users/{User_id}?access_token=

    ¡Felicitaciones, actualizaste tu información de usuario! Recuerda enviar solamente los campos que deseas actualizar.

    Usuario Vendedor S = P (sell equal pay)

    Si deseas que todas tus operaciones sean exclusivamente a través de Mercado Pago deberás indicar en la información de tu usuario que solo aceptas la modalidad S = P (sell equal pay). De esta manera quedará deshabilitada la opción “Acuerdo con el vendedor”.

    PUT:

     curl -XPUT -H "Content-type: application/json" -d 
    
    '{
        "reason": "by_user"
    }'
    
    https://api.mercadolibre.com/users/{user_id}/immediate_payment?access_token=$ACCESS_TOKEN

    Si querés dejar de aceptar como única opción Mercado Pago, puedes eliminar la marca de la siguiente manera:

     curl -XDELETE https://api.mercadolibre.com/users/{user_id}/immediate_payment/by_user?access_token=$ACCESS_TOKEN



    Artículos relacionados:
    Direcciones del usuario.


    Siguiente:
    Gestiona paquetes.

    Please rate this

    Gestiona contactos y visitas

    Cuando los usuarios buscan en los artículos clasificados, pueden contactar al propietario del artículo a través de un formulario que se muestra en la publicación o pueden ver el teléfono del propietario.
    Existe una diferencia respecto del funcionamiento entre los usuarios que iniciaron sesión y los usuarios invitados. Cuando los usuarios invitados realizan una pregunta sobre tu artículo, el contacto se dirige directamente al buzón de entrada de tu correo electrónico y se mostrará en nuestro recurso de contacts, porque no sigue el flujo de preguntas habitual. Cuando un usuario que tiene cuenta en nuestro sitio e inició sesión realiza una pregunta, sigue el flujo de preguntas habitual y puedes utilizar el recurso de questions.

    Para ver cómo trabajar con preguntas de usuarios que iniciaron sesión, consulta nuestra guía de Administración de preguntas y respuestas.

    Guía de contactos clasificados

    Esta guía te ayudará a recolectar datos sobre preguntas y visualizaciones del teléfono en tus artículos clasificados. Se trata de una API de solo lectura, muy útil para llevar métricas de tus artículos clasificados. Puedes consultar datos sobre preguntas y llevar un registro de cuántas veces se hizo clic en la opción ‘Ver teléfono’. Puedes consultar por usuario, artículo, fechas y períodos de tiempo.

    Contenidos:

    Descripción de parámetros

    Tipo Parámetro Descripción
    Entero {userId} ID de usuario.
    Entero {itemId} ID de artículo.
    Fecha {dateFrom} Fecha, en formato ISO, que define el inicio de la consulta.
    Fecha {dateTo} Fecha, en formato ISO, que define el fin de la consulta.
    Entero {limit} Opcional. Cantidad máxima de artículos a devolver.
    Entero {offset} Opcional. Paginación.
    Entero {last} Opcional. Denota cuántas horas/días atrás cubrirá la muestra.
    Cadena {unit} Unidad de consulta, valores posibles: [“día”, “hora”].
    Fecha {ending} Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales.
    Cadena {order} Opcional. Clasifica los resultados por fecha: [“desc”, “asc”] (por defecto es “asc”).

    Preguntas totales

    Puedes acceder a las preguntas totales que tuvo un artículo o las preguntas totales que tuvo un vendedor en todos sus artículos en un rango de fechas.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999

    Respuesta:

    {
    	"date_from": "2014-08-01T00:00:00.000-03:00",
    	"date_to": "2014-08-02T23:59:59.999",
    	"item_id": "MLV421672596",
    	"total": 9
    }

    Preguntas con fecha

    Este recurso te permite acceder a las preguntas sobre un artículo específico o por vendedor para un período de tiempo específico. Además, accedes a detalles sobre contactos realizados en modo invitado (usuarios que no iniciaron sesión o que no están registrados) entre intervalos de tiempo, por hora o por día.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}

    Si necesitas concatenar artículos, haz lo siguiente:

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour

    Respuesta:

    {
    	"item_id": "MLA510272257",
    	"total": 0,
    	"date_from": "2014-08-06T12:00:00Z",
    	"date_to": "2014-08-06T14:00:00Z",
    	"last": 2,
    	"unit": "hour",
    	"results": [
        	{
            	"date": "2014-08-06T12:00:00Z",
            	"total": 0
        	},
        	{
          	  "date": "2014-08-06T13:00:00Z",
            	"total": 0
        	}
    	]
    }

    Clicks en teléfonos de contacto

    Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario en rangos de fechas.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999

    Respuesta:

    {
    	"date_from": "2014-05-28T00:00:00.000-03:00",
    	"date_to": "2014-05-29T23:59:59.999",
    	"total": 71,
    	"user_id": "52366166"
    }

    Clicks en teléfonos de contacto con fecha

    Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario durante cierto período de tiempo. Además de entregar las visitas totales, la información se detalla y agrupa por intervalo de tiempo.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

    Si necesitas concatenar artículos:

    curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00

    Respuesta:

    [
    	{
        	"item_id": "MLA510272257",
        	"total": 0,
        	"date_from": "2014-05-28T02:00:00Z",
        	"date_to": "2014-05-28T04:00:00Z",
        	"last": 2,
        	"unit": "hour",
        	"results": [
            	{
                	"date": "2014-05-28T02:00:00Z",
                	"total": 0
            	},
            	{
                	"date": "2014-05-28T03:00:00Z",
                	"total": 0
            	}
        	]
    	},
    	{
        	"item_id": "MLA489747739",
        	"total": 0,
        	"date_from": "2014-05-28T02:00:00Z",
      	  "date_to": "2014-05-28T04:00:00Z",
        	"last": 2,
        	"unit": "hour",
        	"results": [
            	{
                	"date": "2014-05-28T02:00:00Z",
                	"total": 0
            	},
            	{
                	"date": "2014-05-28T03:00:00Z",
                	"total": 0
            	}
        	]
    	}
    ]



    Siguiente:
    Recibe notificaciones.

    Please rate this

    Consultas avanzadas

    Si tu intención es que vendedores usen la aplicación que desarrollaste para potenciar su negocio, ten en cuenta que hay muchísima información de mercado que puedes consumir y será fructífera para ayudar a que vendedores creen estrategias de venta y tomen decisiones acertadas a tiempo. También podrías desarrollar un sistema que compare precios y atributos entre distintos tipos de anuncios.

    ¡Sigue nuestras guías para aprender a sacarle provecho a cada recurso!

    Ayuda a tus anunciantes a estar siempre un paso adelante en sus negocios. En primer lugar debes saber que no podrás obtener datos privados sobre usuarios que no han dado permisos a tu aplicación. Sin embargo, hay datos públicos que puedes obtener sobre éstos usuarios como quienes publican en las mismas categorías que tu, la cantidad de anuncios publicados, qué precios y atributos manejan en sus anuncios, en qué categorías publican y cuántos contactos y visitas reciben por día.

    Con tu sistema, puedes sugerir a los vendedores cuál es mejor precio para vender sus productos y mantener tu competitividad al analizar el precio del mismo tipo de productos publicados en MercadoLibre. Para hacerlo, es conveniente aprender cómo buscar artículos por categoría, consultar el campo precio de esos artículos y calcular el promedio.

    También puedes desarrollar un sistema que analice los precios y atributos de los artículos del mercado clasificados para que los compradores puedan comparar, localizar y encontrar exactamente lo que están buscando.


    Artículos relacionados

    Please rate this

    Guía para Vehículos

    Los vehículos son publicaciones de clasificados donde los datos de contacto de los vendedores son públicos, lo que facilita a los compradores comunicarse con los vendedores directamente, y el pago y la entrega se coordina entre las contrapartes sin oferta de por medio.

    Puedes crear aplicaciones que publiquen vehículos y comparen precios y características entre similares, tomen métricas de los contactos, guarden favoritos, envíen recordatorios, etc.

    Siguiente:
    Autenticación y Autorización

    Please rate this