Durch die Integration durch FilesTXT kann ein POS-Verkauf an ImaCash gesendet und TXT-Dateien in einem konfigurierten Ordner generiert werden. ImaCash überwacht diesen Ordner, liest die ausstehenden Dateien und erstellt die entsprechende Transaktion im System.
Jede Datei muss eine einzelne Transaktion in der ersten Zeile enthalten. Der Dateiname kann frei sein, es wird jedoch empfohlen, die Ticketnummer zu verwenden, um die Rückverfolgbarkeit zu erleichtern. Die eigentliche Kennung des Vorgangs wird dem dritten Feld des Inhalts entnommen.
Dateibeispiel
```txt
0,10;2;12347;ALEX;2025-10-28 12:40:00;1
Dateiformat
Jede Zeile muss 6 durch Semikolons getrennte Felder enthalten ;.
Antwort von ImaCash
Wenn die Transaktion abgeschlossen ist, generiert ImaCash unter Verwendung der Ticketnummer eine Antwortdatei im selben Ordner.
- Wenn der Vorgang erfolgreich abgeschlossen wird: 12347.OK
- Wenn der Vorgang brochen ist: 12347.KO
Diese Antwortdateien enthalten keine Daten; Sein Zustand zeigt das Ergebnis der Operation an. Die Originaldatei wird intern in Unterordnern verarbeitet oder fehlerhaft abgelegt und die am POS sichtbare Antwort ist die Datei {ticket}.OK oder {ticket}.KO.
Wichtige Regeln
- Jede.txt-Datei muss einen einzelnen Vorgang enthalten.
- ImaCash liest nur die erste Zeile der Datei.
- Die Ticketnummer muss eindeutig sein.
- Wenn das Format nicht genau 6 Felder umfasst, wird die Datei als fehlerhaft behandelt.
- Wenn die Datei leer ist oder nicht interpretiert werden kann, wird sie in den Fehlerstatus verschoben.
- Wenn die Einrichtung keine Kartentransaktionen akzeptiert, muss 1 als Zahlungsmethode angegeben werden.
- Das Feldtrennzeichen sollte immer; sein.
Integrationsfluss
- Die Kasse generiert eine .txt-Datei im konfigurierten Ordner.
- ImaCash erkennt die Datei und liest die erste Zeile.
- Wenn das Format korrekt ist, wird die Transaktion mit der angegebenen Ticketnummer erstellt.
- Die Originaldatei wird in den entsprechenden internen Unterordner verschoben.
- Nach Abschluss des Vorgangs generiert ImaCash die I read Antwortdatei (.OK oder.KO) im Ordner für den POS.
