Anker

CashGenic / Anker con ImaCash: configuración y operaciones seguras

Guía del conector CashGenic en la ficha Anker. Antes de instalar o cambiar la configuración, confirma con el fabricante el modelo, firmware, moneda y operaciones admitidas; esta guía no amplía las capacidades de la máquina.

Requisitos y configuración

• El fabricante debe habilitar la API HTTPS y facilitar la IP o dirección, el puerto, el usuario y la contraseña de esa instalación, con permisos para las operaciones previstas. El PC de ImaCash debe poder acceder a ese endpoint HTTPS por la red autorizada. No supongas puertos ni credenciales, no los incluyas en una URL y no desactives la seguridad para conectar.
• Con un usuario autorizado y sin operaciones pendientes, abre Configuración > Máquina, selecciona el equipo CashGenic/Anker correspondiente e introduce los datos de conexión facilitados por el fabricante. Verifica la conexión y los permisos antes de mover efectivo.
• Para pesos chilenos, selecciona CLP en Configuración > Máquina y confirma que la máquina está configurada para esa misma moneda. CLP no tiene decimales en ImaCash: 1000 CLP son 1000 pesos, no 100000 ni 10. No multipliques por 100 ni uses EUR para compensar un importe o una visualización incorrectos.

Consultar la configuración en el manual de ImaCash

Diagnóstico confirmado y criterio de corrección

Se ha confirmado un defecto en el flujo manual de ImaCash: utilizaba EUR y multiplicaba el importe por 100 aunque la moneda fuera CLP. La corrección debe alinear la moneda enviada, el importe y su presentación con la moneda activa, sin decimales para CLP.

También se ha confirmado que CashGenic respondía PayOutFailed/PayoutJammed a RefundAmount 1000, pero ImaCash devolvía SUCCESS. Ese éxito local era incorrecto: el fallo de dispensación no confirma que se haya entregado el importe solicitado.

El criterio de corrección exige aceptar únicamente el estado terminal esperado de la misma operación y verificar el importe confirmado. Una respuesta antigua, de otra operación, un error, un timeout o una entrega incompleta no permiten totalizar: la operación debe quedar pendiente para revisión y sin repetir automáticamente el movimiento.

Vigilancia de bloqueos físicos y comunicación

En /system, CashGenic solo ofrece isConnected como indicador de conexión; un valor positivo no garantiza que la máquina esté operativa ni que sus módulos estén colocados y cerrados. La vigilancia operativa debe contrastarse con /status.

/status publica errorCondition y eventos como CashboxRemoved (stacker o cashbox retirado), RCCassetteRemoved (casete reciclador retirado), NotePathOpen (ruta de billetes abierta), Full (almacén de dispensación lleno), PayoutJammed y otros fallos de atasco o desconexión comunicados por el equipo. Estos avisos describen el estado publicado por CashGenic, no un rechazo de credenciales ni necesariamente una caída de red.

En una versión de ImaCash que incorpore esta corrección, el último aviso de error confirmado se conserva y se muestra tanto en el frontal como en la ventana de pago: una consulta vacía no lo borra. Un fallo posterior de red se muestra como comunicación; no se considera resuelto el bloqueo físico previo. El estado físico se conserva internamente y vuelve a mostrarse al recuperar la comunicación mientras no se confirme la recuperación operativa.

En reposo, el aviso solo se retira cuando /status confirma un estado válido y coherente Idle con errorCondition=None (sin error) posterior al fallo, sin otro error posterior contradictorio. Puede llegar en el mismo lote si la marca temporal confirma que es estrictamente posterior al fallo; no es obligatorio esperar otra petición o sondeo. Reponer una pieza, recuperar isConnected o recibir una respuesta vacía no basta. Durante una operación monetaria, cualquier fallo del lote exige revisión aunque después incluya Idle sin error. Retirar el aviso no libera automáticamente una operación monetaria incierta: conserva su bloqueo y requiere conciliar el efectivo y el historial antes de cualquier nuevo movimiento.

No todos los fallos físicos son detectables desde ImaCash: la detección depende de que el firmware publique el evento por la API. Si la API no responde, se indica un problema de comunicación; esa ausencia de respuesta no permite inventar un stacker retirado, una puerta abierta ni otro diagnóstico físico. Confirma con el fabricante qué eventos publica el firmware instalado.

