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.
Réponse directe
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.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. |
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. |
- Créez le raccourci avec le code réel du dossier.
- Exécutez-le une première fois en tant qu’administrateur.
- Vérifiez que le serveur reste actif.
- Ajoutez son démarrage automatique selon la politique du poste.
- Testez la communication depuis le terminal.
5. Configurer le réseau et le pare-feu
Le serveur Android utilise le port d’écoute TCP 2001.
- Attribuez une adresse IP stable au serveur ou une réservation DHCP.
- Connectez le terminal au même réseau Wi-Fi local.
- Créez une règle entrante autorisant le port TCP 2001.
- Limitez la règle au profil réseau et aux sous-réseaux autorisés.
- Ne désactivez le pare-feu que pour un diagnostic très bref, jamais comme solution.
- Testez le bouton de communication depuis l’application Android.
6. Installer l’application Android
- Branchez le terminal au PC avec un câble USB.
- Choisissez le mode MTP — transfert de fichiers.
- Copiez le package APK fourni par KWISATZ dans le dossier Downloads ou un autre dossier accessible.
- Ouvrez un explorateur de fichiers sur le terminal.
- Lancez le package.
- Autorisez l’installation depuis cette source uniquement si le package provient du support KWISATZ.
- Suivez l’assistant jusqu’à la fin.
- Lancez l’application WKW_Terminal.
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.
- Relevez les informations affichées par l’application.
- Contactez le support ou l’intégrateur.
- Saisissez la clé fournie.
- Validez.
- Vérifiez que le menu principal s’affiche.
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. |
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.
- Vérifiez que le serveur Android est actif.
- Ouvrez le menu Intégration.
- Lancez le traitement.
- Attendez la fin du téléchargement.
- Confirmez l’intégration locale.
- Ouvrez la liste Produits.
- Testez la recherche par code, code interne et libellé.
- Contrôlez le stock du magasin sélectionné.
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. |
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. |
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.
- Testez un EAN13 dans une zone de texte Android.
- Vérifiez qu’aucun caractère n’est supprimé.
- Activez le suffixe Entrée ou Carriage Return.
- Testez les codes internes et les codes poids/prix.
- Testez un EAN128 si les lots sont utilisés.
- Contrôlez les doubles lectures du bouton matériel.
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.
- Activez le mode Session Multiple dans le paramétrage de la fonction.
- Ouvrez la saisie.
- Créez une nouvelle session.
- Donnez-lui un libellé identifiable : client, fournisseur, palette ou tournée.
- Sélectionnez la session avant chaque scan.
- Contrôlez son contenu dans la visualisation.
- Transférez les sessions prévues.
- Supprimez uniquement les sessions déjà intégrées et contrôlées.
15. Transférer une saisie vers KWISATZ
- Ouvrez la visualisation de la saisie.
- Contrôlez les codes, quantités, prix, lots et sessions.
- Ouvrez l’écran Transfert.
- Activez « Transmettre les produits créés » uniquement si nécessaire.
- Vérifiez le nombre total d’enregistrements.
- Lancez le transfert.
- Attendez que le nombre transmis corresponde au total.
- Ne remettez pas immédiatement la saisie à zéro.
- Intégrez et contrôlez d’abord le fichier dans KWISATZ.
16. Lire la saisie dans KWISATZ
- Ouvrez Démarrage > Périphériques utilisés.
- Sélectionnez Terminal portable.
- Choisissez le type PDA Android.
- Ouvrez le menu correspondant au type de saisie.
- Cliquez sur Lire portable.
- Sélectionnez le fichier du bon terminal et du bon type.
- Contrôlez la date et l’heure.
- Intégrez le fichier.
- 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.
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.
- Vérifiez que le transfert est terminé.
- Vérifiez l’intégration dans KWISATZ.
- Contrôlez le nombre de lignes.
- Archivez ou conservez le fichier reçu selon la procédure.
- Revenez sur le terminal.
- Lancez la remise à zéro de la saisie concernée.
- Confirmez uniquement après le dernier contrôle.
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.
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. |
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.
- Activez la gestion multi-dossier.
- Rechargez la liste des dossiers si nécessaire.
- Sélectionnez le dossier avant toute synchronisation.
- Vérifiez le code dans la barre de titre.
- Téléchargez les produits du dossier sélectionné.
- Contrôlez à nouveau le dossier avant le transfert.
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.
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
- Tester la communication avec le serveur.
- Télécharger la base produits.
- Scanner un produit existant et un code inconnu.
- Tester Ajouter et Remplacer.
- Tester le retour chariot automatique du scanner.
- Saisir un inventaire de trois lignes.
- Transférer et intégrer l’inventaire.
- Contrôler une correction de prix sans la valider définitivement.
- Tester un document client et un document fournisseur.
- Tester plusieurs sessions.
- Tester un EAN128 avec lot et péremption.
- Tester un code poids/prix.
- Tester la consultation Wi-Fi.
- Tester la remise à zéro après intégration.
- Redémarrer le serveur et le terminal puis retester.
24. Diagnostic rapide
Le bouton TEST ne communique pas avec le serveur
Le serveur Android se ferme immédiatement
Le scanner lit le code mais ne lance pas la recherche
Le terminal affiche un ancien prix ou un ancien stock
Le transfert est réussi mais aucun fichier n’apparaît dans KWISATZ
KWISATZ ouvre la mauvaise fenêtre de lecture portable
Les lignes sont doublées après un nouveau transfert
Le contrôle de prix est transféré sans valeur exploitable
Un produit créé sur le terminal n’est pas complet
Les lots ou dates ne sont pas reconnus
Un poste secondaire ne voit pas les fichiers Android
L’application Android devient inutilisable après une mise à jour
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
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.