Cette fonctionnalité vous permet de configurer des imports automatiques qui seront lancés toutes les nuits à partir d'un fichier CSV via FTP(S).

Ce fichier CSV doit être créé et importé sur un espace de stockage accessible via le protocole FTP(S) de votre choix.

Vous devrez ensuite configurer les accès de cet espace dans SPREAD pour que nous puissions nous y connecter toutes les nuits pour importer les données.

Pour des raisons de sécurité, il est fortement conseillé de réserver un espace de stockage FTP dédié à cette fonctionnalité, avec des accès dédiés à SPREAD.

Traitement des colonnes

Si, dans le fichier fourni, certains colonnes ne respectent pas le format attendu, l'ensemble de la ligne sera ignorée et non importée.

Caractéristiques du fichier CSV

Encodage	UTF-8
Caractère séparateur	;
Caractère délimiteur pour les champs texte	"

Correspondance des colonnes

Colonne du fichier	Format attendu	Détails	Peut être vide ?
name	Chaîne	100 caract. max	Oui
firstname	Chaîne	100 caract. max	Oui
email	Chaîne (adresse email valide)	100 caract. max	Oui (si `email_encrypted` est fourni)
email_encrypted	Chaîne	255 caract. max. Doit être un md5 de l'adresse email.	Oui (si `email` est fourni)
external_id	Chaîne	250 caract. max.	Oui (si `email` ou `email_encrypted` est fourni)
language	Chaîne	120 caract. max	Oui
birthday	Date	Format : yyyy-mm-dd	Oui
gender	Chaîne	male : homme female : femme	Oui
address	Chaîne	250 caract. max	Oui
cp	Chaîne	20 caract. max	Oui
city	Chaîne	250 caract. max	Oui
country	Chaîne	100 caract. max	Oui
company	Chaîne	100 caract. max	Oui
occupation	Chaîne	100 caract. max	Oui
phone	Chaîne	25 caract. max	Oui
mobile	Chaîne	25 caract. max	Oui
creation_date	Date + Heure	yyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide ) Correspond à la date de création du compte sur votre site.
order_id	Chaîne
order_num	Chaîne
order_status	Numérique	-1 : Erreur 0 : Annulée 10 : Enregistrée 20 : Payée 50 : Envoyée 100 : Reçue par le client
order_creation_date	Date + Heure	yyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide )
order_amount	Numérique	Peut être à virgule. Jusqu'à 7 chiffres avant la virgule, 2 après

Importer des champs personnalisés

Vous pouvez également importer des valeurs pour les champs personnalisés configurés pour votre site.

Le nom de colonne attendu pour importer un champ personnalisé est customfield_XXXX où "XXXX" est l'identifiant numérique unique de votre champ personnalisé.

Par exemple si votre champ a l'identifiant "123456", le nom de la colonne sera customfield_123456.

La liste des identifiants de vos champs personnalisés est disponible dans "Paramétrage > Tracker > Exemples de code" de votre backoffice SPREAD.

En fonction du type de champ, voici les informations à connaître pour la définition des valeurs dans vos fichiers d'import :

Type du champ	Format attendu	Détails
Champ texte	Chaîne	500 caractères max
Champ numérique	Numérique	Peut être à virgule (sera arrondi à 5 chiffres après la virgule). Les zéros en début de chaîne seront supprimés.
Oui / Non	Numérique (1 chiffre max)	-1 : Non 1 : Oui
Champ date	Date + Heure	yyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" (veut dire vide)
Choix unique (boutons radio)	Chaîne	La valeur sélectionnée parmi les choix configurés dans votre champ personnalisé
Choix multiples (cases à cocher)	Chaîne	Liste des valeurs sélectionnées, séparées par un "pipe" (" \| " : sous mac Alt + Maj + L, sous windows Alt gr + 6) Exemple Pour un choix multiple dont la question serez "Quels animaux possédez vous?". Réponses possibles : Chien, Chat, Hamster, Rat Lors d'un import vous pouvez remplir ce champs de la sorte : Chien\|Chat\|Rat

Notez qu'il n'est pas nécessaire de définir tous vos champs personnalisés dans votre fichier d'import si vous souhaitez n'en importer qu'un : vous n'avez qu'à définir seulement ceux que vous souhaitez importer.

Importer des consentements

Vous pouvez également importer des consentements configurés pour votre site.

Pour importer un consentement, vous devez importer 2 colonnes :

la valeur du consentement :
1. elle doit avoir pour valeur soit 1 pour "Oui / Consentement accepté", soit 0 pour "Non / Consentement refusé"
2. le nom de cette colonne est `consent_date_XXXXX` où XXXXX est le nom technique du consentement, disponible sur la page de configuration du consentement en question, sous le nom "Identifiant technique".
la date d'acceptation ou de refus du consentement
1. elle doit avoir pour valeur la date à laquelle le consentement a été accepté ou refusé par le client
2. le nom de cette colonne est `consent_value_XXXXX` où XXXXX est le nom technique du consentement, disponible sur la page de configuration du consentement en question, sous le nom "Identifiant technique".

Importer des attributs produits

Vous pouvez également importer les attributs produits de vos commandes.

Pour importer un ou plusieurs attributs, vous devez importer autant de colonnes que de groupes d'attributs. Les colonnes doivent obligatoirement avoir un nom qui respecte le format suivant :

product_attributes_X où X est un chiffre. Chaque chiffre doit être différent d'une colonne à l'autre.

Vous devrez donc avoir autant de colonnes d'attributs produits que le maximum d'attributs produit que vous aurez sur une commande.

Les différents attributs au sein d'un groupe d'attributs doivent être séparés par un pipe ("|").

Exemple :

Nom:pantalon|Couleur:bleu foncé|taille:38

Ceci ajoutera un groupe d'attributs produits avec 3 attributs : Nom, Couleur et taille qui auront les valeurs ci-dessus assignées.

Vous pouvez ajouter autant d'attributs produits que vous souhaitez par groupe de produits ; de plus, il n'est pas obligatoire qu'ils soient identiques.

Browser not supported