Configuración del Negocio y Organización

¿Para qué sirve?

Edita la información fiscal de tu establecimiento, gestiona tus sucursales físicas, configura las estaciones de preparación (cocina/barra) y asigna los roles operativos con alcances (scopes) a tu equipo.

Antes de empezar

• Se requieren permisos de Dueño (owner) o Administrador.

Secciones Disponibles

1. General: Nombre comercial, moneda, zona horaria y feature flags.
2. Salón y cocina:
   • Sucursales: Creación y edición de sucursales físicas asociadas a la organización. Al registrar tu negocio se crea automáticamente la Sucursal Principal; aquí puedes renombrarla o dar de alta sucursales adicionales.
   • Mesas: Configuración del mapa de mesas por zona y sucursal.
   • Estaciones de preparación: Alta de estaciones (Barra, Cocina Caliente, Parrilla) vinculadas a sus respectivas sucursales.
3. Equipo:
   • Miembros del equipo: Invitación de usuarios y rol de administración (owner, admin, member).
   • Roles de piso y alcances (Scopes): Asignación de rol operativo (mesero, cocina, caja), sucursal asignada y estación de producción autorizada.
4. Neuronas (IA): Saldo y consumo de inteligencia artificial de la organización. 1 neurona = 1 millón de tokens, medidos en dos categorías independientes: Generación (chat del asistente y reportes de operaciones) y Embeddings (categoría legado: la memoria semántica de agentes fue retirada; ya no registra consumo nuevo). Desde aquí puedes:
   • Ver el consumo acumulado contra la cuota de cada categoría, con barra de progreso y porcentaje restante.
   • Editar la cuota de neuronas de cada categoría (enteros ≥ 0) y guardarla.
   • Abrir Ver detalles para consultar el historial de eventos de consumo (fecha, tipo, origen, modelo y tokens), filtrable por tipo.
   • Al agotarse el saldo de generación, el asistente se bloquea (aviso “Te quedaste sin neuronas de IA”) y los reportes de operaciones se omiten hasta recargar. Las reposiciones de inventario y las propuestas de precios NO consumen neuronas: son cálculos deterministas del sistema.
5. Facturación electrónica SUNAT: Selecciona primero la sucursal que vas a configurar. Cada ubicación conserva su propio RUC, dirección fiscal, credenciales SOL, certificado digital y series de comprobantes.
   • Usa el interruptor Activar facturación electrónica de la sucursal. Mientras esté desactivada, el formulario de datos SUNAT y la emisión de comprobantes permanecen bloqueados. En un entorno de producción, la activación valida automáticamente las credenciales y el certificado contra SUNAT BETA; si la homologación falla, la sucursal no se activa.
   • El certificado .pfx o .p12 puede arrastrarse al área de archivo; la clave SOL y el certificado se guardan cifrados. Si el certificado fue emitido para otro RUC, se rechaza al guardar.
   • Para activar SUNAT, la configuración general debe usar moneda PEN, IGV de 18 % y zona horaria America/Lima. El certificado se rechaza si está vencido y la pantalla avisa si vence en menos de 30 días.
   • Al final del formulario, guarda los cambios y usa Validar en SUNAT BETA para firmar y enviar un comprobante de prueba al servicio de homologación de SUNAT. La boleta de prueba no se registra como comprobante real, no tiene validez tributaria y no reemplaza una emisión en producción.
   • Si un dato no es válido al guardar, uunit9 indica el campo y muestra la razón del error; el cursor se mueve directamente al campo que debes corregir.
   • Configura el modo de emisión y las Series de comprobantes en sus secciones separadas. Las series no pueden repetirse entre sucursales de la misma organización. Las series de boletas y sus notas de crédito deben iniciar con B; las de facturas y sus notas deben iniciar con F.
6. Integraciones: Muestra un catálogo en grid de integraciones disponibles. Cada tarjeta indica el estado (Activa, Desactivada, Pendiente o No configurada) y la tarjeta activa se resalta visualmente. Al presionar Configurar o activar el interruptor de SMTP, se despliega un drawer inferior con el formulario correspondiente:
   • Correo saliente (SMTP): Configura el servidor de correo personalizado para la organización (tickets, invitaciones y comprobantes). El formulario incluye un botón Probar conexión para verificar la alcanzabilidad del servidor SMTP antes de guardar. Una integración solo queda Activa al guardar una configuración válida. El botón Quitar configuración restablece el envío al servidor de correo global de la aplicación.
   • Telegram: Genera un código de vinculación de 8 caracteres alfanuméricos (con caducidad de 15 minutos) y un enlace directo para vincular cuentas o bots de Telegram. Permite además configurar o eliminar el PIN de operador de 4 dígitos (hasheado y con bloqueo automático tras 5 intentos fallidos) para autorizar acciones de aprobación desde Telegram.

