Contenidos

→Publicar desde una publicación existente
→Publicar directamente en catálogo
→Creación automática de publicaciones de catálogo



Publicar desde una publicación existente (optin)

Una vez que valides que tu publicación existente es elegible para catálogo y obtengas el catalog_product_id activo, desde el recurso product search, que corresponde exactamente a lo que estás publicando, debes crear la publicación de catálogo con un POST a /items/catalog_listings.


Variaciones

En los dominios donde actualmente existe catálogo, sus publicaciones no admiten variaciones porque ya están asociadas a un producto específico. Por tanto, si tu publicación original tenía variaciones, tendrás una publicación de catálogo por cada una de ellas.
La información relevante de tus variaciones, como el color del artículo, no se perderá sino que estará reflejada en los atributos del producto de catálogo. En el futuro, es posible que existan dominios donde el producto nunca termine de especificar perfectamente lo que se vende, por ejemplo en ropa para el talle, y es factible que estén permitidas las variaciones. Te avisaremos cuando eso ocurra.

Si tu ítem existente contiene variaciones deberás hacer un POST por cada una de las mismas enviando el campo variation_id en el cuerpo del POST.


Ejemplo sobre un ítem con variaciones:

curl -X POST https://api.mercadolibre.com/items/catalog_listings?access_token=$ACCESS_TOKEN
{
  "item_id":"MLA1234",
  "variation_id": 4321,
  "catalog_product_id":"MLA9876"
}

Ejemplo sobre un ítem sin variaciones:

curl -X POST https://api.mercadolibre.com/items/catalog_listings?access_token=$ACCESS_TOKEN
{
  "item_id":"MLA1234",
  "catalog_product_id":"MLA9876" 
}

Ejemplo acotado de respuesta a la creación de un ítem:

Respuesta:

{
    "id": "MLA1234",
    "site_id": "MLA",
    "title": "Samsung Galaxy J7 Prime 16 Gb Negro",
    "warranty": null,
    "catalog_product_id": "MLA9876",
    "domain_id": "MLA-CELLPHONES",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-08-02T11:33:31.270Z",
    "last_updated": "2019-08-02T11:33:31.270Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": true,
    "item_relations": [
        {
            "id": "MLA123456789",
            "variation_id": null,
            "stock_relation": 1
        }
    ]
}

Además, ten en cuenta:

  • Si el ítem es enviado sin variaciones cuando sí las tiene, la respuesta será un error 400.
  • El campo catalog_product_id es obligatorio en el POST para ítems con o sin variaciones.

Para realizar una publicación directa en catálogo es necesario, en primer lugar, conseguir el catalog_product_id que corresponde exactamente con el producto a publicar, consultando al recurso product search obtienes una sugerencia de productos en base a ciertos parámetros de búsqueda.

Importante:
El contenido de la publicación de catálogo es provisto por Mercado Libre. Por lo tanto, el vendedor es responsable de confirmar que el producto a asociar coincida con las características específicas que se muestran en la plataforma.

En caso que exista una diferencia entre lo que el usuario compre y el producto asociado es posible, que se generen reclamos y/o cancelaciones que impactarán negativamente en su reputación y como consecuencia de esto la inhabilitación para publicar en Catálogo, llevando eventualmente a la suspensión de la cuenta.

Además de realizar publicaciones de catálogo con una publicación original, también puedes crear ítems de catálogo sin necesidad de contar con un ítem de marketplace para vincular. Ten en cuenta que para crear el ítem de catálogo deberás considerar los mismos requisitos expuestos en Publicar ítem en catálogo.

Ten en cuenta que al momento de realizar el POST es necesario enviar los siguientes valores para que se cree la publicación de catálogo.

"catalog_product_id": este valor debe ser confirmado con el recurso de search/product.
"catalog_listing": true: es necesario envíar el valor en true para generar el ítem de catálogo.


Llamada:

