Imports – Tickets (Orders)
Cet article vous montrera comment préparer des fichiers d’import pour le scope "Orders". Les données de ce périmètre représentent les tickets passés dans des magasins ou le site web, qui sont ensuite complétés avec les données «order items».
Les données dans le scope "Orders" peuvent être mises à jour avec un import ultérieur. De plus, Splio créera un objet "order" par défaut (vide) pour chaque ID de ticket dans l'import "orders" qui n'existe pas encore dans la base de données.
Sachez que Splio commence à traiter les imports dans le scope "orders" en supprimant d'abord tous les "orders items" pour chaque "order_id" trouvée dans le fichier d'import.
Conditions préalables
- Connaissance de base du format CSV et du codage UTF-8.
- La sous-séquence doit être définie dans le fichier de configuration sous le scope "orders".
- Un éditeur de texte compatible UTF-8.
- Un tableur.
- Un fichier pour réimporter tous les tickets liés à chaque «order_id» que vous mettez à jour.
Préparation d'un fichier de tickets
Modifiez le fichier d'import avec votre éditeur de texte compatible UTF-8 préféré. Si nécessaire, contrôlez le nombre et la position des colonnes avec un tableur. C'est le meilleur outil pour supprimer toutes les colonnes que vous ne souhaitez pas importer.
N'oubliez pas de sauvegarder en utilisant l'encodage UTF-8.
En-tête et colonnes
La première ligne du fichier est appelée en-tête. Il ne doit contenir que les noms des colonnes utilisées dans les lignes restantes. Si Splio traite un nom de colonne qu'il ne peut pas reconnaître, il n'importera pas le fichier.
Les colonnes suivantes sont disponibles dans le scope "orders":
- order_id - l'identifiant externe du ticket importé, comme son numéro unique ; cette colonne est obligatoire et doit être unique pour chaque ticket.
- customer_key - la colonne spéciale utilisée par Splio pour identifier les contacts dans la base de données; cette colonne est obligatoire. Vous verrez le détail dans les exemples ci-dessous. Veuillez consulter l’article Imports - Contacts pour plus de détails.
- store_id - l'id externe du magasin où le ticket a été créé, créant une relation entre les "orders" et les "stores". Cette colonne est obligatoire et doit contenir des références aux magasins précédemment importés.
- order_date - la date à laquelle le ticket a été créé. Voir «dates» ci-dessous pour plus de détails sur le formatage.
- card_code - le numéro d'une carte de fidélité liée au ticket. Il doit faire référence à une carte de membre fidélité existante. Voir «Exemple 3: tickets Loyalty» ci-dessous pour plus de détails.
- shipping_amount - représente le montant dû pour l'expédition du produit.
- discount_amount - la remise totale appliquée au ticket.
- tax_amount - le montant total de la taxe (TVA) appliqué au ticket.
- total_amount - le montant total payé.
- currency - le code à 3 lettres de la devise du ticket; s'applique à toutes les valeurs. Si aucune devise n'est indiquée, Splio prendra la devise par défaut de l'univers.
- salesperson – le vendeur en magasin lié au ticket.
- Une colonne personnalisée, si elle est définie pour les tickets de votre univers Splio.
Notez que les noms de colonnes sont toujours en minuscules.
N'oubliez pas que Splio vérifie les fichiers d’import pour les colonnes obligatoires. Vous devez inclure "order_id", "store_id" et "customer_key" pour que l'import réussisse.
Exemple 1 : clé client par défaut
Les premières lignes d'un fichier d'import "orders" utilisant la clé client par défaut (email du contact) peuvent ressembler à ceci :
order_id; customer_key; store_id; order_date; total_amount; currency
Chaque ligne se compose exactement de 6 colonnes. Le "order_id" est utilisé pour distinguer les tickets, la "customer_key" relie le ticket au contact.
Exemple 2 : champ personnalisé comme clé client
Voici un fichier d'import en utilisant une colonne personnalisée comme clé client :
order_id;customer_key;store_id;order_date;total_amount;currency
70x1bKkUt-1531738300;PPL000000045732;MGZOO;2018-06-27 12:17:27;225.00;EUR
70x1bKooY-1531738300;PPL000000007633;MGZOO;2018-06-27 12:19:23;17.00;EUR
70x1bu9Gt-1531756600;PPL000000045661;MGZOO;2018-06-27 12:22:07;112.50;EUR
Cet import est très similaire à celle de l'exemple 1, seul le type de valeurs de la "customer_key" est différent. Vous devez toujours utiliser le type de clé client défini dans votre univers Splio.
Exemple 3 : tickets Loyalty
Les tickets importés peuvent être liés à des membres Loyalty simplement en incluant le numéro de carte ("card_code"). Les tickets importés de cette manière apparaîtront alors dans la section "Loyalty" des données de contact et, entre autres, affecteront le nombre de points gagnés par le contact en tant que membre.
order_id; customer_key; store_id; card_code; order_date; total_amount; currency
72cvSYhmJ-1537635000; 72RqRjczN-1537005545@nomail.xl.cx; Internet; 72RqRjeki; 2018-09-22 13: 37: 48; 262.19; EUR
1562029508; 72TSdyzYr-1537097372@yopmail.com; Internet; 72TSdz0iy; 2019-07-01 10: 03: 45; 371.95; EUR
73XAxEvFX-1540830000; 73F3Q9dzx-1539800401@mailnesia.com; Internet; 73F3Q9nHM; 2018-10-29 17: 33: 00; 14.92; EUR
Les tickets de cet exemple affichent "card_code" comme colonne supplémentaire. Il suffit d'utiliser un tel fichier pour importer des tickets Loyalty.
Nommez votre fichier
Pour enregistrer votre fichier, utilisez un nom composé du nom de l'univers, de le scope ("orders"), de la sous-séquence et de la date actuelle. Par exemple :
myuniverse_orders_zoo_20180627.csv
Ce nom de fichier appartient à l'univers "myunivers", sous-séquence "zoo" défini pour les tickets, et est daté du 27 juin 2018.
Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.
Date
Chaque date se compose de 4 chiffres pour un an, 2 pour un mois et 2 pour un jour, suivis des heures, des minutes et des secondes, de 2 chiffres chacun. Une date correcte pour le 15 mars 2018, 13h17, prendra la forme suivante :
2018-03-15 13:37:00
Le jour et l'heure sont séparés par un espace vide. Vous pouvez omettre la partie heure et utiliser uniquement la date. Si vous le faites, Splio considérera l'heure la plus tôt possible pour la journée (minuit). Donc,
2018-03-07
est traité exactement comme si vous aviez entré
2018-03-07 00:00:00
Informations avancées
Cette partie du document contient des informations supplémentaires qui complètent le guide ci-dessus et fournissent plus de détails.
Format de fichier
Nom de fichier |
|
<universe>_abandonedcarts_<name>_<date>(_<id>).csv |
Encodage |
|
UTF-8 |
Format |
|
CSV (no multiline) |
Séparateur de colonnes |
|
; (semicolon) |
Qualificateur de texte |
|
" (double quote, optional) |
Caractère d'échappement |
|
\ (backslash) |
Fin de ligne |
|
\n or \r\n |
Séparateur décimal |
|
. (dot) |
Format du champ de date |
|
yyyy-mm-dd HH:MM:SS or yyyy-mm-dd |
Si un champ de date dans le fichier n'est pas conforme au format ci-dessus, l'import ne sera pas traité.
Colonnes
Les sections ci-dessous décrivent les colonnes (champs) utilisables lors de la construction ou de la modification des fichiers de tickets.
/! \ N'oubliez pas que tous les noms de colonne sont sensibles à la casse. Pour cette raison, les noms par défaut sont tous en minuscules.
Colonne |
Obligatoire |
Type de données / longueur maximale |
Description |
order_id |
Oui (voir ci-dessus) |
Texte (max.50 caractères) |
L'identifiant externe du ticket importé. |
customer_key |
Oui (voir ci-dessus) |
(varie) |
Cette colonne fait référence à la clé client de le scope des contacts. Son type correspond à celui de la colonne clé. |
order_completed |
N/A |
Booléen (TRUE) |
TRUE dans cette colonne indique que le ticket a été validé (il ne s'agit pas d'un panier abandonné). Cette colonne est validée automatiquement par Splio et ne doit pas être incluse dans les fichiers CSV. |
store_id |
Oui |
Texte (max.50 caractères) |
Utilisé pour référencer l'ID externe du magasin où le ticket a été créé. Splio créera un nouveau magasin s'il rencontre une valeur qu'il ne peut pas reconnaître. |
order_date |
Oui |
Date |
Date à laquelle le ticket a été créé. Doit être conforme au format aaaa-mm-jj HH: MM: SS ou aaaa-mm-jj (si la partie horaire est omise, 00:00:00 sera utilisée). |
card_code |
Non |
Texte |
Numéro d'une carte de fidélité existante. Lorsqu'elle est présente, le ticket est considérée comme un "ticket Loyalty". |
shipping_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant dû pour l'expédition du ticket. |
discount_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant de la remise appliquée au ticket. |
tax_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant de la taxe appliquée au ticket. |
total_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant total payé pour les articles du ticket et de l'expédition, moins la remise. |
currency |
Non |
Texte (max.120 caractères) |
La devise utilisée. |
salesperson |
Non |
Texte (max.120 caractères) |
Le vendeur est lié au ticket. |
<custom> |
Non |
Texte (max.120 caractères) |
Voir ci-dessous |
La fonction d'import de Splio permet d'utiliser des champs personnalisés qui ont été configurés dans votre univers. Pour inclure un champ personnalisé dans l'en-tête, utilisez le nom technique du champ (lettre minuscule "c" suivie de son identifiant numérique).
Par exemple, si vous avez un champ appelé "promo" dans votre scope "tickets" et que son identifiant est 5, vous devez utiliser "c5" comme nom de la colonne. Vous pouvez inclure autant de champs (colonnes) personnalisés dans vos fichiers d’import que définis pour le scope donné dans votre univers Splio. Chaque nom de colonne ne doit être utilisé qu'une seule fois.
Gardez également à l'esprit que si Splio ne peut pas reconnaître le nom d'une colonne, il n'importera pas le fichier.
Surveillance
Les informations suivantes sont mises à disposition par Splio après l'import.
- Le nombre de lignes OK et KO
- Le nombre de lignes créées et mises à jour (la somme sera les lignes OK)
Mais les données ne sont pas disponibles si :
- L'import est abandonné ou n'est pas traité
- La raison pour laquelle une ligne a été sautée
Lorsqu'il est présent dans le dossier imports /, où vous téléchargez le fichier .csv à importer, vous devez aller dans les logs / folders pour trouver les logs des imports. De même, les fichiers importés se trouvent dans / imports / archives /.