Installation

Le téléchargement et l’installation de Comarch POS sont assurés par l’application Comarch ERP Auto Update.

Veuillez consulter la description de cet application et de ses fonctionnalités sur la site dédiée : https://aide.comarch.fr/autoupdate/

Pour les informations sur le téléchargement et l’installation de l’application POS veuillez consulter l’article : https://aide.comarch.fr/autoupdate/documentation/ajouter-et-configurer-un-produit-sur-lexemple-de-comarch-retail/




Comarch POS Agent

Informations de base

Le service (POS Agent) fournit des informations à jour concernant les états de stocks sur chaque point de vente lors de l’émission de documents. Les informations sont présentées en tenant compte des entrepôts particuliers. Tous les processus de l’entrepôt peuvent désormais se dérouler en mode hors ligne, sans la connexion à la caisse centrale, grâce à quoi l’utilisation de ce service assure une autonomie de chaque magasin en garantissant que l’état de stocks est toujours à jour.

En mode hors ligne, l’agent de messages Comarch POS Agent Broker est utilisé pour communiquer avec POS Agent. Ce composant agrège la file d’attente des messages en transmettant la mise à jour des états de stocks à un POS Agent approprié d’un magasin donné.

Le service POS Agent est un endroit où toutes les informations nécessaires pour un point de vente POS sont stockées, y compris :

  • Documents sauvegardés
  • Statistiques concernant le compteur de passages
  • Etats de stocks et des réservations

Fonctionnement

Le service POS Agent est un service autonome avec sa propre base de données sur le même ordinateur où se trouve la base de données de Comarch POS ou sur un autre ordinateur.

Avant de valider les documents, POS Agent vérifie si les informations concernant des états de stocks sont correctes. Il s’agit des documents suivants :

  • commerciaux
    • Reçus (R) et leurs correctifs de la quantité et leurs correctifs manuels
    • Factures client (FC) et leurs correctifs de la quantité et leurs correctifs manuel
    • Commandes client
  • d’entrepôt
    • Mouvements d’entrepôt (ME-/ME+)
    • Profits et pertes (PROF/PERT) et leurs correctifs de la quantité
    • Bons de réception et bons de livraison (REC/LIV) et leurs correctifs manuels

Installation et configuration

Afin d’installer le service Comarch POS Agent, vous devez utiliser l’outil Comarch ERP Auto Update.

Attention
La version la plus récente de Comarch ERP Auto Update 2020.0 est requise.

Une fois l’application Comarch ERP Auto Update démarrée, vous devez effectuer les opérations suivantes :

  • Ajouter le produit Comarch Retail dans l’onglet Configuration

Ajout du produit Comarch Retail

  • Ajouter le composant Comarch POS Agent pour le produit Comarch Retail.

Ajout du composant Comarch POS Agent

  • Configurer le composant Comarch POS Agent. Vous pouvez ouvrir la fenêtre de configuration en sélectionnant le composant et ensuite en cliquant le bouton [Configuration]. Vous devez y saisir les données pour la connexion avec le serveur Microsoft SQL Server Management Studio où la base de données POS Agent sera installée.

Configuration de la connexion au serveur SQL pour POS Agent

  • Nom du serveur – nom su serveur avec l’instance où la base de données sera installée
  • Nom de la base – BOSDB_ [code_du profil] est suggéré par défaut
  • Données de connexionNom d’utilisateur, Mot de passe

Le bouton [Test de la connexion] permet de vérifier la connexion avec le serveur indiqué.

  • Ensuite, vous devez enregistrer des modifications et fermer la fenêtre de configuration du composant en sélectionnant des boutons appropriés [Enregistrer] et [Fermer].

Configuration avec Comarch ERP Altum

Afin de configurer un point de POS Agent dans le système Comarch ERP Altum, il faut :

  • Aller à la section Structure des droits qui est située dans la section Structure d’entreprise dans l’onglet Configuration ;

Onglet Configuration dans Comarch ERP Altum

  • Ensuite, sélectionner le centre approprié auquel le point de vente POS est configuré ;
  • Dans le formulaire POS Agent, dans l’onglet Points de vente POS il faut :
    • Remplir le champ Code
    • Ajouter des entrepôts appropriés et enregistrer les modifications

Attention
L’entrepôt ajouté doit être disponible dans le centre de la structure et ne peut pas être attaché dans la configuration de POS Agent à la liste d’entrepôts d’aucun centre.

Configuration de POS Agent

Attention
Les champs Hôte, Port et GUID sont remplis automatiquement une fois les données correctes ont été introduites dans POSAgentConfigurator.exe, qui se situe dans le dossier d’installation de POS Agent. 

  • Dans un temps suivant, il faut ouvrir le dossier d’installation de POS Agent et exécuter l’application POSAgentConfigurator.exe.
  • Vous obtiendrez une erreur indiquant que le service est désinstallé :

Erreur concernant le service désinstallé

  • Après avoir cliqué sur le bouton [OK], les paramètres sont chargés :

