Configurar FicherosTXT con ImaCash
FicherosTXT recibe solicitudes de un POS mediante archivos de texto. El proveedor debe preparar el formato y recoger los resultados antes del uso comercial. No es el perfil Ficheros Alcornoque, FicherosRCSCash ni un perfil de pruebas; tampoco acredita compatibilidad con cualquier máquina o sistema operativo.
1. Preparar el intercambio
Reserva una carpeta exclusiva para este POS e instalación. El usuario Windows de ImaCash necesita leer, crear, mover y borrar archivos y crear subcarpetas. No elijas la raíz del disco, documentos personales ni copias de seguridad. Comprueba el acceso a cualquier recurso compartido con ese mismo usuario; no presupongas varios lectores simultáneos.
2. Seleccionar FicherosTXT
Abre Configuración > Integración, elige la categoría ImaCash y selecciona FicherosTXT. Configura la máquina de efectivo por separado. El nombre del método no convierte otros conectores de archivos en equivalentes ni exige cambiar a un perfil oculto o de pruebas.
3. Indicar la carpeta
En Ventas, selecciona el directorio de intercambio confirmado por el proveedor; no un archivo individual. Las capturas antiguas pueden mostrar Transacciones y un botón Guardar anterior. No se solicitan servidor SQL, base de datos, puerto ni credenciales propias del conector. Mantén privados la ruta y los datos de acceso al recurso compartido.
4. Preparar el TXT
Cada archivo contiene una solicitud: se lee únicamente la primera línea, con exactamente seis campos separados por punto y coma. No añadas cabeceras ni confíes en líneas adicionales. El POS debe terminar el archivo antes de hacerlo visible como TXT; acuerda con el proveedor la codificación y el formato bajo la configuración regional de Windows de ImaCash.
| Campo | Contenido que debe confirmar el proveedor |
|---|---|
| Importe | Importe solicitado y signo; sin separador de miles. Valida el separador decimal bajo la configuración regional real de ImaCash. Un importe negativo no acredita que el abono esté autorizado. |
| Terminal | Identificador de puesto del POS, conservado como dato de la solicitud; no es el modelo de máquina. |
| Referencia | Identificador único y válido de la operación, apto para nombrar la respuesta y sin separadores de ruta. No lo reutilices ni lo cambies para repetir un pago incierto. |
| Vendedor | Identificador o etiqueta del operario que envía el POS; debe coincidir con los filtros, sin suponer un catálogo de usuarios. |
| Fecha y hora | Fecha y hora interpretables por ImaCash en su configuración regional. Confirma el formato y la fecha de negocio con el proveedor. |
| Tipo de pago | 1 para efectivo o 0 para tarjeta, conforme al formato acordado. No envíes otros valores ni interpretes el campo como autorización bancaria. |
5. Guardar al cerrar
Cierra Configuración y confirma el guardado cuando se solicite; sigue el reinicio propuesto si corresponde. El inicio comprueba acceso básico al directorio y escritura, pero un indicador conectado no acredita el formato, el movimiento de archivos, un cobro ni la recepción de la respuesta por el POS.
6. Distinguir captura y pago
Los TXT disponibles se leen sin reconstruir un histórico a partir de la fecha de sincronización. Los archivos pueden pasar a processed al incorporarse o revisarse localmente; eso no significa cobrado. Los archivos vacíos o con formato incorrecto pueden pasar a error, sin que cada fallo genere una respuesta .KO. No borres, edites ni reinyectes archivos de esas carpetas para forzar un cobro.
7. Revisar tarjetas y filtros
El tipo 1 identifica efectivo y el 0 tarjeta. Aceptar tarjetas permite incluir solicitudes de tarjeta; no autoriza ni liquida el pago bancario y el formato no desglosa pagos mixtos. Contrasta terminal y vendedor con los filtros locales; los seis campos no aportan una empresa o caja independientes ni catálogos de tiendas y operarios. No se acredita lectura de artículos, turnos o total bancario.
8. Comprobar respuestas y cancelación
La confirmación intenta escribir una respuesta .OK identificada por la referencia, que puede diferir del nombre del TXT original. Una cancelación utiliza .KO y puede renombrar su archivo de solicitud; no toda incidencia de formato equivale a cancelación. El POS debe usar el formato de cancelación acordado con el proveedor. La presencia del archivo no prueba su lectura o cierre en origen ni una devolución física.
9. Validar el recorrido completo
Prueba con el proveedor la solicitud, su incorporación, el importe y signo, el resultado en ImaCash y la máquina y la recepción de la respuesta en el POS. Confirma fecha de negocio, moneda, filtros y cancelaciones admitidas, sin prometer una ventana universal de dos horas ni duplicados imposibles. Ante incertidumbre, revisa sistemas y efectivo real antes de repetir, reenviar, cambiar referencias, resincronizar o reiniciar. Esta revisión documental no sustituye una prueba física.