Documentation technique et fonctionnelle KWISATZ

Le terminal de saisie sous Android

Le module Android permet de scanner des produits en rayon ou en réserve, de travailler à partir d’une base produits locale et de transférer vers KWISATZ des inventaires, contrôles de prix, promotions, étiquettes, régularisations, documents clients, documents fournisseurs et lignes de vente.

Fiche : MOB-AND-001 Module : Terminal portable Android Public : technicien ou utilisateur avancé Risque : élevé Catégorie : Stocks, inventaires et mouvementsMise à jour : 6 août 2026

Réponse directe

Repère de diagnostic : WKW_Serveur_PDA_Android, WKW_Terminal. Ce repère interne ne doit pas être modifié directement. Faites analyser et valider le réglage par un technicien KWISATZ après sauvegarde et relevé de la configuration.
Un transfert ne doit jamais être intégré sans vérifier le numéro du terminal, le type de saisie, le magasin et la date du fichier. La suppression d’un fichier reçu ou la remise à zéro d’une saisie est irréversible.

Conseil technicien général

1. Licence et disponibilité

La dépendance de licence mentionnée dans ce document provient des sources. Sa disponibilité peut varier selon la version, la sérialisation, le partenaire ou l’installation ; faites-la valider techniquement avant de modifier l’environnement.

2. Protection des données

3. Architecture du module

Composant Emplacement Rôle
WKW_Serveur_PDA_Android.exe Ordinateur ou serveur contenant KWISATZ. Fait le lien entre le terminal et le dossier KWISATZ : envoi des produits, réception des inventaires, documents et contrôles.
Application WKW_Terminal / package APK Terminal Android. Scanne les articles, conserve les saisies dans une base locale et transmet les fichiers au serveur.
Wi-Fi local Réseau du magasin ou de l’entrepôt. Permet la synchronisation, le transfert et la consultation produit selon le cycle de communication configuré.
Base locale Android Stockage de l’application. Permet de travailler temporairement sans connexion après téléchargement des produits.
Dossier d’import Android Arborescence du dossier KWISATZ. Conserve les fichiers transférés en attente d’intégration.
La documentation indique un développement testé sur un Point Mobile PM80 en 1280 × 720 pixels à 295 DPI. Ce matériel constitue un exemple de validation, pas une garantie de compatibilité pour tous les terminaux Android.

4. Installer le serveur Android

L’exécutable se trouve dans le répertoire WKW de l’installation. Il doit rester actif pendant les échanges.

Raccourci documenté

C:\WKW\WKW_Serveur_PDA_Android.exe -dCODE_DOSSIER -A -I
Paramètre Fonction
-dCODE_DOSSIER Associe le serveur au dossier KWISATZ concerné.
-A Démarre automatiquement le serveur.
-I Réduit ou iconise l’application dans la barre des tâches.
  1. Créez le raccourci avec le code réel du dossier.
  2. Exécutez-le une première fois en tant qu’administrateur.
  3. Vérifiez que le serveur reste actif.
  4. Ajoutez son démarrage automatique selon la politique du poste.
  5. Testez la communication depuis le terminal.
N’utilisez pas un code de dossier d’exemple. Une saisie transmise au mauvais dossier peut être intégrée dans la mauvaise société ou le mauvais magasin.

5. Configurer le réseau et le pare-feu

Le serveur Android utilise le port d’écoute TCP 2001.

  1. Attribuez une adresse IP stable au serveur ou une réservation DHCP.
  2. Connectez le terminal au même réseau Wi-Fi local.
  3. Créez une règle entrante autorisant le port TCP 2001.
  4. Limitez la règle au profil réseau et aux sous-réseaux autorisés.
  5. Ne désactivez le pare-feu que pour un diagnostic très bref, jamais comme solution.
  6. Testez le bouton de communication depuis l’application Android.