Vue du chargement des paramètres dans l’application Configurateur du service POS Agent

  • Une fois les paramètres chargés, la fenêtre de configuration s’ouvre :

Configuration POS Agent

  • Dans l’application il faut indiquer :
    • Adresse IP du service POS Agent – l’adresse IP de l’ordinateur où vous voulez installer le service POS Agent
    • Port du service POS Agent – 8098 par défaut
    • Adresse du serveur OMS – http://localhost:8099/DataService/ est une adresse par défaut
    • Code POS Agent – code POS Agent saisi dans le système ERP ; après l’enregistrement correct le champ devient gris
    • Guid POS Agent – valeur complétée automatiquement
  • Le service est installé en sélectionnant le bouton [Installer].
  • Le bouton [Vérifier] sert à vérifier si les données saisies sont correctes, le bouton [Enregistrer] permet d’enregistrer le service POS Agent.
  • Pour vérifier si le processus a été terminé avec succès, vous devez passer à l’onglet POS Agent dans Comarch ERP Altum et vérifier si les données dans les champs Hôte, Port et GUID ont été mises à jour.

Dans l’application POS, après avoir installé le service, l’icône    est disponible. Elle informe quel est le statut de la connexion aux services.

  • Vert – tous les services sont activés

  • Jaune – l’un des services est désactivé

  • Rouge – tous les services sont désactivés

Attention
Chaque point de vente POS et mPOS du magasin doit établir une connexion, mais uniquement avec l’Agent POS en cas de validation d’un document d’entrepôt. Cependant, seule la connexion avec la caisse centrale garantit que le document d’entrepôt contient la bonne quantité disponible et sera traité correctement.

En outre, l’icône  contient également le bouton [Configuration des services] qui ouvre la fenêtre de configuration des services de l’application Comarch POS. Il est aussi disponible à partir du menu principal (mosaïque Configuration).

Fenêtre Configuration des services de l’application Comarch POS

Enregistrement du service POS Agent à partir de l’invite de commande

Il est également possible d’enregistrer le service Comarch POS Agent à partir de l’invite de commande Windows.

Commandes disponibles :

  • –register
  • –install
  • –uninstall
  • –setaddress –agentIP:127.0.0.1 –port:8098 (définit l’adresse IP et le port pour le service POS Agent)
  • –seterpaddress –adres:http://example.com (définit l’adresse du serveur OMS)
  • –stop
  • –start
  • –help
  • –status
  • –waitforstatus

Afin d’enregistrer le service Comarch POS Agent à partir de l’invite de commande Windows, il faut :

  • Exécuter l’invite de commande en tant qu’administrateur à partir de cette localisation :

C:\Users\nazwa.użytkownika\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\System Tools

Fenêtre de l’invite de commande

  • Retrouver et copier le chemin où se trouve l’application Assistant de configuration POS Agent, chemin d’accès exemplaire :

C:\Program Files (x86)\Comarch Retail\Comarch Retail POS Agent

  • Dans l’invite de commande taper : cd C:\Program Files (x86)\Comarch Retail\Comarch Retail POS Agent et appuyer sur [Enter]

Invite de commande pour cd C:\Program Files (x86)\Comarch Retail\Comarch Retail POS Agent

  • Installer le service POS Agent en tapant : POSAgentConfigurator.exe –install et en appuyant sur le bouton [Enter]

Message sur l’installation réussie du service Comarch POS Agent dans l’invite de commande

  • Après l’installation réussie, il faut démarrer le service en tapant : POSAgentConfigurator –start et en appuyant sur le bouton [Enter]

Message sur le démarrage du service Comarch POS Agent réussi

  • Afin d’enregistrer le service, il faut taper : POSAgentConfigurator –register et appuyer sur le bouton [Enter]

Message sur l’enregistrement du service Comarch POS Agent réussi

  • Pour vérifier le statut de la connexion du service, il faut taper : POSAgentConfigurator.exe –status et appuyer sur le bouton [Enter]

Message sur le statut de la connexion du service Comarch POS Agent

Après la vérification du statut du service, sont affichées les informations suivantes :

  • statut du service
  • adresse du service POS Agent
  • adresse du service OMS
  • code de POS Agent
  • GUID de POS Agent enregistré



Comarch POS Agent Broker

Attention
Le composant POS Agent Broker est nécessaire pour la communication entre le système Comarch ERP Standard/XL et Comarch POS Agent.

Informations de base

Le composant Comarch POS Agent Broker (POS Agent Broker) est utilisé pour la communication avec le service Comarch POS Agent (POS Agent) en tant que broker de messages. Le composant agrège la file d’attente des messages en transmettant la mise à jour des états de stocks à POS Agent approprié d’un magasin donné s’il n’y a pas de connexion à la caisse centrale.

Lors de l’émission de documents dans Comarch ERP Standard, la mise à jour permet de :

  • vérifier les états de stocks actuels sur un point de vente POS avant de générer un document où les informations sur les états de stock de l’entrepôt assigné au point de vente POS donné sont chargées
  • ajouter à la file d’attente un message qui concerne par exemple l’augmentation de stocks lorsqu’un document augmentant ces stocks est établi.

