Playbook: Facturación Electrónica (DGI)

Video Tutorial

Video próximamente — se agregará el enlace una vez publicado en YouTube.

---

Problema 1: Factura se queda en “Pendiente”

Síntomas

• La factura aparece con estado amarillo “Pendiente” en el listado.
• No se genera CUFE.
• El cliente no recibe el comprobante fiscal válido.

Diagnóstico

1. Verificar conexión a internet — El indicador en la app debe estar en verde.
2. Revisar cola de envío — En la app, ve a Facturas Electrónicas y revisa si hay varias pendientes acumuladas.
3. Verificar configuración de Aludra — En el portal web, ve a Configuración > Facturación Electrónica y confirma que apiKey y companyCode estén configurados.

Solución

Causa	Acción
Sin internet	Las facturas se enviarán automáticamente al recuperar conexión. No se requiere acción.
Cola atascada	Desde el portal web, ve a Facturas Electrónicas > selecciona las pendientes > “Reintentar Envío”.
Aludra no configurado	Configura las credenciales de Aludra en Configuración > Facturación Electrónica (necesitas apiKey y companyCode).
Envío deshabilitado	Verifica que aludraSendEnabled no esté en false en la configuración del tenant.

Prevención

• Mantener conexión WiFi estable en el punto de venta.
• Revisar facturas pendientes al final de cada jornada.
• Usar el reintento masivo desde el portal para limpiar colas.

---

Problema 2: Error de Certificado Digital (P12)

Síntomas

• Error al firmar: “Contraseña incorrecta” o “Certificado inválido”.
• Error: “Certificado expirado”.
• La factura no se firma localmente.

Diagnóstico

1. Verificar fecha de expiración — En la app, ve a Ajustes > Certificado Digital. La fecha de vencimiento debe ser futura.
2. Verificar contraseña — Confirma que la contraseña del P12 es correcta (case-sensitive).
3. Verificar formato del archivo — Debe ser un archivo .p12 o .pfx válido emitido por una CA autorizada en Panamá.

Solución

Error	Acción
Contraseña incorrecta	Reingresa el certificado con la contraseña correcta desde Ajustes > Certificado Digital.
Certificado expirado	Renueva el certificado con tu proveedor (CA). Luego recárgalo en la app.
Certificado inválido	Verifica que sea un P12 válido. Si fue convertido de otro formato, reconviértelo correctamente.
No inicializa	Cierra la app completamente, vuelve a abrirla e intenta cargar el certificado nuevamente.

Prevención

• Configurar una alerta 30 días antes del vencimiento del certificado.
• Guardar una copia de respaldo del P12 en un lugar seguro.
• Nunca compartir la contraseña del certificado.

---

Problema 3: Rechazo de la DGI (Error de Validación)

Síntomas

• La factura aparece en rojo con estado “Error”.
• Hay un mensaje de error específico de la DGI (ej: “RUC inválido”, “Código de seguridad inválido”).

Diagnóstico

1. Leer el mensaje de error — Haz clic en la factura con error para ver el detalle del rechazo.
2. Identificar el código de error — Los códigos comunes:

Código	Significado	Causa frecuente
RUC inválido	El RUC/DV del receptor no existe en DGI	Cliente con datos fiscales incorrectos
Código de seguridad	El consecutivo (dNroDF) no es válido	Desincronización del consecutivo del terminal
Formato inválido	El XML no cumple el esquema de la DGI	Campos faltantes o mal formateados
Certificado no autorizado	El certificado no está registrado en DGI	Certificado no habilitado para facturación

Solución

1. Corregir el dato origen:
   • Si es error de cliente → Edita los datos fiscales del cliente (RUC, DV, tipo de contribuyente).
   • Si es error de consecutivo → Contacta soporte para resincronizar el dNroDF del terminal.
   • Si es error de formato → Verifica que el tipo de contribuyente esté configurado correctamente.
2. Reintentar envío — Desde el detalle de la factura, presiona “Reintentar Envío”.

Prevención

• Verificar los datos fiscales del cliente antes de facturar (usar la verificación de RUC integrada).
• No modificar manualmente los consecutivos del terminal.
• Mantener actualizado el tipo de contribuyente en la configuración.

---

Problema 4: Reintento Masivo de Facturas

Cuándo usar

• Tienes múltiples facturas pendientes o con error después de una caída prolongada de internet.
• Necesitas limpiar la cola de envío.

Pasos

1. Ve al Portal Web > Facturas Electrónicas.
2. Filtra por estado “Pendiente” o “Error”.
3. Selecciona las facturas a reenviar (o usa “Seleccionar todas”).
4. Presiona “Reintentar Envío Masivo”.
5. Espera a que se procesen — el estado se actualizará automáticamente.

Importante

Las facturas con errores de datos (RUC inválido, etc.) volverán a fallar si no corriges el dato origen antes de reintentar.

---

Guión del Video

Título: “Cómo resolver problemas de Facturación Electrónica en NAOS”

Duración estimada: 5-7 minutos

Tiempo	Escena	Acción	Narración
0:00	Intro	Logo NAOS + título	”En este video aprenderás a resolver los problemas más comunes con la facturación electrónica en NAOS.”
0:20	App - Listado de facturas	Mostrar facturas con diferentes estados (verde, amarillo, rojo)	“Cada factura tiene un estado: verde es aceptada, amarilla es pendiente y roja tiene un error.”
0:50	App - Factura pendiente	Tap en una factura pendiente	”Si una factura está pendiente, generalmente es por falta de internet. Se enviará automáticamente cuando tengas conexión.”
1:20	Portal - Reintento individual	Abrir detalle de factura con error, mostrar mensaje de error	”Si hay un error, haz clic en la factura para ver qué falló. Aquí vemos que el RUC del cliente es inválido.”
2:00	Portal - Editar cliente	Corregir datos fiscales del cliente	”Corregimos los datos fiscales del cliente y guardamos.”
2:30	Portal - Reintentar	Presionar Reintentar Envío	”Ahora presionamos Reintentar Envío y esperamos la respuesta de la DGI.”
3:00	Portal - Éxito	Factura cambia a verde con CUFE	”La factura ahora está aceptada y se generó el CUFE exitosamente.”
3:30	App - Certificado	Ajustes > Certificado Digital	”Si el error es de certificado, ve a Ajustes, Certificado Digital. Verifica la fecha de vencimiento y recarga el P12 si es necesario.”
4:30	Portal - Reintento masivo	Filtrar pendientes, seleccionar todas, reintento masivo	”Para limpiar muchas facturas pendientes de una vez, usa el reintento masivo desde el portal web.”
5:30	Tips finales	Pantalla con checklist	”Recuerda: revisa facturas pendientes cada día, verifica datos fiscales antes de facturar, y mantén tu certificado vigente.”
6:00	Cierre	Logo + soporte	”Si necesitas más ayuda, contacta a soporte en naos.pa/soporte.”