Découvrons ensemble comment enrichir mettre à jour vos fiches fournisseurs avec Postman : ajouter ou modifier les noms et descriptions dans plusieurs langues (description courte et/ou longue).

Avant de commencer, nous vous recommandons de consulter l'article ✍️ Mettre à jour vos produits du catalogue via l'API (Postman) qui détaille la récupération de la clé API, du token et la configuration de Postman.

Prérequis

Avant de vous lancer dans la création de votre requête, assurez-vous d'avoir récupéré les éléments suivants :

Votre clé API Ezus → header x-api-key.
Un token valide (via /login, valable 12 h) → header Authorization: Bearer ….
Le champ API : c'est une référence unique qui permet d'identifier le(s) fournisseur(s) que vous souhaitez modifier

⚠️ Assurez-vous que les langues dans lesquelles vous souhaitez mettre à jour vos fiches fournisseurs soit bien activées dans les paramètres de votre compte Ezus. Autrement, la requête sera refusée par l'API.

Où trouver la référence API de mon fournisseur ?

Directement depuis la fiche fournisseur :
Depuis votre catalogue :

Utile si vous souhaitez récupérez l'information pour plusieurs fournisseurs : vous pouvez également exporter ces données en cliquant sur les trois petits points puis sur le bouton Exporter.

💡 Si vous ne voyez pas cette colonne dans votre tableau, vous devrez l'ajouter. Pour cela, cliquez sur les trois petits points à droite puis sur le bouton "Modifier les colonnes".

Ajouter des descriptions multilingues

Pour ajouter ou modifier les descriptions, utilisez la route suppliers-upsert avec le bloc langs. Chaque langue est un objet contenant le nom et les descriptions du fournisseur dans cette langue.

Toute autre information de votre fiche fournisseur (adresse, catégorie, tags…) ne seront pas impactées.

Étape 1 — Créer la requête

Méthode POST, URL : https://api.ezus.app/suppliers-upsert

Étape 2 — En-têtes (Headers)

x-api-key → votre clé API
Authorization → Bearer suivi de votre token
Content-Type → application/json

Étape 3 — Contenu (Body → raw → JSON)

{     "reference": "REFERENCE_DU_FOURNISSEUR",     "langs": [         {             "lang": "french",             "name": "Nom du fournisseur",             "short_description": "Une description courte en français",             "long_description": "Une description longue en français"         },         {             "lang": "english",             "name": "Supplier name",             "short_description": "A short description in English",             "long_description": "A long description in English"         },         {             "lang": "spanish",             "name": "Nombre del proveedor",             "short_description": "Una descripción corta en español",             "long_description": "Una descripción larga en español"         }     ] }

Description des champs :

reference : correspond à la donnée « champ API » dans Ezus (obligatoire).
langs : un tableau, avec un objet par langue.
lang : la langue de l'objet. Toujours en minuscule et en anglais : french, english, american, spanish, italian, german, dutch, portuguese…
name : le nom affiché du fournisseur dans cette langue.
short_description : description courte.
long_description : description longue.

💡 Bon à savoir : il est recommandé de mettre à jour toutes les langues utilisées dans un seul appel (le bloc langs fixe les descriptions pour les langues fournies).

Étape 4 — Envoyer et vérifier

Cliquez sur Send. Réponse attendue :

{     "error": "false",     "message": "ok",     "action": "Supplier successfully updated",     "reference": "REFERENCE_DU_FOURNISSEUR" }

Nous vous recommandons de vérifier dans Ezus que les descriptions apparaissent bien dans chaque langue.

Et les images (logo, visuels, médias) ?

À ce jour, les images d'un fournisseur ne peuvent pas être ajoutées via l'API. La route suppliers-upsert ne comporte aucun champ pour le logo, les visuels ou les médias. Ces éléments apparaissent uniquement en lecture lorsqu'on consulte une fiche (requête GET supplier), mais ne sont pas modifiables par l'API.

Pour ajouter des images sur vos fiches fournisseurs, deux possibilités :

Depuis l'interface Ezus : directement depuis la fiche fournisseur.
Via un import : contactez votre Customer Success Manager pour en savoir plus.

Enrichir plusieurs fournisseurs d'un coup

Regroupez une requête par fournisseur dans une collection, puis lancez le Collection Runner :

Survolez la collection → ··· → Run collection.
Vérifiez les requêtes cochées, laissez un délai d'environ 200 ms, gardez « Stop run if an error occurs » coché.
Cliquez sur Run : statut Passed / Failed par fournisseur.

💡 Nous vous recommandons de d'abord tester une seule requête avec succès avant de lancer le run complet.

Résolution des problèmes courants

Erreur 401 / 403 : vérifiez la clé API et le token (régénérez-le s'il a expiré).
Langue refusée : la langue doit être activée dans les Réglages du compte, et orthographiée en anglais (french, english, spanish…).
La description n'apparaît pas : vérifiez que la reference correspond bien à un fournisseur existant (colonne « champ API »).

Mettre à jour vos fiches fournisseurs via l'API (Postman)