L'integrazione tramite FilesTXT consente a un POS di inviare vendite a ImaCash generando file.txt in una cartella configurata. ImaCash monitora quella cartella, legge i file in sospeso e crea la transazione corrispondente all'interno del sistema.
Ogni file deve contenere una singola transazione sulla prima riga. Il nome del file può essere libero, anche se si consiglia di utilizzare il numero del ticket per facilitarne la tracciabilità. L'identificatore effettivo dell'operazione viene preso dal terzo campo del contenuto.
Esempio di file
```txt
0.10;2;12347;ALEX;28-10-2025 12:40:00;1
Formato del file
Ogni riga deve avere 6 campi separati da punto e virgola ;.
Risposta da ImaCash
Una volta completata la transazione, ImaCash genera un file di risposta nella stessa cartella utilizzando il numero del ticket.
- Se l'operazione viene completata correttamente: 12347.OK
- Se l'operazione viene annullata: 12347.KO
Questi file di risposta non contengono dati; La sua presenza indica il risultato dell'operazione. Il file originale viene archiviato internamente in sottocartelle come elaborato o errore e la risposta visibile al POS è il file {ticket}.OK o {ticket}.KO.
Regole importanti
- Ciascun file.txt deve contenere una singola operazione.
- ImaCash legge solo la prima riga del file.
- Il numero del biglietto deve essere univoco.
- Se il formato non ha esattamente 6 campi, il file viene considerato errato.
- Se il file è vuoto o non può essere interpretato, viene spostato in errore.
- Se la struttura non accetta transazioni con carta, è necessario inviare 1 come metodo di pagamento.
- Il separatore di campo dovrebbe essere sempre;.
Flusso di integrazione
- Il POS genera un file .txt nella cartella configurata.
- ImaCash rileva il file e legge la prima riga.
- Se il formato è corretto crea la transazione con il numero del ticket indicato.
- Il file originale viene spostato nella sottocartella interna corrispondente.
- Al termine dell'operazione, ImaCash genera il file di risposta vuoto (.OK o .KO) nella cartella del POS.
