Ir al contenido
FMX EPOS
Descargar
Inicio del centro de ayuda

Solución de problemas de base de datos y continuidad

En el modo Remote (remoto), los datos del negocio se guardan de forma permanente en la base de datos remota. Mientras no está disponible, FMX EPOS puede poner en cola las escrituras de facturación admitidas y las envía en orden cuando la base de datos vuelve a responder. Estas comprobaciones son para un encargado o un administrador; los cajeros deben dejar la caja como está y avisar a uno.

Una caja que ya tiene la sesión iniciada muestra el aviso Database offline («Sales are kept on this till.») mientras la base de datos no está disponible y, después, Syncing … local writes hasta que su trabajo guardado ha llegado a la base de datos. Además, puede que una acción se rechace con un mensaje sobre la base de datos o que una página muestre Database Connection Unavailable («EPOS cannot reach the database right now. Check the network connection, then try again.»), y la página de inicio de sesión también lo indica.

  1. Anote el mensaje exacto y la hora.
  2. Compruebe si están afectados todos los terminales. Si solo lo está uno, revise la red y los ajustes de base de datos de ese terminal.
  3. Si el Back Office ya está abierto en un terminal, revise las tarjetas Database y Continuity en Back Office → Diagnostics. Un nuevo inicio de sesión en el Back Office no funciona hasta que la base de datos responda.
  4. Use solo las acciones sin conexión que ofrece FMX EPOS. Si una acción indica que necesita la base de datos remota, deténgase en lugar de adivinar.
  5. No cierre la sesión en las demás cajas ni las reinicie. Mientras la base de datos no está disponible, la página de inicio de sesión muestra «The database is unavailable or emergency bills are waiting to sync. Only the emergency terminal can sign in offline.» Un PIN introducido en cualquier otra caja se rechaza con «Cannot connect to the database. Check the connection and sign in again.»
  6. No cambie el modo de almacenamiento ni cree otra base de datos para que desaparezca el mensaje. Para averiguar qué falla y qué corresponde hacer, use Recover Connection.
  7. Si la base de datos está en este PC y la instaló FMX EPOS, Recover Connection lo indica. Si no, arregle el servidor de base de datos o la conexión de red. Para FMX EPOS, una contraseña de la base de datos cambiada, o una base de datos que se ha renombrado o eliminado, también parece una caída, así que compruebe también eso.
  8. Deje el terminal en marcha mientras se envían las escrituras en cola.
  9. En cada terminal que haya trabajado sin conexión, vigile Pending Writes en la tarjeta Database de Diagnostics. La tarjeta Terminals, al final de Diagnostics, y la de la página Database muestran en una sola lista las escrituras pendientes de todos los terminales.

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

Mientras la base de datos no está disponible, una acción que la necesita se rechaza con un mensaje que lo indica, por ejemplo «Coupons cannot be checked while the database is offline. Record the payment without a coupon or wait for the connection.» Las comandas y las etiquetas de un pedido en cola esperan a que se vuelva a conectar la base de datos, y el número de pedido completo muestra Pending Sync hasta que el pedido llega a la base de datos.

Cuando vuelve la base de datos, algunas acciones siguen esperando hasta que las escrituras en cola de este terminal hayan llegado a ella. La mayoría de los mensajes nombran la acción y terminan con «Waiting for N queued writes to reach the database.», por ejemplo «Coupons cannot be checked. Waiting for 3 queued writes to reach the database.» Esto se aplica a los cupones, los puntos y las ventajas de socio en cualquier venta, a la impresión de comandas y etiquetas de un pedido en cola, al reembolso de un pedido cuyo guardado o pago sigue en cola y al reembolso de una cuota de membresía. Un reembolso de pedido indica «Waiting for queued writes to reach the database. No refund has been started.», y un reembolso de cuota de membresía indica solo «Waiting for 3 queued writes to reach the database.»

Los informes X y Z necesitan la base de datos remota. Un informe Z también se rechaza mientras este terminal tenga escrituras en cola o retenidas, el periodo tenga un resultado de tarjeta desconocido o un reembolso con tarjeta sin registrar, u otro terminal en línea tenga escrituras sin confirmar; el mensaje indica el terminal. Si otro terminal está sin conexión, la caja muestra Run Z Report? con «… is offline. Its unsent data will not be in this Z. Continue?» Seleccione Run Z Report solo si lo acepta.

Escrituras pendientes y escrituras que requieren revisión