Installation et configuration

Avant d’installer le service POS Agent Broker, vous devez activer les fonctionnalités supplémentaires du système Windows – Internet Information Services (IIS). Pour cela, vous devez accéder à Panneau de configuration Programmes Programmes et fonctionnalités Activer ou désactiver des fonctionnalités Windows Internet Information Services (IIS) et activer les composants suivants :

  • Outils d’administration WEB
  • Services World Wide Web

Fonctionnalités Windows

L’installation de POS Agent Broker est effectuée à l’aide de l’outil Comarch ERP Auto Update. Une fois Comarch ERP Auto Update démarré, vous devez effectuer les opérations suivantes :

  • Ajouter le produit Comarch Retail dans l’onglet Configuration

Ajout du produit Comarch Retail

  • Ajouter le composant Comarch POS Agent Broker pour le produit Comarch Retail

Ajout du composant Comarch POS Agent Broker

Attention
Après avoir activé des fonctionnalités Windows supplémentaires et installé POS Agent Broker, un redémarrage du poste de travail peut être nécessaire.

En outre, il faut configurer dans le système ERP un emplacement réseau du service POS Agent Broker installé. Vous trouverez les informations détaillées dans la documentation du système ERP dans les articles relatifs à l’ajout et à la configuration d’un nouveau point de vente POS.

Adresse du service Comarch POS Agent Broker

Afin de vérifier l’adresse à laquelle le service Comarch POS Agent Broker a été mis à disposition, vous devez :

  • Ouvrir le Gestionnaire des services Internet
  • Dérouler l’onglet Sites -> Defaut Web Site
  • Indiquer l’élément qui contient « POSAgentBroker » dans son nom
  • Dans la vue Actions, sélectionner l’option Parcourir *:80 (http)

Gestionnaire des services Internet IIS

  • Dans votre navigateur par défaut, la barre d’adresse contiendra un lien valide vers le service POS Agent Broker

Adresse du service Comarch POS Agent Broker dans la barre d’adresse du navigateur

Attention
http://localhost/ POSAgentBroker est l’adresse par défaut du profil principal de Comarch ERP Auto Update.




Exigences minimales

Voici les exigences minimales nécessaires pour le fonctionnement correct de l’application Comarch POS et Comarch POS Agent (sur les machines distinctes) :

  • Système d’explotation Microsoft Windows 8.1/10
  • Processeur Intel Core i3/i5/i7 4th Gen, AMD Ryzen 5 ou de classe similaire (Résultat dans CPU benchmark 3000 points au minimum – pour garantir une réaction acceptable)
  • 6 GB de la mémoire RAM (ou plus)
  • Microsoft .NET Framework 4.7.2
  • Mcrosoft SQL Server 2014 en version Express ou plus récente
  • Collation Latin1_General_CI_AS

Si Comarch POS et Comarch POS Agent sont installés sur la même machine, il faut garantir (par rapport aux exigences mentionnées ci-dessus) :

  • Meilleur processeur, Intel Core i5 au minimum
  • 8 GB de la mémoire RAM ou plus

Attention
Il faut prendre en considération

  • les exigences minimales du système Microsoft Windows
  • les exigences minimales du système Microsoft SQL Server

en fonction de la charge du poste par un autre logiciel ou du nombre des opérations effectuées.

Lors de l’installation de l’application Comarch POS, Comarch ERP Auto Update vérifie la version du composant Microsoft .NET Framework installé sur l’ordinateur. S’il manque ce composant ou si la version du composant est inférieure, le composent sera installé en version requise.




Installer le composant BI Point

Sur le point de vent POS, il est possible d’utiliser l’application BI Point après avoir installé un composant approprié à l’aide de l’outil Comarch ERP Auto Update.

Une fois l’application Comarch ERP Auto Update démarrée, il faut :

1. Sur l’onglet Configuration indiquer le produit Comarch Retail.

2. Pour le produit Comarch Retail ajouter le composant Comarch POS BI Point.

Ajout du composant Comarch POS BI Point

3. Enregistrer les modifications et fermer la fenêtre de la configuration des produits en sélectionnant les boutons [Enregistrer] et [Fermer].

4. Dans la fenêtre d’accueil de l’application, il faut choisir l’une des options disponibles :

  • [Télécharger] – le produit est enregistré dans le dossier défini dans la configuration. Le chemin par défaut est le suivant : C:\Comarch ERP Auto Update\Downloads. Une fois le téléchargement terminé, le bouton [Installer] est affiché.
  • [Télécharger et installer] – lance l’installation du produit automatiquement après le téléchargement.

Produit Comarch Retail avec le composant Comarch POS BI Point

L’adresse par défaut présentée sur le point de vente POS pour BI Point est : http://bipoint.comarch.pl/. L’adresse peut être modifié dans le tableau du point de vent POS Configuration.Settings, à la ligne BIPointUrl.

Pour en savoir plus sur l’installation des produits, reportez-vous à la catégorie Comarch ERP Auto Update.