curl -X POST https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X POST -H "Content-Type: application/json" -d
'{
    "site_id": "MLA",
    "title": "Item de test no ofertar",
    "category_id": "MLA1055",
    "price": 10000000,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "pictures": [],
    "attributes": [
        {
            "id": "CARRIER",
            "name": "Compañía telefónica",
            "value_id": "298335",
            "value_name": "Liberado",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "catalog_product_id": "MLA6005934",
    "catalog_listing": true
}'
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Respuesta:

{
    "id": "MLA811894603",
    "site_id": "MLA",
    "title": "Apple iPhone iPhone 3g 8 Gb Negro 128 Mb Ram",
    "subtitle": null,
    "seller_id": 464161506,
    "category_id": "MLA1055",
    "official_store_id": null,
    "price": 10000000,
    "base_price": 10000000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2019-08-29T14:49:42.945Z",
    "historical_start_time": "2019-08-29T14:49:42.945Z",
    "stop_time": "2039-08-24T04:00:00.000Z",
    "end_time": "2039-08-24T04:00:00.000Z",
    "expiration_time": "2019-11-17T14:49:42.987Z",
    "condition": "new",
    "permalink": "http://articulo.mercadolibre.com.ar/MLA-811894603-apple-iphone-iphone-3g-8-gb-negro-128-mb-ram-_JM",
    "pictures": [
        {
            "id": "675782-MLA31138875214_062019",
            "url": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
            "size": "249x500",
            "max_size": "598x1200",
            "quality": ""
        },
        {
            "id": "915001-MLA31138546867_062019",
            "url": "http://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
            "size": "250x500",
            "max_size": "600x1200",
            "quality": ""
        },
        {
            "id": "881441-MLA31138332972_062019",
            "url": "http://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
            "size": "243x500",
            "max_size": "585x1200",
            "quality": ""
        },
        {
            "id": "804666-MLA31139286536_062019",
            "url": "http://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
            "size": "405x500",
            "max_size": "836x1030",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA811894603-2265773390"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1061221617,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "1414",
        "city": {
            "id": "",
            "name": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": 38.11569,
        "longitude": 13.3614868,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": 38.11569,
        "longitude": 13.3614868
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "CARRIER",
            "name": "Compañía telefónica",
            "value_id": "298335",
            "value_name": "Liberado",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "9344",
            "value_name": "Apple",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "LINE",
            "name": "Línea",
            "value_id": "58993",
            "value_name": "iPhone",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": "14605",
            "value_name": "iPhone 3G",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "IS_DUAL_SIM",
            "name": "Es Dual SIM",
            "value_id": "242084",
            "value_name": "No",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "COLOR",
            "name": "Color",
            "value_id": "52049",
            "value_name": "Negro",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "INTERNAL_MEMORY",
            "name": "Memoria interna",
            "value_id": "59566",
            "value_name": "8 GB",
            "value_struct": {
                "number": 8,
                "unit": "GB"
            },
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "RAM",
            "name": "Memoria RAM",
            "value_id": "366239",
            "value_name": "128 MB",
            "value_struct": {
                "number": 128,
                "unit": "MB"
            },
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "MAIN_COLOR",
            "name": "Color principal",
            "value_id": "2450295",
            "value_name": "Negro",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "OPERATING_SYSTEM_NAME",
            "name": "Nombre del sistema operativo",
            "value_id": "7404961",
            "value_name": "iOS",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "WITH_IMEI",
            "name": "Con IMEI",
            "value_id": "242085",
            "value_name": "Sí",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment",
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": "MLA6005934",
    "domain_id": "MLA-CELLPHONES",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-08-29T14:49:43.099Z",
    "last_updated": "2019-08-29T14:49:43.099Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": true,
    "item_relations": []
}

Creación automática de publicaciones de catálogo

Importante:
Actualmente, desde Mercado Libre no estamos creando publicaciones forzadas a catálogo pero recuerda que es muy importante estar suscrito al feed de ítems (notificaciones).

Estas publicaciones de catálogo serán creadas con status paused y marcadas con el tag catalog_boost. Los vendedores contarán con 7 días para confirmar que venden exactamente los productos a los que las asociamos. Luego de esa fecha, activaremos las publicaciones automáticamente y perderán el tag con el que se reconocían. Para conocer el producto al que pertenece tu item de catálogo podrás consultar el recurso /products/{product_id}.

Si tu herramienta no permite que el vendedor confirme que vende exactamente los productos a los que asociamos sus publicaciones, deberás recomendarle acceder al listado de publicaciones en su cuenta de Mercado Libre hasta que adaptes tu herramienta.

A continuación, puedes ver cómo queda el JSON de un ítem de catálogo.


Ejemplo de ítem de catálogo taggeado:

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

Respuesta:

{
   "id":"MLA123456789",
   "site_id":"MLA",
   "title":"Samsung Galaxy A10 32 Gb Negro 2 Gb Ram",
   "subtitle":null,
   "seller_id":12312345,
   "category_id":"MLA1055",
   "official_store_id":null,
   "price":14498.49,
   "base_price":14498.49,
   "original_price":null,
   "currency_id":"ARS",
   "initial_quantity":1,
   "available_quantity":1,
   "sold_quantity":0,
   "sale_terms":[

   ],
   "buying_mode":"buy_it_now",
   "listing_type_id":"gold_special",
   "start_time":"2020-02-25T13:30:06.000Z",
   "stop_time":"2040-02-20T04:00:00.000Z",
   "condition":"new",
   "permalink":"https://articulo.mercadolibre.com.ar/MLA-840863454-samsung-galaxy-a10-32-gb-negro-2-gb-ram-_JM",
   "thumbnail":"http://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "secure_thumbnail":"https://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "pictures":[

   ],
   "video_id":"63vjmsBa3nw",
   "descriptions":[

   ],
   "accepts_mercadopago":true,
   "non_mercado_pago_payment_methods":[

   ],
   "shipping":{

   },
   "international_delivery_mode":"none",
   "seller_address":{

   },
   "seller_contact":null,
   "location":{

   },
   "geolocation":{

   },
   "coverage_areas":[

   ],
   "attributes":[

   ],
   "warnings":[

   ],
   "listing_source":"",
   "variations":[

   ],
   "status":"active",
   "sub_status":[

   ],
   "tags":[
      "brand_verified",
      "extended_warranty_eligible",
      "catalog_boost",
      "good_quality_picture",
      "good_quality_thumbnail",
      "immediate_payment",
      "cart_eligible"
   ],
   "warranty":"Garantía del vendedor: 6 meses",
   "catalog_product_id":"MLA14648964",
   "domain_id":"MLA-CELLPHONES",
   "parent_item_id":null,
   "differential_pricing":null,
   "deal_ids":[

   ],
   "automatic_relist":false,
   "date_created":"2020-02-25T13:30:06.000Z",
   "last_updated":"2020-02-28T16:28:14.000Z",
   "health":0.9,
   "catalog_listing":false
}
Nota:
Podrás realizar una búsqueda por vendedor para identificar los ítems que estén marcados con el tag utilizando el siguiente recurso.

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/1234567/items/search?status=paused&tags=catalog_boost&access_token=$ACCESS_TOKEN

Siguiente: Publicaciones requeridas en catálogo.