Certificado Digital (PAC Signer)
Para emitir facturas electrónicas válidas ante la DGI de Panamá, la app necesita un certificado digital (archivo P12) para firmar cada documento XML.
Requisitos Previos
Antes de configurar el certificado necesitas:
- Archivo P12 — Certificado digital emitido por una autoridad certificadora autorizada.
- Contraseña del P12 — La contraseña que protege el certificado.
- Código de empresa — Código asignado por tu PAC (Aludra).
- API Key — Clave de integración con Aludra.
Configurar el Certificado
- Ve a Ajustes en la app.
- Busca la sección “Certificado Digital / PAC Signer”.
- Presiona “Configurar”.
- Selecciona el archivo P12 desde el almacenamiento del dispositivo.
- Ingresa la contraseña del certificado.
- Presiona “Inicializar”.
Verificación
Al inicializar correctamente:
- Aparece un indicador verde confirmando que el certificado está cargado.
- Se muestra la fecha de vencimiento del certificado.
- La app está lista para firmar facturas.
Si falla la inicialización
| Error | Causa | Solución |
|---|---|---|
| Contraseña incorrecta | La contraseña no coincide con el P12 | Verifica la contraseña |
| Certificado inválido | Archivo corrupto o formato incorrecto | Obtén un nuevo P12 |
| Certificado expirado | El P12 venció | Renueva con tu autoridad certificadora |
Cómo Funciona la Firma
Cuando completas una venta con factura electrónica:
- La app genera el XML de la factura con los datos de la venta.
- El PAC Signer firma digitalmente el XML usando el certificado P12.
- Se genera el CUFE (Código Único de Factura Electrónica).
- Si hay conexión, se envía a Aludra quien lo transmite a la DGI.
- Si no hay conexión, se guarda localmente para envío posterior.
Envío a la DGI (Aludra)
La configuración de Aludra se realiza desde el Portal Web en Configuración > DGI/PAC:
- API Key — Clave de autenticación.
- Código de Empresa — Identificador ante Aludra.
- Envío Automático — Activa/desactiva el envío automático al completar la venta.
Estados de Factura
| Código DGI | Estado | Significado |
|---|---|---|
0920 | Aceptada | Factura procesada correctamente |
0260 | Aceptada | Factura aceptada (código alterno) |
| Otro | Error | Revisar detalle del error |
| — | Pendiente | Aún no se ha enviado a la DGI |
Reintentar Facturas con Error
- Ve a Facturas Electrónicas en el menú lateral.
- Filtra por estado “Error” o “Pendiente”.
- Puedes:
- Reintentar una factura individual.
- Reintentar todas las pendientes de una vez.
Mantenimiento del Certificado
- Vencimiento: Revisa periódicamente la fecha de vencimiento en Ajustes.
- Renovación: Al obtener un nuevo P12, repite el proceso de configuración.
- Múltiples dispositivos: Cada tablet necesita su propia inicialización del P12 (el mismo archivo sirve para todos).
¿Problemas con facturas? Consulta Facturación Electrónica ¿Necesitas configurar la impresora? Ver Impresoras