Système de synchronisation des offres d’un revendeur

La vente du stock d’un revendeur nécessite que l’information sur la présence ou non à la vente d’un article soit la plus exacte possible. Pour cela des mises à jour régulières depuis le système de gestion du revendeur sont nécessaires. Vous trouverez sur cette page la description du système tel qu’il a été mis en place sur la plateforme leslibraires.fr.

Description générale

Les échanges se font par fichiers CSV à déposer sur le serveur FTP du site leslibraires.fr. Un compte est attribué à chaque revendeur. La fréquence de ces mises à jour est au minimum quotidienne.

Le nom du fichier CSV

Le fichier doit être nommé selon le schéma suivant :

Préfix
OFFERS pour indiquer que c’est un fichier contenant des offres de revendeur.
Numéro de revendeur
Sur 8 chiffres en complétant par des zéros.
Date de création du fichier
Au format AAAAMMDDHHMMSS
Type d’opération
UPDATE ou INIT. Dans le cas d’une opération UPDATE, seules les offres présentes dans le fichier seront affectées. En revanche, l’opération INIT réinitialise l’ensemble des offres d’un revendeur avec les offres présentes dans le fichier. Les offres affichées sur la plateforme qui ne sont pas présentes dans un fichier INIT seront effacées.
Suffix
Par défaut .csv. Il est vivement conseiller de compresser les fichiers avant envoi (surtout dans le cas d’un fichier INIT). Nous préférons les compressions GIZP ou BZIP2 ce qui donne respectivement .csv.gz et .csv.bz2 comme suffix.

Le tout séparé par des caratères _.

Voici un exemple de nom de fichier:

OFFERS_00000117_20100602213400_UPDATE.csv.bz2

Les champs à inclure dans le fichier CSV

Numéro de revendeur
Celui qui vous a été communiqué lors de l’ouverture du compte.
EAN13
L’ean13 de l’article.
Type de l’offre
New pour les articles neufs ou Secondhand pour les articles d’occasion.
Quantité en stock
Ne pas oublier d’enlever de la quantité en stock le nombre d’articles réservés pour des clients.
Réassort possible
1 ou 0 selon que le revendeur est en mesure de se réapprovisionner ou pas. Ne rien mettre (champ vide) quand on a pas l’information.
Délai avant expédition
Délai en jour pour que l’article soit expédié après réception de la commande.
Quantité maximale commandable
La quantité maximale de cette offre dans un panier. Si 0, ce sera la limite générale qui s’applique à toute la plateforme.
Prix TTC
Le prix TTC (prix public TTC non remisé pour un livre) de l’article, en €, avec 2 décimales.
Taux TVA 1
Le taux de TVA principal.
Prix HT 1
La base du prix correspondant au taux de TVA principal.
Taux TVA 2
0 s’il n’y en a pas besoin.
Prix HT 2
0 s’il n’y en a pas besoin.
Taux TVA 3
0 s’il n’y en a pas besoin.
Prix HT 3
0 s’il n’y en a pas besoin.

Voici un exemple de ligne de mise à jour:

2,"9782745918161","New",2,1,1,0,19.90,5.5,11.37,19.6,6.61,0,0

Un autre format CSV, avec des champs supplémentaires

Ce format reprend les champs du format précédent. On ajoute quelques colonnes permettant de communiquer des informations bibliographiques. Cela permet de vendre des articles qui seraient absents de notre base de données.

Info 1
La désignation principale d’un article. Pour un livre, le titre.
Info 2
L’auteur d’un livre, ...
Info 3
L’éditeur d’un livre, la marque d’un jouet, ...
Date de sortie
La date de parution d’un livre, de mise à la vente d’un jouet, ... Format AAAAMMJJ ou AAAAMM ou AAAA.
Codes catégories
Les codes des catégories dans votre système. Permet de classer les articles que vous nous envoyez correctement dans notre base de données. Il faut pour cela nous envoyer au préalable vos systèmes de classification avec leurs codes. S’il y a plusieurs codes, les séparer par :.

Voici un exemple de ligne de mise à jour:

2,"9782070138098","New",2,1,1,0,22.50,5.5,21.33,0,0,0,0,"La théorie de l'information","Aurélien Bellanger","Gallimard",20120822,RC

Autres formats

Nous acceptons beaucoup d’autres formats. Il n’est pas nécessaire de développer un export spécifique à notre plateforme si vous avez déjà des échanges en place vers d’autres systèmes. Nous traitons par exemple les fichiers de remonter de stock vers Amazon, des fichiers en ONIX 2.1 et 3.0.

Les envois

Les fichiers sont à déposer sur le serveur FTP de leslibraires.fr. Les détails de connexion vous seront transmis à la création de votre compte de revendeur.

La fréquence des mises à jour doit être au moins quotidienne. Dans le cas d’un fichier UPDATE, la mise à jour peut reprendre l’ensemble des modifications sur une période supérieure à l’inverse de la fréquence. On peut envoyer par exemple l’ensembles des modifications des dernières 48h toutes les 24h. Cela permet un rattrapage automatique si un transfert échoue.