Sección titulada «Escrituras pendientes y escrituras que requieren revisión»
  • Pending Writes, en la tarjeta Database de Diagnostics, cuenta todas las escrituras que este terminal sigue guardando, incluidas las retenidas para revisión. Las que no están retenidas desaparecen solas en cuanto la base de datos responde.
  • Review Writes cuenta las escrituras retenidas.

Las escrituras retenidas aparecen en Local Writes Needing Review dentro de Payment Review. Una escritura queda retenida cuando la base de datos la rechaza por un motivo distinto de una conexión perdida, como un error de datos o dos cajas que cambian el mismo registro a la vez; las escrituras relacionadas que esperan detrás también quedan retenidas («Waiting for an earlier update to be reviewed.»). Una escritura marcada Review se reintenta sola tras esperas de 1, 5 y 15 minutos después de sus intentos fallidos, mientras la base de datos esté accesible y ninguna escritura retenida anterior la bloquee; las escrituras que esperan a una actualización anterior continúan cuando esa actualización se resuelve. Algunos errores requieren la intervención del personal o del soporte. Compruebe el motivo mostrado antes de usar Reconcile. Los demás pedidos siguen sincronizándose. La lista solo aparece en el terminal que guarda esas escrituras.

Para tratar una escritura que requiere revisión:

  1. En el terminal que la guarda, abra Back Office → Orders → Payment Review. Cash & Card → Payment Review en la caja muestra las mismas escrituras con los mismos botones.
  2. Lea la columna Reason. La columna Operation identifica el guardado, el pago o el reembolso de un pedido por el pedido, por ejemplo Order Payment · #12 · £12.50 · Card, y las demás escrituras por su tipo. Despliegue Recorded Details para ver el registro guardado. Si no sabe a qué pedido, cliente o pago corresponde, envíe una captura de pantalla al soporte.
  3. Compruebe en FMX EPOS cómo debería quedar el registro definitivo.
  4. Corrija la causa y seleccione Retry Database Write. Reintentar nunca envía otra solicitud a Clover. Si la escritura sigue en la lista, no se ha escrito: vuelva a leer Reason.
  5. Use Reconcile solo como último recurso (consulte la advertencia de abajo).

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

Cuando una caja no puede conectar con su base de datos, Recover Connection averigua por qué y ofrece lo que corresponde. Solo está en la aplicación de escritorio, mientras la base de datos no responde y el terminal no está en pausa por mantenimiento. Selecciónelo en la página de inicio de sesión de la caja o en la página Database Connection Unavailable, en cada caja que no pueda conectarse.

What Is Wrong indica dónde está la base de datos y qué ha encontrado FMX EPOS. What To Do enumera las opciones, con la solución probable primero, marcada como Recommended. Return to Sign In no cambia nada.

La página indica Opciones
El servicio MySQL de este PC se ha detenido Start MySQL, Reinstall MySQL, Use Another Database
MySQL en este PC está en marcha, pero no deja entrar a la caja Reinstall MySQL, Enter New Connection Details, Use Another Database
MySQL en este PC se ha eliminado, o solo queda una parte Reinstall MySQL, Use Another Database
Sus bases de datos han desaparecido Use Another Database
La base de datos está en otro equipo y no responde Enter New Connection Details, Use Another Database

Windows pide permiso; después el servicio se inicia y la caja vuelve a la página de inicio de sesión.

FMX EPOS descarga MySQL 8.4 (unos 270 MB, así que este PC necesita conexión a internet) y lo vuelve a poner sobre las bases de datos de este PC. Antes, Windows pide permiso. Las ventas, la carta y los ajustes quedan como estaban.

Use esta opción cuando el servidor de base de datos funciona pero se ha trasladado, o han cambiado sus datos de acceso. Necesita el nombre de usuario y la contraseña de un administrador activo del Back Office del establecimiento.

  1. Seleccione Enter New Connection Details y después Continue. Se abre la página New Connection Details.

  2. Introduzca Database Server IP Address y Port. Si han cambiado el usuario o la contraseña de la base de datos, introduzca los nuevos en Database Login y Database Password; deje Database Login en blanco para conservar el usuario de esta caja. Después introduzca, en Administrator Username y Password, el nombre de usuario y la contraseña de un administrador del Back Office. Son los datos de inicio de sesión del Back Office, no el usuario de la base de datos.

  3. Seleccione Check Database.

  4. FMX EPOS indica a qué establecimiento pertenece la base de datos y pregunta «Connect this till to it? Its waiting sales and emergency bills then go there.» Seleccione Connect This Till o Cancel.

  5. La caja vuelve a la página de inicio de sesión. Después, sus escrituras en cola se envían a la base de datos en la dirección nueva.

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

