Interface: SHOP - Codes promotionnels version 2020.20

Ce document décrit l'interface AbaConnect Codes promotionnels de l'application SHOP .


Informations générales

Informations générales sur l'interface.

Information de l'interface AbaConnect
Application:SHOP
Nom de l'interface:Codes promotionnels
ID:XML PromotionCode ( Masterdata )
Version:2020.20
Status:Productif


Fonctions d'exportation et d'importation possibles de l'interface

Fonctions exportation/importation
Exportation:XML
Importation:XML


Informations complémentaires sur l'interface

Information complémentaire

                                  Révision champ Maximum de l'interface : 0



Informations de mappage

Les informations relatives au mappage sont affichées ci-dessous.

Informations de mappage
ID mappage:AbaDefault
Nom du mappage:Codes promotionnels
Description:

                



Exemple d'une structure XML AbaConnect

Ci-dessous un exemple d'une structure Header XML. Cette information est donc visible dans un fichier d'exportation XML AbaConnect, fichier exporté via l'interface AbaConnect Abacus.

Structure XML AbaConnect
<?xml version='1.0' encoding='UTF-8'?>
<AbaConnectContainer>
  <TaskCount>1</TaskCount>
  <Task>
    <Parameter>
      <Application>SHOP</Application>
      <Id>XML PromotionCode</Id>
      <MapId>AbaDefault</MapId>
      <Version>2020.20</Version>
      <!-- Attention: Le numéro de mandant est facultatif et signifie que les données ne peuvent être importées que dans le mandant spécifié -->
      <!-- L'option mandant a un effet uniquement lors de l'importation des données. Configuration possible dans les paramètres d'exportation AbaConnect. -->
      <!-- Par défaut, le numéro de mandant n'est pas écrit dans le fichier d'exportation -->
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <PromotionCode mode='SAVE'>
          <!-- Les champs spécifiques des données pour l'interface AbaConnect peuvent être définis ici. -->
      </PromotionCode>
    </Transaction>
  </Task>
</AbaConnectContainer>



Exemple AbaConnect Command Line

Voici quelques exemples de la ligne de commande AbaConnect. La ligne de commande AbaConnect peut être exécutée avec les programmes abaconnectexportconsole.exe et abaconnectimportconsole.exe. La ligne de commande AbaConnect doit être exécutée directement sur le serveur. Vous trouverez de plus amples informations sur la page d'accueil d'Abacus. Les exemples suivants servent de point de départ pour la création d'une ligne de commande simple.

AbaConnect Command Line
Export :
abaconnectexportconsole.exe "/USRuser" "/PWxxx"  "-aSHOP"  "-version2020.20"  "-M7777"  "-acidXML PromotionCode"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aSHOP"  "-version2020.20"  "-M7777"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-importfileX:\data.xml"

N.B. : Pour importer des données XML, il n'est pas nécessaire de spécifier l'ID d'interface et le mappage dans la Command Line. Cette information se trouve dans le fichier d'importation XML.



Champs / structure du mappage

La table suivante affiche les données du mappage de manière simplifiée.
Le nom de l'élément XML et du parent est toujours écrit en anglais. Avec un clic de la souris sur une ligne, des informations supplémentaires sont affichées.

Nom élément XML Nom du champ Nom parent Type Longueur Obligatoire
PromotionCodeCodes promotionnels---Oui
    - PromotionNoNuméro promotionnelPromotionCodeNuméro8Non
    - PromotionCodeCode promotionnelPromotionCodeTexte50Oui
    - CurrencyMonnaiePromotionCodeTexte3Oui
    - ValidFromValable dèsPromotionCodeDate/heure-Oui
    - ValidUntilValable jusqu'auPromotionCodeDate/heure-Non
    - TextIDId du textePromotionCodeNuméro14Non
    - ProductAssortmentNoNuméro d'assortimentPromotionCodeNuméro14Non
    - DiscountInPercentRabais en pourcentagePromotionCodeNuméro4Non
    - DiscountAmountMontant du rabaisPromotionCodeNuméro12Non
    - FreePromotionProductProduit d'action gratuitPromotionCodeNuméro8Non
    - FreePromoProdQtyqté de produits gratuitsPromotionCodeNuméro8Non
    - IsOneTimePerCustomerValable qu'une seule foisPromotionCodeBooléen-Non
    - AllowedCustomerTypeClients autorisésPromotionCodeNuméro2Non
    - MinOrderValueLimitValeur de commande minimalePromotionCodeNuméro12Non



