wikintpv

le wiki de KinTPV

Outils pour utilisateurs

Outils du site


04-rubrique-article:07-importer-des-articles:fenetre-importer-articles

Import d'articles par fichier tableur

L'import d'articles permet de créer ou de mettre à jour rapidement un grand nombre de produits à partir d'un fichier tableur (Excel, LibreOffice, OpenOffice…).

Avant d'intégrer les données dans KinTPV, l'assistant d'import contrôle la cohérence des informations et signale les éventuelles anomalies afin de limiter les erreurs.

Si vous importez un catalogue important, nous vous conseillons de commencer par un essai sur une dizaine d'articles avant de lancer l'import complet.

L'import d'articles est conçu pour créer une base complète.
À partir d'un fichier unique, KinTPV peut créer automatiquement les articles, leurs déclinaisons, les fournisseurs, les types d'articles, les critères, les marques, les prix, les stocks, les catégories web et l'ensemble des informations associées.

Import rapide

L'import se déroule toujours selon les étapes suivantes :

  1. Préparer le fichier d'import.
  2. L'enregistrer au format Texte avec séparateur tabulation.
  3. Sélectionner le fichier depuis le menu “Importer des articles” de KinTPV.
  4. Associer les colonnes du fichier aux champs KinTPV (si nécessaire).
  5. Vérifier la cohérence des données et identifier les éventuelles anomalies.
  6. Corriger le fichier d'origine si nécessaire, puis relancer l'import.
  7. Lancer l'import.

Avant de commencer

Par défaut, l'outil d'import attend un fichier texte avec séparateur tabulation (tsv).

Depuis Excel, LibreOffice ou OpenOffice, utilisez Enregistrer sous… ou Exporter… puis choisissez le format Texte (séparateur tabulation).

Un fichier texte tabulé reste un fichier tableur : il contient toujours des lignes et des colonnes de données.

Pour un premier import, il n'est pas nécessaire de renseigner toutes les colonnes disponibles.

Dans la majorité des cas, seules quelques informations suffisent :

  • Référence article
  • Code-barres (ou génération automatique)
  • Type d'article
  • Nom de l'article
  • Prix de vente (facultatif mais conseillé)

Toutes les autres colonnes sont optionnelles et pourront être utilisées selon vos besoins.


Options de l'import

L'écran de contrôle des données propose 3 fonctionnalités pour la gestion de l'import.

Choix de la valeur unique

La donnée unique permettant de rechercher chaque produit (décliné ou non) est :

  • la Référence Article (par défaut) [01]
  • ou le code-barres général de l'article [02]
  • ou la référence fournisseur [12]

Dans le cas d'articles déclinés (par taille, couleur, longueur, diamètre ou ce que vous voulez), cette valeur doit être recopiée sur chacune des lignes de déclinaison.
Si vous souhaitez indiquer une référence unique par déclinaison, utilisez la colonne “Ref_Decli” [51].

Dossier des photos

Si des noms de fichiers images (jpg ou png) sont indiqués dans le fichier d'import, lesdits fichiers doivent tous être présents dans un dossier à indiquer au logiciel.
Les fichiers seront alors recopiés dans le dossier Image de KinTPV.

"Tarif" du Prix de Vente

Pour KinTPV, un Tarif est un ensemble de Prix de Vente, chacun ayant sa propre date d'application.
Le Tarif “DEFAUT” (= boutique) est pré-sélectionné, mais il est possible d'attribuer le Prix de Vente du fichier à un autre Tarif.

Fichier "sur mesure"

Vous pouvez créer un fichier d'import ne comportant que les colonnes qui vous conviennent.
Il suffit de vérifier que le fichier répondre aux spécifications requises.

A la 1ère étape de l'import, vous devrez “lier” manuellement les colonnes de votre fichier avec les champs correspondants de la base KinTPV.
Par exemple, la colonne 1 avec “Reference_Article”, Colonne 2 avec “Nom_Article”, etc.
Vous pouvez enregistrer (puis recharger) votre configuration d'import, vous évitant ainsi de refaire les liens à chaque import.

