ficherosTXT

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 (;):

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

1. Ve a INTEGRACIÓN en el menú de ImaCash
2. Selecciona FicherosTXT como método de integración
3. Configura la carpeta donde tu POS generará los archivos .txt
4. 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