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;1Formato 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 .txt a .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