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.