Retrouvez dans cet article les procédures à suivre pour modifier :
le prix de base d'un produit (prix d'achat, prix de vente, TVA), c'est-à-dire que le prix s'applique par défaut toute l'année
vos tarifs saisonniers qui viennent remplacer le prix de base sur une période de l'année précise (haute saison, promotion…)
Pour en savoir plus sur les tarifs saisonniers, veuillez consulter notre article ✍️ Tarifs saisonniers.
Prérequis
Avant de démarrer, nous vous recommandons de consulter notre article ✍️ Configurer Postman pour vos appels API.
Vous aurez besoin de récupérer les informations suivantes :
Votre clé API Ezus → header
x-api-key.Un token valide, obtenu via
/loginet valable 12 heures → headerAuthorization: Bearer …La référence (« Champ API ») du ou des produits à modifier.
Les routes utilisées fonctionnent en mode « upsert » = update or insert. Cela signifique que si la référence envoyée existe déjà, l'élément est mis à jour ; sinon, il est créé.
Chaque produit possède une référence unique qui correspondant à la valeur de la colonne « Champ API » de votre export de produits. C'est cette donnée qui permet d'indiquer à Ezus quel produit modifier.
💡 A noter que tous les prix sont saisis Toutes Taxes Comprises (TTC) et dans la devise du produit. Il n'est pas possible de saisir un prix Hors Taxe (HT) ou dans une autre devise.
Cas 1 — Mettre à jour le prix de base d'un produit
On utilise la route products-upsert, aussi disponible via https://api.ezus.io/#post-products-upsert.
Le principe : on envoie la référence du produit + uniquement les champs de prix à changer. Toutes les autres informations liées au produit (titre, description, catégorie…) restent inchangées.
Étape 1 — Créer la requête
Dans Postman, créez une nouvelle requête. Choisissez la méthode POST et saisissez l'URL : https://api.ezus.app/products-upsert
Étape 2 — Renseigner les en-têtes (Headers)
Dans l'onglet Headers, ajoutez trois lignes :
x-api-key→ votre clé APIAuthorization→Bearersuivi de votre tokenContent-Type→application/json
Étape 3 — Écrire le contenu (Body)
Dans l'onglet Body, choisissez raw puis le format JSON, et collez :
{ "reference": "REFERENCE_DU_PRODUIT", "purchase_price": 42, "sales_price": 84, "vat_rate": 20, "vat_regime": "margin" }
Signification des champs :
reference: la référence du produit (« Champ API »). Obligatoire pour cibler le bon produit.purchase_price: prix d'achat, en nombre, TTC (ex.42ou42.50— point décimal, pas de symbole €).sales_price: prix de vente, en nombre, TTC.vat_rate: taux de TVA en pourcentage (ex.20pour 20 %). Laissé vide → le taux par défaut du compte s'applique.vat_regime:classic(TVA de droit commun),margin(TVA sur marge), ounone(non applicable).
💡 N'incluez que les champs que vous souhaitez modifier. Par exemple, si vous souhaitez mettre à jour uniquement le prix de vente, envoyez seulement reference et sales_price .
Étape 4 — Envoyer et vérifier
Cliquez sur Send. Une réponse réussie ressemble à :
{ "error": "false", "message": "ok", "action": "Product successfully updated", "reference": "REFERENCE_DU_PRODUIT" }
Vérifiez ensuite dans Ezus que le prix a bien changé sur la fiche produit.
Cas 2 — Créer ou mettre à jour un tarif saisonnier
Pour modifier un prix spécifique sur une période donnée (haute saison, offre limitée…), utilisez la route product-seasons-upsert, aussi disponible via https://api.ezus.io/#post-product-seasons-upsert.
Chaque saison est rattachée à un produit via product_reference.
Même méthode que pour le Cas 1 (POST + Headers identiques), avec l'URL https://api.ezus.app/product-seasons-upsert et ce Body :
{ "product_reference": "REFERENCE_DU_PRODUIT", "reference": "REFERENCE_DE_LA_SAISON", "name": "Haute saison 2026", "purchase_price": 165.25, "sales_price": 200, "limit_start": "2026-01-01", "limit_end": "2026-01-31", "is_yearly": true }
Signification des champs :
product_reference: référence du produit concerné (obligatoire).reference: référence unique de la saison. A renseigner obligatoirement si vous souhaitez mettre à jour une saison existante. Si non renseigné, Ezus créera automatiquement une nouvelle saison.name: nom du tarif saisonnier (100 caractères max).purchase_price/sales_price: prix d'achat / de vente TTC pour la période.limit_start/limit_end: début et fin de la saison, au format YYYY-MM-DD.is_yearly: indiquertruesi le tarif se répète chaque année, sinonfalse.
💡 Comment obtenir la référence unique de la saison ?
Vous devez au préalable appeler l'API GET /product pour le produit concerné. La réponse contient un tableau de tarifs, et chaque entrée possède sa propre référence. C'est cette valeur qu'il faut transmettre comme référence dans l'API POST /product-seasons-upsert pour mettre à jour une saison existante.
Mettre à jour les tarifs de vos produits en masse
Pour modifier les tarifs de beaucoup de produits d'un coup, vous pouvez regrouper une requête par produit dans une collection, puis lancer le Collection Runner :
Survolez le nom de la collection → cliquez sur les ··· → Run collection.
Vérifiez que les requêtes voulues sont cochées.
Réglez un délai (Delay) d'environ
200 msentre les requêtes.Laissez « Stop run if an error occurs » coché : en cas d'erreur, l'exécution s'arrête sur la requête fautive.
Cliquez sur Run : chaque produit s'affiche avec un statut Passed ou Failed.
💡 Conseil : testez toujours une seule requête avec succès avant de lancer un run complet, cela évite d'envoyer des dizaines d'appels erronés.
Résolution des problèmes courants
Erreur 401 / 403 : problème d'authentification. Vérifiez la clé API et le token (sans espace superflu). Si le token a plus de 12 h, régénérez-le via
/login.Le prix n'a pas changé : la
referencene correspond à aucun produit existant. Utilisez bien la valeur de la colonne « Champ API ».Un tarif saisonnier en double est apparu : vous avez utilisé une nouvelle
referencede saison. Réutilisez la même référence pour mettre à jour au lieu de créer.Prix refusé / résultat étrange : saisissez un nombre (point décimal, sans symbole), TTC, dans la devise du produit.
Date refusée : respectez le format YYYY-MM-DD (ex. 2026-07-01).