Publicar en 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/catalog_listings
{
"item_id":"MLA1234",
"variation_id": 4321,
"catalog_product_id":"MLA9876"
}Ejemplo sobre un ítem sin variaciones:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/catalog_listings
{
"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.
Sincronización de condiciones de venta
La sincronización de las condiciones de venta (como precio, forma de entrega, stock, garantía, SKU y PIs) de las publicaciones asociadas será automática para los ítems con items_relations y con las siguientes reglas:
- El vendedor no podrá eliminar la sincronización (opt-out).
- Las publicaciones nuevas estarán sincronizadas desde el inicio.
- Las publicaciones existentes asociadas se sincronizarán a partir de que el vendedor modifique alguna de las condiciones de venta de la publicación original.
Publicar directamente en catálogo
Para realizar una publicación directa en catálogo es necesario, en primer lugar, debes 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.
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.
Al momento de realizar el POST podrás 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 enviar el valor en true para generar el ítem de catálogo.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/itemsEjemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -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/itemsRespuesta:
{
"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": []
}Publicaciones de catálogo creadas automáticamente
Ten en cuenta que la publicación original será actualizada con los attributes, variations.attributes o variations.attribute_combinations del producto al cual fue asociado para que ambas publicaciones relacionadas sean consistentes.
A continuación, puedes ver un ítem de catálogo con optin automático. Recuerda que puedes reconocer estas publicaciones con el tag catalog_boost.
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789Respuesta:
{
"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":[
"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":true
}Filtrar ítems publicados automáticamente por vendedor
Podrás realizar una búsqueda por vendedor para identificar los ítems que estén marcados con el tag catalog_boost, utilizando el siguiente recurso.
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1234567/items/search?status=active&tags=catalog_boostCrear publicaciones de marketplace con optin automático
Antes de crear nuevas publicaciones, debes identificar si es un producto activo en catálogo y si se encuentra requerido para catálogo. Para esto, realiza un GET al recurso /products/search con el filtro status:active y revisa mediante el listing_strategy: catalog_required si el producto es requerido para que se genere la publicación a catálogo de manera automática.
Ten cuenta que, en este caso, podrás enviar el catalog_product_id y/o GTIN en el POST al crear la publicación.
Respuesta ejemplo de producto requerido en catálogo:
{
"keywords": " Apple iphone 3g",
"domain_id": "MLA-CELLPHONES",
"paging": {
"total": 3,
"limit": 10,
"offset": 0
},
"results": [
{
"id": "MLA6005934",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Apple iPhone iPhone 3G 8 GB Negro 128 MB RAM",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "9344",
"value_name": "Apple"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "58993",
"value_name": "iPhone"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "14605",
"value_name": "iPhone 3G"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52049",
"value_name": "Negro"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59566",
"value_name": "8 GB"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "579543",
"value_name": "128 MB"
},
{
"id": "MAIN_COLOR",
"name": "Color principal",
"value_id": "2450295",
"value_name": "Negro"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7404961",
"value_name": "iOS"
}
],
"pictures": [
{
"id": "675782-MLA31138875214_062019",
"url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
},
{
"id": "915001-MLA31138546867_062019",
"url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
},
{
"id": "881441-MLA31138332972_062019",
"url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
},
{
"id": "804666-MLA31139286536_062019",
"url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
}
]
},
{
"id": "MLA6007403",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Apple iPhone iPhone 3G 16 GB Negro 128 MB RAM",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "9344",
"value_name": "Apple"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "58993",
"value_name": "iPhone"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "14605",
"value_name": "iPhone 3G"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52049",
"value_name": "Negro"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59561",
"value_name": "16 GB"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "579543",
"value_name": "128 MB"
},
{
"id": "MAIN_COLOR",
"name": "Color principal",
"value_id": "2450295",
"value_name": "Negro"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7404961",
"value_name": "iOS"
}
],
"pictures": [
{
"id": "675782-MLA31138875214_062019",
"url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
},
{
"id": "915001-MLA31138546867_062019",
"url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
},
{
"id": "881441-MLA31138332972_062019",
"url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
},
{
"id": "804666-MLA31139286536_062019",
"url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
}
]
},
{
"id": "MLA6007404",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Apple iPhone iPhone 3G 16 GB Blanco 128 MB RAM",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "9344",
"value_name": "Apple"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "58993",
"value_name": "iPhone"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "14605",
"value_name": "iPhone 3G"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52055",
"value_name": "Blanco"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59561",
"value_name": "16 GB"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "579543",
"value_name": "128 MB"
},
{
"id": "MAIN_COLOR",
"name": "Color principal",
"value_id": "2450308",
"value_name": "Blanco"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7404961",
"value_name": "iOS"
}
],
"pictures": [
{
"id": "675782-MLA31138875214_062019",
"url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
},
{
"id": "915001-MLA31138546867_062019",
"url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
},
{
"id": "881441-MLA31138332972_062019",
"url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
},
{
"id": "804666-MLA31139286536_062019",
"url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
}
]
}
]
}Validación previa a publicar en un producto requerido en catálogo
Utilizar el recurso /items/validate para reconocer, previo a realizar un POST, que cumplas con todas las validaciones, para poder publicar correctamente.
Beneficios por enviar los valores
| POST | Beneficio |
|---|---|
| Con catalog_product_id y GTIN | Recomendado. Ambos campos son requeridos por separado. Enviando ambos valores optimizas el tiempo de la creación de la publicación automática. Se actualiza la publicación original con la información correspondiente al producto. |
| Con catalog_product_id o GTIN | Reemplaza los valores de la ficha técnica con los del producto, excepto el GTIN (no se modifica ni autocompleta). |
| Solo con catalog_product_id | Este campo tiene precedencia sobre los PKs o GTIN, tomado este valor e ignorando los demás valores. |
| Solo con GTIN | Se realiza la búsqueda del producto por GTIN, completando el catalog_product_id con el resultado de la búsqueda. |
| Con catalog_product_id inactivo o incorrecto | Devuelve error, por más que el POST cuente con PKs y GTIN para evitar incongruencias en la creación. |
Errores de validación y soluciones
| Code_id | Reason | code_name | code_message | Solución |
|---|---|---|---|---|
| 4400 | catalog_product_id o GTIN obligatorios (detectamos producto en base a PKs) | body.required_fileds | Missing catalog_product_id or GTIN. It’s required at least one of them. | Enviar catalog_product_id o GTIN |
| 4402 | No encontramos producto activo en base a catalog_product_id | item.catalog_product_id | The product $product_id is not active | Enviar un catalog_product_id activo o GTIN correcto |
| 417 | catalog_product_id no se corresponde al category_id | item.catalog_product_id | The product $product_id does not belong to the catalog_domain of the category $category_id. | Enviar un catalog_product_id correcto |
| 418 | catalog_product_id de distintas familias entre el ítem y la variación | item.catalog_product_id | Variation catalog_product_id $variation_product_id is not a child of item catalog_product_id $item_product_id. | Enviar un catalog_product_id a nivel item y variación que sean de la misma familia. |
Siguiente: Publicaciones requeridas en catálogo.
