# Sirvo POS

## Docs

- [Authentication](https://docs.laportenard.com/api-reference/authentication.md): JWT-based authentication for the POS API.
- [Orders](https://docs.laportenard.com/api-reference/orders.md): API endpoints for creating and managing orders.
- [Payments](https://docs.laportenard.com/api-reference/payments.md): API endpoints for payment processing and credit checks.
- [Tables](https://docs.laportenard.com/api-reference/tables.md): API endpoints for floor plan table management.
- [Order lifecycle](https://docs.laportenard.com/architecture/order-lifecycle.md): How orders move through states and kitchen statuses.
- [Architecture overview](https://docs.laportenard.com/architecture/overview.md): High-level architecture of the Sirvo POS system.
- [Permissions](https://docs.laportenard.com/architecture/permissions.md): How the role-based permission system works across frontend and backend.
- [Tax calculation](https://docs.laportenard.com/architecture/tax-calculation.md): Odoo-compatible POS tax calculation — data model, pure function calculator, fiscal position remapping, and order totals integration.
- [Auto-updates](https://docs.laportenard.com/guides/auto-updates.md): Self-updating system for desktop (Cloudflare Worker proxy) and Android (Odoo endpoint) clients.
- [Backend development](https://docs.laportenard.com/guides/backend-development.md): Working with the Odoo 12 backend modules and API.
- [Close session](https://docs.laportenard.com/guides/close-session.md): Session close wizard with cash denomination counting, open order warnings, and manager override.
- [Credit payments](https://docs.laportenard.com/guides/credit-payments.md): Customer credit eligibility, credit payment flow, and how credit lines are handled during order submission.
- [Customers](https://docs.laportenard.com/guides/customers.md): Customer lookup, RNC/Cédula validation via DGII, and assigning customers to orders.
- [Discounts](https://docs.laportenard.com/guides/discounts.md): Preset and manual discounts, comps, role-based access, and max discount enforcement.
- [Frontend development](https://docs.laportenard.com/guides/frontend-development.md): How to work with the Next.js frontend, state machines, and UI components.
- [Kitchen display (KDS)](https://docs.laportenard.com/guides/kitchen-display.md): Set up a dedicated kitchen display terminal that shows sent orders as tickets and lets kitchen staff bump items as done.
- [Order state machine](https://docs.laportenard.com/guides/order-state-machine.md): Order lifecycle states, kitchen status transitions, and configurable kitchen notifications.
- [Order submission](https://docs.laportenard.com/guides/order-submission.md): How orders are submitted to Odoo — the useOrderSubmission hook, posReference format, and payment mapping.
- [Payment screen](https://docs.laportenard.com/guides/payment-screen.md): Payment screen layout, payment methods, split actions, and completion flow.
- [Printing](https://docs.laportenard.com/guides/printing.md): Manual QA checklist for kitchen tickets, checks, fiscal receipts, and thermal printer configuration.
- [Sale order loading](https://docs.laportenard.com/guides/sale-orders.md): Loading existing Odoo sale orders into POS orders for fulfillment.
- [Sync hub](https://docs.laportenard.com/guides/sync-hub.md): How real-time synchronization works between POS terminals.
- [Tauri Android](https://docs.laportenard.com/guides/tauri-android.md): Building, configuring, and debugging the Tauri v2 Android app.
- [Tauri desktop](https://docs.laportenard.com/guides/tauri-desktop.md): Building and configuring the Tauri v2 desktop app wrapper.
- [Troubleshooting](https://docs.laportenard.com/guides/troubleshooting.md): Common issues and their fixes.
- [User roles](https://docs.laportenard.com/guides/user-roles.md): Three-tier role system for managers, cashiers, and waiters.
- [Introduction](https://docs.laportenard.com/introduction.md): Internal developer documentation for the Sirvo POS restaurant system.
- [Project structure](https://docs.laportenard.com/project-structure.md): How the monorepo is organized and where to find things.
- [Quickstart](https://docs.laportenard.com/quickstart.md): Get the Sirvo POS development environment running locally.
- [Architecture](https://docs.laportenard.com/sync/architecture.md): System topology, component overview, and data flow for the sync system.
- [Conflict resolution](https://docs.laportenard.com/sync/conflict-resolution.md): Version tracking, reconciliation strategies, merge logic, and conflict prevention.
- [Deployment](https://docs.laportenard.com/sync/deployment.md): Raspberry Pi setup, Docker, systemd, mDNS discovery, and monitoring.
- [Frontend integration](https://docs.laportenard.com/sync/frontend-integration.md): State machine, providers, UI components, and i18n for the sync system.
- [How it works](https://docs.laportenard.com/sync/how-it-works.md): A plain-English walkthrough of the sync protocol — what happens from login to order saved.
- [Hub server](https://docs.laportenard.com/sync/hub-server.md): Node.js hub internals: storage, handlers, forwarder, configuration, and HTTP endpoints.
- [Leasing](https://docs.laportenard.com/sync/leasing.md): Single-writer order ownership, heartbeats, expiry, and manager override.
- [Offline and outbox](https://docs.laportenard.com/sync/offline-outbox.md): Offline-first design, localStorage outbox, retry with backoff, and hub-side event log.
- [Sync overview](https://docs.laportenard.com/sync/overview.md): Real-time, offline-first synchronization for multi-terminal restaurant POS environments.
- [Protocol](https://docs.laportenard.com/sync/protocol.md): WebSocket message types, snapshot format, Zod validation, and connection lifecycle.
- [Local development quickstart](https://docs.laportenard.com/sync/quickstart-dev.md): Step-by-step guide to run the full sync stack locally with real-time multi-terminal sync.
- [Table locking](https://docs.laportenard.com/sync/table-locking.md): Exclusive table-level access control, heartbeats, manager takeover, and floor plan UI.
- [Testing](https://docs.laportenard.com/sync/testing.md): Test strategy, coverage summary, and how to run sync system tests.
- [Transport layer](https://docs.laportenard.com/sync/transport-layer.md): Frontend abstraction, direct vs hub transport, factory pattern, and offline fallback.
- [Productos 86 (sin existencia)](https://docs.laportenard.com/user-guide/86.md): Marcar productos agotados durante el turno.
- [Abrir tu turno](https://docs.laportenard.com/user-guide/abrir-turno.md): Cómo abrir la caja al inicio del día.
- [Actualizaciones](https://docs.laportenard.com/user-guide/actualizaciones.md): Mantener Sirvo POS al día.
- [Agregar productos y enviar a cocina](https://docs.laportenard.com/user-guide/agregar-productos.md): Cómo tomar una orden: buscar, agregar, modificar y enviar.
- [Aplicar anticipos al pago](https://docs.laportenard.com/user-guide/anticipos.md): Usar el saldo del cliente para cubrir la cuenta.
- [Anular ítems o cuenta](https://docs.laportenard.com/user-guide/anular-items.md): Cómo anular productos enviados o una cuenta entera.
- [Buscar un cliente](https://docs.laportenard.com/user-guide/buscar-cliente.md): Encontrar a un cliente registrado.
- [Cerrar tu turno](https://docs.laportenard.com/user-guide/cerrar-turno.md): Cuenta el efectivo, revisa el desglose y cierra la sesión al final del día.
- [Cobrar una cuenta](https://docs.laportenard.com/user-guide/cobrar.md): Procesa el pago: efectivo, tarjeta, mixto, y entrega del cambio.
- [Cobrar facturas pendientes](https://docs.laportenard.com/user-guide/cobrar-facturas.md): Pagar facturas formales emitidas previamente.
- [Conflictos de sincronización](https://docs.laportenard.com/user-guide/conflictos.md): Resolver diferencias entre terminales.
- [Crear un cliente](https://docs.laportenard.com/user-guide/crear-cliente.md): Registrar un cliente nuevo con cédula o RNC.
- [Pago con crédito](https://docs.laportenard.com/user-guide/credito.md): Cargar el consumo a la cuenta del cliente.
- [Cuentas cerradas](https://docs.laportenard.com/user-guide/cuentas-cerradas.md): Ver, reimprimir o anular cuentas pagadas.
- [Descuentos](https://docs.laportenard.com/user-guide/descuentos.md): Aplicar descuento por ítem o por cuenta.
- [Devoluciones](https://docs.laportenard.com/user-guide/devoluciones.md): Modo devolución y notas de crédito.
- [Dividir cuenta](https://docs.laportenard.com/user-guide/dividir-cuenta.md): Repartir una orden entre varios pagadores.
- [Enviar a cocina](https://docs.laportenard.com/user-guide/enviar-cocina.md): Mandar el pedido y manejar cambios después.
- [Errores comunes](https://docs.laportenard.com/user-guide/errores-comunes.md): Mensajes frecuentes y qué hacer.
- [Bitácora de eventos](https://docs.laportenard.com/user-guide/eventos.md): Registro de auditoría de la terminal.
- [Factura con NCF](https://docs.laportenard.com/user-guide/factura-ncf.md): Emitir factura formal con RNC o cédula.
- [Glosario](https://docs.laportenard.com/user-guide/glosario.md): Términos que aparecen en la app y en este manual.
- [Imprimir](https://docs.laportenard.com/user-guide/imprimir.md): Recibos, facturas y tickets de cocina.
- [Inicio de sesión](https://docs.laportenard.com/user-guide/inicio-sesion.md): Cómo entrar a Sirvo POS con PIN o tarjeta RFID.
- [Bienvenido a Sirvo POS](https://docs.laportenard.com/user-guide/introduccion.md): Manual de usuario para meseros, cajeros y gerentes.
- [Pantalla de cocina (KDS)](https://docs.laportenard.com/user-guide/kds.md): Lectura, marcar listo y filtros.
- [Mesa bloqueada](https://docs.laportenard.com/user-guide/mesa-bloqueada.md): Qué pasa cuando otra terminal tiene la mesa.
- [Modificadores y acompañantes](https://docs.laportenard.com/user-guide/modificadores.md): Cómo agregar acompañantes y variaciones.
- [Plano de mesas](https://docs.laportenard.com/user-guide/plano-mesas.md): Tu pantalla principal: cómo leer el plano y seleccionar mesas.
- [Recorrido visual](https://docs.laportenard.com/user-guide/recorrido.md): Un tour por las partes principales de la pantalla.
- [Roles en Sirvo POS](https://docs.laportenard.com/user-guide/roles.md): Qué puede hacer cada rol: mesero, cajero y gerente.
- [Saldo y crédito del cliente](https://docs.laportenard.com/user-guide/saldo-cliente.md): Ver crédito disponible y anticipos.
- [Seleccionar una mesa](https://docs.laportenard.com/user-guide/seleccionar-mesa.md): Iniciar una orden y registrar comensales.
- [Sincronización y conexión](https://docs.laportenard.com/user-guide/sincronizacion.md): Indicador del Hub y modo offline.
- [Solicitudes especiales](https://docs.laportenard.com/user-guide/solicitudes-especiales.md): Notas, alergias y requisitos del cliente.
- [Tomar un anticipo](https://docs.laportenard.com/user-guide/tomar-anticipo.md): Recibir dinero por adelantado del cliente.
- [Transferir una mesa](https://docs.laportenard.com/user-guide/transferir-mesa.md): Mover una orden de una mesa a otra.
- [Venta con despacho](https://docs.laportenard.com/user-guide/venta-con-despacho.md): Generar despacho sin facturar (gerente).

## OpenAPI Specs

- [openapi](https://docs.laportenard.com/api-reference/openapi.json)