Guía paso a paso — Configuración y uso de funcionalidades

Complemento práctico del Manual de usuario.
Enfocado en cómo hacer tareas concretas en el sistema: sucursales, cajas, usuarios, facturas, POS, ARCA, etc.

Requisito general: usuario con rol Administrador, salvo que se indique lo contrario.

Tabla de contenidos

1. Configuración inicial (onboarding)
2. Crear una sucursal
3. Crear una caja
4. Asignar usuarios a sucursales
5. Crear un cajero (usuario local)
6. Enlazar operador a una caja
7. Abrir caja y turno en el POS
8. Cerrar caja y cierre Z
9. Configurar datos fiscales del negocio
10. Configurar ARCA por sucursal
11. Medios de pago
12. Pasarelas Mercado Pago (QR y Point)
13. Preferencias del POS
14. Panel movimientos del día (distribuidoras)
15. Código de acceso del negocio
16. Invitar un usuario por email
17. Dar de alta un producto
18. Dar de alta un cliente con cuenta corriente
19. Importar lista de precios del proveedor
20. Primera venta en el POS
21. Orden recomendado para un negocio nuevo

1. Configuración inicial (onboarding)

Ruta: /onboarding (se abre automáticamente la primera vez, solo admin)

El asistente tiene 4 pasos:

Pasos:

1. Completá nombre, razón social, CUIT y condición IVA → Guardar y continuar.
2. Código de sucursal (ej. CEN, SUC1) y nombre (ej. Casa central) → Crear sucursal.
3. Número de caja 1, nombre Caja principal → Crear caja.
4. Finalizar o ir directo al POS.

Podés Saltear paso si ya configuraste algo manualmente en Configuración.

2. Crear una sucursal

Ruta: /configuracion → sección Sucursales

Solo administradores pueden crear, editar o eliminar sucursales. No se puede borrar la sucursal principal.

Alta de sucursal nueva

1. Ir a Configuración (/configuracion).
2. Bajar hasta Sucursales.
3. En el formulario de alta:
   • Código: corto, único, sin espacios (ej. NORTE, DEP2). Se usa internamente y en reportes.
   • Nombre: nombre comercial visible (ej. Sucursal Norte).
   • Dirección: opcional.
   • Perfil de ticket: normalmente Copiar datos del negocio (hereda razón social y CUIT del negocio en los tickets).
4. Clic en Crear sucursal.

Editar sucursal existente

1. En la lista de sucursales, clic en Editar en la fila deseada.
2. Modificar código, nombre, dirección o datos de ticket (si no hereda del negocio).
3. Guardar cambios.

Datos de ticket por sucursal

Si una sucursal factura con otra razón social o CUIT (poco común):

1. Al editar, desactivar Heredar datos del negocio en ticket.
2. Completar razón social, CUIT, teléfono, horarios y email propios de esa sucursal.

Después de crear la sucursal

• Aparece en el selector de sucursal del encabezado.
• Los usuarios deben tenerla asignada para operar en ella (ver §4).
• Creá al menos una caja en esa sucursal antes de usar el POS allí (ver §3).

3. Crear una caja

Ruta: /facturacion/cierre-caja → sección Cajas del negocio

Solo administradores ven la sección de gestión de cajas. Los operadores solo usan las cajas a las que están enlazados.

¿Qué es una caja?

Una caja es un punto de venta lógico dentro de una sucursal:

• Tiene número (entero ≥ 1, único por sucursal) y nombre (ej. Mostrador 1, Caja 2).
• Agrupa turnos (apertura → ventas → cierre).
• Se vincula a Mercado Pago QR/Point si usás pasarelas (cada integración apunta a una caja).
• Puede tener un operador por defecto al abrir turno.

Alta de caja

1. Ir a Facturación → Cierre de caja (/facturacion/cierre-caja).
2. En Cajas del negocio, formulario de alta:
   • Sucursal: elegir la sucursal (si hay más de una).
   • Número: ej. 1, 2, 3.
   • Nombre: ej. Caja principal, Mostrador.
   • Operador por defecto: opcional; usuario que se preselecciona al abrir turno.
3. Clic en Crear caja.

Editar o desactivar caja

En la tabla de cajas:

Si una caja ya tuvo movimientos, no la borres: desactivala. Así conservás el historial de cierres y comprobantes.

Auto-cierre de turno

En cada caja podés configurar auto-cierre en horas (ej. 12 h): el sistema cierra el turno automáticamente en el POS si quedó abierto.

4. Asignar usuarios a sucursales

Ruta: /configuracion/usuarios

Cada usuario solo puede operar en las sucursales que tenga asignadas.