Feature flags del flujo POS

En Avanzado → Feature flags, los dueños y administradores pueden elegir el flujo operativo de las comandas:

• Cobro directo en mostrador: habilita Cobrar para una comanda abierta, sin pre-cuenta obligatoria. El pago envía los ítems pendientes y cierra la comanda.
• Módulo de cocina (KDS y entregas): habilita las estaciones de preparación, Por entregar y la pantalla pública de turnos. Al apagarlo, el POS oculta esas pantallas, no existen estados de cocina y los ítems pasan directamente a servidos al cobrar o pedir la cuenta, descontando el stock en ese momento, sin crear comandas de cocina.

Los cambios se aplican a toda la organización. Restablece cada flag para volver al flujo completo predeterminado.

Emitir y consultar comprobantes

En Facturación, caja y gerencia pueden filtrar y consultar boletas, facturas y notas de crédito. La pestaña Comprobantes ofrece una barra de herramientas con búsqueda (serie, cliente o número de documento), el botón Filtros para marcar varios tipos y estados a la vez (por ejemplo Aceptado y Error) y un Rango de fechas con calendario y accesos rápidos (Hoy, Ayer, 7 días, 30 días, Este mes, Todo); los tres se reflejan en la URL, así que puedes compartir o recargar la vista sin perder el filtro. Cambia la sucursal desde Operando en en la cabecera: todas las tablas de comprobantes, pendientes y configuración se recargan para esa ubicación. En modo manual, la pestaña Por emitir permite seleccionar una orden cerrada (con búsqueda local por número de ticket o tipo), elegir boleta o factura e ingresar los datos del cliente. Las facturas requieren un RUC de 11 dígitos.

Boletas, facturas y notas de crédito se envían a SUNAT individualmente al emitirse y quedan Aceptadas (u Observadas) de inmediato. Si el envío falla por una causa transitoria (SUNAT no disponible, corte de comunicación), el comprobante queda en Error y se reintenta automáticamente; también puedes reintentarlo desde el menú de la fila.

Las acciones de cada comprobante se abren desde el menú de tres puntos de su fila: Ver detalle abre un panel con el estado SUNAT, cliente, fechas, op. gravada, IGV, total, código y descripción del CDR y el hash del XML; desde el mismo panel (o desde el menú) puedes descargar el PDF con QR, el XML y — cuando SUNAT ya respondió — la Constancia de Recepción (CDR), enviar el comprobante por email y emitir una nota de crédito. El envío por email abre un panel que valida el correo del cliente antes de enviar. El email adjunta el PDF del comprobante, un archivo .zip que contiene el XML (los filtros de correo suelen bloquear o alterar el .xml suelto) y, cuando SUNAT ya respondió, la Constancia de Recepción (CDR) en un segundo .zip con el prefijo R- (por ejemplo R-20123456789-03-B001-00000001.zip). El cuerpo del correo incluye un resumen del comprobante: tipo y número, fecha de emisión, datos fiscales del emisor (razón social, RUC y dirección fiscal), cliente, op. gravada, IGV, importe total y estado SUNAT (“Aceptado por SUNAT”; si está observado, incluye el código y la descripción del CDR). Si el comprobante aún está pendiente de confirmación por SUNAT, el email lo advierte en el cuerpo del mensaje y la constancia viaja cuando SUNAT la emita; un comprobante rechazado o con error no puede enviarse por correo. Para Devolución por ítem, selecciona los productos y las cantidades a acreditar; no se permiten notas parciales cuando la venta tiene un descuento global. Las propinas no están disponibles al facturar con SUNAT.

En emisión automática, si una venta no puede emitirse, la orden conserva una incidencia visible con la causa y se puede emitir manualmente tras corregirla.

La validación BETA comprueba las credenciales y el certificado, mientras que la emisión requiere además una orden cerrada y datos de cliente válidos según el tipo de comprobante. Si falta un requisito, uunit9 explica la causa antes de emitir. Si el nombre del cliente o de un producto contiene caracteres que SUNAT no admite (por ejemplo emojis), la emisión se detiene antes de firmar y uunit9 indica qué dato corregir.

La habilitación productiva requiere que SUNAT autorice al RUC como emisor SEE, una clave SOL secundaria y el certificado registrado en SOL.

¿Qué deberías ver?

Un mensaje de confirmación notificando que los datos del negocio fueron actualizados correctamente.

Problemas frecuentes

Problema	Solución
Cambios no se reflejan en el ticket	Cierra la sesión activa en la caja y vuelve a abrirla para sincronizar la nueva cabecera de ticket.