Configuration de Dioscourides
ImaCash lit les opérations de Dioscourides dans SQL Server. L'intégration est en lecture seule : elle ne modifie pas la source et n'envoie aucune confirmation de paiement, de refus ou d'annulation à Dioscourides.
Prérequis
- Demandez à l'administrateur de Dioscourides un serveur SQL Server accessible depuis le poste ImaCash, la base réelle et un compte disposant du droit SELECT sur la source. Aucun droit d'écriture ou d'administration n'est nécessaire. Ne partagez pas d'identifiants dans les captures, les tickets d'assistance ou les journaux.
- La table ou vue UD_MORF_CASH_TRANSACTIONS_NEW doit exposer TRANS_DATE, TRANS_ID, TRANS_AMOUNT, CASHIER, COMPANY et SALE_TYPE. Vérifiez l'accès avec le compte et la base configurés dans ImaCash.
Étapes à suivre
- Accéder à la configuration de l’intégration : Ouvrez Configuration > Intégration dans ImaCash.
- Sélectionner le système POS : Sélectionnez la catégorie POS du catalogue.
- Sélectionnez ensuite Dioscourides dans le menu déroulant.
- Renseigner les données de connexion :
- Serveur / IP : Saisissez l'hôte ou l'IP SQL Server ; si nécessaire, utilisez hôte\instance ou hôte,port dans ce champ, selon les informations de l'administrateur. Il ne s'agit pas d'une URL HTTP.
- Nom de la base de données : Saisissez le nom réel de la base. FARMAKIO est un exemple, pas un nom obligatoire.
- Utilisateur : Saisissez le compte SQL autorisé à effectuer des SELECT ; les valeurs d'exemple ne sont pas des identifiants valides.
- Mot de passe : Saisissez le mot de passe associé à cet utilisateur.
- Enregistrer la configuration : Cliquez sur Enregistrer et vérifiez le résultat de la connexion avant d'effectuer une opération contrôlée.
Capture et limites
- Seules les espèces identifiées exactement par SALE_TYPE='CASH' sont capturées. TRANS_ID identifie l'opération, TRANS_DATE sa date et TRANS_AMOUNT son montant ; les montants négatifs sont des remboursements. Les cartes et les autres types ne sont pas convertis en espèces. Aucune confirmation bidirectionnelle ni écriture de rapprochement n'est envoyée à Dioscourides.
- COMPANY peut être NULL ou vide : cela ne constitue pas à lui seul une erreur de vente. Conservez cette valeur sans inventer une entreprise, un magasin ou un poste pour compléter le champ.
- CASHIER est également facultatif : NULL et vide sont valides. La valeur reste vide, sans inventer d'opérateur.
- Les critères de Paramètres > Filtres s'appliquent exclusivement dans ImaCash, selon les interrupteurs activés ; aucun filtre de magasin, de poste ou d'opérateur n'est ajouté au SQL. Si un filtre actif exige une métadonnée absente de l'opération, il l'exclut. Un filtre désactivé ne doit plus restreindre la capture après l'enregistrement. N'inventez pas de données pour forcer une correspondance.
Validation du correctif
- Au démarrage, ImaCash valide le schéma et exécute un véritable SELECT avant de déclarer l'intégration connectée. Une connexion ouverte ne prouve pas à elle seule l'accès à la table ou à la vue.
- En cas d'échec de connexion, de schéma ou de lecture, ImaCash conserve le curseur de capture sans mettre un lot partiel en file d'attente. DateSync et SaleType sont envoyés comme paramètres SQL. Le diagnostic n'enregistre ni identifiants ni erreurs brutes du fournisseur.
- Les montants sont traités avec decimal. Si la source fournit du texte, le point ou la virgule représente le séparateur décimal, sans séparateur de milliers et indépendamment des paramètres régionaux Windows.
Vérifications chez le client
Avec la version corrigée et validée, contrôlez une vente en espèces, un remboursement négatif et un paiement par carte qui ne doit pas apparaître comme espèces. Incluez COMPANY et CASHIER renseignés, NULL et vides, des filtres activés puis désactivés après enregistrement et des montants avec point ou virgule. Redémarrez ImaCash et vérifiez l'absence de doublons et de pertes d'opérations en attente. Vérifiez également qu'un échec de lecture ne publie pas d'opérations partielles et que la reprise conserve le curseur. Le sondage existant et la fenêtre globale de 120 minutes restent inchangés. Comparez les résultats avec Dioscourides avant d'autoriser l'utilisation courante.