Configurer Ágora Retail dans ImaCash
Ce guide concerne POS > AgoraRetail et sa lecture SQL Server. Ágora POS et Ágora API sont des modes distincts. Les anciens noms AgoraRetail V2 et V3 désignent le même connecteur ; ils ne prouvent ni versions commerciales ni compatibilité supplémentaire.
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 > AgoraRetail. Confirmez le mode préparé avec le fournisseur avant de modifier une installation existante.
- 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.
Enregistrez la connexion et choisissez les moyens réels de l’installation lorsque les listes apparaissent. Conservez la configuration fonctionnelle et vérifiez les valeurs enregistrées avant utilisation. L’absence de moyens ne prouve pas que la connexion a validé les paiements. Effectuez un nouveau démarrage normal d’ImaCash, sans opération en cours, pour appliquer et vérifier les moyens enregistrés.
Espèces, cartes et mouvements de caisse
Sélectionnez le moyen espèces par son nom réel. Pour les cartes, choisissez un moyen distinct et activez Accepter les cartes dans les réglages. Si cette option est désactivée, seul le moyen espèces est interrogé ; son activation ajoute le moyen carte sélectionné. N’utilisez pas d’identifiants d’exemple et ne supposez pas qu’une liste vide ou une sélection annulée garantit le classement. Crédit, bons et autres moyens ne sont pas inclus automatiquement.
Chaque paiement est lu comme montant payé moins monnaie rendue, en conservant son signe. Un document mixte peut produire des mouvements distincts pour les composantes sélectionnées ; son total n’est pas répété pour chaque moyen. Un montant négatif ne prouve ni remboursement exécuté ni autorisation bancaire. Ce mode ne comprend pas de lecture indépendante des mouvements de caisse/fournisseurs.
Postes, opérateurs et filtres
Vérifiez postes et opérateurs avec des documents connus avant de filtrer. La liste des postes peut fournir des identifiants alors que les mouvements affichent des noms ; vérifiez leur correspondance. Dans certains schémas, le poste est celui d’ouverture du ticket, pas celui du paiement. L’opérateur est celui d’ouverture du document. Les filtres locaux d’ImaCash peuvent exclure des paiements déjà lus par SQL ; une référence générique de magasin n’identifie pas un magasin physique.
Vérifier les résultats
Comparez paiements existants en espèces, par carte et mixtes, monnaie rendue, montants négatifs, dates et liens aux documents. Examinez avec le fournisseur les paiements sans document associé, doublons, omissions et filtres. Ne réalisez pas de paiements ou remboursements réels pour tester. Une connexion SQL réussie ne prouve ni lecture complète ni clôture du document. Les paiements sans document associé peuvent ne pas identifier de poste ou d’opérateur ; ne complétez pas ces données par supposition.
La liaison lit les paiements ; elle n’importe pas de produits et n’écrit ni confirmations, refus ni annulations dans Ágora. Listes de moyens, connexion et variantes de schéma prévues ne prouvent ni compatibilité avec toutes les versions ni validation physique. Confirmez le périmètre de l’installation avant tout usage automatique.