Si la caja no está registrada en la base de datos de esa dirección, la comprobación se rechaza con «This till is not registered on the database at that address, so it may be another shop’s. Check the address.» Si la base de datos se retiró por una migración, traslade en su lugar el terminal a la base de datos nueva desde Administrator Recovery.

Esta opción abandona la base de datos del establecimiento, así que úsela solo cuando esa base de datos haya desaparecido o quiera empezar de nuevo. Seleccione Use Another Database, Continue y después Leave This Database. Los datos se quedan en esa base de datos, y la configuración inicial puede volver a conectar la caja a ella. Después se abre la configuración inicial, donde puede elegir una base de datos MySQL nueva en este PC, Local SQLite, otro servidor de base de datos o la base de datos de otra caja. Back vuelve aquí hasta que se elija otra base de datos.

Esta opción no está disponible mientras esta caja guarde ventas o cuentas de emergencia registradas durante la caída. Pertenecen a esa base de datos, así que hágalas llegar primero allí.

Durante una caída de la base de datos remota, solo el Emergency Terminal (terminal de emergencia) puede seguir llevando cuentas de mesa del restaurante. Un administrador lo elige de antemano en Database → Terminals; consulte Elegir el terminal de emergencia. Si no hay ninguno elegido, Diagnostics muestra un aviso. Ese terminal debe haber estado en línea después de elegirlo, para que tenga guardada una copia de la configuración del restaurante. Los demás terminales pueden seguir con las acciones de caja que funcionan sin conexión, pero no con cuentas de mesa: muestran «The database is offline. Only the emergency terminal with a saved configuration can do this until it is back.»

Mientras el terminal de emergencia lleva estas cuentas, está en modo de emergencia. Su panel del pedido muestra EMERGENCY · NEW BILLS ONLY y el plano de mesas indica «Emergency Mode: only new bills opened on this terminal are shown. Existing remote bills and table occupancy cannot be checked.», es decir, solo se ven las cuentas nuevas abiertas en este terminal y no se pueden comprobar las cuentas remotas ni la ocupación de las mesas. En modo de emergencia no se pueden hacer arqueos ni informes X y Z. Los cupones y las ventajas de socio no se pueden comprobar mientras la base de datos está sin conexión.

Las cuentas y los pedidos tomados en modo de emergencia imprimen sus comandas de cocina, pero no aparecen en la pantalla de cocina, ni durante la caída ni después de subirlos. La cocina trabaja con las comandas en papel.

Un pedido programado que se toma en el terminal de emergencia durante la caída pasa a cocina según la regla Kitchen Release del establecimiento. El Integration Host todavía no puede ver el pedido, así que lo libera el propio terminal de emergencia. Un pedido configurado como Manual espera a que el personal lo envíe desde Orders → Kitchen Release en el terminal de emergencia. Un pedido ya liberado no se vuelve a enviar a cocina después de la subida.

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

Cuando vuelve la base de datos, primero se envían las escrituras en cola normales y después se suben las cuentas de emergencia. La tarjeta Continuity de Diagnostics muestra Emergency Mode hasta que termina la subida, y cualquier problema aparece junto a Attention:

  • «Finish or review the current payment and printing operation before synchronising emergency bills.» o «Record or reverse the approved card payment before synchronising emergency bills.»: termine primero ese pago o esa impresión en el terminal de emergencia. Después la subida empieza sola.
  • “Emergency bills are not uploaded until this terminal’s unfinished card requests are checked: …”: FMX EPOS no pudo terminar la comprobación automática de las solicitudes de tarjeta de la ejecución anterior; el motivo aparece después del mensaje. Lo vuelve a intentar en la próxima sincronización, así que deje el terminal en marcha. Si se repite el mismo motivo, contacte con soporte. Un resultado de tarjeta marcado unknown no impide la carga. Revise esa transacción después en Payment Review. No repita un pago ni un reembolso hasta saber si se movió dinero.
  • «Emergency bills could not be uploaded and need review: …» seguido del motivo: no se subió nada. El terminal vuelve a aceptar cuentas de emergencia hasta que se corrija el problema y una subida tenga éxito. Si el motivo indica que una mesa de emergencia está ocupada o en limpieza en remoto, esa misma mesa de la base de datos del restaurante todavía tiene una cuenta abierta, está pagada y pendiente de liberar, o se está limpiando. Las mesas que se usaron y se liberaron antes no cuentan. Libere esa mesa en otra caja, o pase la cuenta de emergencia a una mesa libre en el Emergency Terminal; ninguna de las dos cuentas se ha sobrescrito.
  • «Waiting to confirm the remote upload. Do not repeat payment or printing.»: la conexión se cortó durante la subida. Las cuentas quedan bloqueadas hasta que FMX EPOS pueda comprobar si la subida llegó, lo que ocurre solo en cuanto la base de datos responde.
  • «Emergency bills were uploaded but could not be cleared from this terminal: …»: la subida llegó. FMX EPOS borra las cuentas de este terminal en la siguiente sincronización.

