Vous êtes ici :
Importation/exportation des bons de réduction et codes promo dans B2C Commerce
Les bons de réduction sont importés au format XML et exportés au format CSV (valeur séparée par des virgules). Utilisez le fichier de schéma coupon.xsd pour importer les bons de réduction générés par le marchand. Cette rubrique concerne B2C Commerce.
Les codes promo comportant des espaces au début ou à la fin sont tronqués au cours de l'exportation et un message d'avertissement est émis.
Emplacement d'importation de Business Manager
Importation des bons de réduction
La procédure d'importation des bons de réduction et l'interface des bons de réduction de Business Manager présentent les mêmes restrictions en termes de validation.
Sont interdits :
- Nombres négatifs pour limite par code, limite par client, limite par période>limite ou limite par période>période ; et pour nombre maximal de codes en cas de bons de réduction générés par le système.
- Limite par période>période supérieure à 999.
- Changement du type d'un bon de réduction (exception faite pour le mode REMPLACER).
- Création d'un code promo système sans nombre maximum de codes.
Sont autorisés :
- Suppression du préfixe pour les codes promo générés par le système lorsqu'il s'agit d'une chaîne vide.
- Mise à jour des paramètres des codes générés par le système, tant que le bon de réduction n’a pas été utilisé ni émis.
- Mise à jour des bons de réduction uniques, même si le code inchangé se trouve dans le fichier xml.
Pipelets
ImportCoupons
ExportCouponCodes
ExportCoupons
Granularité : bons de réduction passés.
Importation/exportation de bons de réduction pour les promotions dans B2C Commerce
Bons de réduction (pas de codes promo individuels). Cette rubrique concerne B2C Commerce.
Voici plusieurs façons d'importer/exporter les données d'un bon de réduction :
- Définitions : vous pouvez importer et exporter des définitions de bons de réduction.
- Importation : vous pouvez importer des codes promo générés par des outils externes.
- Exportation : vous pouvez exporter des codes émis et utilisés, indépendamment de l'exportation des définitions de bons de réduction mentionnée précédemment.
Utilisez coupon.xsd pour définir le fichier d'importation/exportation de vos codes promo.
- L’élément
<RedemptionLimits><limit-per-code>est un champ obligatoire, mais il n’est pas possible de le déclarer comme tel en raison des modes de mise à jour. Si cet élément n'est pas spécifié pour les nouveaux bons de réduction, le système définit une limite de 1 et émet un avertissement. - L'élément
<CouponCodes>prend en charge les mises à jour incrémentales des bons de réduction existants (fixes, à codes multiples). Cette fonction est utile si des codes promo fournis par paquets par des systèmes externes doivent être importés (par exemple, 1 000 nouveaux codes par mois).
Importation/exportation d’utilisations de bons de réduction dans B2C Commerce
Des utilisations de bons de réduction peuvent apparaître dans des exportations de commandes. Cette rubrique concerne B2C Commerce.
L'exemple XML suivant illustre une exportation de commande comprenant des données d'utilisation d'un code promo. Les utilisations de bons de réduction sont également visibles en cliquant sur .
Vous pouvez importer/exporter des utilisations de bons de réduction au format XML, ou chaque code séparément au format CSV. L’importation d’utilisations de bons de réduction doit toutefois rester exceptionnelle. Avant d’exporter des utilisations de bons de réduction d’une instance pour les importer dans une autre instance, vérifiez que toutes les informations relatives au bon de réduction et à la commande ont déjà été importées. L’importation peut dysfonctionner dans le cas contraire.
<?xml version="1.0" encoding="UTF-8"?><orders xmlns="http://www.demandware.com/xml/impex/order/2006-10-31">
<order order-no="00000004">
<order-date>2008-10-07T17:07:50.585Z</order-date>
. . .
<product-lineitems>
<product-lineitem>
<net-price>449.00</net-price>
<tax>17.96</tax>
<gross-price>466.96</gross-price>
<base-price>449.00</base-price>
. . .
<price-adjustments>
<price-adjustment>Ajustement du prix net
<net-price>-44.90</net-price>Ajustement de la taxe
<tax>-1.80</tax>Ajustement du prix brut
<gross-price>-46.70</gross-price>Ajustement du prix de référence
<base-price>-44.90</base-price>Identifiant du bon de réduction
<lineitem-text>10PercentOff</lineitem-text>Identifiant de la promotion
<promotion-id>10PercentOff</promotion-id>Campagne
<campaign-id>Demo Campaign</campaign-id>Numéro du bon de réduction
<coupon-id>a1</coupon-id>
</price-adjustment>
</price-adjustments>
</product-lineitem>
</product-lineitems>
...
</order>
</orders>Exemple de fichier XML de bon de réduction dans B2C Commerce
Vous pouvez créer des bons de réduction via Business Manager ou en important des définitions au format XML. L'exemple de fichier XML suivant illustre les principaux éléments du format d'importation de bons de réduction. Cette rubrique concerne B2C Commerce.
<coupons>Cette définition montre que le bon de réduction autorise jusqu’à 500 utilisations, une par client, et jusqu’à cinq par semaine et par client.
<coupon coupon-id="myCoupon">
<description>Description du bon</description>
<enabled-flag>true</enabled-flag>
<redemption-limits>
<limit-per-code>500</limit-per-code>
<limit-per-customer>1</limit-per-customer>
<limit-per-timeframe time-frame="week">5</limit-per-timeframe>
</redemption-limits>Par défaut, tous les bons de réduction tiennent compte de la casse. Si le code promo n'est pas sensible à la casse, il est défini ici. Cette définition ne fonctionne que pour les bons de réduction sans codes existants.
<case-insensitive>true</case-insensitive>Si le bon n'a qu'un seul code promo, il est défini ici.
<single-code>DRR94IGB49S</single-code>Dans l’exemple qui suit, les codes du bon sont générés par le système. Leur préfixe est "ABC" et 1000 codes maximum sont émis.
<virtual-codes>
<code-prefix>ABC</code-prefix>
<code-limit>1000</code-limit>
<virtual-codes>S'il en a plusieurs, ils sont répertoriés comme ceci : Pour les bons de réduction comportant un grand nombre de codes, utilisez des bons générés par le système. Voir Gestion des codes générés par le système.
</coupon>
<coupon-codes coupon-id="myCoupon">
<code>ABEEO48HD4C</code>
<code>ABRREO48H7F</code>
</coupon-codes>
...
</coupons>