Imports automatiques
- Yves Piquel (Unlicensed)
- Stéphane Larzet (Unlicensed)
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 |
| 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 |
| 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)
|
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 :
- elle doit avoir pour valeur soit 1 pour "Oui / Consentement accepté", soit 0 pour "Non / Consentement refusé"
- 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
- elle doit avoir pour valeur la date à laquelle le consentement a été accepté ou refusé par le client
- 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_Xoù 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.