No actualice FMX EPOS en el terminal de emergencia mientras tenga cuentas de emergencia, porque las cuentas registradas con una versión deben subirse con esa misma versión. No borre los datos locales de la aplicación ni cambie de base de datos para forzar el desbloqueo de las cuentas. Si el mensaje no desaparece, envíelo al soporte.

Un terminal está en la página de mantenimiento

Sección titulada «Un terminal está en la página de mantenimiento»

Data Migration, Import Data, Export Data y la copia programada Automatic Backup de la página Database ponen en pausa todos los terminales. Un terminal en pausa muestra Terminal Paused: «This terminal is paused for database maintenance. Do not repeat payments or printing. …» con un botón Administrator Recovery. Una pantalla del cliente abierta muestra la pausa sin ese botón. Un terminal que aún tenga escrituras en cola o cuentas de emergencia sigue vendiendo mientras las envía y después se pone en pausa. Durante una exportación o una copia de seguridad automática no hay nada que hacer: el mensaje lo indica, y el terminal continúa por sí solo.

Una exportación o una copia de seguridad automática libera los terminales al terminar. Si el terminal que la inició se apaga durante ella, por ejemplo por un corte de luz, los libera cuando vuelve a arrancar. Después de una importación o una migración correctas, solo sigue el terminal que la hizo; todos los demás terminales siguen en pausa:

  • Después de una importación, reanude cada uno de los demás terminales con Resume This Terminal.
  • Después de una migración, traslade cada uno de los demás terminales a la base de datos nueva con Move to Another Database. La base de datos antigua queda marcada como retirada, así que ningún terminal puede reanudarse en ella.

Si la operación falló antes de cambiar ningún dato, FMX EPOS normalmente levanta la pausa por sí mismo. Si la base de datos nueva no confirmó el cambio, el mensaje indica que «may or may not hold the new data» (puede tener o no los datos nuevos) y todos los terminales siguen en pausa. Compruebe primero la base de datos de destino y después reanude el terminal que inició la operación, y los demás terminales se reanudarán solos. Si una exportación o una copia de seguridad automática terminó mientras no se podía acceder a la base de datos, el terminal que la hizo levanta la pausa en cuanto la base de datos vuelve a responder.

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

  1. En el terminal que inició la operación, lea el mensaje final de la migración o la importación.
  2. Mientras el resultado sea desconocido, no vuelva a iniciar la misma operación destructiva.
  3. En el terminal en pausa, seleccione Administrator Recovery.
  4. Para seguir con la misma base de datos, introduzca el usuario y la contraseña de un administrador en Resume This Terminal y seleccione Check & Resume This Terminal.
  5. Para que este terminal use la base de datos nueva, rellene Move to Another Database en la aplicación de escritorio con el nuevo Database Type, Server, Database, Database Username y Database Password, más un Administrator Username y un Administrator Password, y seleccione Move This Terminal. Una base de datos sin cuentas de usuario inicia en su lugar la configuración inicial.
  6. Trate los terminales de uno en uno.

Si la reanudación se rechaza con «An export or automatic backup started on … has not ended. Resume that terminal first; …», la exportación o la copia automática de ese terminal sigue abierta. Vuelva a arrancar ese terminal (para una copia automática, el Integration Host): él mismo termina la operación y los demás terminales se reanudan. Si no va a volver, marque End an export or automatic backup another terminal started and will not finish en Resume This Terminal y seleccione de nuevo Check & Resume This Terminal; esa operación no cambió ningún dato. Si la reanudación se rechaza con «The configured database is still under maintenance or has been retired. Configure the destination database before resuming this terminal.», la importación o la migración de otro terminal no ha terminado, o la base de datos se migró: reanude primero el terminal que inició la operación y use Move to Another Database solo después de una migración.

