Beta técnica: Conector ODBC de solo lectura disponible para una primera validación controlada con una instalación real de Open POS NG. No debe habilitarse con cobros reales hasta completar la matriz de prueba.
Requisitos previos
ImaCash debe ejecutarse en Windows y alcanzar el servidor local de Open POS NG. Cree un DSN de sistema ODBC de 32 bits con el controlador de base de datos que utilice esa instalación y una cuenta limitada a lectura con permiso SELECT sobre una tabla o vista transaccional preparada por Avalon o el mantenedor del POS.
Configuración en ImaCash
- Abra Configuración > Integración y seleccione Open POS NG (Avalon) - Beta.
- En Nombre ODBC indique el nombre exacto del DSN de sistema x86. Complete usuario y contraseña solo si el DSN no los administra.
- En Tabla o vista de ventas indique el origen exacto autorizado, con una fila por operación o por forma de pago; nunca una tabla de artículos que repita el total del ticket. Puede usar esquema.tabla cuando sea necesario. ImaCash no explora ni selecciona otros orígenes.
Mapeo explícito y autoritativo
Defina siempre el mapeo de columnas con pares separados por punto y coma; ImaCash lo usa como contrato autoritativo y no intenta adivinar columnas. Debe incluir dateonly=true|false: true indica que date es una columna DATE sin hora y permite usar time con dateonly=true; false indica que date ya contiene fecha y hora. Por ejemplo: id=ID;date=FECHA;dateonly=true;time=HORA;cash=IMPORTE_EFECTIVO;operator=OPERARIO;terminal=CAJA. El contrato cash acepta una única cantidad coherente por ID y falla cerrado si ese ID se repite con valores distintos. Para líneas de pago use amount=IMPORTE_PAGO;payment=FORMA_PAGO;cashvalue=EFECTIVO|CASH. Si los identificadores necesitan delimitadores, añada quote=none|double|bracket|backtick; none es el valor predeterminado.
Contrato de finalización obligatorio
Configure una de estas dos opciones: una vista que contenga exclusivamente ventas finales junto con finalonly=true; o status=ESTADO;closedvalue=CERRADA|PAGADA;modified=MODIFICADA para filtrar los estados cerrados y recuperar cierres tardíos. En el contrato amount+payment con status+modified, modified identifica el cambio de la venta: ImaCash obtiene primero los IDs modificados y después recupera todas sus líneas antes de sumar el efectivo, evitando capturar parcialmente un pago mixto. Sin uno de estos contratos la integración falla de forma cerrada.
Alcance de esta beta
La integración consulta operaciones recientes y entrega a ImaCash únicamente el efectivo, incluida solo la parte efectiva de los pagos mixtos y los abonos con signo negativo. Es estrictamente de solo lectura: nunca modifica Open POS NG ni escribe confirmaciones, estados, cobros o cancelaciones en el sistema de Avalon.