Configurer FicherosTXT avec ImaCash
FicherosTXT reçoit les demandes d’un logiciel de caisse par fichiers texte. Le fournisseur doit préparer le format et récupérer les résultats avant utilisation commerciale. Il ne s’agit ni de Ficheros Alcornoque, ni de FicherosRCSCash, ni d’un profil de test ; le nom ne valide pas tous les dispositifs ou systèmes d’exploitation.
1. Préparer l’échange
Réservez un dossier à cette caisse et à cette installation. Le compte Windows d’ImaCash doit pouvoir lire, créer, déplacer et supprimer des fichiers et créer des sous-dossiers. Ne choisissez ni racine du disque, ni documents personnels, ni sauvegardes. Vérifiez tout partage réseau avec ce même compte ; ne présumez pas plusieurs lecteurs simultanés.
2. Sélectionner FicherosTXT
Ouvrez Configuration > Intégration, choisissez la catégorie ImaCash puis FicherosTXT. Configurez séparément le dispositif de gestion des espèces. Le nom de la méthode ne rend pas les autres connecteurs de fichiers équivalents et n’impose pas de profil masqué ou de test.
3. Indiquer le dossier
Dans Ventes, sélectionnez le répertoire d’échange confirmé par le fournisseur, pas un fichier individuel. Les anciennes captures peuvent afficher Transactions et un ancien bouton Enregistrer. Le connecteur ne demande pas de serveur SQL, base de données, port ou identifiants propres. Gardez privés le chemin et les identifiants du partage réseau.
4. Préparer le TXT
Chaque fichier contient une demande : seule la première ligne est lue, avec exactement six champs séparés par des points-virgules. N’ajoutez pas d’en-tête et ne comptez pas sur les lignes suivantes. La caisse doit terminer le fichier avant de le rendre visible comme TXT ; convenez de l’encodage et du format avec le fournisseur selon les paramètres régionaux Windows d’ImaCash.
| Champ | Contenu à confirmer par le fournisseur |
|---|---|
| Montant | Montant demandé et signe, sans séparateur de milliers. Validez le séparateur décimal dans les paramètres régionaux réels d’ImaCash. Un montant négatif ne prouve pas l’autorisation du remboursement. |
| Terminal | Identifiant du poste de caisse conservé dans la demande, pas le modèle du dispositif. |
| Référence | Identifiant unique et valide de l’opération, utilisable pour nommer la réponse sans séparateurs de chemin. Ne le réutilisez ou modifiez pas pour répéter un paiement incertain. |
| Vendeur | Identifiant ou libellé de l’opérateur transmis par la caisse ; il doit correspondre aux filtres sans présumer un catalogue d’utilisateurs. |
| Date et heure | Date et heure interprétables par ImaCash selon ses paramètres régionaux. Confirmez format et date d’activité avec le fournisseur. |
| Type de paiement | 1 pour espèces ou 0 pour carte selon le format convenu. N’envoyez pas d’autres valeurs et ne considérez pas ce champ comme une autorisation bancaire. |
5. Enregistrer à la fermeture
Fermez Configuration et confirmez l’enregistrement lorsque cela vous est demandé ; suivez le redémarrage proposé si nécessaire. Le démarrage vérifie un accès élémentaire au dossier et l’écriture, mais l’indicateur connecté ne prouve ni format, ni déplacement des fichiers, ni encaissement, ni réception de la réponse par la caisse.
6. Distinguer capture et paiement
Les TXT présents sont lus sans reconstituer d’historique depuis la date de synchronisation. Les fichiers peuvent passer dans processed après incorporation ou examen local ; cela ne signifie pas payé. Les fichiers vides ou mal formés peuvent passer dans error sans que chaque échec produise une réponse .KO. Ne supprimez, modifiez ou réinjectez pas ces fichiers pour forcer un encaissement.
7. Vérifier cartes et filtres
Le type 1 désigne les espèces et 0 la carte. Accepter les cartes permet d’inclure ces demandes ; cela n’autorise ni ne règle le paiement bancaire, et le format ne ventile pas les paiements mixtes. Vérifiez terminal et vendeur avec les filtres locaux ; les six champs n’apportent pas d’entreprise ou de caisse indépendante ni de catalogues de magasins ou d’opérateurs. La lecture des articles, services et totaux bancaires n’est pas validée.
8. Vérifier réponses et annulation
La confirmation tente d’écrire une réponse .OK identifiée par la référence, qui peut différer du nom du TXT d’origine. L’annulation utilise .KO et peut renommer son fichier de demande ; toute erreur de format n’est pas une annulation. La caisse doit utiliser le format d’annulation convenu avec le fournisseur. La présence du fichier ne prouve ni sa lecture ou la clôture à la source, ni un remboursement en espèces.
9. Valider le parcours complet
Avec le fournisseur, testez demande, incorporation, montant et signe, résultat dans ImaCash et le dispositif, puis réception de la réponse par la caisse. Confirmez date d’activité, devise, filtres et annulations admises, sans promettre une fenêtre universelle de deux heures ni l’absence de doublons. En cas de doute, vérifiez systèmes et espèces réelles avant de répéter, renvoyer, changer les références, resynchroniser ou redémarrer. Cette révision documentaire ne remplace pas un essai physique.