Sincroniza y modifica publicaciones

Consideraciones para actualizar ítems

- Identifica a qué canal corresponde tu publicación (Mercado Libre o Mercado Shops). Si se trata de una publicación de mshops, modifica publicaciones de mshops.
- Cuando el ítem está activo puedes modificar:

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

- Cuando el ítem tiene ventas, no puedes cambiar:

• Título
• Modo de compra
• Métodos de Pago distintos de Mercado Pago

- Cuando el ítem no tiene ventas ("sold_quantity" = 0), puedes modificar:

• Título

- El tipo de publicación se puede modificar solo una vez.
- Considera si la publicación tiene variaciones.
- Verifica si el ítem tiene una oferta activa.

Actualizar ítems

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/$ITEM_ID

Descripciones

En nuestra documentración Descripción de productos crear, actualizar o eliminar una descripc un ítem.

Imágenes

Siempre puedes agregar o reemplazar imágenes de ítems. Mira más sobre Trabajar con imágenes.

Tipos de publicación

Para mejorar o actualizar el tipo de publicación puedes revisar nuestros Tipos y exposición de publicaciones.

Flujo y estados de las publicaciones

Active: la publicación se encuentra activa y tiene la posibilidad de recibir ofertas o preguntas. Puede cambiar la exposición de la publicación (upgrade de listing type).
Payment required: este caso se da cuando un usuario con deuda o baja política de crédito realiza una publicación y se reactiva automáticamente una vez que el usuario realiza el pago.
Under Review: el ítem se encuentra bajo revisión por Mercado Libre por los siguientes motivos:

• warning: ítem que sigue activo, pero tiene una corrección pendiente por parte del usuario. Si no se corrige en 2 días pasa a waiting_for_patch.
• waiting_for_patch: ítem oculto hasta que el usuario corrija la infracción reportada.
• held: ítem oculto a la espera de una moderación manual por parte de Mercado Libre.
• pending_documentation: ítem oculto hasta que el usuario presente la documentación solicitada.
• forbidden: ítem dado de baja por moderación. En esta condición, el elemento sólo puede ser eliminado directamente.

Paused: puede ser automaticamente (out of stock) o por decisión del usuario.

• out of stock: el ítem fue pausado por falta de stock y será activado automáticamente cuando sea repuesto.
• picture downloading pending: el ítem fue pausado hasta que la imagen tipo source se descargue correctamente y será activado cuando esto suceda.

Closed: este es el estado final del ítem y se puede dar por las siguientes causas:

• waiting for patch
• held
• expired: se alcanzó la fecha de finalización de la publicación (end_time) y aún tiene stock.
• deleted: se agrega cuando el ítem está cerrado y el seller decide eliminarlo. O cuando el ítem expira y se republica automaticamente.
• suspended
• freezed

Luego de un periodo de tiempo, los ítems finalizados dejaran de mostrarse para ser consultados.

Inactive: si no se realiza la corrección necesaria para salir del estado under review el ítem pasa a inactive. La corrección se puede encontrar en la cuenta del usuario en la sección de ventas en la solapa de publicaciones "revisar".

Los ítems pueden tener estado:

• cerrado: finaliza tu publicación. Una vez cerrado, no se puede volver a activar, pero puedes republicar ítems.

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"closed"
}
https://api.mercadolibre.com/items/$ITEM_ID

• pausado: pausa tu publicación. Una vez pausado, no será visible para otros usuarios de Mercado Libre, pero no se cerrará y se podrá reactivar más tarde.

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/$ITEM_ID

• activo: reactiva un artículo previamente pausado.

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"active"
}
https://api.mercadolibre.com/items/$ITEM_ID

Eliminar publicaciones

Recuerda que los items cerrados serán descartados automáticamente y si aún necesitas eliminar un ítems, por ejemplo con estado: payment_required que no responderán al estado ‘cerrado’, debes:

Ejemplo:

• 1. Actualizar el estado a cerrado:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status": "closed"
}
https://api.mercadolibre.com/items/$ITEM_ID

• 2. Eliminar el ítem:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "deleted": "true"
}
https://api.mercadolibre.com/items/$ITEM_ID

Stock de ítems

Actualizar el stock

Para actualizar el stock de un ítem debes agregar un valor en el campo “available_quantity” teniendo en cuenta:

• Si haces PUT del available_quantity = 0 cambiará el estado a “paused” con sub estado out_of_stock.
• Si haces PUT del available_quantity mayor a 0 y el sub estado es out_of_stock cambiará el estado a activo sin sub estado out_of_stock.
• Sólo puedes pausar un ítem enviando available_quantity = 0 cuando sea del tipo condition = new y no sea listing_type = free.

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 6
}
https://api.mercadolibre.com/items/$ITEM_ID

Stock de ítems usados

Conoce las categorías y países con límite de 1 (un) ítem con condición usada ("condition":"used").

Tiempo de realización (MANUFACTURING TIME)

Tiempo de disponibilidad de stock

Puedes utilizar la funcionalidad para mostrar a los compradores cuánto tiempo tardas en disponibilizar los productos para vender, en situaciones como:

• Realización de pedidos por encargo.
• Fabricación de productos.
• Personalización de productos para venderlos.
• Cuando recibas stock del proveedor de manera periódica.

La publicación quedará activa aunque los productos no estén listos para la venta y los compradores podrán comprarlo sabiendo el día exacto que llegará. Cuanto más tiempo agregues, menos exposición tendrán las publicaciones. Siempre mostraremos primero las que tengan stock disponible, por lo tanto asegúrate de utilizarla solo cuando sea necesario.

Consultar categoría con manufacturing time

