La integración por FicherosTXT permite que un POS envíe ventas a ImaCash generando archivos .txt en una carpeta configurada. ImaCash monitoriza esa carpeta, lee los archivos pendientes y crea la transacción correspondiente dentro del sistema.
Cada archivo debe contener una única transacción en la primera línea. El nombre del archivo puede ser libre, aunque se recomienda usar el número de ticket para facilitar la trazabilidad. El identificador real de la operación se toma del tercer campo del contenido.
Ejemplo de archivo
```txt
0.10;2;12347;ALEX;2025-10-28 12:40:00;1
Formato del archivo
Cada línea debe tener 6 campos separados por punto y coma ;.
Respuesta de ImaCash
Cuando la transacción finaliza, ImaCash genera un archivo de respuesta en la misma carpeta usar el número de ticket.
- Si la operación se completa correctamente: 12347.OK
- Si la operación se cancela: 12347.KO
Estos archivos de respuesta no contienen datos; su presencia indica el resultado de la operación. El archivo original se archiva internamente en subcarpetas como processed o error, y la respuesta visible para el POS es el fichero {ticket}.OK o {ticket}.KO.
Reglas importantes
- Cada archivo .txt debe contener una sola operación.
- ImaCash solo lee la primera línea del archivo.
- El número de ticket debe ser único.
- Si el formato no tiene exactamente 6 campos, el archivo se trata como erróneo.
- Si el archivo está vacío o no se puede interpretar, se mueve a error.
- Si la instalación no acepta transacciones de tarjeta, se debe enviar 1 como método de pago.
- El separador de campos siempre debe ser ;.
Flujo de integración
- El POS genera un archivo .txt en la carpeta configurada.
- ImaCash detecta el archivo y lee la primera línea.
- Si el formato es correcto, crea la transacción con el número de ticket indicado.
- El archivo original se mueve a la subcarpeta interna correspondiente.
- Al terminar la operación, ImaCash genera el archivo de respuesta vacío (.OK o .KO) en la carpeta para el POS.