N’exposez pas le port 2001 directement sur Internet. L’utilisation distante doit passer par un VPN ou une architecture sécurisée validée par l’administrateur réseau.
Si l’adresse IP du serveur change, chaque terminal doit être reconfiguré. Une réservation DHCP ou une adresse fixe limite ces incidents.

6. Installer l’application Android

  1. Branchez le terminal au PC avec un câble USB.
  2. Choisissez le mode MTP — transfert de fichiers.
  3. Copiez le package APK fourni par KWISATZ dans le dossier Downloads ou un autre dossier accessible.
  4. Ouvrez un explorateur de fichiers sur le terminal.
  5. Lancez le package.
  6. Autorisez l’installation depuis cette source uniquement si le package provient du support KWISATZ.
  7. Suivez l’assistant jusqu’à la fin.
  8. Lancez l’application WKW_Terminal.
N’installez pas un APK trouvé sur un site tiers. Utilisez uniquement le package remis par KWISATZ ou votre intégrateur autorisé.
Une mise à jour Android peut retirer certaines autorisations, bloquer l’installation d’APK ou modifier le fonctionnement du scanner intégré. Retestez le scan, le stockage et le réseau après chaque mise à jour majeure.

7. Sérialiser l’application

Au premier lancement, l’application affiche une demande de sérialisation. La clé de contrôle doit être obtenue auprès du service technique KWISATZ.

  1. Relevez les informations affichées par l’application.
  2. Contactez le support ou l’intégrateur.
  3. Saisissez la clé fournie.
  4. Validez.
  5. Vérifiez que le menu principal s’affiche.
Ne publiez pas les clés de sérialisation et ne les réutilisez pas sur un autre terminal sans autorisation.

8. Paramètres généraux du terminal

Ouvrez Paramètres > Générale.

Zone Utilisation
Adresse IP serveur Adresse du poste où s’exécute WKW_Serveur_PDA_Android.
TEST Vérifie la communication avec le serveur.
N° du terminal Numéro unique utilisé pour identifier les fichiers transmis.
Magasin — Stock à gérer Code du magasin ou dépôt utilisé pour les informations de stock.
Gestion multi-dossier Oblige l’utilisateur à sélectionner un dossier avant d’accéder aux fonctions.
Cacher le PAHT Masque le prix d’achat dans l’application.
PV en HT Affiche le prix de vente hors taxe plutôt que TTC.
Lecture EAN128 Active l’interprétation des codes contenant lot et date de péremption.
Autoriser saisie lot Permet de saisir manuellement le numéro de lot et la péremption.
Attribuez un numéro différent à chaque terminal. Les trois premiers caractères du nom de fichier reçu identifient le terminal émetteur.

9. Télécharger la base produits

Le menu Intégration des produits télécharge et intègre :

  • les produits ;
  • les rayons ;
  • les familles ;
  • les lignes ;
  • les marques ;
  • les taux de TVA ;
  • les informations de stock et de prix prévues par le module.
  1. Vérifiez que le serveur Android est actif.
  2. Ouvrez le menu Intégration.
  3. Lancez le traitement.
  4. Attendez la fin du téléchargement.
  5. Confirmez l’intégration locale.
  6. Ouvrez la liste Produits.
  7. Testez la recherche par code, code interne et libellé.
  8. Contrôlez le stock du magasin sélectionné.
La base locale n’est pas mise à jour en permanence. Relancez l’intégration après une modification importante des prix, produits, codes-barres ou référentiels.

10. Travail local et consultation Wi-Fi

Mode Connexion nécessaire Source des informations
Saisie standard Pas en permanence après synchronisation. Base locale du terminal.
Transfert Oui. Serveur Android du dossier.
Intégration produits Oui. Dossier KWISATZ associé au serveur.
Consultation Wi-Fi Oui, en temps réel. Fiche produit interrogée sur le serveur.
La consultation Wi-Fi peut afficher en temps réel une fiche produit. Pour les produits TCB, un onglet d’enfants peut être proposé, avec exclusion facultative des variantes dont le stock est nul.