En sale_terms de un ítem podrás especificar el tiempo de disponibilidad de stock de tu publicación usando el sale_term MANUFACTURING_TIME.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/sale_terms

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1577/sale_terms

Respuesta:

[
  {
    "id": "INVOICE",
    "name": "Facturación",
    "tags": {
      "hidden": true,
      "multivalued": true
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "6891885",
        "name": "Factura A"
      },
      {
        "id": "6891886",
        "name": "Factura B"
      },
      {
        "id": "6891887",
        "name": "Factura C"
      },
      {
        "id": "6891888",
        "name": "No factura"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "SUBSCRIBABLE",
    "name": "Suscribible",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "PRICE_SUBSCRIPTION",
    "name": "Precio por suscripción",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "SUBSCRIPTION_FREE_SHIPPING",
    "name": "Envío gratis por suscripciones",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_1",
    "name": "Precio por nivel 1 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_2",
    "name": "Precio por nivel 2 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_3",
    "name": "Precio por nivel 3 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_4",
    "name": "Precio por nivel 4 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_5",
    "name": "Precio por nivel 5 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_6",
    "name": "Precio por nivel 6 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "CHECKOUT_EXCHANGE_RATE",
    "name": "Tipo de cambio para checkout",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "ARS/USD",
        "name": "ARS/USD"
      }
    ],
    "default_unit": "ARS/USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "DISCOUNT_SUBSCRIPTION",
    "name": "Descuento por suscripciones",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "%",
        "name": "%"
      }
    ],
    "default_unit": "%",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "WARRANTY_TYPE",
    "name": "Tipo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230280",
        "name": "Garantía del vendedor"
      },
      {
        "id": "2230279",
        "name": "Garantía de fábrica"
      },
      {
        "id": "6150835",
        "name": "Sin garantía"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "WARRANTY_TIME",
    "name": "Tiempo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "días",
        "name": "días"
      },
      {
        "id": "meses",
        "name": "meses"
      },
      {
        "id": "años",
        "name": "años"
      }
    ],
    "default_unit": "meses",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "MANUFACTURING_TIME",
    "name": "Tiempo de elaboración",
    "tags": {
      "hidden": true
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "días",
        "name": "días"
      }
    ],
    "default_unit": "días",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  }
]

Consideraciones

• No puedes configurar valores superiores a 45 días.
• No aplica a la vertical VIS (Inmuebles, Automóviles y Servicios).
• No es compatible con ítems con envíos Flex o Fulfillment.
• Al agregar o modificar el sale term, utiliza alguna unidad disponible (ver en allowed_units). Siguiendo el ejemplo anterior, puedes apreciar que solo la unidad “días” está disponible para usarse dentro de la categoría MLA1577.

Crear ítem con disponibilidad de stock

Para crear una publicación con MANUFACTURING_TIME, primero debes consultar y verificar que la categoría en la que deseas publicar tenga disponible MANUFACTURING_TIME.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
  "site_id": "MLA",
  "title": "Item de testeo, por favor no contactar --kc:off",
  "category_id": "MLA1577",
  "price": 4000,
  "currency_id": "ARS",
  "pictures": [{
    "source": "http://mla-s2-p.mlstatic.com/777099-MLA26466460545_112017-O.jpg"
  }],
  "buying_mode": "buy_it_now",
  "listing_type_id": "gold_special",
  "condition": "new",
  "available_quantity": 10,
  "sale_terms": [{
    "id": "MANUFACTURING_TIME",
    "value_name": "20 días"
  }]
}
https://api.mercadolibre.com/items

Modificar disponibilidad de stock

Realiza un PUT similar al anterior especificando el nuevo valor del sale_term en value_name.

Ejemplo:

curl -X PUT -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d
{
   "sale_terms": [{
       "id": "MANUFACTURING_TIME",
       "value_name": "30 días"
   }]
}
https://api.mercadolibre.com/items/11000222

Eliminar disponibilidad de stock

Para eliminar el sale term MANUFACTURING_TIME, envia null en los campos value_id y value_name del ítem.

Llamada:

curl -X PUT -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d
{
  "sale_terms": [
    {
      "id": "MANUFACTURING_TIME",
      "value_id": null
      "value_name": null
    }
  ]
}
https://api.mercadolibre.com/items/110002223

Cantidad máxima de compra

Cantidad máxima

En el contexto del consumo responsable por Covid-19, limitamos la cantidad de ítems por compra para evitar abusos y desabastecimiento en productos críticos de la categoría Supermercado. Consulta si la categoría tiene la condición cantidad máxima de compra por operación con el $CATEGORY_ID.

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLM167991/sale_terms

Respuesta:

{
  [
[...]
{
        "id": "PURCHASE_MAX_QUANTITY",
        "name": "Cantidad máxima de compra",
        "tags": {
            "hidden": true,
            "read_only": true
        },
        "hierarchy": "SALE_TERMS",
        "relevance": 2,
        "value_type": "number",
        "value_max_length": 18,
        "attribute_group_id": "OTHERS",
        "attribute_group_name": "Otros"
    }
[...]
]
}

Cargar la cantidad máxima de compra en una publicación

Desde Mercado Libre revisaremos aquellos valores ingresados que estén por debajo del valor mínimo permitido “1” en un proceso offline, eliminando el sale_term de los casos que no cumplan con el requisito.

Llamada:

curl -X PUT 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json'
{...}
https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -H 'Accept: application/json' -d
{
   "sale_terms":[
      {
         "id":"PURCHASE_MAX_QUANTITY",
         "value_name":"10"
      }
   ]
}
https://api.mercadolibre.com/items/11122233

Conoce más sobre Sincronizamos tus publicaciones.