Configuración de VGaleno
Esta integración tiene un coste adicional sobre la licencia estándar de ImaCash. Confirma las condiciones con Imagina antes de la puesta en marcha.
1. Datos que debe facilitar VGaleno
VGaleno debe instalar el controlador Informix de 32 bits compatible y sus prerrequisitos, preparar el DSN de sistema y la autenticación, confirmar los datos privados de conexión, la estructura, los permisos de lectura y confirmación, y el ID de cajón de ese puesto. El pack ayuda a preparar Windows; no sustituye la instalación ni la validación del proveedor.
2. Elegir entre un ODBC existente y uno nuevo
ImaCash necesita IBM INFORMIX ODBC DRIVER de 32 bits, aunque Windows sea de 64 bits. El pack utiliza Windows PowerShell 5.1 de 32 bits. Si VGaleno ya ha preparado un DSN operativo, compruébalo directamente; no lo reconstruyas por defecto.
Descarga ImaCash VGaleno 1.0.1 (x86) desde Dependencias de Admin o Distribuidores. El ZIP completo incluye el asistente PowerShell, IBM Informix Client SDK 4.10.TC16W4 y Visual C++ 2013 x86. Confirma con VGaleno la compatibilidad del equipo y del servidor.
Abrir Dependencias de ImaCloud (requiere acceso)
Si el ODBC ya está preparado
Coordina el cierre normal de ImaCash sin operaciones en curso. Extrae el ZIP completo y ejecuta directamente COMPROBAR.cmd con el usuario y permisos reales de ImaCash, indicando el DSN de sistema x86 existente. No necesitas ejecutar INICIAR.cmd ni recrear el DSN. Si la comprobación es correcta, continúa con el cajón confirmado y los campos de ImaCash. Si falta la conexión, sigue con VGaleno el recorrido de preparación siguiente.
Si falta el DSN: preparación con VGaleno
INICIAR.cmd: extrae todo el ZIP en una carpeta local, no lo ejecutes desde el comprimido. Cierra ImaCash normalmente, sin operaciones en curso, y abre este archivo. Windows solicitará permiso de administrador para preparar el equipo.- Si faltan Visual C++ 2013 x86 o el controlador Informix x86, el asistente abre sus instaladores oficiales incluidos. Completa sus ventanas y condiciones; no es una instalación silenciosa. Si solicitan reiniciar Windows, reinicia y vuelve a abrir INICIAR.cmd.
- Solo para preparar un DSN nuevo: introduce los datos privados confirmados por VGaleno, incluidos el nombre del DSN, servidor, puerto TCP, instancia Informix, base de datos e ID de cajón. El kit 1.0.1 exige un puerto numérico incluso si indicas un alias de servicio; no lo descubre desde ese alias. hosts, services, ClientLocale y DatabaseLocale son opciones del proveedor. El asistente no detecta el cajón ni cambia ImaCash.
- Al crear un DSN nuevo se abre el formulario oficial del driver para completar la autenticación. El asistente no pide ni guarda contraseñas en PowerShell, JSON o informes. Si reutiliza un DSN existente que ya coincide, no vuelve a abrir ese formulario automáticamente; revisa su autenticación con VGaleno si es necesario.
Introduce en la configuración local los datos privados de la cuenta autorizada por VGaleno. Necesita lectura y los permisos de escritura para confirmar operaciones que requiera la integración; una cuenta de solo lectura no basta. No concedas administración general.
Antes de modificar hosts o services guarda copias verificadas. No sobrescribe un DSN incompatible ni alias que apunten a otro destino: ante un conflicto, detente y revísalo con el proveedor. No modifica el firewall, el antivirus ni la seguridad del servidor. TLS u otro protocolo requieren un perfil compatible confirmado por VGaleno.
3. Comprobar con el usuario real de ImaCash
COMPROBAR.cmd: cierra la ventana elevada de configuración y ejecuta este archivo con el mismo usuario y permisos de Windows que ImaCash. No solicita elevación: si ImaCash no se ejecuta como administrador, tampoco eleves esta prueba. Introduce el nombre del DSN. La comprobación dura como máximo 30 segundos, abre el DSN sin añadir usuario ni contraseña y consulta solo la estructura de lectura, sin recuperar ventas ni nombres ni escribir datos comerciales.
ImaCash abre el DSN sin añadir usuario ni contraseña a la conexión. Un técnico debe comprobar una apertura y cierre con la misma cuenta de Windows que ejecutará ImaCash, sin introducir datos en una ventana interactiva. La prueba aislada del controlador no acredita por sí sola esa autenticación.
Un resultado correcto solo acredita conexión y estructura de lectura; no valida la caja ni los permisos de escritura para confirmar operaciones. No uses un cobro real como prueba de conexión. La recepción de ventas y sus confirmaciones necesitan una prueba supervisada acordada con VGaleno, con la misma caja, cuenta y versión de servidor.
4. Completar los campos de ImaCash
- El asistente no cambia la configuración de ImaCash. Abre Configuración > Integración y selecciona la categoría POS y VGaleno. Pharmacy / Farmacia corresponde a documentación antigua.
- En Nombre de la BBDD introduce exactamente General > Data Source Name del DSN de 32 bits comprobado. No introduzcas User Id, Database Name ni Service del driver: son campos distintos.
- En ID Cajón introduce el cajón de intercambio confirmado por VGaleno para ese puesto. No tiene por qué coincidir con la terminal ni identifica la máquina de efectivo. Para varios cajones autorizados, utiliza sus ID numéricos separados por comas y sin espacios. COMPROBAR.cmd no averigua este dato: no supongas un número ni generes cobros para descubrirlo.
- Antes de guardar y habilitar la integración, acuerda la puesta en marcha con VGaleno: el inicio operativo puede encontrar operaciones pendientes. No cambies otros parámetros sin confirmación del proveedor.
Referencia técnica: configuración manual
Esta referencia identifica archivos y campos para revisarlos con VGaleno. Conserva la conexión que ya funciona; no repitas cambios realizados por el proveedor o el asistente.
Archivos hosts y services
Haz una copia de estos archivos antes de editarlos como administrador, sin añadir una extensión .txt. Solo necesitas entradas nuevas si los alias que ha indicado VGaleno no están ya resueltos por la instalación.
C:\Windows\System32\drivers\etc\hosts: Relaciona la IP real del servidor con su nombre de equipo o alias. No confundas este nombre con la instancia Informix.C:\Windows\System32\drivers\etc\services: Relaciona el nombre del servicio con el puerto TCP que indique VGaleno. No cambies un servicio ya utilizado ni supongas que el puerto es siempre 2004.
Estas dos líneas son plantillas, no valores para copiar. La primera corresponde a hosts y la segunda a services; sustituye cada marcador por el dato confirmado por el proveedor.
[IP_VGALENO] [HOST_VGALENO]
[SERVICE_VGALENO] [PORT_VGALENO]/tcpOrigen de datos ODBC (DSN)
En Windows de 64 bits abre el Administrador de orígenes de datos ODBC de 32 bits. Crea un DSN de sistema con IBM INFORMIX ODBC DRIVER, accesible para la cuenta de Windows que ejecuta ImaCash.
C:\Windows\SysWOW64\odbcad32.exe
En Windows de 32 bits, el administrador ODBC está en: C:\Windows\System32\odbcad32.exe
- General > Data Source Name: el nombre del DSN que introducirás después en ImaCash. No tiene por qué coincidir con el nombre de la base de datos.
- Connection: completa Server Name (instancia Informix), Host Name (equipo o IP), Service (servicio o puerto confirmado), Protocol (onsoctcp cuando corresponda) y Database Name (base activa), con los datos de VGaleno.
onsoctcp significa TCP. Si Service contiene un alias, Windows debe resolverlo mediante su entrada en services. VGaleno debe confirmar el puerto de esa instalación; no hay un puerto universal. Un DSN ya operativo se comprueba por su nombre, sin rehacerlo para introducir un puerto numérico.