Mais en utilisant notre matrice (fichier présent dans le dossier d'installation de KinTPV sur votre ordinateur), vous vous vous évitez la longue étape de correspondance des colonnes.

Fichier "matrice"

Pour vous faciliter la création du fichier texte d'import, voici une matrice qui répertorie les différentes colonnes à remplir.

Ouvrez le fichier sous Excel pour remplir les colonnes avec vos données, puis enregistrez-le en format texte. Matrice d'import d'article pour KinTPV
Notez que cette matrice se trouve aussi dans le dossier KinTPV installé sur votre machine.

Pour ouvrir le fichier sous OpenOffice, remplacez l'extension “.txt” par “.csv”.

Attention, à vérifier avant l'import :

Données existantes

Si des données existent déjà dans KinTPV, des noms de fournisseurs ou de déclinaison par exemple, respectez scrupuleusement l'orthographe, sous peine d'avoir ces données en doublon.

Choix des colonnes à importer

La fenêtre d'import vous permet de choisir les colonnes à importer.

Une fois le fichier créé et enregistré en format texte tabulé, importez le dans KinTPV par l'onglet “Articles Stocks-Inventaires” menu “importer des articles”.

Après avoir choisi le fichier, l'écran de choix des colonnes s'affiche.

Depuis cet écran, vous pouvez :

  • Définir les délimiteurs, utile pour le délimiteur de fin d'enregistrement.
  • Choisir les colonnes à importer : Par exemple si vous ne voulez pas mettre à jour le stock des articles, vous devez sélectionner dans le titre de la colonne de stocks “Non importée”, ou si vous voulez utiliser les code-barres automatiques, vous devez sélectionner dans le titre de la colonne des code-barres “Non importée”.

Remarque : la présence d'une ligne d'en-tête n'empêche pas l'import. Elle sera simplement signalée comme erronée et ignorée par KinTPV.

Vérification de la cohérence des données

Cet écran vous indique les incohérences majeures dans les différentes lignes importées et vous permez de choisir le dossier pour l'import des images liées aux articles.

Cliquez sur la ligne qui pose problème pour visualiser son compte rendu dans l'encadré en bas à droite.

Documentation de référence

Le tableau ci-dessous constitue la documentation complète du format d'import de KinTPV.

Il n'est pas nécessaire de renseigner toutes les colonnes. Consultez uniquement les colonnes que vous souhaitez utiliser.

Les colonnes obligatoires sont clairement indiquées dans leur description.

Description complète des colonnes

Légende
Obligatoire
Unique
Optionnel
& ET
/ Selon le contexte
Colonne Info

Identification

01
&
Reference_Article
[texte]
si le Choix de la valeur unique est “Référence Article”.

Pour les articles avec déclinaisons, répétez cette référence pour chaque ligne de déclinaison.

Si le Choix de la valeur unique N'est PAS “Référence Article”
et que vous souhaitez une référence générée automatiquement par KinTPV, indiquez __AUTO__.

Note : si vous souhaitez indiquer une référence unique par déclinaison, utilisez la colonne “Ref_Decli” [51].
02
&
Code_Barre
[texte]
si le Choix de la valeur unique est “par Code Barre”.

Répétez alors cette valeur pour chaque ligne d'un article décliné.

Si le Choix de la valeur unique N'est PAS “par Code Barre”
- pour un article décliné, indiquez impérativement __AUTO__
- pour un non-décliné, faute de code-barres fabricant, indiquez __AUTO__ pour une création automatique d'un code-barres.

Note : pour un article décliné, si vous souhaitez indiquer un code-barres unique par déclinaison, renseignez la colonne “Code_Barre_Decli” [49].

– x –

Si l'article possède plusieurs codes-barres, séparez-les par le caractère “2 points” (“:”), exemple :
4052916086674:4009900491365:3276007395716
03 Type_Article
[texte]
Type d'article permettant de regrouper des produits similaires (liste simple, sans hiérarchie).
Si le type n'existe pas encore, il est créé automatiquement lors de l'import.
04 Nom_Article
[texte]
Libellé principal de l'article. Utilisé sur les tickets, devis et factures.

Valeur des six critères principaux de l'article.
Les libellés affichés dans KinTPV (Dominant, Saison, Genre, etc.) peuvent être personnalisés dans les Préférences.


05 Dominant (Critère 8)
[texte]
Valeur du critère Dominant.
06 Saison (Critère 9)
[texte]
Valeur du critère Saison.
07 Genre (Critère 10)
[texte]
Valeur du critère Genre.
08 Famille (Critère 11)
[texte]
Valeur du critère Famille.
09 Couleur (Critère 12)
[texte]
Valeur du critère Couleur.
10 Marque (Critère 7)
[texte]
Valeur du critère Marque.

Informations fournisseur

11 Nom_Fournisseur
[texte]
Nom du fournisseur principal.
12
/
Ref_Fournisseur
[texte]
si le Choix de la valeur unique est “par Référence Fournisseur”.

Pour les articles avec déclinaisons, répétez cette référence pour chaque ligne de déclinaison.

Dans les autres cas, cette information est optionnelle
13 Designation1_Fournisseur
[texte]
Désignation utilisée chez le fournisseur.
14 Designation2_Fournisseur
[texte]
Complément de désignation fournisseur.
15 Description*
[texte]
Description courte de l'article, utile pour le web.

Propriétés

16 VenteEnPortion_0_1
[0 ou 1]
vide ou 0 = non/faux, 1 = oui/vrai
17 PublierSurWeb_0_1
[0 ou 1]
vide ou 0 = non/faux, 1 = oui/vrai
18 Poids
[0…9,.]
Poids de l'article (en kg).

Prix & Stock

19 Declinaison*
[texte]
Nom(s) et valeur(s) de la/des déclinaison(s) (taille, couleur, pointure…).
Voir le chapitre consacré aux déclinaisons.
20 PrixAchat_HT
[0…9,.] sans devise
Prix d'achat hors taxes.
Si la valeur est présente, alors la “DateApplication_PrixAchat” est obligatoire
21 RemisePourcent_PrixAchat
[0…9,.] sans “%”
Si renseigné, le prix de revient est calculé.
22 FraisApproche_PrixAchat_HT
[0…9,.] sans devise
Si renseigné, le prix de revient est calculé.
23 PrixValoStock_PrixAchat_HT
[0…9,.] sans devise
24 DateApplication_PrixAchat
[jj/mm/aaaa]
Date de prise d'effet du prix d'achat.
Obligatoire si PrixAchat_HT renseigné.
25
/
TauxTaxe_TVA
[0…9,.] sans “%”
Obligatoire si PrixVente_TTC renseigné et importé
26 PrixVente_TTC
[0…9,.] sans devise
Si présent, “DateApplication_PrixVente” est alors obligatoire. ATTENTION, pour vendre un article, KinTPV impose d'avoir un Prix de Vente. Il pourra être défini manuellement ultérieurement.
27
/
DateApplication_PrixVente
[jj/mm/aaaa]
Obligatoire si PrixVente_TTC renseigné et importé.
Date à partir de laquelle le Prix de Vente prend effet.
28 QteEnStock
[0…9]
Quantité à ajouter au stock actuel. Lors de la création d'un article, cette valeur correspond donc au stock initial.

Paramètres de la commande fournisseur automatique

29 CmdAuto_StockMini
[0…9]
Seuil minimum avant proposition de commande.
Si présent, les colonnes “CmdAuto_” doivent être renseignées.
30 CmdAuto_Colisage
[0…9]
Quantité d'un colis fournisseur.
Si présent, les colonnes “CmdAuto_” doivent être présentes.
31 CmdAuto_QteACommander
[0…9]
Quantité fixe ou calculée à commander (Cf. colonne CmdAuto_CalculerQte_0_1).
Si présent, les colonnes “CmdAuto_” doivent être présentes.
32 Nom_Autre_Fournisseur
[texte]
Fournisseur(s) secondaire(s) de l'article.
33 Ref_Autre_Fournisseur
[texte]
Références de l'article chez les autres fournisseurs.

Critères supplémentaires

34 Critere_1
[texte]
Valeur du critère supplémentaire n.1.
35 Critere_2
[texte]
Valeur du critère supplémentaire n.2.
36 Critere_3
[texte]
Valeur du critère supplémentaire n.3.
37 Critere_4
[texte]
Valeur du critère supplémentaire n.4.
38 Critere_5
[texte]
Valeur du critère supplémentaire n.5.
39 Critere_6
[texte]
Valeur du critère supplémentaire n.6.
40 NumSerie
[texte]
Numéro de série de l'article.
41 Ref_Fourn_Decli
[texte]
Référence fournisseur propre à cette déclinaison.

Web

42 Description_Complete*
[texte]
Description détaillée de l'article destinée au site web.
43 Meta_Title
[texte]
Titre utilisé pour le référencement (SEO).
44 Meta_Keyword
[texte]
Mots-clés SEO.
45 Meta_Description
[texte]
Description SEO.
46 URL_Simple
[texte]
Adresse simplifiée de la fiche article.
47 Categorie_Web*
[texte]
Catégorie(s) du site web dans laquelle apparaîtra l'article.
Voir le paragraphe dédié à ce sujet.
48 IdExterneNe pas renseigner (laisser la colonne vide), information pour traitement interne.
49 Code_Barre_Decli
[texte]
Code-barres spécifique à cette déclinaison.
Si la déclinaison de l'article possède plusieurs codes-barres, séparez-les par le caractère “2 points” (“:”), exemple :
4052916086674:4009900491365:3276007395716
50 Poids_Decli
[0…9,.]
Poids spécifique de cette déclinaison.
51 Ref_Decli
[texte]
Référence propre à cette déclinaison.
52 Image_Article*
[texte]
Nom du ou des fichiers image à importer pour cet article.
Voir le paragraphe dédié à ce sujet.
53 WEB_QteMiniCMD
[0…9]
Quantité minimale pouvant être commandée sur le site web.
54 WEB_MsgEnStk
[texte]
Message affiché sur le site web lorsque l'article est en stock.
55 WEB_MsgHorsStock
[texte]
Message affiché sur le site web lorsque l'article est en rupture de stock.
56 WEB_DateDispo
[jj/mm/aaaa]
Date de disponibilité affichée sur le site web.
57 WEB_SiRuptureChoix
[0, 1 ou 2]
Comportement du site en cas de rupture de stock.
0 = Valeur par défaut (comme défini sur le site)
1 = Refuser les commandes
2 = Accepter les commandes
58 ServiceHorsStock_0_1
[0 ou 1]
Indique si l'article est un service (pas de gestion de stock) ou un produit physique (gestion de stock activée).

Infos supplémentaires

59 ArticleEpuise_0_1
[0 ou 1]
Indique si l'article est épuisé chez le fournisseur. Lorsqu'il est épuisé, il ne peut plus être proposé lors des commandes fournisseur.
60
/
CmdAuto_CBColis
[texte]
Code-barres du colis fournisseur.
Si présent, les colonnes “CmdAuto_” doivent être présentes.
61
/
CmdAuto_CalculerQte_0_1
[0 ou 1]
0 = quantité fixe,
1 = quantité calculée.

* = Voir description ci-dessous.

Encodage des déclinaisons

Pour importer des articles avec des déclinaisons (taille, couleur, pointure, etc.), vous devez renseigner la colonne Declinaison.

Chaque combinaison de déclinaisons correspond à une ligne dans le fichier d'import. Les informations communes à l'article (référence, nom, marque, etc.) doivent être répétées sur chaque ligne.

Exemple avec une seule déclinaison

L'article Polo existe en deux tailles : M et XL.

Reference_Article Nom_Article Declinaison
REF_POLO_01 Polo TAILLE=M
REF_POLO_01 Polo TAILLE=XL

Lors de l'import, KinTPV crée automatiquement la déclinaison TAILLE si elle n'existe pas encore, ainsi que les valeurs M et XL.

Exemple avec plusieurs déclinaisons

Vous pouvez combiner plusieurs déclinaisons dans une même colonne en les séparant par le caractère :.

Reference_Article Nom_Article Declinaison
REF_POLO_01 Polo TAILLE=M:COULEUR=JAUNE
REF_POLO_01 Polo TAILLE=M:COULEUR=VERT
REF_POLO_01 Polo TAILLE=XL:COULEUR=JAUNE
REF_POLO_01 Polo TAILLE=XL:COULEUR=VERT

Dans cet exemple, KinTPV crée automatiquement les déclinaisons TAILLE et COULEUR, ainsi que leurs différentes valeurs.

Limitation : un article peut comporter au maximum 3 niveaux de déclinaisons.

Les combinaisons comportant 4 niveaux ou plus (par exemple HAUTEUR + LARGEUR + COULEUR + MATIÈRE) ne sont pas prises en charge.

Encodage des catégories Web

Pour affecter un ou plusieurs emplacements Web à un article, renseignez la colonne Categorie_Web.

Chaque catégorie est indiquée sous la forme d'un chemin, en séparant les différents niveaux par le caractère >.

Si un article doit apparaître dans plusieurs catégories, indiquez chaque chemin entre accolades.

Exemple :

{Accueil>Vêtement>Polo}

Le même article peut être présent dans plusieurs catégories :

{Accueil>Vêtement>Polo}{Accueil>Vêtement>Nouveautés}

Lors de l'import, les catégories inexistantes sont créées automatiquement.

Respectez le nom des catégories ainsi que leur hiérarchie.
Une différence d'orthographe ou de casse entraîne la création d'une nouvelle catégorie.

Encodage des images liées à l'article

Pour associer une ou plusieurs images à un article, renseignez la colonne Image_Article.

Indiquez uniquement le nom des fichiers image.
Si un article possède plusieurs images, séparez-les par le caractère “:”.

Exemple :

image1.jpg:image2.jpg:image3.jpg

Toutes les images doivent être regroupées dans un même dossier.
Ce dossier sera sélectionné dans l'écran de Vérification de l'import.

Lors de l'import :

  • Les images sont ajoutées à celles déjà associées à l'article.
  • La première image devient l'image principale, uniquement si l'article n'en possède pas déjà une.
  • Les images suivantes sont enregistrées comme images supplémentaires (onglet Web de la fiche article).

Pour les articles avec déclinaisons, ne renseignez la colonne Image_Article que sur la première ligne de l'article.

Si cette colonne est répétée sur chaque ligne de déclinaison, les mêmes images seront importées plusieurs fois.

Caractères spéciaux

Avant d'importer votre fichier, vérifiez qu'il ne contient pas de tabulations ou de retours à la ligne dans les champs texte (notamment Description et Description_Complete).

Ces caractères sont utilisés pour structurer le fichier d'import et ne peuvent donc pas être présents directement dans les données.

Pour les conserver dans un texte, remplacez-les par les mots-clés suivants :

Caractère Windows macOS
Tabulation Kin_9 Kin_9
Retour à la ligne Kin_13Kin_10 Kin_13

Saisissez uniquement les mots-clés (sans les guillemets).
Lors de l'import, KinTPV les remplacera automatiquement par les caractères correspondants.

Correspondance des colonnes d'un fichier d'import avec les champs KinTPV

Reportez vous à la numérotation du tableau explicatif de la matrice pour répérer à quoi chaque colonne du fichier correspond dans l'interface de KinTPV.

Exemples

Fichier de 6 articles non-déclinés

Reference_Article Code_Barre Type_Article Nom_Article Dominant Saison Genre Famille Couleur Marque Nom_Fournisseur Ref_Fournisseur Designation1_Fournisseur Designation2_Fournisseur Description VenteEnPortion_0_1 PublierSurWeb_0_1 Poids Declinaison PrixAchat_HT RemisePourcent_PrixAchat FraisApproche_PrixAchat_HT PrixValoStock_PrixAchat_HT DateApplication_PrixAchat TauxTaxe_TVA PrixVente_TTC DateApplication_PrixVente QteEnStock CmdAuto_StockMini CmdAuto_Colisage CmdAuto_QteACommander Nom_Autre_Fournisseur Ref_Autre_Fournisseur Critere_1 Critere_2 Critere_3 Critere_4 Critere_5 Critere_6 NumSerie Ref_Fourn_Decli Description_Complete Meta_Title Meta_Keyword Meta_Description URL_Simple Categorie_Web IdExterne Code_Barre_Decli Poids_Decli Ref_Decli Image_Article WEB_QteMiniCMD WEB_MsgEnStk WEB_MsgHorsStock WEB_DateDispo WEB_SiRuptureChoix ServiceHorsStock_0_1 ArticleEpuise_0_1 CmdAuto_CBColis CmdAuto_CalculerQte_0_1
PTR714-V8 __AUTO__ Poisson Tanichtys Orpheus PTR714-V8
RBN846-P0 3256225048427 Aquarium monob90x60x60 SubMarin MarSystem RBN846-P0
RES367-K4 3700006255011 Aquarium monob70x50x50 SubMarin MarSystem RES367-K4
POT984-G9 __AUTO__ Poisson Tropheus Orpheus POT984-G9
bidule766 __AUTO__ Poisson Misgurnus Orpheus POM431-A2
T64238461 4056489007166 Plante Anubia LaBotanik T64238461

Fichier de 3 articles, dont 2 déclinés

Reference_Article Code_Barre Type_Article Nom_Article Dominant Saison Genre Famille Couleur Marque Nom_Fournisseur Ref_Fournisseur Designation1_Fournisseur Designation2_Fournisseur Description VenteEnPortion_0_1 PublierSurWeb_0_1 Poids Declinaison PrixAchat_HT RemisePourcent_PrixAchat FraisApproche_PrixAchat_HT PrixValoStock_PrixAchat_HT DateApplication_PrixAchat TauxTaxe_TVA PrixVente_TTC DateApplication_PrixVente QteEnStock CmdAuto_StockMini CmdAuto_Colisage CmdAuto_QteACommander Nom_Autre_Fournisseur Ref_Autre_Fournisseur Critere_1 Critere_2 Critere_3 Critere_4 Critere_5 Critere_6 NumSerie Ref_Fourn_Decli Description_Complete Meta_Title Meta_Keyword Meta_Description URL_Simple Categorie_Web IdExterne Code_Barre_Decli Poids_Decli Ref_Decli Image_Article WEB_QteMiniCMD WEB_MsgEnStk WEB_MsgHorsStock WEB_DateDispo WEB_SiRuptureChoix ServiceHorsStock_0_1 ArticleEpuise_0_1 CmdAuto_CBColis CmdAuto_CalculerQte_0_1
RBN846-P0 __AUTO__ Poisson Tanichtys Sexe=Mâle
RBN846-P0 __AUTO__ Poisson Tanichtys Sexe=Femelle
BOtrdm960 3700006255011 Aquarium monob90x60x60
SX969482R __AUTO__ Poisson Misgurnus Couleur=Blanc
SX969482R __AUTO__ Poisson Misgurnus Couleur=Bleuâtre
SX969482R __AUTO__ Poisson Misgurnus Couleur=Bleu
04-rubrique-article/07-importer-des-articles/fenetre-importer-articles.txt · Dernière modification : de KinTPV

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki