Playbook: Configuración Inicial y Terminal
Problema 1: No puedo registrar el terminal
Síntomas
- Al abrir la app por primera vez, el registro del terminal falla.
- Error: “Terminal no encontrado” o “Código inválido”.
- La app se queda en la pantalla de registro.
Diagnóstico
- Verificar que el terminal existe en el portal — Ve a Configuración > Terminales en el portal web.
- Verificar el código del terminal — El código debe coincidir exactamente (case-sensitive).
- Verificar conexión a internet — El registro inicial requiere conexión.
Solución
| Causa | Acción |
|---|---|
| Terminal no creado | Crea un terminal nuevo desde el portal web: Configuración > Terminales > Agregar. |
| Código incorrecto | Copia el código exacto del terminal desde el portal. Es case-sensitive. |
| Sin internet | Conéctate a WiFi. El primer registro no funciona offline. |
| Terminal ya registrado en otro dispositivo | Un terminal solo puede estar activo en un dispositivo a la vez. Desvincula el anterior desde el portal o crea un nuevo terminal. |
| Sesión de usuario no válida | Verifica que el usuario y contraseña son correctos. Pide al admin resetear si es necesario. |
Prevención
- Crear los terminales desde el portal antes de configurar los dispositivos.
- Documentar los códigos de terminal y a qué dispositivo corresponden.
- Tener WiFi disponible para la primera configuración.
Problema 2: La app no se conecta al servidor
Síntomas
- Error: “No se puede conectar al servidor”.
- Pantalla de carga infinita.
- Todo aparece vacío (sin productos, sin categorías).
Diagnóstico
- Verificar internet — Abre el navegador y accede a cualquier página.
- Verificar URL del servidor — La app debe apuntar al servidor correcto.
- Verificar estado del servicio — El servidor de NAOS puede estar en mantenimiento.
Solución
| Causa | Acción |
|---|---|
| Sin internet | Conéctate a WiFi o datos móviles. |
| Servidor en mantenimiento | Espera unos minutos y reintenta. Verifica con soporte si persiste. |
| URL incorrecta | Contacta soporte — la URL del servidor se configura en el build de la app. |
| DNS no resuelve | Prueba reiniciando el router o usando datos móviles temporalmente. |
Problema 3: No se carga el certificado digital (P12)
Síntomas
- Al intentar cargar el certificado P12, falla la inicialización.
- Error: “No se pudo inicializar el certificado”.
Diagnóstico
- Verificar el archivo — Debe ser un
.p12o.pfxválido. - Verificar la contraseña — Es case-sensitive.
- Verificar que no está corrupto — Intenta abrirlo en otro programa (ej: KeyChain en macOS).
Solución
| Causa | Acción |
|---|---|
| Contraseña incorrecta | Reingresa la contraseña exacta. Es case-sensitive. |
| Archivo corrupto | Solicita una nueva copia del certificado al emisor. |
| Formato incompatible | El archivo debe ser PKCS12 (.p12 o .pfx). Si es otro formato (.pem, .cer), debe convertirse. |
| Certificado expirado | Renueva el certificado con tu proveedor de CA. |
Para más detalles sobre el certificado, ve a la guía de Certificado Digital.
Problema 4: Los productos no aparecen en la app
Síntomas
- La app está conectada pero la lista de productos está vacía.
- Solo aparecen algunas categorías sin productos.
Diagnóstico
- Verificar que hay productos creados — Revisa en el portal web que existen productos.
- Verificar la sucursal — Los productos deben estar asignados a la sucursal del terminal.
- Verificar sincronización — Los productos se descargan en la primera sync.
Solución
| Causa | Acción |
|---|---|
| Sin productos en el portal | Crea productos desde el portal web o importa via CSV. |
| Productos en otra sucursal | Asigna los productos a la sucursal correcta desde el portal. |
| Sync no completada | Fuerza un sync: tira hacia abajo (pull-to-refresh) en la pantalla principal. |
| Productos inactivos | Verifica que los productos están marcados como “Activos” en el portal. |
Problema 5: La configuración fiscal (DGI) no funciona
Síntomas
- No se puede facturar electrónicamente.
- Error al intentar enviar a DGI.
- El campo “Tipo de Contribuyente” está vacío.
Diagnóstico — Checklist de configuración fiscal
| # | Requisito | Dónde verificar |
|---|---|---|
| 1 | Tipo de contribuyente configurado | Portal > Configuración > Facturación Electrónica |
| 2 | Credenciales de Aludra (apiKey + companyCode) | Portal > Configuración > Facturación Electrónica |
| 3 | Certificado P12 cargado en la app | App > Ajustes > Certificado Digital |
| 4 | Consecutivo (dNroDF) del terminal configurado | Portal > Configuración > Terminales |
| 5 | Terminal registrado y activo | App > Ajustes > Terminal |
Solución
Completa cada paso del checklist en orden. Si ya configuraste todo y aún falla, consulta el Playbook de Facturación Electrónica.
Problema 6: No puedo iniciar sesión en el portal web
Síntomas
- Error: “Credenciales inválidas”.
- La página se queda cargando.
- Error: “Cuenta bloqueada”.
Solución
| Causa | Acción |
|---|---|
| Contraseña incorrecta | Usa “Olvidé mi contraseña” para resetear. |
| Usuario no existe | Pide al administrador que cree tu usuario. |
| Cuenta bloqueada | Contacta al administrador para desbloquear. |
| Primer ingreso | Algunos tenants requieren cambio de contraseña en el primer login. |
Checklist de Primera Configuración
Usa esta lista para configurar un nuevo punto de venta de inicio a fin:
| # | Paso | Plataforma | Estado |
|---|---|---|---|
| 1 | Crear cuenta y acceder al portal web | Portal | |
| 2 | Configurar datos del negocio (nombre, logo, dirección) | Portal | |
| 3 | Configurar tipo de contribuyente y datos fiscales | Portal | |
| 4 | Configurar credenciales de Aludra (apiKey, companyCode) | Portal | |
| 5 | Crear categorías de productos | Portal | |
| 6 | Crear productos (manual o CSV) | Portal | |
| 7 | Crear terminal(es) | Portal | |
| 8 | Configurar consecutivo (dNroDF) del terminal | Portal | |
| 9 | Descargar e instalar la app NAOS | Dispositivo | |
| 10 | Registrar terminal en la app | App | |
| 11 | Cargar certificado P12 | App | |
| 12 | Configurar impresora | App | |
| 13 | Hacer prueba de impresión | App | |
| 14 | Hacer apertura de caja | App | |
| 15 | Realizar primera venta de prueba | App | |
| 16 | Verificar factura electrónica (si aplica) | App + Portal |
Guión del Video
Título: “Primera Configuración de NAOS — De cero a tu primera venta”
Duración estimada: 8-10 minutos
| Tiempo | Escena | Acción | Narración |
|---|---|---|---|
| 0:00 | Intro | Logo NAOS + título | ”En este video configuraremos NAOS desde cero: desde crear tu cuenta hasta hacer tu primera venta.” |
| 0:20 | Portal - Login | Acceder al portal web | ”Ingresa al portal web con tus credenciales. Si es tu primer ingreso, te pedirá cambiar la contraseña.” |
| 0:40 | Portal - Negocio | Configurar datos del negocio | ”Primero, configura los datos de tu negocio: nombre, logo, dirección y datos fiscales.” |
| 1:10 | Portal - DGI | Configurar tipo contribuyente + Aludra | ”Para facturación electrónica, configura el tipo de contribuyente y las credenciales de Aludra.” |
| 1:40 | Portal - Productos | Crear categorías y productos | ”Crea tus categorías y agrega productos. Puedes hacerlo manualmente o importar un CSV.” |
| 2:20 | Portal - Terminal | Crear terminal con consecutivo | ”Crea tu terminal y configura el consecutivo de facturación. Este número es asignado por la DGI.” |
| 3:00 | App - Instalar | Instalar la app en la tablet | ”Descarga NAOS desde la Play Store e instálala en tu dispositivo Android.” |
| 3:20 | App - Registro | Registrar terminal | ”Al abrir la app, ingresa tus credenciales y el código del terminal que creaste en el portal.” |
| 3:50 | App - Certificado | Cargar certificado P12 | ”Carga tu certificado digital P12. Si la carga es exitosa, verás la fecha de vencimiento.” |
| 4:20 | App - Impresora | Configurar impresora | ”Configura tu impresora: Bluetooth, WiFi, o automática si tienes un Senraise.” |
| 4:50 | App - Prueba impresión | Probar impresión | ”Haz una prueba de impresión para verificar que todo funciona.” |
| 5:10 | App - Apertura | Hacer apertura de caja | ”Abre la caja ingresando el monto inicial en efectivo.” |
| 5:30 | App - Primera venta | Agregar productos y cobrar | ”Ahora haz tu primera venta: agrega productos, selecciona el método de pago y cobra.” |
| 6:00 | App - Factura | Verificar factura electrónica | ”Si configuraste facturación electrónica, verifica que la factura se envió y fue aceptada por la DGI.” |
| 6:30 | Portal - Verificar | Ver la venta en el portal | ”Desde el portal, puedes verificar que la venta se sincronizó y aparece en los reportes.” |
| 7:00 | Problemas comunes | Pantalla con tabla | ”Si algo falla: terminal no registra, revisa el código y la conexión. Certificado no carga, verifica la contraseña. Productos vacíos, sincroniza la app.” |
| 7:40 | Tips | Checklist completo | ”Usa nuestra checklist de primera configuración para no olvidar ningún paso.” |
| 8:00 | Cierre | Logo + soporte | ”¿Necesitas ayuda? Nuestro equipo de soporte te guiará paso a paso. Contáctanos en naos.pa/soporte.” |