Documentation technique KWISATZ

Import TCB

L’utilitaire WKW_IMPORT_TCB.EXE importe un catalogue de prêt-à-porter ou de produits à variantes sous forme de modèles et de cellules Tailles–Couleurs–Bonnets. Chaque ligne du fichier décrit une variante, tandis que le champ Modèle regroupe les variantes sous un article générique.

Télécharger cette fiche en PDF
Fiche : IMP-TCB-001 Module : Produits / Prêt-à-porter Public : intégrateur ou technicien Risque : critique Catégorie : Articles, tarifs et nomenclaturesMise à jour : 6 août 2026

Réponse directe

Préparez un fichier ASCII avec une première ligne de titres, le séparateur ; et les colonnes dans l’ordre imposé. Créez auparavant toutes les couleurs, tailles et bonnets dans les nomenclatures. Lancez ensuite WKW_IMPORT_TCB.EXE -DCODE_DOSSIER, chargez le fichier, corrigez les éventuels journaux du dossier LOG, puis exécutez Outils > Recalculs/Contrôle > Articles — Contrôle des fiches.
Testez toujours l’import sur une copie récente du dossier. Le traitement crée ou alimente de nombreuses fiches parent/enfant et peut générer des lignes d’inventaire pour chaque magasin.

Conseil technicien général

1. Repères de version

Les références de version ci-dessous sont conservées comme repères documentaires. Les menus, options et comportements doivent être contrôlés sur la version et la sérialisation réellement installées ; une évolution plus récente peut avoir modifié le fonctionnement.

2. Comprendre la structure TCB

Élément Rôle Exemple
Article modèle ou générique Parent commun regroupant toutes les variantes. TEE-SHIRT ALPHA
Couleur Premier axe de la grille. Noir, Blanc, Marine
Taille Deuxième axe de la grille. S, M, L, XL
Bonnet Troisième axe lorsqu’une grille 3D est utilisée. A, B, C, D
Cellule ou enfant Produit vendable correspondant à une combinaison précise. TEE-SHIRT ALPHA / Noir / M

Toutes les lignes portant la même valeur dans la colonne Modèle sont destinées au même parent. Chaque combinaison couleur, taille et bonnet représente une cellule enfant.

L’utilitaire affecte la valeur Modèle au code interne du parent. La valeur EAN source est affectée au code interne de l’enfant dans la procédure documentée.
Si vous attendez également un code-barres commercial dans une table de codes BIS, effectuez un test unitaire : le comportement documenté de cet utilitaire place l’EAN dans le code interne de la cellule.

3. Prérequis avant import

  • sauvegarde complète et restaurable du dossier ;
  • version KWISATZ compatible avec l’utilitaire ;
  • WKW_IMPORT_TCB.EXE provenant de la même installation ;
  • code du dossier cible confirmé ;
  • nomenclatures Couleurs, Tailles et Bonnets complétées ;
  • codes fournisseurs, rayons, familles, lignes et marques validés ;
  • valeurs par défaut des nouvelles fiches renseignées ;
  • stratégie de stocks et magasins définie ;
  • fichier pilote limité à un ou deux modèles ;
  • plan de contrôle des parents, cellules, prix et stocks.

Valeurs par défaut obligatoires

Avant de lancer l’import, renseignez dans l’utilitaire les valeurs à appliquer aux fiches créées, notamment :

  • mode Saisie TTC ;
  • code TVA ;
  • autres valeurs générales demandées par la fenêtre ;
  • options de prix, stock et article propres au dossier.
Une TVA ou un mode de saisie HT/TTC incorrect se répercute sur tous les modèles et toutes les cellules créés pendant le traitement.

4. Préparer les nomenclatures

L’utilitaire ne crée pas automatiquement les couleurs, tailles et bonnets manquants. Il vérifie leur présence avant l’intégration.

  1. Extrayez la liste distincte des couleurs du fichier source.
  2. Extrayez la liste distincte des tailles.
  3. Extrayez la liste distincte des bonnets pour les grilles 3D.
  4. Créez chaque valeur dans les grilles de nomenclature KWISATZ.
  5. Respectez exactement les libellés, espaces et accents.
  6. Définissez l’ordre d’affichage souhaité des tailles et couleurs.
  7. Testez manuellement la création d’un modèle avec ces nomenclatures.
