> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laportenard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores comunes

> Mensajes frecuentes y qué hacer.

<Note>
  **Rol:** Cualquiera. Esta página es para resolver dudas rápidas sin tener que llamar a soporte.
</Note>

Los mensajes que más aparecen en Sirvo POS y qué hacer con cada uno. Si te trabaste con algo que no aparece aquí, avísale al gerente o al administrador para que lo agreguemos.

## Acceso y pantalla bloqueada

| Mensaje                                                 | Qué significa                                                                   | Qué hacer                                                                      |
| ------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **`Tarjeta no reconocida o usuario no autorizado`**     | La tarjeta RFID no está vinculada o tu usuario no tiene acceso a esta terminal. | Confirma que sea tu tarjeta. Si lo es, pídele al admin que te dé acceso.       |
| **`La tarjeta no corresponde al usuario seleccionado`** | Pasaste una tarjeta que no es la del usuario que tenías marcado.                | Selecciona el usuario correcto o pasa la tarjeta correcta.                     |
| **`PIN incorrecto`**                                    | El PIN que escribiste está mal.                                                 | Reintenta con cuidado. Si no recuerdas, pídele al admin que te lo restablezca. |

## Sesión y caja

| Mensaje                                                          | Qué significa                                           | Qué hacer                                                  |
| ---------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------- |
| **`Esta configuración POS está siendo utilizada por [nombre]`**  | Otro cajero ya abrió sesión en esta terminal.           | Espera a que cierre, o usa otra terminal.                  |
| **`Ya tienes una sesión abierta en [config] ([sesión])`**        | Tienes una caja abierta en otro terminal.               | Cierra la primera o ve a esa terminal.                     |
| **`Se requiere saldo de apertura para: [journals]`**             | No has ingresado el efectivo inicial.                   | Ingresa el monto inicial antes de abrir.                   |
| **`Hay [N] órdenes abiertas sin pagar`**                         | Estás cerrando la caja con cuentas activas.             | Cobra o transfiere las cuentas pendientes antes de cerrar. |
| **`Se requiere aprobación de un gerente para cerrar la sesión`** | Hay descuadre o política especial que exige aprobación. | Pídele a un gerente que apruebe con su PIN.                |

## Toma de orden

| Mensaje                                       | Qué significa                                              | Qué hacer                                                                              |
| --------------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| **`Sin artículos en la orden`**               | La cuenta está vacía.                                      | Toca productos del menú.                                                               |
| **`Toca productos para agregarlos`**          | Mismo: la cuenta está vacía.                               | Selecciona algo.                                                                       |
| **`No se encontraron artículos`**             | Tu búsqueda no encontró nada.                              | Cambia las palabras o usa categorías.                                                  |
| **`(Orden enviada - edición deshabilitada)`** | El ítem ya se envió a cocina y no se puede borrar directo. | Si necesitas quitarlo, [anúlalo](/user-guide/anular-items).                            |
| **`PRODUCTOS EN 86: [producto]`**             | El producto se acabó.                                      | No lo ofrezcas a los clientes. Avisa cuando vuelva. Ver [Producto 86](/user-guide/86). |

## Pagos

| Mensaje                                                              | Qué significa                           | Qué hacer                                           |
| -------------------------------------------------------------------- | --------------------------------------- | --------------------------------------------------- |
| **`Envía la orden antes de procesar el pago`**                       | Tienes items sin enviar a cocina.       | Toca `Enviar Pedido` primero.                       |
| **`El total de la orden debe ser mayor a cero`**                     | La cuenta no tiene monto.               | Agrega al menos un ítem con precio.                 |
| **`No hay métodos de pago disponibles para esta configuración POS`** | La terminal no tiene métodos asignados. | Avísale al admin.                                   |
| **`Límite de crédito excedido`**                                     | El cliente no tiene suficiente crédito. | Cobra otro método o pídele al gerente que autorice. |
| **`Error al verificar crédito`**                                     | El servidor no respondió.               | Revisa la conexión y reintenta.                     |
| **`Sin NCF disponibles`**                                            | La secuencia de comprobantes se agotó.  | Avísale al admin para que active más NCF.           |