11. Paramétrer le mode de saisie

Paramètre Choix documentés Effet
Article inconnu Autoriser, Interdire ou Créer. Détermine si un code absent peut être saisi ou donner lieu à une création minimale.
Ordre de saisie Chronologique ou Par code. En chronologique, chaque scan crée une ligne. Par code, une seule ligne est conservée par article.
Mode de saisie Ajouter ou Remplacer pour les quantités. Ajoute à la quantité existante ou la remplace.
Mode de confirmation Avec fenêtre, Sans fenêtre ou Automatique. Contrôle le niveau de validation demandé après le scan.
Valeur par défaut Selon la fonction. Préremplit la quantité ou la valeur à saisir.
Session Unique ou Multiple selon les documents. Permet de préparer plusieurs documents simultanément.
En mode Par code + Ajouter, scanner deux fois le même article cumule la quantité. En mode Remplacer, le dernier scan remplace la valeur précédente.
Pour un inventaire rapide avec quantité unitaire, le mode Automatique peut valider la valeur par défaut sans afficher de fenêtre.

12. Configurer le scanner

Le scanner intégré doit transmettre le code complet et, de préférence, un retour chariot après chaque lecture.

  1. Testez un EAN13 dans une zone de texte Android.
  2. Vérifiez qu’aucun caractère n’est supprimé.
  3. Activez le suffixe Entrée ou Carriage Return.
  4. Testez les codes internes et les codes poids/prix.
  5. Testez un EAN128 si les lots sont utilisés.
  6. Contrôlez les doubles lectures du bouton matériel.
Sans retour chariot, l’utilisateur doit valider manuellement après chaque scan, ce qui ralentit la saisie et augmente le risque d’erreur.

13. Fonctions de saisie disponibles

Fonction Valeur saisie Usage côté KWISATZ
Inventaire Quantité comptée. Préparation d’inventaire à contrôler puis valider.
Contrôle de prix Prix relevé dans la zone Audit. Contrôle visuel puis application des prix sélectionnés.
Promotion Prix promotionnel. Préparation de modifications tarifaires.
Étiquettes Nombre d’étiquettes. Alimente une demande d’impression.
Bon inter-magasins Quantité, lot et péremption si activés. Création d’un mouvement entre magasins.
Régularisation de stock Quantité, lot et péremption. Prépare un mouvement de correction de stock.
Code interne Nouveau code interne. Mise à jour des références articles.
Vente directe Quantité vendue. Prépare des lignes de vente à relire en caisse selon la configuration.
Bon de commande vente Quantité, lot et péremption. Crée ou complète un BCV.
Bon de livraison vente Quantité, lot et péremption. Crée ou complète un BLV.
Facture de vente Quantité, lot et péremption. Crée ou complète une facture client.
Bon de commande achat Quantité, lot et péremption. Crée ou complète un BCA.
Bon de réception achat Quantité, lot et péremption. Crée ou complète un BRA.
Facture d’achat Quantité, lot et péremption. Crée ou complète une facture fournisseur.

14. Utiliser plusieurs sessions de documents

Pour les documents de gestion, le mode Session Multiple permet de préparer plusieurs commandes, livraisons ou réceptions en parallèle.

  1. Activez le mode Session Multiple dans le paramétrage de la fonction.
  2. Ouvrez la saisie.
  3. Créez une nouvelle session.
  4. Donnez-lui un libellé identifiable : client, fournisseur, palette ou tournée.
  5. Sélectionnez la session avant chaque scan.
  6. Contrôlez son contenu dans la visualisation.
  7. Transférez les sessions prévues.
  8. Supprimez uniquement les sessions déjà intégrées et contrôlées.
La suppression d’une session locale est irréversible. Vérifiez que son fichier a été transféré et intégré avant de l’effacer.

