ScanEat — Guide Monnayeur VNE

Le protocole VNE (V.N.E. S.r.l.) est utilisé par les monnayeurs automatiques VNE, très répandus en Europe. Il utilise une API REST HTTP/HTTPS avec des données JSON — le même format que les APIs web modernes.

✅ Avantages

Pas de port série requis. Communication via réseau local WiFi ou Ethernet. Pas de driver à installer.

🔌 Connexion

Le monnayeur est connecté au réseau local (WiFi ou câble). Il a sa propre adresse IP locale.

🌐 Protocole

HTTPS sur port 443 (ou HTTP sur port 8080). Requêtes POST en JSON vers /selfcashapi/

📦 Modèles

Compatible avec tous les monnayeurs VNE équipés du module réseau (AC-xxx series).

2. Architecture de communication

ScanEat Caisse (navigateur)
⬇️ WebSocket ws://localhost:8765
ScanEat Cash Service (Node.js sur PC caisse)
⬇️ HTTPS POST /selfcashapi/
Monnayeur VNE (192.168.x.x:443)

ℹ️ Le service ScanEat Cash doit être installé et lancé sur le PC de caisse. Il fait le pont entre le navigateur et le monnayeur.

3. Installation du service ScanEat Cash

Télécharger le service

Admin ScanEat → Paiements → Activer Monnayeur → ⬇️ Télécharger le service (Windows)

Installer Node.js si besoin

Télécharger sur nodejs.org → version LTS → installer. Vérifier : node --version

Extraire le ZIP

Extraire dans un dossier fixe, ex: C:\ScanEatCash\

Installer les dépendances

Double-cliquer install-windows.bat — installe automatiquement les modules Node.js requis.

Lancer le service

Mode test : start.bat | Mode production : start-production.bat

✅ Le service démarre sur le port 8765. Il doit rester ouvert pendant toute la durée de travail.

4. Mode Test — Simulateur VNE

Le simulateur permet de tester l'intégration sans avoir de vrai monnayeur connecté.

Lancer start.bat

Ouvre 2 fenêtres : le simulateur VNE (port 8766) et le service ScanEat Cash (port 8765).

Dans la caisse ScanEat

Cliquer sur le bouton 🏧 Monnayeur → puis 🏧 VNE

Cliquer "Simulateur"

Le simulateur se connecte automatiquement sur localhost:8766

Tester un paiement

Sélectionner une commande → cliquer 🏧 VNE → le simulateur répond après 3 secondes avec paiement confirmé.

ℹ️ Le simulateur simule l'insertion de billets après 3 secondes automatiquement.

5. Mode Production — Vrai monnayeur

Connecter le monnayeur au réseau

Brancher le monnayeur VNE au réseau local (câble Ethernet recommandé). Configurer l'IP fixe dans le menu du monnayeur.

Trouver l'adresse IP du monnayeur

Dans le menu du monnayeur : Paramètres → Réseau → IP. Exemple : 192.168.1.100

Lancer start-production.bat

Lance uniquement le service ScanEat Cash (sans simulateur).

Configurer dans la caisse

Cliquer 🏧 VNE → entrer l'IP du monnayeur → cliquer "Connecter VNE"

Tester la connexion

Le statut doit afficher "Monnayeur connecté". Faire un paiement test.

⚠️ Le PC de caisse et le monnayeur doivent être sur le même réseau local.

6. Utilisation dans la caisse

Sélectionner une commande

Cliquer sur la commande à encaisser dans la liste.

Cliquer sur 🏧 VNE

Le panel monnayeur s'ouvre avec le montant à encaisser.

Le client insère les billets

Le monnayeur accepte les billets et pièces. ScanEat affiche le montant inséré en temps réel.

Paiement confirmé

Quand le montant est atteint, ScanEat confirme automatiquement la commande et enregistre le paiement.

La monnaie est rendue

Le monnayeur rend automatiquement la monnaie au client.

7. Commandes VNE disponibles

Type	Action	Paramètres
`1`	Demande paiement	importo (centimes), opName
`2`	Statut paiement	id (du paiement)
`3`	Annuler paiement	id (du paiement)
`20`	Statut machine	—
`60`	Clôture caisse	opName
`65`	Remboursement	importo, id
`82`	Version machine	—

Exemple requête paiement

POST https://192.168.1.100/selfcashapi/
{
  "tipo": 1,
  "importo": 590,
  "opName": "ScanEat",
  "refundable": 1,
  "credit_card": 0
}

Réponse

{
  "esito": "ok",
  "id": 1234567890,
  "stato": "in_attesa"
}

8. Dépannage

Problème	Cause	Solution
Service non démarré	Node.js non installé	Installer Node.js depuis nodejs.org
Monnayeur non connecté	IP incorrecte	Vérifier IP dans menu monnayeur
Timeout 5 secondes	Réseau différent	PC et monnayeur sur même réseau
Erreur SSL	Certificat auto-signé	Normal — le service ignore le SSL VNE
Port 8765 occupé	Autre programme	Modifier wsPort dans config.json

ℹ️ Les logs sont disponibles dans la fenêtre du terminal du service ScanEat Cash.

🏧 ScanEat — Guide Monnayeur VNE

📋 Table des matières

1. Présentation du protocole VNE