L'intégration par FilesTXT permet à un point de vente d'envoyer des ventes à ImaCash en générant des fichiers.txt dans un dossier configuré. ImaCash surveille ce dossier, lit les fichiers en attente et crée la transaction correspondante dans le système.
Chaque fichier doit contenir une seule transaction sur la première ligne. Le nom du fichier peut être libre, même s'il est recommandé d'utiliser le numéro du ticket pour faciliter la traçabilité. L'identifiant réel de l'opération est extrait du troisième champ du contenu.
Exemple de fichier
```txt
0.10;2;12347;ALEX;2025-10-28 12:40:00;1
Format du fichier
Chaque ligne doit avoir 6 champs séparés par des points-virgules ;.
Réponse de ImaCash
Une fois la transaction terminée, ImaCash génère un fichier de réponses dans le même dossier en utilisant le numéro de ticket.
- Si l'opération se termine avec succès : 12347.OK
- Si l'opération est annulée : 12347.KO
Ces fichiers de réponses ne contiennent pas de données ; Sa présence indique le résultat de l'opération. Le fichier original est archivé en interne dans des sous-dossiers comme traité ou erreur, et la réponse visible par le POS est le fichier {ticket}.OK ou {ticket}.KO.
Règles importantes
- Chaque fichier.txt doit contenir une seule opération.
- ImaCash lit uniquement la première ligne du fichier.
- Le numéro du billet doit être unique.
- Si le format ne comporte pas exactement 6 champs, le fichier est traité comme erroné.
- Si le fichier est vide ou ne peut pas être interprété, il est déplacé vers l'erreur.
- Si l'établissement n'accepte pas les transactions par carte, 1 doit être soumis comme mode de paiement.
- Le séparateur de champ doit toujours être ;.
Flux d'intégration
- Le POS génère un fichier .txt dans le dossier configuré.
- ImaCash détecte le fichier et lit la première ligne.
- Si le format est correct, il crée la transaction avec le numéro de ticket indiqué.
- Le fichier d'origine est déplacé vers le sous-dossier interne correspondant.
- A la fin de l'opération, ImaCash génère le fichier de réponse vide (.OK ou .KO) dans le dossier du POS.