15. Transférer une saisie vers KWISATZ

  1. Ouvrez la visualisation de la saisie.
  2. Contrôlez les codes, quantités, prix, lots et sessions.
  3. Ouvrez l’écran Transfert.
  4. Activez « Transmettre les produits créés » uniquement si nécessaire.
  5. Vérifiez le nombre total d’enregistrements.
  6. Lancez le transfert.
  7. Attendez que le nombre transmis corresponde au total.
  8. Ne remettez pas immédiatement la saisie à zéro.
  9. Intégrez et contrôlez d’abord le fichier dans KWISATZ.
La création de produits depuis le terminal ne remplace pas la fiche complète. Les articles créés avec des informations minimales doivent être complétés dans KWISATZ avant leur utilisation commerciale normale.

16. Lire la saisie dans KWISATZ

  1. Ouvrez Démarrage > Périphériques utilisés.
  2. Sélectionnez Terminal portable.
  3. Choisissez le type PDA Android.
  4. Ouvrez le menu correspondant au type de saisie.
  5. Cliquez sur Lire portable.
  6. Sélectionnez le fichier du bon terminal et du bon type.
  7. Contrôlez la date et l’heure.
  8. Intégrez le fichier.
  9. Contrôlez les lignes avant validation finale.

Le nom de fichier contient :

  • les trois premiers caractères : numéro du terminal ;
  • les trois caractères suivants : type de saisie ;
  • les derniers caractères : date et heure du transfert.
Le bouton de suppression du fichier reçu est irréversible. Ne supprimez jamais un fichier non intégré ou non archivé.

17. Remettre à zéro la saisie locale

Chaque module dispose d’un bouton de remise à zéro : RAZ Inventaire, RAZ Contrôle prix, RAZ Promotion, RAZ Étiquette, RAZ Document ou équivalent.

  1. Vérifiez que le transfert est terminé.
  2. Vérifiez l’intégration dans KWISATZ.
  3. Contrôlez le nombre de lignes.
  4. Archivez ou conservez le fichier reçu selon la procédure.
  5. Revenez sur le terminal.
  6. Lancez la remise à zéro de la saisie concernée.
  7. Confirmez uniquement après le dernier contrôle.
Oublier la remise à zéro mélange l’ancienne saisie avec la suivante. La faire trop tôt supprime la seule copie locale avant validation.

18. EAN128, lots et dates de péremption

Lorsque la gestion des lots et la lecture EAN128 sont activées, les fonctions documentaires affichent des zones supplémentaires :

  • numéro de lot ;
  • date de péremption ;
  • valeurs extraites automatiquement du code EAN128 compatible ;
  • saisie manuelle si l’option correspondante est activée.
Testez les identifiants d’application réellement utilisés par les fournisseurs. Tous les codes GS1/EAN128 ne contiennent pas les mêmes informations ni le même format de date.

19. Codes-barres poids et prix

Le menu Paramètres > Radical permet de renseigner jusqu’à neuf radicaux de poids et neuf radicaux de prix.

Paramètre Fonction
Poids 1 à 9 Deux premiers chiffres des codes contenant un poids.
Prix 1 à 9 Deux premiers chiffres des codes contenant un prix.
Unité 1 à 9 Si activée, un code prix produit une quantité de 1 ; sinon la quantité est calculée à partir du prix de vente.
EUR 1 à 9 Indique que le prix encodé est exprimé en euros dans la logique historique documentée.
Reproduisez les mêmes radicaux que dans KWISATZ. Une différence peut associer le code au mauvais produit ou calculer une quantité erronée.

20. Gestion multi-dossier

Lorsque l’option est activée, les fonctions restent indisponibles tant qu’un dossier n’a pas été sélectionné. Le code choisi s’affiche dans la barre de titre.

  1. Activez la gestion multi-dossier.
  2. Rechargez la liste des dossiers si nécessaire.
  3. Sélectionnez le dossier avant toute synchronisation.
  4. Vérifiez le code dans la barre de titre.
  5. Téléchargez les produits du dossier sélectionné.
  6. Contrôlez à nouveau le dossier avant le transfert.
