Configurer gsBase avec ImaCash
gsBase est une plateforme de développement d’applications de gestion. Ce guide décrit le profil d’échange de fichiers d’ImaCash ; le fournisseur doit confirmer que l’application installée produit et reçoit ce format. Il ne prouve pas la compatibilité de tous les ERP, versions ou de l’API gsBase.
1. Préparer un dossier exclusif
Convenez avec le fournisseur d’un dossier d’échange pour un seul poste et un seul consommateur. Le compte Windows réel d’ImaCash doit pouvoir lister les fichiers, ouvrir les entrées en lecture et écriture exclusives, les supprimer et créer le sous-dossier RESPUESTA et ses fichiers. Ne sélectionnez ni racine de disque, documents, sauvegardes ou dossiers d’autres logiciels.
2. Sélectionner le profil actuel
Ouvrez Configuration > Intégration et sélectionnez POS > GsBase. Dans Ventes, choisissez le répertoire convenu avec l’icône de dossier. Ce profil ne demande ni serveur, port, compte SQL, mot de passe ou DSN. L’administrateur fournit les données privées de l’installation.
3. Convenir des enregistrements et références
Le lecteur prend les .txt du premier niveau. Préparez un enregistrement compact par fichier, UTF-8 sans BOM et inférieur à 1 KiB, avec quatre champs séparés par des points-virgules : magasin ; référence de vente ; vendeur ; montant. Un cinquième champ est accepté mais ignoré. La référence vient du deuxième champ, non du nom de fichier ; elle doit être unique et valide pour le nom de la réponse. N’incluez ni chemins ni séparateurs de répertoire.
4. Confirmer l’unité du montant
Le quatrième champ a deux interprétations : s’il est reconnu comme entier, il est divisé par cent ; sinon il est converti en décimal selon les paramètres régionaux Windows. Le fournisseur doit vérifier unité, séparateur décimal, signe, devise et montant obtenu avant utilisation. Ne supposez pas qu’un entier représente des unités monétaires entières ni qu’un même texte décimal fonctionne sur tous les postes.
5. Enregistrer et vérifier l’accès
Enregistrez puis fermez sous le compte Windows d’ImaCash, avec le chemin complet et non vide. Au démarrage, le profil tente de préparer RESPUESTA ; l’indication connecté ne prouve ni lecture de la caisse, format correct ou espèces. Vérifiez dossier, droits, montant et réception des réponses avec le fournisseur avant l’exploitation commerciale.
6. Comprendre la lecture et les identifiants
Les entrées sont supprimées après lecture, avant confirmation du résultat, même sans vente valide. Il n’existe ni archive des fichiers traités ni récupération historique par date. Magasin et vendeur viennent du registre ; le terminal est affecté en interne et la date est celle de lecture, non une date de vente importée. Aucun catalogue de magasins, caisses ou vendeurs n’est interrogé et les filtres ne prouvent pas l’isolement par poste. Conservez la traçabilité à la source sans remettre les fichiers pour répéter.
7. Contrôler RESPUESTA
La confirmation tente d’écrire dans RESPUESTA avec la référence de vente et l’extension .OK, contenant montant, somme remise et monnaie rendue séparés par | ; vérifiez le signe de la monnaie avec le fournisseur. Une transaction marquée annulée tente .KO avec le montant et deux zéros. Le refus seul n’écrit aucune réponse. La présence d’un fichier ne prouve ni sa lecture par la caisse, ni la clôture de la vente ou la fin de l’annulation.
8. Valider le circuit et ses limites
Ce profil enregistre les entrées comme des espèces et ne propose ni sélecteur Accepter les cartes, ventilation bancaire indépendante, produits, stocks ou services. Le cinquième champ ne prouve pas un moyen de paiement. Validez sous supervision références, montants et signes, réponses dans les deux logiciels et espèces réelles. En cas de résultat incertain, vérifiez-les avant de répéter, remettre des fichiers, resynchroniser ou redémarrer. Un guide ou une connexion ne constitue pas une validation physique.
Nous conservons le logo gsBase du catalogue ; le guide explique le sélecteur POS actuel et remplace les anciennes captures de configuration.