Clients

Définition des champs

Les champs obligatoires sont signalés par un crayon. Les définitions des champs se réfèrent à la syntaxe MySQL.

L'identification d'un client existant s'effectue via le numéro de client externe (external) ou le numéro de client interne (id). Si aucune correspondance n'est trouvée, un nouveau client est créé.

Plusieurs adresses peuvent être importées par client. Chaque adresse est spécifiée sous la forme d’un nœud <address> distinct au sein du bloc <addresses>. La première adresse est automatiquement définie comme adresse de livraison et de facturation par défaut.

Les groupes de clients peuvent être définis dans le bloc optionnel « <groups> » situé avant les données client. Les groupes existants sont mis à jour à l'aide de leur ID, tandis que les nouveaux groupes sont créés automatiquement.

Le bloc « <extra_fields> » permet de transmettre des champs supplémentaires sous forme de paires nom-valeur. Les champs suivants font l'objet d'un traitement spécifique :

À partir de la version 4.8.6 de la boutique, un nœud facultatif « <discounts> » peut être transmis au sein de l’élément « <customer> ». Chaque entrée « <discount> » correspond à une ligne de remise dans le champ « Remises » de la gestion des clients (x % sur la catégorie N).

Si la boutique comporte plusieurs comptes clients portant le même numéro de client externe (par exemple, plusieurs interlocuteurs d’une même entreprise), les remises transmises sont automatiquement appliquées, à partir de la version 4.8.8 de la boutique, à tous les comptes associés à ce numéro. Les autres données client (nom, e-mail, adresses) ne sont pas concernées par cette modification.

Pour le nœud « <discounts> » , la sémantique « Remplacer si présent » s’applique :

• Nœud contenant des entrées : l'ensemble des remises du client est remplacé.
• Nœud vide (<discounts></discounts>): toutes les remises du client sont supprimées.
• Nœud absent : les remises restent inchangées – les liaisons existantes n’ont aucune incidence.

Le drapeau d'activation interne du client est automatiquement mis à jour – les remises s'appliquent immédiatement dans la boutique.

Interaction avec les prix personnalisés : par défaut, une remise de catégorie s’applique en plus d’un prix personnalisé (la remise s’applique alors au prix client). À partir de la version 4.8.8 de la boutique, il est possible de désactiver cette fonctionnalité via le paramètre « Remises par catégorie sur les prix personnalisés » dans la configuration de la boutique – le prix personnalisé est alors le prix final et n’est pas concerné par la remise.

Exemple dans l’élément « <customer> » :

<discounts>
  <discount>
    <category_id>0</category_id>
    <value>8,5</value>
  </discount>
  <discount>
    <category_id>22</category_id>
    <subcategories>0</subcategories>
    <value>15</value>
    <special>1</special>
  </discount>
</discounts>

Exemple XML

Le fichier XML doit respecter la convention de nommage suivante :
Customers(.)*.xml

Emplacement de stockage : /xoport/xml/import/

Lancer l'importation : /xpanel/xoport/import_customers.php (alias à partir de la version 4.8.6 de la boutique : update_customers.php).

<?xml version="1.0" encoding="UTF-8"?>
<customer_data>

  <!-- Kundengruppen (optional) -->
  <groups>
    <group>
      <id>1</id>
      <name>Standardkunde</name>
    </group>
    <group>
      <id>2</id>
      <name>Premium</name>
    </group>
  </groups>

  <!-- Kundendaten -->
  <customers>
    <customer>
      <id></id>
      <external>ERP-12345</external>
      <group_id>1</group_id>
      <language>de</language>
      <gender>m</gender>
      <firstname>Max</firstname>
      <lastname>Mustermann</lastname>
      <email_address>max@example.com</email_address>
      <telephone>+49 371 123456</telephone>
      <newsletter>1</newsletter>
      <addresses>
        <address>
          <gender>m</gender>
          <firstname>Max</firstname>
          <lastname>Mustermann</lastname>
          <company>Meine GmbH</company>
          <tax_id>DE123456789</tax_id>
          <street_address>Hauptstraße 1</street_address>
          <postcode>09247</postcode>
          <city>Chemnitz</city>
          <country_code>DE</country_code>
          <state>Sachsen</state>
        </address>
      </addresses>
      <extra_fields>
        <extra_field>
          <name>belegsperre</name>
          <value>false</value>
        </extra_field>
      </extra_fields>
      <discounts>
        <discount>
          <category_id>0</category_id>
          <value>8,5</value>
        </discount>
      </discounts>
    </customer>
  </customers>

</customer_data>

Télécharger la définition XSL