## Mesas y bloqueo

| Mensaje                                                                | Qué significa                                          | Qué hacer                                                         |
| ---------------------------------------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------- |
| **`Mesa Bloqueada`**                                                   | Otra terminal está editando esa mesa.                  | Espera o pide que la liberen. Solo gerente puede `Tomar Control`. |
| **`Mesa tomada`** / **`Un gerente ha tomado el control de esta mesa`** | Un gerente desbloqueó forzadamente la mesa.            | Vuelve al plano. La mesa ahora la edita el gerente.               |
| **`No hay mesas activas`**                                             | El plano está vacío para tu vista.                     | Confirma que tu turno esté abierto y estés en el piso correcto.   |
| **`No hay mesa seleccionada`**                                         | Estás haciendo una acción sin haber seleccionado mesa. | Selecciona una primera.                                           |

## Anulaciones y descuentos

| Mensaje                                  | Qué significa                       | Qué hacer                                             |
| ---------------------------------------- | ----------------------------------- | ----------------------------------------------------- |
| **`Aprobación de Gerente Requerida`**    | Tu rol no permite esta acción.      | Llama a un gerente para aprobar con su PIN.           |
| **`No tiene permisos para esta acción`** | Aun con aprobación, hay un bloqueo. | Habla con el admin.                                   |
| **`Se requiere una razón de anulación`** | Faltó seleccionar un motivo.        | Toca uno de los motivos predefinidos o escribe libre. |

## Conexión y sincronización

| Mensaje                       | Qué significa                              | Qué hacer                                                                       |
| ----------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------- |
| **`Hub desconectado`** (rojo) | Pérdida de conexión al servidor.           | Sigue trabajando offline. La sincronización vuelve sola cuando recupere la red. |
| **`Sin WiFi`**                | Tu dispositivo no está en red.             | Reconecta el WiFi de tu dispositivo.                                            |
| **`Conflicto detectado`**     | Tu cambio choca con otro de otra terminal. | Ver [Conflictos](/user-guide/conflictos).                                       |
| **`Sincronizando...`**        | Está subiendo cambios pendientes.          | Espera unos segundos.                                                           |

## Impresión

| Mensaje                      | Qué significa             | Qué hacer                                                                  |
| ---------------------------- | ------------------------- | -------------------------------------------------------------------------- |
| **`Impresora desconectada`** | La impresora no responde. | Revisa cable, papel y energía.                                             |
| **`Error al imprimir`**      | Falló la impresión.       | Intenta reimprimir desde [Cuentas cerradas](/user-guide/cuentas-cerradas). |
| **`Sin papel`**              | Acabó el rollo.           | Cambia el rollo.                                                           |

## Actualizaciones

| Mensaje                                              | Qué significa                                | Qué hacer                                        |
| ---------------------------------------------------- | -------------------------------------------- | ------------------------------------------------ |
| **`Hay una actualización disponible`**               | Versión nueva lista para instalar.           | Toca `Actualizar ahora` cuando sea buen momento. |
| **`Versión desactualizada`** / **`CLIENT_OUTDATED`** | Tu versión está debajo del mínimo soportado. | Tienes que actualizar antes de seguir.           |
| **`Error al descargar la actualización`**            | La descarga falló.                           | Reintenta. Si sigue, espera mejor red.           |

## Cuándo llamar al gerente o admin

* Cualquier error fiscal (NCF, RNC, validación DGII).
* Mensajes que digan "comuníquese con soporte" o "error fatal".
* Discrepancias de caja al cerrar.
* Problemas de impresión que no se resuelven en 5 minutos.
* Bloqueos que llevan rato sin resolverse.
* Conflictos de sincronización con montos grandes.

## Relacionado

* [Sincronización](/user-guide/sincronizacion)
* [Conflictos](/user-guide/conflictos)
* [Bitácora de eventos](/user-guide/eventos) — el gerente puede investigar ahí.