« Bleu Marine », « BLEU MARINE » et « Bleu marine » peuvent être considérés comme des valeurs différentes selon les règles de comparaison de la version. Normalisez le fichier avant import.
La colonne Bonnet doit rester à la position prévue dans le fichier. Elle est utilisée pour les grilles 3D ; suivez le modèle officiel même pour un catalogue principalement en deux dimensions.

5. Format général du fichier

Règle Valeur attendue
Type de fichier Fichier ASCII ou CSV lisible par l’utilitaire.
Première ligne Titres des colonnes obligatoires.
Séparateur Point-virgule ;.
Ordre Strictement celui de la documentation.
Une ligne Une cellule TCB ou variante.
Numériques Valeurs sans symbole monétaire ; format décimal à tester avec les paramètres régionaux de l’installation.
Lignes vides Interdites ; elles provoquent un rapport d’erreur.

Exemple simplifié sans stocks magasins

MODELE;EAN;DESIGNATION;COULEUR;TAILLE;BONNET;PA;PVTTC;CODE_FOURNISSEUR;NOM_FOURNISSEUR;CODE_RAYON;LIBELLE_RAYON;CODE_FAMILLE;LIBELLE_FAMILLE;CODE_LIGNE;LIBELLE_LIGNE;CODE_MARQUE;LIBELLE_MARQUE;STOCKSITE
TSHIRT-ALPHA;3700000000011;Tee-shirt Alpha;NOIR;S;;8,50;19,90;FOU001;TEXTILE SA;10;TEXTILE;101;TEE-SHIRTS;1;BASIQUES;ALPHA;ALPHA;2
TSHIRT-ALPHA;3700000000028;Tee-shirt Alpha;NOIR;M;;8,50;19,90;FOU001;TEXTILE SA;10;TEXTILE;101;TEE-SHIRTS;1;BASIQUES;ALPHA;ALPHA;3
TSHIRT-ALPHA;3700000000035;Tee-shirt Alpha;BLANC;S;;8,50;19,90;FOU001;TEXTILE SA;10;TEXTILE;101;TEE-SHIRTS;1;BASIQUES;ALPHA;ALPHA;1
Cet exemple illustre l’ordre logique des colonnes. Utilisez en priorité le fichier exemple livré avec votre version et validez le séparateur décimal sur un modèle pilote.

6. Détail des colonnes 1 à 19

N° Nom Type Destination ou usage
1 Modèle Alphanumérique obligatoire Référence commune parent/enfants ; affectée au code interne du parent.
2 EAN Alphanumérique Code fournisseur de la variante ; affecté au code interne du produit enfant dans l’import documenté.
3 Désignation Alphanumérique Libellé du produit.
4 Couleur Alphanumérique obligatoire Nom exact d’une couleur présente dans la nomenclature.
5 Taille Alphanumérique obligatoire Nom exact d’une taille présente dans la nomenclature.
6 Bonnet Alphanumérique, colonne obligatoire Troisième dimension des grilles 3D ; doit correspondre à la nomenclature lorsqu’elle est renseignée.
7 PA Numérique Prix d’achat du produit.
8 PVTTC Numérique Prix de vente TTC.
9 Code fournisseur Alphanumérique Code du fournisseur du produit.
10 Nom fournisseur Alphanumérique Libellé du fournisseur.
11 Code rayon Entier Code de classement rayon.
12 Libellé rayon Alphanumérique Libellé du rayon.
13 Code famille Entier Code de classement famille.
14 Libellé famille Alphanumérique Libellé de la famille.
15 Code ligne Entier Code de classement ligne.
16 Libellé ligne Alphanumérique Libellé de la ligne.
17 Code marque Alphanumérique Code de la marque.
18 Libellé marque Alphanumérique Libellé de la marque.
19 Stock site Numérique Stock du site principal ; génère une ligne d’inventaire.
Ne déplacez pas une colonne vide vers la fin du fichier. Même non renseignée, elle doit rester à sa position afin de ne pas décaler toutes les données suivantes.

7. Colonnes de stocks magasins 20 à 118

