--- audiencia: usuario screen_key: configuracion/puntos-de-venta titulo: Sucursales, Cajas y Configuración POS aliases: - sucursales - establecimientos - cajas - puntos de expedicion - numeracion documentos - timbrado caja - configuracion pos - pos retail - pos admin - impresora termica - arqueo de caja - fondo fijo --- # Sucursales, Cajas y Configuración POS Cubre todo lo que está bajo **Configuración → Puntos de Venta**: el alta de **sucursales** (establecimientos), las **cajas** dentro de cada sucursal, los **puntos de expedición** que numeran los documentos, las **numeraciones por tipo de documento** y la **configuración POS** por caja (impresora, layout, seguridad, fondo fijo, arqueo). ## Dónde está esto en el menú `Configuración → Puntos de Venta → Sucursales y Cajas` `Configuración → Puntos de Venta → Configuración POS` ## Conceptos generales La jerarquía es esta y conviene tenerla clara antes de configurar nada: ``` Empresa (RUC) └─ Sucursal (establecimiento, código 3 dígitos, ej. 001) └─ Caja (descripción libre, ej. "Caja Mostrador") └─ Punto de Expedición (código 3 dígitos, ej. 001) └─ Numeración por Tipo de Documento (FCE, NCC, NDD, AUT, NRM, etc.) ``` - **Sucursal / Establecimiento**: lugar físico autorizado por la SET para emitir documentos. Cada sucursal tiene su **punto de establecimiento** (3 dígitos) que aparece en el número de factura `001-001-0000001`. - **Caja**: agrupador operativo de puntos de expedición + configuración POS + arqueos + sesiones. Una caja puede tener varios puntos de expedición. - **Punto de Expedición**: 3 dígitos. Define la segunda parte del número de documento (`001-XXX-0000001`). Cada punto de expedición tiene una numeración propia por **tipo de documento** (Factura, Nota de Crédito, etc.) atada a un **timbrado**. - **Numeración de documento**: rango `numero_inicial → numero_final` autorizado por la SET para un (punto de expedición, tipo de documento, timbrado). Se va incrementando solo. - **Configuración POS**: parámetros específicos de cada caja: tipo (retail/admin), impresora, layout, fondo fijo, arqueo, etc. Permisos relevantes: | Permiso | Para qué | |---|---| | `ADM_SUC_SUCURSAL_VER` / `ADM_SUC_SUCURSAL_CREAR` / `ADM_SUC_SUCURSAL_EDITAR` | Ver, crear y editar sucursales, cajas y puntos de expedición | | `ADM_USR_USUARIO_EDITAR` | Asignar usuarios/cajeros a sucursal o caja (botón "Asignaciones" en Usuarios) | | `INV_DEP_DEPOSITO_VER` (+ `_CREAR` / `_EDITAR`) | Ver/editar depósitos dentro de la sucursal | | `ADM_POSCFG_VER` / `ADM_POSCFG_EDITAR` | Ver y modificar Configuración POS por caja | --- ## 1. Sucursales (pantalla principal) Lista todas las sucursales de la empresa con: Establecimiento (código), Descripción, Dirección, Teléfono, Estado y Acciones (Ver / Activar–Desactivar / Editar). Botón **+ Nueva Sucursal** abre el formulario de alta. ### 1.1 Datos de la sucursal | Campo | Obligatorio | Reglas | |---|---|---| | Punto Establecimiento | Sí | 3 dígitos, único por empresa, inmutable después de creado | | Descripción | Sí | Nombre amigable (ej. "Casa Central", "Sucursal Lambaré") | | Dirección | Sí | Calle y referencias | | Número de Casa | Sí | Hasta 6 caracteres. Usar "0" si no aplica | | País | Sí | Por defecto Paraguay | | Departamento | Sí | Depende del país | | Distrito | Sí | Depende del departamento | | Ciudad | Sí | Depende del distrito | | Barrio | No | Depende de la ciudad | | Teléfono | No | 6–15 caracteres | | Email | No | Validado contra regex de email | | Complemento 1 / 2 | No | Texto libre para notas adicionales | | Estado | Auto | Activa / Inactiva (toggle) | > El **punto de establecimiento** no se puede cambiar una vez emitido un documento — ya quedó impreso en facturas reales. Si hay que reemplazarlo se da de baja y se crea otro. > **El punto de establecimiento también define qué ve un usuario restringido.** Los comprobantes fiscales (facturas, notas de crédito, remisiones) no guardan la sucursal: se atan a ella por este código. Una sucursal sin punto de establecimiento cargado no tiene forma de vincular sus comprobantes, y un usuario asignado sólo a ella abre Facturación y no ve nada. Ver `guia-alcance-por-sucursal.md`. ### 1.2 Configuración operativa de la sucursal Dentro del detalle de la sucursal hay un tab **Configuración** con las políticas que ya documentamos en `guia-compras.md` (resumen acá): - **Política de stock**: Estricto (bloquea sin stock) / Advertencia (permite con alerta y stock negativo) / Libre (sin validación). - **Reserva en órdenes de venta**: si se reserva stock al confirmar una OV. - **Maneja lotes** + **Método de costeo (FIFO)** + **Alertar lotes vencidos** + **Días alerta vencimiento** (default 30). - **Compras crédito requiere cuotas** (suma exacta) y **Requiere caja para pagos a proveedor**. - **Envío en lote al middleware** (envío diferido vs manual de XML al SIFEN). Cualquier cambio acá afecta sólo a esa sucursal. ### 1.3 Tabs adicionales en el detalle El detalle de la sucursal tiene solo tres tabs: **Cajas**, **Depósitos** y **Config.** (la configuración operativa de §1.2). No existe un tab "Usuarios" dentro del detalle de la sucursal — la asignación de usuarios a sucursal/caja se hace desde `Configuración → Usuarios y Permisos → Usuarios`, con el ícono de **Asignaciones** en la fila del usuario. - **Cajas**: lista, alta y baja de las cajas que pertenecen a esta sucursal. - **Depósitos** (si el permiso `INV_DEP_DEPOSITO_VER` está otorgado): código, descripción, tipo (físico/virtual/en tránsito), bandera **principal**. > Conviene que **toda sucursal tenga al menos un depósito**. Un usuario asignado a una sucursal sin depósitos ve el catálogo de productos pero no tiene dónde cargarles stock: los selectores de depósito en Ajustes, Compras y Transferencias le salen vacíos. --- ## 2. Cajas Cada caja vive dentro de una sucursal. Los campos son: | Campo | Obligatorio | Reglas | |---|---|---| | Descripción | Sí | "Caja Mostrador", "Caja Trastienda", "Caja 1" | | Estado | Auto | Activa / Inactiva | Una caja: - Tiene **uno o más puntos de expedición** (sección 3). - Tiene **una y sólo una `Configuración POS`** (sección 5). - Acumula **sesiones de caja** (apertura / cierre) y **arqueos** (ver `guia-apertura-cierre-caja.md`). - Se desactiva en lugar de borrarse: una caja con documentos emitidos no se elimina, se marca inactiva. ### Asignación de usuarios a la caja Esto **no** se hace desde el detalle de la sucursal (que no tiene tab de usuarios). Se hace desde **Configuración → Usuarios y Permisos → Usuarios**: en la fila de cada usuario hay un botón **"Asignaciones"** (ícono de tienda) que abre un diálogo para elegir **Sucursal** (obligatoria) y **Caja** (opcional). Requiere permiso `ADM_USR_USUARIO_EDITAR`. Eso deja al usuario como cajero responsable; si no se elige caja, ve todas las cajas de esa sucursal al abrir el POS. --- ## 3. Puntos de Expedición Cada caja contiene puntos de expedición. El **punto de expedición** es el segundo bloque del número de comprobante: `001-XXX-0000001`. | Campo | Obligatorio | Reglas | |---|---|---| | Punto Expedición | Sí | 3 dígitos (001, 002…). Único dentro de la sucursal | | Descripción | No | Nombre interno ("Mostrador 1", "Pagos Varios") | | Eslogan | No | Texto para imprimir al pie de los tickets / KuDE | | N° Inicial | No | Número de arranque sugerido por la SET (7 dígitos) | | Estado | Auto | Activo / Inactivo | Una caja puede tener varios puntos de expedición (por ejemplo, uno para facturas y otro para notas de remisión), aunque lo habitual es **uno por caja**. --- ## 4. Numeraciones de Documentos Cada **(punto de expedición + tipo de documento + timbrado)** tiene su propia numeración. Esto es lo que el SIFEN exige para no repetir números. ### Cómo llegar (ruta exacta) Las numeraciones **no** están en una pantalla o pestaña propia del menú — **no existe** "Puntos de Venta → Numeraciones de Documentos". Se administran **dentro de cada punto de expedición**, que a su vez está dentro de una caja de una sucursal. Ruta: 1. `Configuración → Puntos de Venta → Sucursales y Cajas`. 2. En la lista de sucursales, entrá a la sucursal con **Ver detalle** (ícono del ojo) o clic en la fila. 3. Dentro de la sucursal, andá a la pestaña **CAJAS**. 4. **Expandí la caja** (clic en la flecha ▾). Se muestran sus **Puntos de Expedición**. 5. En el punto de expedición, hacé clic en el botón **# NUMERACIONES**. 6. Ahí ves las numeraciones de ese punto y podés crear una nueva con **Nueva / Agregar numeración**. > Prerrequisitos: la empresa debe tener al menos una **sucursal**, una **caja**, un **punto de expedición** y un **timbrado** cargado (en `Empresa → Datos de la Empresa → Timbrado`) antes de crear la numeración. ### Alta de una numeración Al crear una numeración se completan estos campos: | Campo | Obligatorio | Detalle | |---|---|---| | Tipo de Documento | Sí | Factura (FCE) / Nota de Crédito (NCC) / Nota de Débito (NDD) / Autofactura (AUT) / Nota de Remisión (NRM) | | Timbrado | Sí | Toma el timbrado registrado en Empresa → Timbrado | | Número Inicial | Sí | Desde dónde arranca la serie (ej. 1) | | Número Actual | Auto | Próximo número a emitir; se incrementa solo. Solo editable manualmente por administrador | | Número Final | No | Tope autorizado por la SET. Cuando se alcanza la numeración **se agota** y hay que crear una nueva | | Activa | Auto | Toggle | ### Reglas duras - **Combinación única**: un solo registro de numeración activa por `(punto_expedicion, tipo_documento, timbrado)`. No se permite duplicar. - **No solapar rangos** del mismo tipo de documento — el sistema rechaza el alta. - `numero_actual ≤ numero_final` si se cargó tope. Si se alcanza el final, las próximas ventas fallan con error "Numeración agotada". - Las numeraciones **no se borran** — se desactivan, para conservar la trazabilidad fiscal. ### Tipos de documento y abreviatura | Tipo | Sigla | Uso | |---|---|---| | Factura Electrónica | FCE | Venta normal | | Nota de Crédito | NCC | Reversión total/parcial de factura | | Nota de Débito | NDD | Recargo posterior (intereses, ajustes) | | Autofactura | AUT | Compra a no inscriptos / agricultores | | Nota de Remisión | NRM | Traslado de mercadería | --- ## 5. Configuración POS `Configuración → Puntos de Venta → Configuración POS` — parámetros **por caja**. Cada caja tiene su propia configuración (impresora, layout, seguridad, etc.). Al abrir la pantalla: 1. Se elige **Sucursal** (si hay más de una). 2. Se elige **Caja**. 3. Si la empresa todavía no tiene cajas creadas aparece el aviso _"No hay cajas registradas. Cree una caja primero desde Sucursales y Cajas."_ ### 5.1 Tipo de POS | Valor | Comportamiento | |---|---| | **admin** (default) | POS dentro del layout normal del sistema, con menú lateral y todas las funciones administrativas (búsqueda avanzada, devoluciones, anulaciones, reportes). Recomendado para gerentes / administrativos que también facturan | | **retail** | Pantalla optimizada para ventas rápidas: grilla de productos, teclado numérico, sin menú lateral. Pensado para mostrador y cajeros | Si se elige **retail**, se habilitan los bloques 5.2 a 5.5 y 5.7. ### 5.2 Visualización (sólo retail) | Campo | Valores | Para qué | |---|---|---| | Pantalla completa | ON/OFF (default ON) | Si entra en modo fullscreen al abrir el POS | | Layout | Grilla / Lista / Categorías | Cómo se ven los productos en la pantalla | | Vista inicial | Productos / Categorías / Favoritos | Lo primero que ve el cajero al entrar | | Tamaño de tarjeta | Pequeño / Mediano (default) / Grande | Cuántos productos entran por fila | ### 5.3 Información del producto en la tarjeta (sólo retail) - **Mostrar imagen**: ON/OFF. - **Mostrar precio**: ON/OFF. - **Mostrar stock disponible**: ON/OFF. ### 5.4 Posición de elementos (sólo retail) - **Categorías**: Izquierda (default) / Arriba / Ocultas. - **Teclado numérico**: Derecha (default) / Abajo / Oculto. Hay una **vista previa** que se actualiza en vivo a medida que se cambian estos parámetros. ### 5.5 Moneda por defecto (sólo retail) - **Moneda por defecto**: si se deja en blanco, usa la moneda principal (PYG); si se elige otra, todo el POS retail de esa caja muestra precios y totales en esa moneda. ### 5.6 Impresora térmica (QZ Tray) Para todos los tipos de POS: | Campo | Detalle | |---|---| | Impresora | Nombre que reporta QZ Tray (ej. "EPSON TM-T20III") | | Ancho de papel | 58 mm o 80 mm | | Imprimir ticket automáticamente | ON: imprime sin diálogo / OFF: pregunta cada vez | | Print Mobile (Bluetooth) | Sólo si la empresa tiene módulo `PRINT_MOBILE` (Novasis Print). Permite imprimir desde el celular del cobrador | Botones: - **Detectar impresoras**: pide a QZ Tray la lista del sistema. Estado del cliente QZ: `disconnected / connecting / connected / error`. Si hay error muestra link a https://qz.io/download para instalar QZ Tray. - **Probar impresión**: imprime un ticket de prueba en la impresora seleccionada. > El default recomendado para QZ es **dotDensity = double**. Si el ticket sale claro o "gris", revisar la densidad en QZ. ### 5.7 Funcionalidades adicionales (sólo retail) - **Venta rápida** (default ON): entrada rápida de cantidad por teclado. - **Mesas** (default OFF): Próximamente. - **Delivery** (default OFF): Próximamente. ### 5.8 Seguridad y control de caja Aplica a todos los tipos de POS: | Campo | Default | Para qué | |---|---|---| | Requiere autorización de apertura | ON | Pide PIN de supervisor para abrir la caja del día | | Requiere autorización de cierre | ON | Pide PIN de supervisor para cerrar | | Requiere arqueo al cierre | ON | Obliga a contar el efectivo y registrarlo antes de cerrar | | Fondo fijo | vacío | Monto de referencia con el que debería abrirse la caja (ej. 500.000 PYG). Si el monto de apertura declarado no coincide, el sistema solo registra una advertencia interna (log), **no bloquea la apertura ni el cierre**. Si está vacío no se controla | | Diferencia de arqueo permitida | 0 | Tolerancia: cuánto puede sobrar o faltar sin requerir aprobación extra del supervisor | Estos parámetros gobiernan el flujo descrito en `guia-apertura-cierre-caja.md`. ### 5.9 Otros parámetros (operativos) Algunos campos existen en la configuración aunque no siempre se muestran en pantalla: - **Permitir venta sin stock**: alias a nivel caja de la política de stock de la sucursal. - **Cliente por defecto**: cliente que se carga automáticamente para ventas sin identificación. - **Depósito por defecto** de esta caja. - **Tipos de documento permitidos**: lista blanca de comprobantes que esta caja puede emitir (por ejemplo, solo facturas; nada de notas de crédito). - **Requiere timbrado vigente** (default ON): bloquea la venta si el timbrado venció. ### 5.10 Vista previa del layout Sólo en modo retail. Renderiza en tiempo real un mockup con la posición de categorías, teclado numérico, tamaño de tarjeta y campos visibles. Sirve para validar la configuración antes de guardar. --- ## Combinaciones recomendadas por tipo de negocio | Negocio | Tipo POS | Layout | Tarjeta | Stock | Arqueo | Fondo fijo | Notas | |---|---|---|---|---|---|---|---| | Kiosco / despensa | retail | grilla | medium | mostrar | sí | 100k–300k | Cajero único, ventas rápidas | | Farmacia | retail | categorías | medium | mostrar | sí | sí | Productos con vencimiento → lotes ON | | Ferretería / mayorista | admin | — | — | mostrar | sí | sí | Necesita devoluciones / NC frecuentes | | Restaurante | retail | categorías | large | ocultar | sí | sí | Esperar Mesas / Delivery | | Servicios / consultoría | admin | — | — | libre | opcional | opcional | Sin gestión de stock | | Concesionaria | admin | — | — | estricto | opcional | opcional | Chasis como producto unitario | --- ## Validaciones (texto que ve el usuario) - "El punto de establecimiento es obligatorio y debe tener 3 dígitos". - "Ya existe una sucursal con este punto de establecimiento". - "Ya existe una caja con esta descripción". - "Ya existe un punto de expedición con este código en la sucursal". - "Ya existe una numeración activa para este tipo de documento". - "El número final no puede ser menor al número actual". - "Numeración agotada. Cree una nueva numeración para este tipo de documento". - "Debe seleccionar una caja para guardar la configuración" (Config POS). - "QZ Tray no está disponible. Descárguelo desde qz.io". ## Lo que NO se puede hacer - **No se puede cambiar** el código de punto de establecimiento ni el de punto de expedición una vez emitidos documentos. - **No se puede eliminar** una sucursal con documentos emitidos. Se desactiva. - **No se puede eliminar** una caja con sesiones o arqueos. Se desactiva. - **No se pueden tener** dos numeraciones activas del mismo `(punto, tipo de documento, timbrado)`. - **No se puede solapar** rangos de numeración del mismo tipo de documento. - **No se puede operar** el POS si la caja no tiene al menos un punto de expedición con su numeración correspondiente. - **No se puede vender** si el timbrado venció y la caja tiene "Requiere timbrado vigente" activo. - **No se puede tener** más de una `Configuración POS` por caja (relación 1:1). - **No se puede cerrar** la caja sin arqueo si la opción está activa. ## Problemas frecuentes - **"El número de la próxima factura no es el que esperaba"**: revisar `numero_actual` en la numeración. Si hay que ajustarlo (por una factura del SET emitida fuera del sistema, por ejemplo), un administrador puede editarlo. El sistema controla que sea ≤ `numero_final`. - **"Numeración agotada"**: hay que crear una nueva numeración (mismo tipo de documento, mismo timbrado o el nuevo) con un rango siguiente al que se agotó. - **"La impresora no se detecta"**: 1) QZ Tray debe estar corriendo en la PC del cajero; 2) el navegador debe permitir conectarse a `localhost:8181` (HTTPS local); 3) probar **Detectar impresoras** y mirar el estado del cliente; 4) si dice `error`, reinstalar QZ. - **"El ticket sale en blanco / muy claro"**: subir `dotDensity` a `double` en QZ Tray, o subir el ancho a 80 mm si la impresora lo soporta. - **"No me deja cerrar la caja"**: el cierre puede estar bloqueado por falta de autorización de supervisor, arqueo no cargado (si es obligatorio) o diferencia mayor a la tolerancia configurada. El fondo fijo **no bloquea** el cierre — solo se compara (como advertencia interna) contra el monto de apertura. Ver `guia-apertura-cierre-caja.md`. - **"Mi cajero ve cajas que no son las suyas"**: hay que **asignarlo** a una caja específica desde **Configuración → Usuarios y Permisos → Usuarios**, botón "Asignaciones" (permiso `ADM_USR_USUARIO_EDITAR`). - **"Cambié el layout y no se aplica"**: el POS retail toma la configuración al iniciar la sesión. Cerrar y volver a abrir el POS. - **"El cliente recibió el N° de factura con punto de establecimiento incorrecto"**: la sucursal estaba mal seleccionada al facturar. La numeración la define el punto de expedición de la caja activa. ## Limitaciones actuales - **Mesas** y **Delivery** en el POS retail figuran como "Próximamente" — no están operativos en esta versión. - **No hay alta masiva** de sucursales, cajas o numeraciones: todo se carga manualmente. - **No hay copia de configuración POS** entre cajas — hay que repetir la configuración por cada caja. - **No hay alerta automática** cuando el `numero_actual` está cerca del `numero_final` (queda por revisión manual). - **No hay manejo de turnos múltiples** por caja en el mismo día (solo apertura/cierre simple). Para roles de turno se trabaja con sesiones. - **No hay control geográfico** automático contra el SET: si la dirección de la sucursal no coincide con la registrada en el SET para el timbrado, no se valida — el SIFEN puede rechazar igual. - **El "Print Mobile" (Bluetooth)** solo está disponible para empresas con módulo `PRINT_MOBILE` activo. ## Documentos relacionados - `guia-alcance-por-sucursal.md` — qué ve un usuario asignado a esta sucursal, en todas las pantallas. - `guia-usuarios-perfiles.md` — dónde se cargan las asignaciones de usuario a sucursal/caja. - `guia-empresa.md` — RUC, timbrado y certificado que usan las cajas. - `guia-apertura-cierre-caja.md` — operativa diaria de apertura, arqueo y cierre. - `guia-facturacion.md` — emisión de documentos que consumen las numeraciones. - `guia-compras.md` — políticas por sucursal (stock, lotes, FIFO). - `guia-inventario.md` — depósitos por sucursal.