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.
Pour obtenir des informations sur les nouveautés du nouveau distributeur de billets, cliquez sur Le nouveau distributeur de billets électroniques.
Veuillez noter que le nouveau distributeur de billets introduit dans Piz Bernina v1 remplace seulement le logiciel de l’ancien distributeur. Le matériel reste le même.
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 tel 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.
En règle générale, vous devriez configurer un poste de travail par distributeur.
- Input all the mandatory fields of the new workstation
Input the correct "Terminal number" for the TPE
Please contact Contactis if you are not sure which terminal number to use for your vending machine's TPE.
- Click "Save" button on the top-left corner to save the "General" tab
Note: this is the port name that TPE is connected to on the vending machine PC (usually it's COM2) (as shown in screenshot in the middle below)
Configure the Ticket Printer (currently all the vending machines are using BOCA printer as the ticket printer):
Configure the Receipt Printer (currently all the vending machines are using Zebra printer as the receipt printer):
Choose the correct hardware type for the receipt printer that is used by the ticket vending machine & click "Next" (as shown in the screenshot on the left below)
Choose "Zebra NE" if you don't want the receipt printer to eject the receipt after printing. Otherwise choose "Zebra E".
Note: this is the port name that receipt printer is connected to on the vending machine PC (usually it's COM1) (as shown in screenshot in the middle below)
Sales channel configuration
This step aims at setting up a sales channel for the new TVM.
If you want to sell the same products on all ticket vending machines, you only need to configure one sales channel.
Go to the "Parameters" tab and configure the values accordingly (as shown in the screenshot on the right below). Please make sure the following two parameters are correctly set:
Please make sure that the required migration script to setup the correct psp parameters is executed before you do this step.
- Cliquez sur l’onglet Organisation > Initialisation > Paramètres d’organisation > Postes de travail
- Cliquez sur + Nouveau pour ajouter un nouveau poste de travail
- Configurer les informations générales sous l’onglet Général :
a. Remplir tous les champs obligatoires du nouveau poste de travail
b. Saisir le numéro de terminal approprié pour le TPE
Veuillez contacter Contactis si vous n’êtes pas sûr du numéro de terminal qu’il faut utiliser pour le TPE de votre distributeur.
- Cliquez sur le bouton Enregistrer en haut à gauche pour enregistrer l’onglet Général
- Configurer le terminal de paiement (TPE) :
- Allez sous l’onglet Matériel et cliquez sur + Nouveau
- Sélectionnez TPE dans la liste déroulante Type
- 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)
- Saisissez TPE comme Nom interne et Code
- 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) - Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
- Allez sous l’onglet Ordre du matériel > TPE
- 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)
- Cliquez sur le bouton Enregistrer
- Configurez l’imprimante à billets (tous les distributeurs utilisent actuellement l’imprimante BOCA comme imprimante à billets) :
- Allez sous l’onglet Matériel et cliquez sur + Nouveau
- Sélectionnez Imprimante dans la liste déroulante Type
- Sélectionnez Billet dans la liste déroulante Sous-type
- 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)
- Saisissez BOCA comme Nom interne et Code
- Définissez les paramètres appropriés dans les champs obligatoires restants (comme l’indique la capture d’écran en bas au centre)
- Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
- Allez sous l’onglet Ordre du matériel > Imprimante à billets
- 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)
- Cliquez sur le bouton Enregistrer
- Configurez l’imprimante à reçus (tous les distributeurs de billets utilisent actuellement l’imprimante Zebra comme imprimante à reçus) :
- Allez sous l’onglet Matériel et cliquez sur + Nouveau
- Sélectionnez Imprimante à reçus dans la liste déroulante Type
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.
- Définissez l’imprimante à reçus comme Nom interne et RPR comme Code
- 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) - Cliquez sur ENREGISTRER ET FERMER pour enregistrer les modifications et fermer la fenêtre
- Allez sous l’onglet Ordre du matériel > Imprimante à reçus
- 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)
- Cliquez sur le bouton Enregistrer
Configuration du canal de vente
Cette étape permet de configurer un canal de vente pour le nouveau TVM.
Si vous voulez vendre les mêmes produits sur tous les distributeurs de billets, vous n’avez besoin de configurer qu’un seul canal de vente.
- Allez sous l’onglet Institution > Initialisation > Paramètres de l’institution > Canaux de vente
- Cliquez sur + Nouveau pour ajouter un nouveau canal de vente
- Sélectionnez Interne comme type de canal de vente et cliquez sur Suivant pour continuer
- Indiquez le nom interne et le code du nouveau canal de vente
- Sélectionnez le distributeur de billets (nouveau) dans la liste déroulante Type
- Autorisez les contingents comme vous le souhaitez (comme l’indique la capture d’écran en bas à gauche)
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.
- Sélectionnez Ingenico MPA no SSL comme Prestataire de services de paiement
- Le mode d’expédition doit être immédiat, ce qui signifie que les billets seront imprimés immédiatement après leur achat
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.
En règle générale, vous devez configurer un POS par distributeur.
- 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
- Allez sous l’onglet Point de vente et cliquez sur + Nouveau pour ajouter un nouveau point de vente
- Remplissez les champs obligatoires sous l’onglet Général et assurez-vous de :
- 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 :
Click "SAVE AND CLOSE" to save the changes and close the window
Point of sales configuration
This step aims at setting up a point of sales (POS) for the new TVM.
Typically you should configure one POS for each vending machine station.
- Go to tab Organization > Initialization > Organization parameters > Sales Channels & double click on the TVM sales channel you created in step Sales channel configuration
- Go to the "Point of sales" tab and click "+ New" to add a new point of sales
- Fill in the mandatory fields in the "General" tab and make sure to:
- select the corresponding workstation configured in step Workstation configuration in the Workstation dropdown.
put a unique url for each vending machine:
The recommended url pattern is: https://TVM_Name-INSTITUTION_CODE.ENVIRONMENT_NAME-shop.secutix.com/
e.g.par exemple :
https://tvm1-mosa.int1-shop.secutix.com/,
Go to the "Vending machine parameters" tab and Click "GENERATE" button to generate a secret token.
This secret token is used for authentication when TVM is communicating with SecuTix's REST api.
OPTIONAL - To enable Google Analytics Tracking you can also put the value of your GA Tracking ID or GTM Container ID into the corresponding field. For detailed instructions on how to enable GA or GTM tracking, please visit this page.
- Configure the "Currencies" and "Payment modes" tabs based on your needs
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.
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.
- Configurez les onglets Devises et Modes de paiement selon vos besoins
- Cliquez sur ENREGISTRER pour enregistrer les modificationsClick "SAVE" to save the changes
How it looks - Light customization configuration
This step aims at setting up a theme for the new TVM, which defines its look & feel.
- Go to tab Organization > Initialization > Organization parameters > Sales Channels & double click on the TVM sales channel you created in step Sales channel configuration
- Double click on the Point of sales you created in step Point of sales configuration
- Go to the "Theme" tab and follow the mapping information below to parameter the theme
Light customization mapping
Please choose "Equilibrium (new)" as the Graphical theme in order to have the most optimal presentation.
What products to show - Landing page configuration
The new TVM allows you to freely choose the product grouping and presentation layout displayed on the TVM storefront page. The configuration is the same as the landing page for online sales platform. Please visit A dynamic shop window for more information.
In order to achieve the most optimal look and feel on the TVM's storefront page, you will need to enable Amazon S3 Image Cloud Service for your institution.
The TVM-specific sales calendar configuration (under Organization > Tools > Vending machine configuration > Sale calendar) is still supported in the new TVM, if you want to configure sale exceptions, weekday holes on your TVM, please use this configuration.
Configure opening & closing time
Like in the old Borne, the new TVM also allows you to configure the opening & closing time via menu Organization > Tools > Vending machine configuration > Opening hours.
Deployment
As mentioned above, the new TVM software is simply a web application that can communicate with local hardware like payment terminal & ticket and receipt printers via device manager (as illustrated in the diagram below). In this section we are going to explain you how to deploy the new TVM, including two big steps: installation of the device manager and deploy the TVM web app in Chrome Kiosk mode.
Download and install Device Manager
Go to this page to download the device manager installer
- Find the .exe file you just downloaded and double click on it
- Install the kit with default settings
Setup Chrome to run the TVM web pages in Kiosk mode
- Install the latest version of Chrome from Chrome's official website.
- Create a new Chrome profile and check "create shortcut on Desktop"
- Go to Chrome Settings and install SecuTix Root Certificate (you can download the certificate from here)
- Extract the zip file you downloaded
- Import the file "SecutixRootCA256.crt" to Chrome "Trusted Root Certification Authorities" via Chrome Settings
- Change the "On startup" option to "Open a specific page or set of pages"
- Click on the "Set page" and put in the TVM PoS url that you configured in the previous section "Point of sales configuration"
- Close the Settings menu and go to the page with the TVM PoS url (e.g. https://tvm1-mosa.int1-shop.secutix.com/)
- Right click on the page and click on "Inspect" to open the web inspector
- Go to "Application" tab and input the following <Key, Value> pair into the TVM Web Host's Local Storage:
Key: secutixApiSecretKey
Value: the secret token that's configured in the previous section "Point of sales configuration" - Close Chrome
- Find the Chrome shortcut created at step 2 on desktop & Right click -> Properties
- In the Shortcut > Target field append "--kiosk --disable-pinch --overscroll-history-navigation=0 --remote-debugging-port=9222" at the end and Save & Close the properties popup
- Double click the shortcut to start the TVM
- The new TVM is now running in the Kiosk mode on Chrome!