Les colonnes suivantes correspondent aux stocks MAG01 à MAG99. Elles sont facultatives, mais leur ordre est strict lorsqu’elles sont présentes.

Règle de continuité

Pour renseigner le stock du magasin 4, le fichier doit contenir : 

STOCKSITE;MAG01;MAG02;MAG03;MAG04

Les colonnes MAG01 à MAG03 doivent exister même si leurs valeurs sont vides.

Colonnes Contenu Conséquence
19 Stock site Génère une ligne d’inventaire pour le site.
20 Stock MAG01 Génère une ligne d’inventaire pour le magasin 1.
21 Stock MAG02 Génère une ligne d’inventaire pour le magasin 2.
… Magasins successifs Les positions intermédiaires doivent être conservées.
118 Stock MAG99 Dernier magasin prévu par le format documenté.
L’utilitaire renseigne le stock des enfants et génère les mouvements d’inventaire. Le stock du modèle parent doit ensuite être recalculé à partir de ses cellules.
Importer un stock dans un dossier déjà exploité peut doubler ou modifier la situation attendue si des inventaires existent déjà. Testez sur une copie et définissez une date de reprise claire.

8. Contrôler le fichier avant import

  1. Vérifiez que la première ligne contient les titres.
  2. Comptez le même nombre de séparateurs sur chaque ligne.
  3. Supprimez les lignes totalement vides.
  4. Vérifiez que chaque ligne possède un Modèle, une Couleur et une Taille.
  5. Vérifiez les bonnets pour les grilles 3D.
  6. Normalisez les espaces en début et fin de valeur.
  7. Contrôlez les doublons de combinaison Modèle/Couleur/Taille/Bonnet.
  8. Contrôlez l’unicité des EAN ou codes internes enfants.
  9. Vérifiez les valeurs numériques négatives ou aberrantes.
  10. Vérifiez la continuité des colonnes magasins.
  11. Conservez une copie non modifiée du fichier source.
La documentation ne garantit pas le résultat d’une réimportation d’un même fichier sur des modèles déjà créés. Testez explicitement le comportement de mise à jour ou de doublon sur votre version.

9. Lancer l’import manuellement

Créer le raccourci

C:\WKW3\WKW_IMPORT_TCB.EXE -DDEMO

Remplacez DEMO par le code réel du dossier.

  1. Fermez les opérations de maintenance concurrentes.
  2. Lancez le raccourci.
  3. Vérifiez le code dossier affiché.
  4. Renseignez ou contrôlez les valeurs par défaut des fiches.
  5. Cliquez sur le bouton de sélection du fichier source.
  6. Choisissez le fichier à importer.
  7. Vérifiez son chemin dans la zone prévue.
  8. Lancez le traitement.
  9. Attendez la fin de l’analyse et de l’intégration.
  10. Conservez le compte rendu.
Le traitement charge d’abord le fichier dans une table mémoire, puis analyse les nomenclatures avant de créer les produits.

10. Journaux d’erreur

Si une anomalie de nomenclature est détectée, le traitement s’arrête et écrit des rapports dans le répertoire $DOSSIER\LOG.

Fichier Signification Correction
WKW_IMPORT_TCB_LIGNE_VIDE.LOG Le fichier source contient des lignes vides. Supprimer les lignes vides puis régénérer le fichier.
WKW_IMPORT_TCB_COULEUR_INTROUVABLE.LOG Une ou plusieurs couleurs ne sont pas présentes dans la nomenclature. Créer ou corriger les couleurs listées.
WKW_IMPORT_TCB_TAILLE_INTROUVABLE.LOG Une ou plusieurs tailles ne sont pas présentes. Créer ou corriger les tailles listées.
WKW_IMPORT_TCB_BONNET_INTROUVABLE.LOG Un ou plusieurs bonnets ne sont pas présents. Créer ou corriger les bonnets listés.
  1. Ouvrez chaque rapport.
  2. Dédupliquez les valeurs manquantes.
  3. Décidez si la valeur doit être créée ou corrigée dans le fichier.
  4. Complétez les nomenclatures dans KWISATZ.
  5. Relancez l’import depuis le fichier source corrigé.
Ne contournez pas les erreurs en remplaçant toutes les valeurs par une couleur ou une taille générique. Vous perdriez la structure commerciale du catalogue.

