Ficheros TXT
El método más simple y estable
Si buscas la forma más directa de integrar tu POS con ImaCash, el método de Fichero TXT es tu mejor opción. Sin APIs complejas, sin protocolos especiales: solo un archivo de texto plano que ImaCash lee automáticamente.¿Cómo funciona?
Tu POS genera un archivo.txt con los datos de cada venta. ImaCash monitorea la carpeta que configures y procesa las transacciones automáticamente.
Ejemplo de archivo (sale.txt):
0.10;2;12347;ALEX;2025-10-28 12:40:00;1
Formato del archivo
Cada línea representa una transacción con 6 campos separados por punto y coma (;):
| Campo | Descripción | Ejemplo | Notas importantes |
|---|---|---|---|
| 1. Importe | Monto de la venta | 0.10 |
En formato decimal |
| 2. Terminal | Número de terminal/caja | 2 |
Identifica desde qué punto de venta viene |
| 3. Número de ticket | ID único de la transacción | 12347 |
Debe ser único. Si se repite, ImaCash lo ignora |
| 4. Usuario/Cajero | Nombre del operador | ALEX |
Puede ser cualquier nombre o ID |
| 5. Fecha y hora | Timestamp de la venta | 2025-10-28 12:40:00 |
Formato: YYYY-MM-DD HH:MM:SS. Rango actual ±2 horas |
| 6. Método de pago | Tipo de transacción | 1 |
1 = Efectivo / 0 = Tarjeta |
Reglas importantes
- Número de ticket único – Si repites un número, ImaCash asume que es un duplicado y no lo procesa
- Fecha actualizada – La hora debe estar dentro de un rango de ±2 horas respecto a la hora actual
- Formato consistente – Usa siempre el mismo separador (
;) y el formato de fecha especificado Formatos de salida – Después de procesar el archivo, ImaCash devuelve un fichero de respuesta en el mismo directorio:
Una vez procesado el archivo, ImaCash renombra el fichero original en el mismo directorio para indicar el resultado:
Si la transacción fue exitosa, el archivo cambiará su extensión de
.txta.ok(Ej:sale.ok).Si hubo un error en el procesamiento (por formato, ticket duplicado, etc.), cambiará a
.ko(Ej:sale.ko).
Configuración en ImaCash
- Ve a INTEGRACIÓN en el menú de ImaCash
- Selecciona FicherosTXT como método de integración
- Configura la carpeta donde tu POS generará los archivos
.txt - ImaCash comenzará a monitorear esa ruta automáticamente
Ventajas de este método
- Cero dependencias – No necesitas librerías ni SDKs
- Multiplataforma – Funciona en cualquier sistema operativo
- Fácil de debuggear – Los archivos son legibles y puedes verificarlos manualmente
- Ultra estable – Sin conexiones de red, sin timeouts, sin complicaciones