Usuario invitado por email

1. Configuración → Usuarios.
2. En la fila del usuario, menú ⋮ → Asignar sucursales.
3. Marcar una o más sucursales (mínimo 1).
4. Guardar.

La primera sucursal marcada suele quedar como sucursal por defecto al iniciar sesión.

Al crear usuario local (cajero)

Al dar de alta el cajero, seleccioná las sucursales antes de guardar (ver §5).

Si el usuario ve "sin permisos en esa sucursal"

1. Verificar asignación en Usuarios.
2. Que el usuario cambie sucursal en el encabezado a una asignada.
3. Si el problema continúa: cerrar sesión y volver a entrar.

5. Crear un cajero (usuario local)

Ruta: /configuracion/usuarios

Los cajeros no usan email: entran con código de negocio + usuario + PIN.

Pasos

1. Configuración → Usuarios.
2. Sección Usuario local para caja.
3. Completar:
   • Usuario: corto, sin espacios (ej. caja1, maria).
   • PIN: 4 dígitos.
   • Rol: normalmente Operador o queda como cajero.
4. Marcar al menos una sucursal en la lista inferior.
5. Crear usuario local.

Enlazar a caja

Sin caja enlazada, el cajero no puede abrir turno en el POS. Ver §6.

Login del cajero

1. /login → pestaña Acceso local.
2. Código de negocio (ver §15) + usuario + PIN.
3. El POS abre en la sucursal asignada (si tiene una sola).

6. Enlazar operador a una caja

Un operador o cajero necesita estar vinculado a una caja para usar el POS.

Opción A — Operador por defecto al crear la caja

Al crear la caja (§3), elegir el usuario en Operador por defecto.

Opción B — Editar caja existente

1. /facturacion/cierre-caja → tabla de cajas.
2. Editar la caja.
3. Asignar Operador por defecto o lista de operadores permitidos (según UI de edición).
4. Guardar.

Cómo saber si falta enlace

En Configuración → Usuarios, los operadores sin caja muestran aviso Sin caja enlazada.

7. Abrir caja y turno en el POS

Ruta: /facturacion/pos

Secuencia típica al iniciar el día

1. Entrar al POS (admin, operador o cajero con caja asignada).
2. Si no hay turno abierto, aparece Abrir caja o Abrir caja y turno.
3. Elegir caja (si hay varias en la sucursal).
4. Indicar fondo de efectivo inicial (arqueo de apertura).
5. Confirmar → el turno queda abierto y podés vender.

Dos conceptos

En la práctica el modal Abrir caja y turno hace ambos en un paso.

Requisitos previos

• Sucursal activa correcta en el encabezado (admin).
• Caja creada en esa sucursal.
• Usuario con permiso y caja enlazada.
• Módulo facturador_pos activo en el plan.

8. Cerrar caja y cierre Z

Rutas: /facturacion/pos (cierre rápido) o /facturacion/cierre-caja

Cierre desde el POS

1. En el POS, botón Cerrar caja / menú de cierre.
2. Contar efectivo en caja.
3. Ingresar monto contado → el sistema muestra diferencia vs esperado.
4. Confirmar cierre → genera resumen del turno.

Cierre desde Facturación → Cierre de caja

1. Elegir sucursal y caja registrada.
2. Ver historial de aperturas/cierres del día.
3. Cierre Z — reporte resumen del período (según configuración fiscal).

Gastos de caja

Durante el turno podés registrar gastos (salidas de efectivo) desde el panel de cierre antes de cerrar.

9. Configurar datos fiscales del negocio

Ruta: /configuracion → Datos del negocio

1. Clic en Editar.
2. Completar campos.
3. Guardar.

10. Configurar ARCA por sucursal

Ruta: /configuracion/arca

Requiere módulo facturador_arca.

Pasos

1. Ir a Configuración → ARCA (o /configuracion/arca).
2. Elegir sucursal en el selector (cada sucursal puede tener certificado propio).
3. Completar:
   • CUIT emisor
   • Punto de venta AFIP de esa sucursal
   • Ambiente: homologación (pruebas) o producción
4. Subir certificado .pem y clave privada (generados con AFIP / WSASS).
5. Guardar.

Probar

1. Emitir factura B/C de prueba en homologación desde el POS.
2. Si falla → Facturación → Resolver ARCA (/facturacion/resolver-arca) → leer error → reintentar.

11. Medios de pago

Ruta: /configuracion/medios-de-pago

1. Activar los medios que uses: efectivo, tarjeta, transferencia, cuenta corriente, etc.
2. Guardar.

Los medios activos aparecen en el modal de cobro del POS y en facturación manual.