11. Contrôles obligatoires après import

Articles — Contrôle des fiches

Lancez : Outils > Recalculs/Contrôle > Articles — Contrôle des fiches. Cette opération valide les fiches créées et recalcule notamment les champs contenant les informations tarifaires.

Automate équivalent documenté :

C:\WKW3\KWISATZ.EXE -DTCB -A20 -P99

Contrôle de stock

Si le fichier contient des colonnes de stock, exécutez également la procédure de recalcul de stock validée pour la version afin d’alimenter les quantités des articles modèles à partir des cellules.

Contrôle métier

  1. Ouvrez la liste des produits.
  2. Filtrez sur les articles TCB génériques.
  3. Ouvrez un modèle.
  4. Vérifiez toutes les cellules couleur/taille/bonnet.
  5. Contrôlez les codes internes enfants.
  6. Contrôlez PA, PV TTC, TVA et mode Saisie TTC.
  7. Contrôlez fournisseur, rayon, famille, ligne et marque.
  8. Contrôlez les stocks du site et des magasins.
  9. Testez la sélection TCB en vente directe.
  10. Testez un achat ou inventaire sur une cellule.
Utilisez une version récente. Un ancien correctif autour de la branche 3.44 avait temporairement fait perdre le statut TCB lors du contrôle des fiches ; ce problème a été corrigé dans la version 3.44r10.

12. Informations communes et valeurs locales des cellules

Les versions récentes de KWISATZ permettent de conserver sur chaque cellule certaines valeurs différentes de celles du modèle parent.

Selon la version, les catégories personnalisables comprennent :

  • informations d’achat ;
  • informations de vente ;
  • code interne ;
  • libellé court ;
  • référence fournisseur ;
  • informations de réapprovisionnement ;
  • frais d’achat ;
  • informations du pont comptable.
Après import, une actualisation du modèle peut répercuter ses valeurs vers les cellules, sauf si les indicateurs de conservation locale sont activés. Définissez cette stratégie avant les mises à jour massives.

13. Automatiser l’import

Syntaxe documentée :

C:\WKW3\WKW_IMPORT_TCB.EXE -DCODE_DOSSIER -SFICHIER_SOURCE -A -I
Paramètre Rôle
-DCODE_DOSSIER Dossier KWISATZ cible.
-SFICHIER_SOURCE Chemin complet du fichier à charger.
-A Exécute automatiquement le traitement.
-I Iconise l’application.

Exemple

C:\WKW3\WKW_IMPORT_TCB.EXE -DTCB -S<chemin_import_validé>\Exemple_Importation_TCB.csv -A -I

Planifiez ensuite, après succès de l’import : 

C:\WKW3\KWISATZ.EXE -DTCB -A20 -P99
N’enchaînez pas automatiquement -A20 si l’import a échoué. La tâche doit contrôler le résultat, la présence des journaux d’erreur ou le fichier de compte rendu avant de poursuivre.
Utilisez des chemins locaux ou UNC accessibles au compte de la tâche Windows. Les lecteurs réseau mappés d’une session interactive peuvent être absents dans le Planificateur de tâches.

14. Recette conseillée

  1. Créer un fichier avec un modèle 2D et quatre cellules.
  2. Ajouter un modèle 3D avec quelques bonnets.
  3. Importer sans stocks.
  4. Exécuter le contrôle des fiches.
  5. Tester la grille en vente et en achat.
  6. Restaurer la copie de test.
  7. Importer le même modèle avec STOCKSITE et deux magasins.
  8. Recalculer les stocks.
  9. Comparer les stocks enfants et parent.
  10. Tester une réimportation contrôlée du même fichier.
  11. Vérifier l’absence de doublon ou documenter le comportement.
  12. Valider les journaux avant de traiter le catalogue complet.
La recette est concluante lorsque chaque modèle contient exactement les variantes attendues, que les prix et classifications sont corrects, que les stocks concordent et que la grille TCB fonctionne en vente.

15. Diagnostic rapide

