Créer une annonce avec l'API Mercado Livre
Publie une annonce et la renvoie avec son id. Dans le modèle User Products, actif pour tous les vendeurs, envoyez family_name et aucun title : Mercado Livre construit le titre. La description s'ajoute ensuite avec Créer la description de l'annonce.
- Identifiant
- mercado_livre_create_item
L'appel
POST https://connect.reportei.com/api/tools/mercado_livre_create_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"family_name": "<family_name>",
"category_id": "<category_id>",
"price": 1,
"currency_id": "<currency_id>",
"available_quantity": 1,
"buying_mode": "buy_it_now",
"listing_type_id": "<listing_type_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ètre | Type | Obligatoire | Description |
|---|---|---|---|
| family_name | string | Oui | Generic name of the product, shared by its variants, for example Apple iPhone 256GB. Up to the max_title_length of the category. |
| category_id | string | Oui | Id of the category, from Search categories. |
| price | number | Oui | Price in the currency of currency_id. |
| currency_id | string | Oui | Currency of the site, BRL in Brazil, as in the currency_id of the listings in List items. |
| available_quantity | integer | Oui | Stock. 0 creates the listing paused, with substatus out_of_stock. |
| buying_mode | string | Oui | buy_it_now, the only mode available.Valeurs : buy_it_now |
| listing_type_id | string | Oui | Listing type, for example gold_special (Classic), gold_pro (Premium) or free, as in the listing_type_id of the listings in List items. |
| condition | string | Non | Condition of the product. Mercado Livre is replacing it with the ITEM_CONDITION attribute, which is also the only way to say refurbished.Valeurs : new, used, not_specified |
| pictures | array | Non | Pictures of the product, in order. The max_pictures_per_item of the category sets the limit. |
| attributes | array | Non | Technical attributes of the product, such as BRAND, MODEL, GTIN or SELLER_SKU. List category attributes says which ones the category requires. |
| sale_terms | array | Non | Sale terms, such as the warranty: WARRANTY_TYPE (for example Garantia do vendedor) and WARRANTY_TIME (for example 90 dias). A refurbished item needs them. |
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_create_item. Il devient la définition de tool de votre agent sans conversion.
Autres tools Mercado Livre
- Obtenir l'utilisateur actuelGETRenvoie le compte vendeur connecté : id, nickname, email, site_id et réputation du vendeur. L'id est le user_id, seller et seller_id des autres outils, et le site_id (MLB au Brésil) va dans Rechercher des catégories.
- Rechercher des annoncesGETListe les ids des annonces du vendeur, 50 par page par défaut. results ne contient que des ids d'annonces : Lister les annonces renvoie leurs détails. Paginez avec offset et limit ; au-delà de 1000 résultats, utilisez search_type scan et le scroll_id de chaque réponse.
- Lister les annoncesGETRenvoie jusqu'à 20 annonces par id en un appel : titre, prix, available_quantity, sold_quantity, status, permalink, images et attributs. Chaque élément contient status_code, id et l'annonce dans body.
- Rechercher des catégoriesGETPrédit la catégorie d'un produit à partir de son titre, avec le domaine et les attributs reconnus dans le texte. Le premier résultat est le plus probable. Son category_id va dans Créer une annonce et dans Lister les attributs de la catégorie.
- Lister les attributs de la catégorieGETListe les attributs d'une catégorie avec id, value_type, valeurs acceptées et tags. Les attributs avec la tag required doivent être envoyés dans Créer une annonce, et ceux en new_required quand l'article est neuf.
- Mettre à jour une annoncePUTModifie 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.
- Obtenir la description de l'annonceGETRenvoie la description d'une annonce en plain_text, avec date_created et last_updated.
- Créer la description de l'annoncePOSTAjoute la description à une annonce qui n'en a pas, comme une annonce tout juste créée avec Créer une annonce. Échoue avec 400 quand une description existe déjà : utilisez Mettre à jour la description de l'annonce.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
