STD-Flux-MP-Comptoir-Santé 2015-02-16

Spécifications Techniques Détaillées des
flux
(STD)
> Version du
16/02/2015
> Destinataires Le Comptoir Santé
Frédéric GOJARD
Fabien DURAIN
Marie-Bénédicte MANOUVRIER
> Destinataires TE
Chi-Dang VUONG
Stéphane HERVÉ
Equipe développement TE
Rédacteurs : Stéphane Hervé, Antoine Friteau
1 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation
Table des matières
1. Objectifs .........................................................................................................................................3
2. Flux d’import ................................................................................................................................4
2.1.1 Description....................................................................................................................................................... 4
2.1.2 Caractéristiques du flux .............................................................................................................................. 4
2.1.3 Structure des données................................................................................................................................. 5
2.1.4 Règles de gestion lors de la génération ou traitement du fichier.............................................. 7
2 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation
1. Objectifs
Ce document décrit les flux d’imports produits et le format à respecter pour une bonne
intégration dans le site e-commerce www.comptoirsante.com.
Dans ce contexte, le présent document se propose de décrire les nouvelles fonctionnalités
nécessaires pour la mise en place du flux d’import catalogue produits utile à la Marketplace
du site de vente en ligne Comptoir santé.
Ce document est un document de travail. Sa forme n’est donc pas définitive. Il sera
agrémenté au fur et à mesure des réunions et retours de chacun des intervenants.
Les développements étant en cours, les éléments sont susceptibles d’évoluer et d’être
complétés.
Remarque :
● Surligné en jaune dans le document : éléments à confirmer par le client ou
l’intégrateur.
3 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation
2. Flux d’import
2.1 Flux d’import catalogue
2.1.1 Description
Le flux d’import catalogue permet de créer dans le site e-commerce de Comptoir Santé (Magento), les
différents produits de Comptoir Santé ou des marchands et qui serviront ensuite de support pour les
offres. Le fichier décrit ci-après correspond au format du fichier de produits après mapping dans le
module MCI de Mirakl. Il contient donc tous les attributs nécessaires à la création du produit dans
Magento.
A noter : le fichier du marchand peut contenir plus d’attributs que ce format de fichier mappé. En
revanche, il sera alors nécessaire pour le marchand d’effectuer dans le BO de Mirakl, le mappage des
attributs de son fichier d’entrée avec celui défini dans cette documentation.
2.1.2 Caractéristiques du flux
Le flux d’import « Catalogue » se base sur les éléments suivants :
Protocole de communication :
● Le fichier sera déposé sur le serveur SFTP du site e-commerce Comptoir Santé dans un
répertoire dédié (à définir).
Nom du fichier :
● Catalogue-Produits<Nom-Marchand>.csv
● Pour exemple : « Catalogue-Produits-CopineBio.csv »
Encodage :
● L’encodage supporté est UTF-8 sans BOM.
Format du fichier :
● CSV
● Chaque colonne du fichier correspond à un champ de donnée.
● Chaque ligne du fichier correspond à un produit à créer dans le site e-commerce.
● Certains champs seront définis obligatoires pour la création des produits dans le site ecommerce (attributs minimum pour la création du produit). En cas d’erreur, l’application
tracera l’incident en indiquant les erreurs présentes pour le ou les enregistrements se trouvant
dans cette situation.
Sens du flux
● SI Mirakl marchands >> Site e-commerce Comptoir Santé.
Fréquence d'exécution
● Traitement batch depuis le dépôt et import dans la base de données du site e-commerce.
● L’import peut se faire quotidiennement.
4 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation
2.1.3 Structure des données
Attribut Mirakl /
Correspondance Magento
Type /
Détail
Obligatoire
type
(*)
category_id /category_id
N, /O
Bio / bio
N
Capacité UVC / uvc_capacity
T
Category_ids / category_ids
N, /O
Code ACL / acl_code
T
Oui/non
Liste
multiple
Taille
Description / Règles de gestion
max
Exemple
10
Id category – défini le type de produit à créer Valeurs possibles
LCS – Appareil = 21
LCS – Capillaire = 23
LCS – Complément alimentaire = 25
LCS – Cosmétique = 27
LCS – Minceur = 29
LCS – Produit Standard = 31
LCS – Solaire = 33
LCS – Textile = 35
LCS – Vétérinaire = 37
21
1
Le produit est-il Bio. Valeurs possibles (1/0)
0
255
Capacité du produit
100
10
Catégorie d’appartenance du produit dans
l’arborescence de navigation – Il faut renseigner un
id correspond à la valeur souhaité de la catégorie
10 ou 10,15,410
Choix multiple séparé par
des virgules et sans
espace
255
Attribut spécifique à Comptoir Santé
« Extrait d’Avoine
Rhealba® → Apaise la
peau
Composition / composition
T
Description / description
T, O/
developed length in cm /
developed_length
N
DLC / dlc
N
EAN / ean
T, O/
L'avis du pharmacien
/ pharmacist_review
T
Name / name
PAHT / cost
Price / price
Short Description / short_description
Texte
(**)
Texte
(**)
Oui/non
20000
Composition du produit
20000
Description du produit – Texte ou format HTML
10
Longueur du produit
1
13
Le produit a-t-il une Date limite de Conservation du
produit. Valeurs possibles (0/1)
Code EAN du produit
Mirakl (operator) Restriction du format numérique
possible.
20000
Avis du pharmacien sur le produit vendu – Texte ou
format HTML
T, O/
255
Nom du produit
N
12 ou
(9+2)
N, O/
12 ou
(9+2)
T, O/
Texte
(**)
Texte
(**)
Prix d’achat HT du produit
12 chiffres sans décimales max ou 9 entiers + 2
décimales
Mirakl (operator) Restriction du format possible.
Prix du produit. Exprimé en Euros.
Mirakl (operator) Restriction du format possible.
20000
Description courte du produit / affiché en haut de la
fiche produit
SKU / sku
T, O/
255
SKU du produit
Unité de capacité /
unit_uvc_capacity
T
255
Unité de capacité du produit
20000
Utilisation du produit
Utilisation / usage
T
Texte
(**)
Oxyde de zinc → Protège
la peau
Suspension aqueuse de
silicates de magnésium →
Assèche la peau »
« Cytélium Lotion
Assèchante des
laboratoires A-Derma est
un soin de la peau
asséchant, protégeant des
irritations cutanées
suintantes.
Cette Lotion est … »
50
1
3282779284721
Cytélium Spray Asséchant
100 ml
5.50
138.60
« Soin assèchant, apaisant
et protège des irritations
cutanées suintantes - Bébé
- Enfant – Adulte »
Ml
5 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation
Portion recommandée /
lgl_cplm_journaliere
Vitamines / lgl_cplm_vitamines
Quantité net / lgl_cplm_quantite
Minéraux / lgl_cplm_mineraux
T
255
Portion recommandée journalière et contenue dans
le produit
T
255
Liste des vitamines contenues dans le produit
T
255
Quantité net du produit
T
255
Le produit contient-il des minéreaux
1
Le produit contient-il de la caféine. Valeurs
possibles (0/1)
255
Autres substances contenues dans le produit
Caféine / lgl_cplm_coffee
N
Autres substances /
lgl_cplm_substances
T
Taille / size
Oui/non
N
Liste
10
N
Liste
10
Fournisseur / fournisseur
N
Liste
10
Color / Color
N
Liste
10
Texture / Texture
N
Liste
10
Marque / brand
N
Liste
10
Gamme / range
N
Liste
10
Laboratoire / manufacturer
N
Liste
10
Manufacturer's Suggested Retail
Price / msrp
N
Conseillé pour / product_target
12 ou
(9+2)
Taille du produit / Il faut renseigner un id
correspondant à la valeur souhaité / Liste de valeurs
possibles:
« L », « M », « S », « XL »
Produit conseillé pour / Il faut renseigner un id
correspond à la valeur souhaité / Liste de valeurs
possibles :
« Adulte »
« Animaux »
« Enfant »
« Femme »
« Homme »
« Tous »
Fabricant du produit / Il faut renseigner un id
correspond à la valeur souhaité / Liste de valeurs
possibles :
« F3CLAV »
« FABOCA »
« FACTIVE»
« FADERMA »
Etc…
Couleur du produit / Il faut renseigner un id
correspond à la valeur souhaitée / Liste de valeurs
possibles :
« Beige »
« Beige Nude »
« Blanc »
« Blanc nacré »
Etc…
Mirakl (vendeur): Possibilité de mappé plusieurs
nuances de couleur à une seule (bleu ciel -> bleu,
bleu foncé -> bleu)
Texture du produit / Il faut renseigner un id
correspond à la valeur souhaitée / Liste de valeurs
possibles :
« Ampoules »
« Après Shampoing »
« Barre Céréalière »
« Baume »
Etc…
Marque du produit / Il faut renseigner un id
correspond à la valeur souhaitée / Liste de valeurs
possibles :
« 2 faces »
« 3 chenes »
« 3 claveles »
Etc…
Gamme de produit / Il faut renseigner un id
correspond à la valeur souhaitée / Liste de valeurs
possibles :
« 1er Soins Bébés »
« 9 mois »
« Abcderm »
Etc…
Laboratoire et fabricant du produit / Il faut
renseigner un id correspond à la valeur souhaitée /
Liste de valeurs possibles :
« F3CHENE »
« FGALLET »
Etc…
Prix conseillé par le fabricant
Mirakl (operator) Restriction du format possible
0
604
5
676
2188
601
2261
965
3
7.99
6 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation
tax_class_id
N, /O
Image / image
T
Liste
10
Groupe de classe de taxes du produit / Il faut
renseigner un id correspondant à la valeur de la
taxe
« Exonéré »
« None »
« Normale »
« Réduite »
« Réduite 7% »
2
2000
Url valide d’une image
https://www.lcs.com/media/
product.jpg
(*) T = Texte, N= Numérique, D= Date, /O = champ obligatoire
(**) Texte libre, attention tous les caractères sont autorisés
Remarque : les correspondances entre id et les valeurs de listes seront fournies dans des exports.
Dans le tableau ci-dessus, les valeurs données sont fournies à titre d’exemple. Il ne faut pas donc pas
utiliser les id mentionnés.
2.1.4 Règles de gestion lors de la génération ou traitement du fichier
Id. Règle
Type (**)
Description des règles de gestion, de contrôle, d’affichage et
d’administration
RE-IMP-CAT-01
RG
Les fichiers CSV traités pour l’import des produits marchands seront
supprimés du répertoire de l’application e-commerce sur le serveur SFTP.
RE-IMP-CAT-02
RG
Le caractère point-virgule ‘ ;’ est le caractère de séparation des champs
RE-IMP-CAT-03
RG
Les fichiers d’import doivent respecter les contraintes de champs
obligatoires, les types et longueurs maximales définis dans le tableau cidessus.
RE-IMP-CAT-04
RG
Les enregistrements se retrouvant en erreur seront enregistrés dans un
fichier de log. Il est donc nécessaire de s’assurer de la qualité des fichiers
fournis.
RE-IMP-CAT-05
RG
Les enregistrements contenus dans le fichier seront uniquement créés
dans le système e-commerce. Il n’y a pas de mise à jour possible via cet
import produits.
RE-IMP-CAT-06
RG
Il est important de supprimer les espace et blancs précédant ou finissant
chacune des valeurs. Utilisation d’un « Trim() » en pré-traitement.
FIN DU DOCUMENT
7 /7
Copyright Technology Everywhere © 2015 – Toute reproduction interdite sans autorisation