12. Pasarelas Mercado Pago (QR y Point)

Ruta: /configuracion/pasarelas

Requiere módulo facturador_pos.

Mercado Pago QR

1. En Pasarelas, sección QR.
2. Elegir sucursal y caja a vincular.
3. Pegar Access Token de Mercado Pago (producción o test).
4. Guardar → al cobrar en POS con MP QR, se genera el código en pantalla.

Mercado Pago Point (terminal)

1. Sección Point.
2. Vincular caja + device de Point.
3. Configurar token y datos del dispositivo según el asistente en pantalla.

Cobros pendientes

Si un pago QR quedó colgado, en Pasarelas hay panel de cobros pendientes para sincronizar o cancelar.

13. Preferencias del POS

Ruta: /configuracion → pestaña Preferencias POS

Podés configurar a nivel Negocio (todas las sucursales) o Por sucursal (override).

Por sucursal: elegir sucursal en el selector → modificar solo lo que difiere → Guardar. Si no hay cambios respecto al negocio, el sistema avisa que no guardó override.

Impresora térmica (QZ Tray)

Para que el ticket salga solo al cobrar, sin el popup Allow de Windows:

→ Guía completa: Impresora térmica con QZ Tray (0 a 100)

Resumen: instalar QZ Tray → Descargar override.crt en Preferencias POS → copiar a C:\Program Files\QZ Tray\ → reiniciar QZ → activar impresión automática.

14. Panel movimientos del día (distribuidoras)

Para comercios que venden en cuenta corriente y liquidan precios al cierre del día (distribuidoras).

Ruta: /configuracion → Operación, catálogo y proveedores

1. Pestaña Por sucursal o Negocio según quieras aplicar.
2. Activar Panel movimientos del día en cuenta corriente.
3. Opcional: Permitir liquidación de ítems del día (editar precios de lo vendido hoy en CC).
4. Guardar.

Luego en Clientes → [cliente] aparece el panel con ventas CC del día en curso.

Si ves error 403 "panel no habilitado", la preferencia está apagada o solo está a nivel del negocio y no en la sucursal activa — activar en el nivel correcto.

15. Código de acceso del negocio

Ruta: /configuracion → Datos del negocio → Código de acceso

• Código corto que los cajeros usan en login local (junto con usuario + PIN).
• El admin puede verlo y regenerarlo.
• Compartilo solo con personal de caja.

16. Invitar un usuario por email

Ruta: /configuracion/usuarios

1. Sección Invitar usuario.
2. Email, nombre, rol (admin / operador / visor).
3. Enviar invitación → el usuario recibe email con enlace.
4. Completar registro en /invitacion/completar.
5. Asignar sucursales (§4) y, si es operador de POS, enlazar caja (§6).

17. Dar de alta un producto

Ruta: /productos/nuevo

1. Código y nombre.
2. Categoría.
3. Precio costo y margen % (calcula precio venta) o precio venta directo.
4. IVA.
5. Código de barras (opcional; podés generar EAN interno).
6. Stock inicial en sucursal activa.
7. Guardar.

Alternativa masiva: importar Excel del proveedor (§19).

18. Dar de alta un cliente con cuenta corriente

Ruta: /cuenta-corriente → botón nuevo cliente (o desde ficha)

1. Nombre / razón social.
2. CUIT o DNI según corresponda.
3. Condición IVA (para facturación).
4. Condiciones de cuenta: límite de crédito, días de pago.
5. Guardar.

El cliente ya puede seleccionarse en el POS con medio de pago Cuenta corriente.

19. Importar lista de precios del proveedor

Ruta: /importar

1. Elegir proveedor (crealo antes en /proveedores si no existe).
2. Subir archivo Excel/CSV.
3. Mapear columnas (código, descripción, precio, etc.).
4. Vista previa — revisar filas, elegir si actualizar costos/stock.
5. Confirmar → ver resumen en /importar/resumen.

20. Primera venta en el POS

Checklist:

• Productos con stock y precio
• Caja creada y turno abierto (§7)
• Medios de pago activos (§11)

Pasos:

1. /facturacion/pos
2. Buscar producto (teclado o escáner).
3. Ajustar cantidades.
4. Cobrar → elegir medio de pago.
5. Si es factura con ARCA: cliente con datos fiscales correctos.
6. Imprimir o enviar comprobante.

21. Orden recomendado para un negocio nuevo

Secuencia sugerida para dejar el sistema operativo:

Capturas adicionales para esta guía

Guardar en docs/manual/capturas/.

Guías por perfil

• Distribuidoras — CC y cobranza
• Cajeros — POS rápido

Volver al Manual de usuario completo.