Le traitement s’arrête avant de créer les produits
Consultez le dossier LOG. Une couleur, taille, un bonnet ou une ligne vide est probablement détecté. Corrigez les nomenclatures ou le fichier, puis relancez.
Toutes les colonnes sont décalées
Une colonne vide a probablement été supprimée ou une valeur contient un point-virgule non prévu. Comparez le nombre de séparateurs de chaque ligne et respectez l’ordre strict.
Le modèle parent est incorrect ou plusieurs modèles sont fusionnés
Contrôlez la colonne Modèle. Des lignes portant exactement la même valeur sont regroupées sous le même parent. Normalisez les références sans fusionner des modèles distincts.
Les cellules apparaissent comme des produits classiques
Vérifiez la version et le statut TCB après le contrôle des fiches. Utilisez une version récente ; un ancien bug corrigé en 3.44r10 affectait le statut après import.
Les prix ou champs calculés sont vides
Lancez Articles — Contrôle des fiches ou l’automate -A20. Vérifiez aussi le code TVA, Saisie TTC et les valeurs par défaut de l’import.
Le stock existe sur les cellules mais pas sur le modèle
C’est le comportement décrit immédiatement après import. Exécutez la procédure de recalcul des stocks prévue par la version pour agréger les cellules dans le parent.
Le stock du mauvais magasin est alimenté
Vérifiez la position des colonnes MAG01 à MAG99. Une colonne intermédiaire manquante décale tous les magasins suivants.
L’EAN n’est pas retrouvé comme code-barres attendu
Vérifiez le code interne de la cellule. L’import documenté affecte la colonne EAN à ce champ. Si le dossier nécessite une table de codes BIS, préparez une étape complémentaire validée par le support.
Une réimportation crée des doublons
Arrêtez le traitement complet, restaurez si nécessaire et analysez les clés Modèle/EAN/combinaison. La méthode de mise à jour n’est pas documentée comme universelle pour toutes les versions.
Le contrôle des fiches modifie des valeurs propres aux cellules
Vérifiez les préférences Prêt-à-porter et les indicateurs « Conserver les valeurs locales des cellules » avant toute actualisation depuis le modèle générique.
L’automate fonctionne manuellement mais pas dans Windows
Contrôlez le compte de la tâche, le répertoire de démarrage, le chemin source, les droits et les lecteurs mappés. Utilisez un chemin UNC lorsque le fichier se trouve sur un partage.

16. Actions à éviter

  • importer directement le catalogue complet sans fichier pilote ;
  • ignorer les journaux de nomenclature ;
  • supprimer les colonnes vides du milieu du fichier ;
  • réutiliser le même numéro de colonne pour deux magasins ;
  • lancer un import de stocks sans date de reprise définie ;
  • exécuter -A20 avec une ancienne version connue comme défectueuse ;
  • supposer qu’une réimportation met toujours à jour sans doublon ;
  • modifier directement les statuts TCB dans les tables ;
  • effacer un parent TCB sans contrôler les cellules associées ;
  • automatiser sans journal, sauvegarde ni procédure d’arrêt.

17. Liste de contrôle avant production

  • Le dossier est sauvegardé.
  • La version et l’utilitaire sont compatibles.
  • Le code dossier du raccourci est correct.
  • Les valeurs Saisie TTC et TVA sont renseignées.
  • Les couleurs, tailles et bonnets existent.
  • L’en-tête et le séparateur ; sont présents.
  • L’ordre des dix-neuf premières colonnes est respecté.
  • Les colonnes magasins sont continues.
  • Un modèle pilote a été importé.
  • Les journaux du dossier LOG sont vides ou traités.
  • Articles — Contrôle des fiches a été exécuté.
  • Les stocks ont été recalculés si nécessaire.
  • La grille TCB a été testée en vente.

18. Résultat attendu

Chaque valeur Modèle crée un article générique cohérent, chaque ligne devient la cellule Taille–Couleur–Bonnet attendue, les prix et classifications sont recalculés et les stocks des enfants et du modèle concordent après les contrôles post-import.

19. Sources documentaires

  • Tutoriel KWISATZ — Importation des produits TCB.
  • Tutoriel KWISATZ — format des colonnes, stocks site et magasins.
  • Suivi de développement KWISATZ — Articles — Contrôle des fiches et automate -A20.
  • Suivi de développement KWISATZ — corrections du statut TCB après import.
  • Suivi de développement KWISATZ — valeurs communes et personnalisées des cellules TCB.