Mettre à jour une annonce avec l'API Mercado Livre

Modifie une annonce et la renvoie. Seuls les champs envoyés changent. status paused la masque, active la réactive et closed la termine définitivement. title et family_name ne changent que tant que l'annonce n'a aucune vente.

Identifiant
mercado_livre_update_item

L'appel

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>"
  }
}

Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.

Paramètres

Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.

ParamètreTypeObligatoireDescription
item_idstringOuiId of the listing, from Search items, for example MLB1828680414.
statusstringNonpaused hides the listing, active reactivates a paused one and closed ends it, with no way back.Valeurs : active, paused, closed
pricenumberNonNew price. Ignored when the listing has price automation turned on, and refused with 400 if it is the only field sent.
available_quantityintegerNonNew stock. 0 pauses a new item with substatus out_of_stock, and stock above 0 reactivates it.
titlestringNonNew title, only while the listing has no sales.
family_namestringNonNew family name, only while no listing of the family has sales. It changes every listing of the same product.
picturesarrayNonThe full list of pictures, which replaces the current one. Keep a current picture by its id and add a new one by source.
attributesarrayNonAttributes to add or change. The ones not sent stay as they are.
sale_termsarrayNonSale terms to change, such as WARRANTY_TYPE and WARRANTY_TIME.

Connexions possibles

Votre client connecte son compte Mercado Livre une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

OAuth avec l'app de votre produit

Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/mercado_livre, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.

La réponse

En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.

Prête pour les agents IA

L'input de cette tool est un JSON Schema, disponible via GET /api/tools/mercado_livre_update_item. Il devient la définition de tool de votre agent sans conversion.

Autres tools Mercado Livre

Voir les 14 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.