Configurer Ágora POS dans ImaCash
Ce guide concerne le sélecteur AgoraPOS d’ImaCash et sa lecture SQL Server. Ágora API et Ágora Retail sont des modes distincts : confirmez avec le fournisseur celui préparé pour votre installation avant de choisir ou de modifier le lien.
Avant de commencer
Le fournisseur doit confirmer la version et la structure compatibles, le serveur et la base actifs ainsi qu’un compte autorisé disposant des droits de lecture nécessaires. Vérifiez l’accès sous l’identité qui exécute ImaCash et conservez une configuration fonctionnelle. Ne copiez pas les exemples des manuels et ne supposez pas toute installation Ágora compatible.
Étapes de configuration
- Ouvrez Configuration > Intégration et sélectionnez POS > AgoraPOS. Ne choisissez pas API ou Retail sur la seule ressemblance du nom.
- Vérifiez ces champs avec le technicien en utilisant uniquement les données privées fournies par l’administrateur :
- IP du serveur et Port identifient la destination SQL Server de votre installation. Le port est utilisé si la destination ne contient pas déjà une instance ou un port ; ce guide ne fixe aucun port universel.
- Nom de la BDD est le nom exact de la base de ventes compatible, pas un fichier ni une liste de postes.
- Nom d’instance identifie l’instance SQL Server, si nécessaire. L’instance est prioritaire sur le champ Port ; ne l’ajoutez pas deux fois et ne mélangez pas les données de plusieurs installations.
- Renseignez Utilisateur et mot de passe avec le compte SQL privé autorisé, et saisissez le secret uniquement dans ImaCash. Ce mode n’affiche pas de case d’authentification Windows. Si une configuration antérieure l’utilise déjà, conservez son identité Windows valide et demandez une vérification technique ; ne modifiez pas de fichiers pour l’activer.
Utilisez Enregistrer et vérifiez la connexion. Modifiez une configuration existante avec l’assistance, sans opération en cours. L’enregistrement ou l’ouverture SQL ne prouve pas la lecture de tous les paiements et mouvements attendus.
Espèces, cartes et mouvements de caisse
Ce mode utilise les moyens d’espèces et de carte prévus par le lien, sans sélecteurs de moyens de paiement propres. Le fournisseur doit confirmer leur correspondance. Si Accepter les cartes est désactivé, la lecture inclut les paiements en espèces des documents ; l’activation ajoute les paiements par carte prévus. Les moyens personnalisés, crédits ou bons ne sont pas intégrés automatiquement, et aucun paiement bancaire n’est autorisé.
Chaque paiement est lu pour son montant payé diminué de la monnaie rendue. Les paiements distincts d’un document mixte peuvent produire des mouvements séparés de leurs composantes, sans répéter le total du document pour chaque moyen. Les mouvements de caisse/fournisseurs sont lus comme des espèces et gardent le signe du TPV, même avec les cartes activées : ce ne sont pas tous des sorties. Validez leur périmètre et leur sens avant des mouvements d’espèces automatiques.
Postes, opérateurs et filtres
Vérifiez les noms et identifiants réels de l’installation. Réglez les filtres dans ImaCash et comparez-les à des documents connus. Le filtre d’opérateur peut aussi exclure des mouvements de caisse/fournisseurs ; ne supposez pas les deux lectures identiques dans leur origine ou sélection. Une liste de centres ne prouve pas leur équivalence avec les postes, et la référence de magasin du lien n’identifie pas un magasin physique réel.
Vérifier les résultats
Avec le fournisseur, comparez des paiements existants en espèces, par carte et mixtes, les montants payés diminués de la monnaie, les documents négatifs et les mouvements de caisse/fournisseurs. Vérifiez dates, postes, opérateurs, absences et doublons. Un montant négatif conserve son signe mais ne prouve pas un remboursement effectué. Les bons de livraison identifiés comme rouverts sont omis ; cela ne confirme ni une annulation ni le retrait d’un ancien élément en attente. N’effectuez pas de paiements ou remboursements réels pour tester la configuration.
Le lien lit les données ; il n’importe pas d’articles et n’écrit aucune confirmation, aucun refus ni aucune annulation dans Ágora. Une connexion réussie ne prouve ni lecture complète, clôture de document, paiement bancaire, rapprochement ou validation physique. Confirmez le périmètre des deux lectures et de chaque installation avec le fournisseur.