Le changement de dossier doit être suivi d’une synchronisation cohérente. Ne saisissez pas avec la base produits d’un dossier puis transférez vers un autre.

21. Réseau, multi-caisses et dossiers locaux

Dans un réseau KWISATZ classique avec une base commune, les postes peuvent lire les fichiers Android présents dans le dossier partagé. Dans une architecture comportant plusieurs bases locales indépendantes, le fonctionnement est plus contraignant.

  • le serveur Android écrit dans le contexte du dossier auquel il est associé ;
  • les produits locaux doivent être synchronisés par interface de communication du back-office, interface de communication de la caisse ou une autre procédure validée ;
  • le répertoire d’import Android doit être visible du poste qui réalise la lecture ;
  • un terminal pointant vers une caisse locale ne rend pas automatiquement ses fichiers visibles aux autres caisses ;
  • moteur de données distant partage les données, mais ne remplace pas nécessairement l’accès aux fichiers du disque.
Pour plusieurs caisses autonomes, définissez une caisse ou un serveur d’entrée pour les terminaux, centralisez le répertoire d’import lorsque l’architecture le permet et documentez quel poste doit exécuter Lire portable.
Ne déplacez pas manuellement les fichiers Android entre plusieurs bases sans vérifier le dossier, le magasin et les référentiels produits.

22. Sécurité et exploitation

  • utiliser un Wi-Fi professionnel protégé ;
  • limiter le port 2001 au réseau local ;
  • attribuer un numéro unique à chaque appareil ;
  • verrouiller le terminal par code ou compte professionnel ;
  • ne pas afficher le PAHT aux utilisateurs non autorisés ;
  • installer uniquement les APK fournis par le support ;
  • sauvegarder ou archiver les transferts sensibles ;
  • contrôler les créations de produits avant vente ;
  • désactiver les anciens terminaux perdus ou remplacés ;
  • ne pas stocker de données clients inutiles sur l’appareil.

23. Recette avant mise en production

  1. Tester la communication avec le serveur.
  2. Télécharger la base produits.
  3. Scanner un produit existant et un code inconnu.
  4. Tester Ajouter et Remplacer.
  5. Tester le retour chariot automatique du scanner.
  6. Saisir un inventaire de trois lignes.
  7. Transférer et intégrer l’inventaire.
  8. Contrôler une correction de prix sans la valider définitivement.
  9. Tester un document client et un document fournisseur.
  10. Tester plusieurs sessions.
  11. Tester un EAN128 avec lot et péremption.
  12. Tester un code poids/prix.
  13. Tester la consultation Wi-Fi.
  14. Tester la remise à zéro après intégration.
  15. Redémarrer le serveur et le terminal puis retester.
L’installation est validée lorsque les produits téléchargés sont corrects, les scans sont enregistrés une seule fois, chaque fichier est identifié par le bon terminal et l’intégration produit le résultat attendu dans KWISATZ.

24. Diagnostic rapide

