Actualizar anuncio en Mercado Livre, con una API

Cambia un anuncio y lo devuelve. Solo cambian los campos enviados. status paused lo oculta, active lo reactiva y closed lo termina para siempre. title y family_name solo cambian mientras el anuncio no tiene ventas.

Identificador
mercado_livre_update_item

La llamada

POST https://connect.reportei.com/api/tools/mercado_livre_update_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "item_id": "<item_id>"
  }
}

Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.

Parámetros

Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.

ParámetroTipoObligatorioDescripción
item_idstringSíId of the listing, from Search items, for example MLB1828680414.
statusstringNopaused hides the listing, active reactivates a paused one and closed ends it, with no way back.Valores: active, paused, closed
pricenumberNoNew price. Ignored when the listing has price automation turned on, and refused with 400 if it is the only field sent.
available_quantityintegerNoNew stock. 0 pauses a new item with substatus out_of_stock, and stock above 0 reactivates it.
titlestringNoNew title, only while the listing has no sales.
family_namestringNoNew family name, only while no listing of the family has sales. It changes every listing of the same product.
picturesarrayNoThe full list of pictures, which replaces the current one. Keep a current picture by its id and add a new one by source.
attributesarrayNoAttributes to add or change. The ones not sent stay as they are.
sale_termsarrayNoSale terms to change, such as WARRANTY_TYPE and WARRANTY_TIME.

Conexiones posibles

Tu cliente conecta su cuenta de Mercado Livre una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.

OAuth con la app de tu producto

Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/mercado_livre, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.

La respuesta

Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.

Lista para agentes de IA

El input de esta tool es un JSON Schema, disponible en GET /api/tools/mercado_livre_update_item. Se convierte en la definición de tool de tu agente sin conversión.

Otras tools de Mercado Livre

Ver las 14 tools

Toolkits de la misma categoría

Ver los 100 toolkits

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.