El terminal que inicia el mantenimiento debe enviar primero sus propias escrituras en cola y cuentas de emergencia; si no, indica «Synchronise this terminal’s emergency bills and local writes before maintenance.» Después espera hasta 30 segundos a que todos los demás terminales registrados se pongan en pausa. Si alguno no lo hace, el mensaje empieza por «Maintenance did not start. Every registered terminal must confirm that it has stopped and has nothing left to synchronise.» y enumera cada terminal con su motivo, por ejemplo «Local writes must be synchronised first», «Emergency bills must be synchronised first», «Finish the active operation» o «terminal has not confirmed maintenance». Un terminal apagado suele mostrar «Waiting for maintenance request».

Después resuelva lo que indique el rechazo:

  • Otro terminal en línea ejecuta una versión de FMX EPOS con una estructura de base de datos distinta («… Update both to the same version before maintenance.»). Actualícelo primero.
  • Un terminal no se puso en pausa, está apagado, o aún tiene escrituras sin confirmar o cuentas de emergencia.
  • «Finish or review these on all terminals before database maintenance: …»: hay una operación con tarjeta en curso, un resultado de tarjeta desconocido, o un trabajo de impresión imprimiéndose o con resultado desconocido. El mensaje nombra el terminal en el que se imprime un trabajo.

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

Use Diagnostics, Payment Review y la cola de impresión en el terminal indicado, y revise la tarjeta Terminals de la página Database. No elimine un terminal solo para saltarse un rechazo si puede volver y sincronizarse.

La copia Automatic Backup programada no espera a los terminales que aparecen como Offline en la tarjeta Terminals, así que una caja apagada por la noche no la detiene. Todas las demás operaciones de mantenimiento esperan a todos los terminales registrados.

Cada instalación de FMX EPOS tiene su propia identidad de terminal. Si se copia una carpeta de instalación a otro PC, los dos PC llevan la misma identidad. Cuando FMX EPOS detecta que su identidad ya está en marcha en otro equipo, no inicia la caja. En su lugar muestra Terminal Identity In Use con «This terminal’s identity is also running on …» y el nombre del otro PC. No puede saber cuál de los dos PC es la copia.

Ilustración, no captura de pantalla. La pantalla real puede variar según el tema o la versión.

  1. Localice el PC que aparece en el mensaje y averigüe cuál es la copia.
  2. Si este PC sustituye al otro, apague primero el otro PC, espere unos minutos y vuelva a iniciar FMX EPOS aquí.
  3. Si este PC es la copia y ambos deben seguir funcionando, seleccione Create a New Terminal Identity en la ventana de caja de este PC. El botón solo aparece en la ventana de caja. La pantalla del cliente, la pantalla de cocina y el puesto de recepción ofrecen Try Again en su lugar.
  4. La aplicación de escritorio muestra «Restarting EPOS…» y vuelve a iniciarse como un terminal nuevo, en la página de inicio de sesión.
  5. Vuelva a elegir las impresoras de este terminal en Local Settings → Printers y revise su nombre de terminal, su licencia y las impresoras de las estaciones de cocina.

No cree nunca una identidad nueva en la caja original: sus impresoras, rutas y resultados de tarjeta pendientes pertenecen a su identidad actual.

FMX EPOS solo se ejecuta una vez por PC. Si otro usuario de Windows del mismo PC ya lo tiene abierto, al iniciarlo aparece «FMX EPOS is already running for another Windows user on this PC.» Ciérrelo primero en la sesión de ese usuario.

Siempre que pueda, vuelva a conectar el terminal y deje que se sincronice primero, porque al eliminarlo no se pueden comprobar sus escrituras locales no enviadas.

  1. Abra Back Office → Database en un terminal que funcione (administrador).
  2. En la tarjeta Terminals, busque el terminal. Remove solo se ofrece para otro terminal que aparezca como Offline.
  3. Lea Remove Terminal? y seleccione Remove Terminal.

La eliminación borra los registros de impresoras y las rutas de estación del terminal, y borra las elecciones del Integration Host y del Emergency Terminal si apuntaban a ese terminal. Los trabajos de impresión que aún esperan a sus impresoras fallan con «The terminal was removed. Choose another printer and retry.» Después, vuelva a elegir el Integration Host, las impresoras de las estaciones de cocina y, si era ese terminal, el Emergency Terminal.

Para cambios de almacenamiento planificados, siga Gestionar el almacenamiento de la base de datos y el mantenimiento.