Configurar gsBase con ImaCash
gsBase es una plataforma para desarrollar aplicaciones de gestión. Esta guía describe el perfil de intercambio por archivos de ImaCash; el proveedor debe confirmar que la aplicación instalada genera y recibe ese formato. No acredita todos los ERP, versiones ni la API propia de gsBase.
1. Preparar una carpeta exclusiva
Acuerda con el proveedor una carpeta de intercambio para un solo puesto y consumidor. La cuenta Windows real de ImaCash necesita listar archivos, abrir las entradas en lectura y escritura exclusiva, eliminarlas y crear la subcarpeta RESPUESTA y sus archivos. No selecciones la raíz de un disco, documentos, copias ni carpetas de otros programas.
2. Seleccionar el perfil actual
Abre Configuración > Integración y selecciona POS > GsBase. En Ventas, elige con el icono de carpeta el directorio acordado. No se solicitan servidor, puerto, cuenta SQL, contraseña ni DSN en este perfil. Los datos privados de la instalación los facilita su administrador.
3. Acordar registros y referencias
El lector toma los .txt del nivel principal. Prepara un registro compacto por archivo, UTF-8 sin BOM y menor de 1 KiB, con cuatro campos separados por punto y coma: tienda; referencia de venta; vendedor; importe. Acepta un quinto campo, pero no lo utiliza. La referencia procede del segundo campo, no del nombre del archivo; debe ser única y válida para el nombre de su respuesta. No incluyas rutas o separadores de directorio.
4. Confirmar la unidad del importe
El cuarto campo tiene dos interpretaciones: si se reconoce como entero, se divide entre cien; en otro caso se convierte como decimal con la configuración regional de Windows. El proveedor debe comprobar unidad, separador decimal, signo, moneda e importe resultante antes de operar. No supongas que un entero representa unidades monetarias completas ni que el mismo texto decimal funciona en todos los equipos.
5. Guardar y verificar el acceso
Guarda y cierra bajo la cuenta Windows que ejecuta ImaCash, con la ruta completa y no vacía. Al iniciar, el perfil intenta preparar RESPUESTA; que aparezca conectado no acredita lectura del TPV, formato correcto ni efectivo. Verifica carpeta, permisos, importe y recepción de respuestas con el proveedor antes del uso comercial.
6. Entender lectura e identificadores
Las entradas se eliminan tras su lectura, antes de confirmar el resultado, también cuando no se obtiene una venta válida. No hay archivo de procesados ni recuperación histórica por fecha. Tienda y vendedor vienen del registro; el terminal se asigna internamente y la fecha es la de lectura, no una fecha de venta importada. No se consultan catálogos de tiendas, cajas o vendedores y los filtros no acreditan aislamiento por puesto. Mantén la trazabilidad en origen y no repongas archivos para repetir.
7. Comprobar RESPUESTA
La confirmación intenta escribir RESPUESTA con la referencia de venta y extensión .OK, con importe, entregado y cambio separados por |; contrasta el signo del cambio con el proveedor. Una transacción marcada como cancelada intenta .KO con el importe y dos ceros. Rechazar por sí solo no escribe una respuesta. La existencia de un archivo no demuestra que el TPV lo haya leído, cerrado la venta o completado una cancelación.
8. Validar el circuito y sus límites
Este perfil registra las entradas como efectivo y no ofrece selector Aceptar tarjetas, desglose bancario independiente, productos, existencias ni turnos. El quinto campo no acredita una forma de pago. Valida de forma supervisada referencias, importes y signos, respuesta en ambos programas y efectivo real. Ante resultado incierto, revísalos antes de repetir, reponer archivos, resincronizar o reiniciar. Una guía o una conexión no acreditan validación física.
Conservamos el logotipo de gsBase del catálogo; la guía explica el selector POS actual y sustituye las capturas antiguas de configuración.