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
- Ouvrez Configuration > Intégration et sélectionnez Open POS NG (Avalon) - Beta.
- Dans Nom ODBC, indiquez le nom exact du DSN système x86. Saisissez l’utilisateur et le mot de passe uniquement si le DSN ne les gère pas.
- 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é
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.