Installer le nouveau distributeur de billets : de la configuration au déploiement

Ce document est un guide étape par étape permettant de configurer le nouveau distributeur de billets (TVM). Il comprend deux parties : la configuration et le déploiement.

Architecture et diagramme d’état du distributeur de billets

Configuration

Le nouveau logiciel TVM est une simple application web capable de communiquer avec le matériel local tels que le terminal de paiement et les imprimantes à billets et à reçus. Les étapes suivantes montrent comment configurer un nouveau distributeur TVM sur les écrans de paramétrage SecuTix.

Configuration du poste de travail

Cette étape permet de configurer un poste de travail TVM et tout le matériel connecté au TVM.

1. 1. Cliquez sur le bouton Enregistrer en haut à gauche pour enregistrer l’onglet Général
2. Configurer le terminal de paiement (TPE) :
   
   1. Allez sous l’onglet Matériel et cliquez sur + Nouveau
   2. Sélectionnez TPE dans la liste déroulante Type
   3. Sélectionnez iSelf V3 dans la liste déroulante Matériel et cliquez sur Suivant (comme l’indique la capture d’écran en bas à gauche)
   4. Saisissez TPE comme Nom interne et Code
   5. Sélectionnez le nom de port approprié dans la liste déroulante Port
      Note : il s’agit du nom de port auquel est connecté le TPE sur le PC du distributeur (généralement le port COM2 ; comme l’indique la capture d’écran en bas au centre)
   6. Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
   7. Allez sous l’onglet Ordre du matériel > TPE 
   8. Double-cliquez sur l’élément TPE pour le retirer de l’encadré Non sélectionné et le mettre dans l’encadré Sélectionné et classé (comme l’indique la capture d’écran en bas à droite)
   9. Cliquez sur le bouton Enregistrer
      
      
      
3. Configurez l’imprimante à billets (tous les distributeurs utilisent actuellement l’imprimante BOCA comme imprimante à billets) : 
   
   
   1. Allez sous l’onglet Matériel et cliquez sur + Nouveau
   2. Sélectionnez Imprimante dans la liste déroulante Type
   3. Sélectionnez Billet dans la liste déroulante Sous-type
   4. Sélectionnez le type de matériel approprié utilisé par le distributeur de billets pour l’imprimante BOCA et cliquez sur Suivant (comme l’indique la capture d’écran en bas à gauche)
   5. Saisissez BOCA comme Nom interne et Code
   6. Définissez les paramètres appropriés dans les champs obligatoires restants (comme l’indique la capture d’écran en bas au centre)
   7. Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
   8. Allez sous l’onglet Ordre du matériel > Imprimante à billets 
   9. Double-cliquez sur l’élément BOCA pour le retirer de l’encadré Non sélectionné et le mettre dans l’encadré Sélectionné et classé (comme l’indique la capture d’écran en bas à droite)
   10. Cliquez sur le bouton Enregistrer
       
       
       
4. Configurez l’imprimante à reçus (tous les distributeurs de billets utilisent actuellement l’imprimante Zebra comme imprimante à reçus) : 
   
   1. Allez sous l’onglet Matériel et cliquez sur + Nouveau
   2. Sélectionnez Imprimante à reçus dans la liste déroulante Type

   3. Sélectionnez le type de matériel utilisé par le distributeur de billets pour l’imprimante à reçus et cliquez sur Suivant (comme l’indique la capture d’écran en bas à gauche) 

       

      Sélectionnez Zebra NE si vous ne voulez pas que l’imprimante à reçus éjecte le reçu après l’impression. Dans le cas contraire, sélectionnez Zebra E.

   4. Définissez l’imprimante à reçus comme Nom interne et RPR comme Code
   5. Sélectionnez le nom de port approprié dans la liste déroulante Port
      Note : il s’agit du nom de port auquel est connectée l’imprimante à reçus sur le PC du distributeur (généralement le port COM1 ; comme l’indique la capture d’écran en bas au centre)
   6. Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
   7. Allez sous l’onglet Ordre du matériel > Imprimante à reçus  
   8. Double-cliquez sur l’élément Imprimante à reçus pour le retirer de l’encadré Non sélectionné et le mettre dans l’encadré Sélectionné et classé (comme l’indique la capture d’écran en bas à droite)
   9. Cliquez sur le bouton Enregistrer
      
      
      

Configuration du canal de vente 

Cette étape permet de configurer un canal de vente pour le nouveau TVM.

1. Allez sous l’onglet Institution > Initialisation > Paramètres de l’institution > Canaux de vente
2. Cliquez sur + Nouveau pour ajouter un nouveau canal de vente
3. Sélectionnez Interne comme type de canal de vente et cliquez sur Suivant pour continuer
4. Indiquez le nom interne et le code du nouveau canal de vente
5. Sélectionnez le distributeur de billets (nouveau) dans la liste déroulante Type
6. Autorisez les contingents comme vous le souhaitez (comme l’indique la capture d’écran en bas à gauche)

7. Allez sous l’onglet Paramètres et configurez les valeurs de la manière appropriée (comme l’indique la capture d’écran en bas à droite). Assurez-vous que les deux paramètres suivants sont correctement définis :

    

   Assurez-vous que le script de migration requis pour configurer correctement les paramètres PSP soit exécuté avant de passer à cette étape.

   1. Sélectionnez Ingenico MPA no SSL comme Prestataire de services de paiement
   2. Le mode d’expédition doit être immédiat, ce qui signifie que les billets seront imprimés immédiatement après leur achat
      
      

8. Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
   
   
   

Configuration du point de vente 

Cette étape permet de configurer un point de vente (POS) pour le nouveau TVM.

