Bêta technique: Un connecteur ODBC en lecture seule est disponible pour une première validation contrôlée sur une installation réelle d’Open POS NG. Il ne doit pas être activé pour des opérations d’encaissement réelles avant la fin de la matrice de tests.
Prérequis
ImaCash doit fonctionner sous Windows et pouvoir atteindre le serveur local d’Open POS NG. Créez un DSN système ODBC 32 bits avec le pilote de base de données utilisé par l’installation et un compte en lecture seule disposant du droit SELECT sur une table ou vue transactionnelle préparée par Avalon ou le mainteneur du POS.
Configuration dans ImaCash
- Depuis la fenêtre principale, ouvre Configuration > Intégration > POS et sélectionne Open POS NG (Avalon) - Beta. Utilise l’identification autorisée demandée par ImaCash.
- Dans Nom ODBC, indique le nom exact du DSN système 32 bits préparé par le responsable. Il doit fonctionner sous le compte Windows qui exécute ImaCash, sans boîte de connexion supplémentaire. Utilisateur et Mot de passe sont des données privées ; renseigne-les uniquement si la configuration du DSN les exige.
- Dans Table ou vue des ventes, indiquez la source exacte autorisée, avec une ligne par opération ou mode de paiement ; n’utilisez jamais une table d’articles qui répète le total du ticket. Utilisez schema.table si nécessaire. ImaCash ne recherche ni ne sélectionne d’autres sources.
Mappage explicite et faisant autorité
Saisis le contrat confirmé par le responsable dans Mappage des colonnes. Les noms et valeurs de l’exemple suivant illustrent la syntaxe ; ils ne décrivent pas le schéma de toutes les installations d’Open POS NG. Ne colle pas de chaîne de connexion, de mot de passe ou de données de vente dans ce champ.
Définissez toujours le mappage des colonnes avec des paires séparées par des points-virgules ; ImaCash l’utilise comme contrat faisant autorité et ne devine pas les colonnes. Il doit inclure dateonly=true|false : true indique que date est une colonne DATE sans heure et permet d’utiliser time avec dateonly=true ; false indique que date contient déjà la date et l’heure. Par exemple : id=ID;date=DATE;dateonly=true;time=HEURE;cash=MONTANT_ESPECES;operator=OPERATEUR;terminal=CAISSE. Le contrat cash accepte un seul montant cohérent par identifiant et échoue de manière fermée si cet identifiant se répète avec des valeurs différentes. Pour les lignes de paiement, utilisez amount=MONTANT_PAIEMENT;payment=MODE_PAIEMENT;cashvalue=ESPECES|CASH. Si les identifiants doivent être délimités, ajoutez quote=none|double|bracket|backtick ; none est la valeur par défaut.
Contrat de finalisation obligatoire
Configurez l’une de ces deux options : une vue contenant uniquement les ventes finales avec finalonly=true ; ou status=STATUT;closedvalue=CLOTUREE|PAYEE;modified=MODIFIEE_LE pour filtrer les états clôturés et récupérer les clôtures tardives. Pour le contrat amount+payment avec status+modified, modified identifie la modification de la vente : ImaCash obtient d’abord les identifiants modifiés, puis récupère toutes leurs lignes avant de totaliser les espèces, ce qui évite la capture partielle d’un paiement mixte. Sans l’un de ces contrats, l’intégration échoue de manière fermée.
Périmètre de cette bêta
L’intégration lit les opérations récentes et transmet uniquement les espèces à ImaCash, y compris seulement la part en espèces des paiements mixtes et les remboursements avec un signe négatif. Elle est strictement en lecture seule : elle ne modifie jamais Open POS NG et n’écrit aucune confirmation, aucun état, paiement ou annulation dans Avalon.
Enregistrer et vérifier la configuration
En fermant Configuration avec des modifications, tu peux enregistrer, poursuivre la modification ou quitter sans enregistrer les changements en attente. L’enregistrement se fait par étapes : un échec ultérieur n’annule pas les étapes déjà enregistrées. Ouvrir le DSN et vérifier la source et le mappage atteste seulement cet accès en lecture ; cela ne confirme ni une capture complète, ni un encaissement, ni le fonctionnement du dispositif.
Filtres, historique et validation initiale
Les filtres de poste et d’opérateur exigent respectivement les colonnes terminal et operator dans le mappage. Vérifie leur sélection et leur activation dans Paramètres > Filtres. La consultation utilise une fenêtre récente de deux heures au maximum ; la resynchronisation ne garantit pas la récupération de tout l’historique. Cette bêta n’importe ni articles, ni stocks, ni sessions de caisse, ni total distinct des cartes.
Avant l’utilisation commerciale, le responsable doit vérifier dans une installation réelle une vente en espèces, un paiement mixte, un remboursement, une clôture tardive et la continuité après redémarrage, y compris l’absence de doublons. Un essai avec des données fictives ou une connexion réussie ne suffit pas à valider ce fonctionnement. Si un résultat est incertain, vérifie le ticket et les espèces réelles avant de répéter, de resynchroniser ou de redémarrer.
Consulter la configuration, l’enregistrement et la sortie dans le manuel d’ImaCash