Clienti

Definizione dei campi

I campi obbligatori sono contrassegnati da una matita. Le definizioni dei campi si basano sulla sintassi MySQL.

L'identificazione di un cliente esistente avviene tramite il numero cliente esterno (external) o il numero cliente interno (id). Se non viene trovata alcuna corrispondenza, viene creato un nuovo cliente.

È possibile importare più indirizzi per ogni cliente. Ogni indirizzo viene specificato come nodo <address> separato all'interno del blocco <addresses>. Il primo indirizzo viene automaticamente impostato come indirizzo di consegna e fatturazione predefinito.

I gruppi di clienti possono essere definiti nel blocco opzionale « <groups> » prima dei dati dei clienti. I gruppi esistenti vengono aggiornati in base all'ID, mentre i nuovi gruppi vengono creati automaticamente.

Tramite il blocco " <extra_fields>" è possibile trasmettere campi aggiuntivi sotto forma di coppie nome-valore. I seguenti campi vengono elaborati in modo specifico:

A partire dalla versione 4.8.6 dello Shop, all’interno dell’elemento « <customer> » è possibile trasmettere un nodo opzionale « <discounts> ». Ogni voce « <discount> » corrisponde a una riga di sconto nel campo «Sconti» della gestione clienti (x % sulla categoria N).

Se nel negozio sono presenti più account cliente con lo stesso numero cliente esterno (ad es. più referenti di un’azienda), a partire dalla versione 4.8.8 dello Shop gli sconti trasmessi vengono applicati automaticamente a tutti gli account associati a tale numero. I restanti dati del cliente (nome, e-mail, indirizzi) non vengono modificati.

Per il nodo <discounts> si applica la semantica «Sostituisci, se presente»:

• Nodo con voci presenti: l’intero elenco degli sconti del cliente viene sostituito.
• Nodo vuoto (<discounts></discounts>): tutti gli sconti del cliente vengono rimossi.
• Nodo mancante: gli sconti rimangono invariati – i collegamenti esistenti non modificano nulla.

Il flag di attivazione interno del cliente viene aggiornato automaticamente: gli sconti hanno effetto immediato nel negozio online.

Interazione con i prezzi personalizzati per cliente: per impostazione predefinita, uno sconto di categoria viene applicato in aggiunta a un prezzo personalizzato per cliente (lo sconto si riflette quindi sul prezzo del cliente). A partire dalla versione 4.8.8 del negozio, è possibile disattivare questa funzione tramite l’impostazione «Sconti di categoria sui prezzi personalizzati» nella configurazione del negozio: il prezzo personalizzato diventa quindi il prezzo finale ed è escluso dallo sconto.

Esempio all’interno dell’elemento « <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>

Esempio XML

Il file XML deve rispettare la seguente convenzione di denominazione:
Customers(.)*.xml

Percorso di salvataggio: /xoport/xml/import/

Avviare l'importazione: /xpanel/xoport/import_customers.php (alias a partire dalla versione 4.8.6 dello shop: 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>

Scarica la definizione XSL