Distinguir autorización, atasco e incertidumbre

• Un rechazo explícito de autenticación o permisos requiere que el fabricante revise la cuenta y las operaciones autorizadas; poder consultar la máquina no demuestra permiso para dispensar. Un fallo de red o HTTPS no demuestra que la contraseña sea incorrecta. Si no se conoce el resultado de un movimiento anterior, conserva primero su bloqueo para revisión.
• PayOutFailed/PayoutJammed indica un fallo de dispensación o atasco comunicado por CashGenic, no un error de credenciales. El defecto de confirmación de ImaCash no demuestra la causa física del atasco ni que una actualización lo resuelva; la revisión del equipo corresponde al fabricante o mantenedor autorizado.
• Ante error, timeout o importe entregado incompleto, no repitas el cobro, abono, cambio ni otra orden de efectivo. No reinicies ImaCash o la máquina ni cambies la configuración para eludir la incertidumbre. Mantén la operación pendiente y contrasta el historial de la máquina, el efectivo real y la venta local antes de autorizar cualquier movimiento posterior.
• Conserva la hora, la operación, el importe solicitado y confirmado y el COMPLETE para un diagnóstico por el canal autorizado. No publiques credenciales, tokens ni datos del cliente.

Puesta en marcha bajo control

Con el responsable de la instalación, sin clientes y con importes pequeños previamente acordados, prueba solo las operaciones admitidas por el equipo. Contrasta cada resultado con el efectivo y el historial antes de pasar a la siguiente prueba; detén la validación si algún resultado no es concluyente.

La vigilancia requiere una prueba real autorizada y supervisada por el fabricante o mantenedor, tanto en reposo como en un cobro controlado. Las manipulaciones físicas se hacen únicamente en el estado seguro y según el procedimiento que este autorice; nunca con efectivo en movimiento. No provoques atascos, fuerces sensores ni anules protecciones. No inicies cobros con un bloqueo físico activo; si aparece un aviso durante el cobro, detén la prueba y conserva la operación para revisión.

1. Venta: verifica moneda, importe solicitado y mostrado, efectivo aceptado, cambio realmente entregado y registro local. En CLP, comprueba que todos representan pesos enteros, sin factor 100.
2. Abono: autoriza una única salida y verifica su final, importe realmente entregado y registro local. Un error o entrega parcial debe conservar la operación pendiente, nunca como cobrada ni con una segunda dispensación automática.
3. Cambio: comprueba los importes de entrada y salida, las denominaciones efectivamente entregadas y la confirmación terminal correspondiente. No des por entregado un cambio calculado solo de forma teórica.
4. Cancelación: solicítala una sola vez durante una operación que la admita y comprueba el final cancelado y la devolución real que corresponda. El clic o un acuse de solicitud no bastan para iniciar otra operación.
5. Stacker: en reposo seguro, desplaza o retira y vuelve a colocar el stacker siguiendo al fabricante. Contrasta el evento CashboxRemoved, si el firmware lo publica, con el aviso del frontal y de pago; si no se publica, registra esa limitación sin dar por validada la detección. La reposición solo permite retirar el aviso con un estado /status Idle y errorCondition=None posterior al fallo; prueba también retirada y reposición entre sondeos, con ambos eventos en el mismo lote y sus marcas temporales ordenadas.
6. Puerta o ruta de billetes: abre y cierra únicamente el acceso autorizado y en reposo seguro. Comprueba NotePathOpen u otro evento documentado para ese acceso y firmware, la conservación del aviso y su retirada solo tras la recuperación confirmada. Una puerta no monitorizada no se considera detectada por suponer que usa NotePathOpen.
7. Red y recuperación: acuerda con el fabricante una interrupción y recuperación controladas, primero en reposo y durante un cobro solo si autoriza ese escenario. Comprueba que se indica comunicación, no credenciales ni un stacker retirado inventado, y que una consulta vacía no elimina un aviso previo. Recuperar la red o volver a Idle no confirma el cobro ni libera un resultado monetario incierto; revisa efectivo, historial y venta local antes de continuar.

Esta guía no anuncia una beta publicada ni una versión o fecha de entrega. La disponibilidad de la corrección y su validación física en la instalación requieren confirmación independiente; compilar o superar pruebas automáticas no acredita ninguna de ellas.