Le bouton TEST ne communique pas avec le serveur
Vérifiez l’adresse IP, le Wi-Fi, le port TCP 2001, le pare-feu et l’exécution de WKW_Serveur_PDA_Android. Testez depuis le même réseau et évitez une adresse publique.
Le serveur Android se ferme immédiatement
Contrôlez le raccourci, le code du dossier, les droits et la première exécution en administrateur. Vérifiez aussi qu’une autre instance n’utilise pas déjà le port.
Le scanner lit le code mais ne lance pas la recherche
Activez le suffixe Retour chariot dans le service de scan Android. Testez également que le code complet est transmis sans préfixe parasite.
Le terminal affiche un ancien prix ou un ancien stock
La base locale n’est plus à jour. Relancez l’intégration des produits et vérifiez le magasin sélectionné. Utilisez la consultation Wi-Fi pour contrôler la valeur en temps réel.
Le transfert est réussi mais aucun fichier n’apparaît dans KWISATZ
Vérifiez le dossier associé au serveur, le répertoire d’import, le numéro de terminal, la base réseau et le poste depuis lequel vous utilisez Lire portable.
KWISATZ ouvre la mauvaise fenêtre de lecture portable
Dans Démarrage > Périphériques utilisés > Terminal portable, sélectionnez le type PDA Android sur le poste concerné, puis relancez le menu de lecture.
Les lignes sont doublées après un nouveau transfert
Vérifiez que la saisie précédente a été remise à zéro après intégration. Contrôlez également si le même fichier a été intégré deux fois ou si le mode Par code + Ajouter a cumulé plusieurs scans.
Le contrôle de prix est transféré sans valeur exploitable
Vérifiez que le nouveau prix a été saisi dans la zone Audit. Côté KWISATZ, lisez le fichier, sélectionnez les lignes et contrôlez-les avant la validation des prix.
Un produit créé sur le terminal n’est pas complet
La création Android utilise des informations minimales. Activez le transfert des produits créés, puis complétez la fiche dans KWISATZ : TVA, famille, fournisseur, prix, unité et stock.
Les lots ou dates ne sont pas reconnus
Activez la lecture EAN128, contrôlez le code GS1, les identifiants d’application et le format de la date. Testez la saisie manuelle si elle est autorisée.
Un poste secondaire ne voit pas les fichiers Android
Vérifiez que les postes utilisent la même base réseau et le même dossier d’import. Dans une architecture avec bases locales, centralisez le point d’entrée ou effectuez la lecture sur la caisse hébergeant le serveur Android.
L’application Android devient inutilisable après une mise à jour
Contrôlez les autorisations de stockage, réseau et scanner, puis vérifiez la compatibilité de la version APK. Ne réinitialisez pas la base locale avant d’avoir transféré les saisies en attente.

25. Actions à éviter

  • ouvrir le port 2001 à tout Internet ;
  • installer un APK provenant d’une source inconnue ;
  • utiliser le même numéro pour plusieurs terminaux ;
  • changer de dossier sans recharger les produits ;
  • supprimer un fichier reçu avant intégration ;
  • remettre à zéro une saisie avant contrôle ;
  • intégrer un contrôle de prix sans vérification visuelle ;
  • considérer la base locale comme synchronisée selon le cycle de communication configuré ;
  • déplacer des fichiers entre dossiers KWISATZ différents ;
  • créer massivement des produits incomplets depuis le terminal.

26. Liste de contrôle de mise en service

  • Le serveur Android utilise le bon code dossier.
  • Le port TCP 2001 est ouvert uniquement sur le réseau autorisé.
  • L’application Android est installée et sérialisée.
  • L’adresse IP du serveur est stable.
  • Chaque terminal possède un numéro unique.
  • Le magasin de stock est correct.
  • Les produits et référentiels sont synchronisés.
  • Le scanner envoie un retour chariot.
  • Le mode Ajouter ou Remplacer est compris.
  • Le terminal est déclaré comme PDA Android dans KWISATZ.
  • Un inventaire test est transféré et intégré.
  • La remise à zéro est réalisée uniquement après contrôle.

27. Résultat attendu

Le terminal télécharge les produits du bon dossier, permet une saisie fiable en local ou en Wi-Fi, transfère des fichiers identifiés par terminal et KWISATZ les intègre dans la procédure correspondante sans doublon ni erreur de magasin.

28. Sources documentaires

  • Tutoriel KWISATZ — Module de saisie pour terminal Android.
  • Tutoriel KWISATZ — installation de WKW_Serveur_PDA_Android et du package APK.
  • Tutoriel KWISATZ — inventaire, contrôle de prix, promotions, étiquettes et documents.
  • Base support KWISATZ — scanner, port 2001, lecture portable et remise à zéro.
  • Base support KWISATZ — limites multi-caisses et synchronisation des produits.