> ## 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.

# Sincronización y conexión

> Indicador del Hub y modo offline.

<Note>
  **Rol:** Cualquiera ve el estado de sincronización; cualquier rol puede operar en modo offline.
</Note>

Sirvo POS funciona conectado a un servidor (el **Hub**) que mantiene todas las terminales sincronizadas: las órdenes, los pagos, los anticipos. Cuando hay conexión, todo se comparte en tiempo real entre cajeros, meseros y cocina. Cuando no, sigues operando localmente y los cambios se envían cuando vuelva.

<Frame />

## Los indicadores

En la parte de abajo de la pantalla del plano vas a ver dos indicadores:

| Indicador  | Qué significa                                                  |
| ---------- | -------------------------------------------------------------- |
| **`Hub`**  | La conexión al servidor de sincronización del local.           |
| **`WiFi`** | La conexión a la red. Si no hay WiFi, el Hub tampoco funciona. |

Cada uno tiene un color:

* **Verde** — conectado, todo OK.
* **Amarillo** — reconectando, esperando que vuelva.
* **Rojo** — desconectado. Estás en modo offline.

## Operar conectado (modo normal)

Cuando todo está verde:

* Las órdenes se guardan en tiempo real en el servidor.
* Otras terminales ven los cambios en segundos.
* Cocina recibe los pedidos al instante.
* Los pagos se registran en el sistema central.
* El estado de las mesas se actualiza para todos.

No tienes que hacer nada especial — así trabaja Sirvo POS normalmente.

## Operar offline

Cuando el `Hub` está rojo, sigues operando pero con limitaciones:

| Acción            | Funciona offline | Comentarios                                                                                                             |
| ----------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Tomar orden       | ✅                | Se guarda local.                                                                                                        |
| Enviar a cocina   | ⚠️               | El KDS no recibe hasta que vuelva conexión; los tickets impresos sí salen si la impresora está conectada vía red local. |
| Cobrar            | ✅                | Se registra local.                                                                                                      |
| Generar NCF       | ❌                | El NCF requiere conexión al servidor para reservar el número. Si estás offline, el cobro queda pendiente de NCF.        |
| Aplicar crédito   | ❌                | Necesita validar el saldo del cliente contra el servidor.                                                               |
| Aplicar anticipos | ❌                | Igual que crédito.                                                                                                      |
| Locks de mesa     | ⚠️               | Otras terminales pueden tomar tu mesa después del período de gracia.                                                    |

## Cuando vuelve la conexión

Sirvo POS sincroniza automáticamente lo que tenías pendiente:

1. **Subida** — manda al servidor las órdenes, items, pagos que registraste offline.
2. **Bajada** — actualiza tu pantalla con cambios de otras terminales (mesas que ya están ocupadas, productos en 86, etc.).
3. **Resolución de conflictos** — si dos terminales editaron lo mismo, se resuelve automáticamente o te pide que decidas (ver [Conflictos](/user-guide/conflictos)).

Mientras sincroniza, vas a ver brevemente el indicador en amarillo. En segundos vuelve al verde.

## Buenas prácticas con conexión inestable

* **Cobra rápido las cuentas críticas** mientras tienes conexión, en especial las que necesitan NCF.
* **Avisa al gerente** si el Hub se mantiene rojo más de unos minutos — puede haber un problema con el WiFi del local.
* **No fuerces sincronizaciones manuales** — Sirvo POS lo hace solo. Refrescar repetidamente puede generar duplicados.

## Si la conexión nunca vuelve

Si llevas mucho tiempo offline (varias horas), pueden quedar muchas operaciones acumuladas:

* Sigue operando — Sirvo POS aguanta cientos de operaciones offline.
* Avísale al admin del problema de red.
* Cuando vuelva la conexión, la primera sincronización puede tardar unos segundos. No te asustes si tarda.

## Errores comunes

* **`Hub desconectado` y `WiFi conectado`** — la red está bien pero el servidor del Hub no responde. Avísale al admin.
* **`Sin WiFi`** — el problema es la red del local. Reconecta el WiFi de tu dispositivo o pídele al admin que reinicie el router.
* **Sincronización tarda mucho al volver** — es normal después de horas offline. Espera unos minutos.

## Relacionado

* [Conflictos de sincronización](/user-guide/conflictos)
* [Mesa bloqueada](/user-guide/mesa-bloqueada) — comportamiento de los locks cuando hay desconexiones.
* [Errores comunes](/user-guide/errores-comunes)