Informations détaillées des champs

Description détaillée des champs de l'interface.

Numéro promotionnel
Nom élément XML:PromotionNo
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   8Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   1
Description:

                                  (Le champ ID internes pour cet élément est "PROMOTION_NO")
                    

Code promotionnel
Nom élément XML:PromotionCode
Elément parent:PromotionCode
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   50Décimales:   0Champ obligatoire:   OuiRévision:   0ID Ascii:   2
Description:

                                  (Le champ ID internes pour cet élément est "PROMOTION_CODE")
                    

Monnaie
Nom élément XML:Currency
Elément parent:PromotionCode
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   3Décimales:   0Champ obligatoire:   OuiRévision:   0ID Ascii:   3
Description:

                                  (Le champ ID internes pour cet élément est "CURRENCY")
                    

Valable dès
Nom élément XML:ValidFrom
Elément parent:PromotionCode
Type de champ:Date/heure (2006-08-08T10:16:54.509+02:00)
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   OuiRévision:   0ID Ascii:   4
Description:

                                  (Le champ ID internes pour cet élément est "VALID_FROM")
                    

Valable jusqu'au
Nom élément XML:ValidUntil
Elément parent:PromotionCode
Type de champ:Date/heure (2006-08-08T10:16:54.509+02:00)
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   5
Description:

                                  (Le champ ID internes pour cet élément est "VALID_UNTIL")
                    

Id du texte
Nom élément XML:TextID
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   14Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   6
Description:

                                  (Le champ ID internes pour cet élément est "TEXT_ID")
                    

Numéro d'assortiment
Nom élément XML:ProductAssortmentNo
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   14Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   7
Description:

                                  (Le champ ID internes pour cet élément est "PRODUCT_ASSORTMENT_NO")
                    

Rabais en pourcentage
Nom élément XML:DiscountInPercent
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   4Décimales:   2Champ obligatoire:   NonRévision:   0ID Ascii:   8
Description:

                                  (Le champ ID internes pour cet élément est "DISCOUNT_IN_PERCENT")
                    
Un point doit être utilisé comme séparateur de décimales selon la définition de W3C pour le XML Standard.

Montant du rabais
Nom élément XML:DiscountAmount
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   12Décimales:   4Champ obligatoire:   NonRévision:   0ID Ascii:   9
Description:

                                  (Le champ ID internes pour cet élément est "DISCOUNT_AMOUNT")
                    
Un point doit être utilisé comme séparateur de décimales selon la définition de W3C pour le XML Standard.

Produit d'action gratuit
Nom élément XML:FreePromotionProduct
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   8Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   10
Description:

                                  (Le champ ID internes pour cet élément est "FREE_PROMOTION_PRODUCT")
                    

qté de produits gratuits
Nom élément XML:FreePromoProdQty
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   8Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   11
Description:

                                  (Le champ ID internes pour cet élément est "FREE_PROMOTION_PRODUCT_QUANTITY")
                    

Valable qu'une seule fois
Nom élément XML:IsOneTimePerCustomer
Elément parent:PromotionCode
Type de champ:Booléen (true/false)
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   12
Description:

                                  (Le champ ID internes pour cet élément est "IS_ONE_TIME_PER_CUSTOMER")
                    

Clients autorisés
Nom élément XML:AllowedCustomerType
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   2Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   13
Description:

                                  (Le champ ID internes pour cet élément est "ALLOWED_CUSTOMER_TYPES")
                    

Valeur de commande minimale
Nom élément XML:MinOrderValueLimit
Elément parent:PromotionCode
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   12Décimales:   4Champ obligatoire:   NonRévision:   0ID Ascii:   14
Description:

                                  (Le champ ID internes pour cet élément est "MIN_ORDER_VALUE_LIMIT")
                    
Un point doit être utilisé comme séparateur de décimales selon la définition de W3C pour le XML Standard.