Déclinaisons des produits (variantes)
ps_manage_combinations
- ProTellMyShop Pro uniquement
- Écriture · aperçu + validation
- Enregistre: interrupteur Ventes (jusqu’à désactivation)
- Ventes · interrupteur, jusqu’à désactivation
- Visible dès l’installation
Montre les variantes d’un produit, comme les tailles et les couleurs, et modifie leurs prix, leurs codes et la variante affichée en premier.
TellMyShop Free: Non. Cet outil fait uniquement partie de TellMyShop Pro. TellMyShop Free ne contient que des rapports prêts à l’emploi qui lisent votre boutique.
Demandez au chat
« Les tailles XL du sweat Oslo doivent coûter 10 de plus que les autres tailles. »
Exemple d’aperçu
Produit 310 Sweat Oslo. Déclinaison 1204 (Taille XL, Couleur Gris) : impact sur le prix +0,00 -> +10,00 TTC (+8,13 HT), prix final 189,99 -> 199,99 PLN TTC. Déclinaison 1208 (Taille XL, Couleur Marine) : idem.
Détails techniques
Déclinaisons (variantes : taille, couleur...). action=list affiche les déclinaisons d’un produit avec les attributs, la référence, l’EAN, l’impact sur le prix (HT et TTC), le prix final TTC, le stock et la déclinaison par défaut. action=update modifie jusqu’à 100 déclinaisons : price_impact_gross ou price_impact_net (l’écart de la déclinaison par rapport au prix de base ; 0 = identique), wholesale_price, reference, ean13, upc, mpn, weight_impact, minimal_quantity, default=true (déclinaison par défaut sur la page produit). Il ne crée ni ne supprime de déclinaisons. Stock : ps_update_stock avec combination_id. Promotion sur une seule variante : ps_manage_specific_prices avec combination_id.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| action | enum: list | update | oui | list | update. |
| shop_id | integer | non | ID de la boutique dans une installation multiboutique. Par défaut, la boutique de l’adresse du connecteur. Les ID sont listés par ps_get_shop_info. |
| lang | string | non | Code ISO de la langue, par exemple pl ou en. Par défaut, la langue par défaut de la boutique. |
| product | string | quand | action=list : le produit. Le produit tel qu’une personne le désigne : "id:123", "ref:ABC-1", "ean:5901234123457", une URL de produit de la boutique, un ID seul (1 à 7 chiffres), un EAN (8/12/13 chiffres) ou une référence. 300 caractères maximum. |
| changes | array of object | quand | action=update : un élément par déclinaison. 100 éléments maximum. Champs de chaque élément : product (string, obligatoire) : produit (id:123, ref:ABC-1, ean:..., URL du produit, ID, EAN ou référence). 300 caractères maximum. combination_id (integer, obligatoire) : ID de la déclinaison tiré de action=list. price_impact_gross (number) : impact sur le prix TTC (par exemple 10 = 10 de plus que le prix de base, -5 = moins cher). De -1 000 000 à 1 000 000. price_impact_net (number) : impact sur le prix HT (au lieu du TTC). De -1 000 000 à 1 000 000. wholesale_price (number) : prix d’achat HT de la déclinaison (0 = prix d’achat du produit). De 0 à 10 000 000. reference (string) : référence de la déclinaison (code). 64 caractères maximum. ean13 (string) : EAN-13 (vide = supprimer). upc (string) : UPC. mpn (string) : référence fabricant (MPN). 40 caractères maximum. weight_impact (number) : impact sur le poids (kg). De -10 000 à 10 000. minimal_quantity (integer) : quantité minimale par commande. De 1 à 100 000. default (boolean) : true = la déclinaison par défaut du produit. |
| confirm | boolean | non | false (par défaut) renvoie un aperçu et n’enregistre rien. true exécute, uniquement après que l’utilisateur a validé l’aperçu, avec change_token. |
| change_token | string | quand | Jeton issu de l’aperçu. Obligatoire avec confirm=true. Valable 30 minutes, à usage unique, lié aux arguments et à l’état des données de l’aperçu. |
Limites
update : jusqu’à 100 déclinaisons par appel. Ne crée ni ne supprime de déclinaisons (back office). Annulable avec ps_revert_change.
Ce que vous voyez avant tout enregistrement
Le chat appelle d’abord l’outil sans le confirmer. Le module renvoie un aperçu (valeurs actuelles et nouvelles) et un jeton à usage unique valable 30 minutes. Le chat vous montre l’aperçu et n’enregistre la modification qu’après votre oui.
Outils liés
- Modifier le stock ps_update_stock
- Gérer les prix promotionnels (prix spécifiques) ps_manage_specific_prices
- Modifier les prix ps_update_prices
- Annuler une modification ps_revert_change
Cas d’usage avec cet outil
Dernière mise à jour: 2026-10-11