1. Allez sous l’onglet Organisation > Initialisation > Paramètres d’organisation > Canaux de vente et double-cliquez sur le canal de vente TVM que vous avez créé lors de l’étape Configuration du canal de vente
2. Allez sous l’onglet Point de vente et cliquez sur + Nouveau pour ajouter un nouveau point de vente
3. Remplissez les champs obligatoires sous l’onglet Général et assurez-vous de : 
   

   1. Sélectionner le poste de travail correspondant configuré lors de l’étape Configuration du poste de travail dans la liste déroulante Poste de travail.
      Définir un URL unique pour chaque distributeur :

       Modèle d’URL recommandé : https://nom_TVM-CODE_INSTITUTION.NOM_ENVIRONNEMENT-shop.secutix.com

      par exemple : https://tvm1-mosa.int1-shop.secutix.com/, https://tvm2-mosa.int1-shop.secutix.com/,...

      
      
      

4. Allez sous l’onglet Paramètres du distributeur et cliquez sur le bouton GÉNÉRER pour générer une valeur secrète.

    

   Cette valeur secrète sert d’authentification lorsque le TVM communique avec l’API REST de SecuTix.

   1. FACULTATIF : pour activer le suivi Google Analytics (GA), vous pouvez également définir la valeur de l’ID de GA ou de l’ID du Google Tag Manager (GTM) Container dans le champ correspondant. Des instructions détaillées sur l’activation du suivi GA ou GTM sont disponibles sur cette page.

   
   
   
5. Configurez les onglets Devises et Modes de paiement selon vos besoins
6. Cliquez sur ENREGISTRER pour enregistrer les modifications
7. Si votre nom de domaine est personnalisé merci de contacter nos services pour finaliser l'activation du point de vente

Rendu - Configuration customisation légère 

Cette étape permet de configurer un thème pour le nouveau TVM, définissant l’aspect de celui-ci.

1. Allez sous l’onglet Organisation > Initialisation > Paramètres d’organisation > Canaux de vente et double-cliquez sur le canal de vente TVM que vous avez créé lors de l’étape Configuration du canal de vente
2. Double-cliquez sur le Point de vente que vous avez créé lors de l’étape Configuration du point de vente
3. Allez sous l’onglet Thème et suivez les informations de mappage figurant ci-dessous afin de paramétrer le thème

Mappage de personnalisation light 

Quels produits afficher : configuration de la page de renvoi 

Le nouveau TVM vous permet de choisir librement la disposition des produits et la présentation sur la page d’accueil de TVM. La configuration est la même que pour la page de renvoi pour la plate-forme de ventes en ligne. Consultez Fenêtre d’une boutique dynamique pour plus d’informations. 

Configurer l’heure d’ouverture et de fermeture 

Tout comme dans l’ancienne borne, le nouveau TVM vous permet également de configurer l’heure d’ouverture et de fermeture par le menu Organisation > Outils > Configuration du distributeur de billets > Heures d’ouverture.

Utilisation

Ainsi qu’il est mentionné ci-dessus, le nouveau logiciel TVM est une simple application Web capable de communiquer avec le matériel local tels que le terminal de paiement et les imprimantes à billets et à reçus via le Device Manager (comme illustré dans le diagramme ci-dessous). Dans cette partie, nous allons vous expliquer comment utiliser le nouveau TVM, notamment deux grandes étapes : l’installation du gestionnaire de périphériques (Device Manager) et l’utilisation de l’application Web TVM sur le mode Kiosque de Chrome. 

Télécharger et installer Device Manager 

1. Cliquez sur cette page pour télécharger l’installateur du gestionnaire de périphériques

2. Sélectionnez le fichier .exe que vous venez de télécharger et double-cliquez dessus
3. Installez le kit avec les paramètres par défaut

Configurer Chrome pour exécuter les pages Web de TVM sur le mode Kiosque 

1. Installez la dernière version de Chrome sur le site Web officiel de Chrome
2. Créez un nouveau profil Chrome et cochez Créer un raccourci sur le Bureau
3. Allez dans les Paramètres de Chrome et installez SecuTix Root Certificate (vous pouvez télécharger le certificat ici) 
   
   1. Extrayez le fichier zip que vous avez téléchargé
   2. Importez le fichier SecutixRootCA256.crt dans l’onglet Autorités de certification racines de confiance de Chrome via les paramètres de Chrome
      
4. Modifiez l’option Au démarrage pour appliquer Ouvrir une ou plusieurs pages spécifiques
5. Cliquez sur Définir la page et tapez l’url du point de vente TVM que vous avez configuré dans la section précédente intitulée Configuration du point de vente
6. Fermez le menu Paramètres et allez sur la page de l’adresse url du point de vente TVM (par exemple https://tvm1-mosa.int1-shop.secutix.com/)
7. Faites un clic droit sur la page et cliquez sur Inspecter pour ouvrir l’inspecteur Web
8. Allez sous l’onglet Application et entrez la pair <Clé, Valeur> dans la mémoire locale de l’hébergeur Web TVM
   Clé : secutixApiSecret 
   Valeur : la valeur secrète qui a été configurée à l’étape précédente intitulée Configuration du point de vente
   
   
   
9. Fermez Chrome
10. Trouvez le raccourci Chrome créé à l’étape 2 sur le Bureau et double-cliquez dessus -> Propriétés
11. Dans le raccourci > Ajouter le champ cible --kiosk --disable-pinch --overscroll-history-navigation=0 --remote-debugging-port=9222 à la fin puis enregistrez et fermez la fenêtre des propriétés
12. Double-cliquez sur le raccourci pour démarrer TVM
13. Le nouveau TVM s’exécute à présent sur le mode Kiosque de Chrome !