Facturación electrónica DGI Panamá

Para empresas panameñas (Spongi y sus entidades relacionadas), DigiConta integra la facturación electrónica DGI (Dirección General de Ingresos) — emisión, consulta de estatus y control del ITBMS. Esta guía cubre la configuración de la conexión y el flujo de envío/recepción diario.

1. Configurar la conexión DGI

Menú → Impuestos → DGI Panamá → ícono de engrane (/dgi/config).

Modo de conexión

1. Elige el modo de conexión:

   • Mock (desarrollo) — sin envío real, para pruebas.
   • PAC Provider (REST API) — el camino normal en producción.
   • Direct DGI (SOAP/WCF) — conexión directa contra dgi-fepws.mef.gob.pa con tu certificado de firma electrónica del Registro Público de Panamá (requiere thumbprint del certificado; usa el ambiente de pruebas dgi-fepws-test.mef.gob.pa primero).

2. Si elegiste PAC Provider, selecciona el proveedor:

   • Alegra (Alanube) — DigiConta auto-rellena la URL base (https://api.alegra.com/api/v1/). Captura tu correo de Alegra (como “Client ID”) y el token de API generado en los ajustes de Alegra (como “Client Secret”).
   • Gosocket / ioFacturo — captura URL base, Client ID y Client Secret manualmente.
   • Otro — cualquier PAC con API REST propia.

3. Activa Habilitar integración DGI.

4. Pulsa Probar conexión antes de guardar — confirma que las credenciales autentican contra el PAC.

5. Guardar configuración.

Las credenciales nunca se muestran en claro

Una vez guardado, el campo del secreto queda vacío en pantalla (“dejar vacío para conservar el existente”) — DigiConta nunca vuelve a mostrar el secreto guardado, solo confirma que existe.

Credenciales por empresa (multi-entidad)

Si administras varias empresas panameñas con RUC distinto (el caso real de Spongi vs. una entidad hermana), cada una puede tener sus propias credenciales DGI/PAC en vez de compartir la configuración del tenant:

digiconta.bauxtp.com

Cada empresa con RUC propio puede tener su propia credencial PAC; si no configuras una, hereda la del tenant.

1. En la sección “Credenciales DGI por Empresa” (debajo de la configuración general), selecciona la empresa.

2. Si la empresa no tiene credencial propia, el chip muestra “Usando credenciales del inquilino” — todo funciona con la configuración general de arriba.

3. Para asignarle una credencial distinta, captura Client ID, Client Secret y, opcional, API Key, y pulsa Guardar.

4. Quitar borra la credencial de esa empresa (vuelve a heredar la del tenant).

Tip

Usa credenciales por empresa solo cuando cada entidad factura con un RUC/cuenta PAC distinta. Si todas tus empresas panameñas comparten el mismo contrato con el PAC, la configuración general del tenant es suficiente.

2. Enviar una factura electrónica (FE)

Pestaña General → Enviar (/dgi/submit).

1. Elige el tipo de documento: FE (Factura Electrónica), NCE (Nota de Crédito Electrónica) o NDE (Nota de Débito Electrónica).

2. Pega el XML de la e-factura en el cuadro de texto.

3. Envía. DigiConta lo transmite a la DGI vía el PAC/modo configurado y regresa el CUFE (código único de factura electrónica) cuando la DGI la autoriza.

3. Consultar el estatus por CUFE

Pestaña General → Estatus (/dgi/status).

1. Captura o escanea el código CUFE de la factura (también disponible vía Escanear QR si tienes el papel/PDF físico).

2. Pulsa Consultar estatus — DigiConta pregunta directo a la DGI el estado vigente del documento.

4. Revisar las e-facturas (enviadas y recibidas)

Pestaña General → E-facturas (/dgi/efacturas).

Filtrar por estatus

Filtra por Autorizada / Rechazada / Pendiente para ver rápido qué necesita atención.

Importar en lote

En Importar (/dgi/import), sube un Excel con e-facturas históricas o sincroniza contra SharePoint — útil para migrar el histórico de un PAC anterior o de facturas que llegaron fuera del flujo normal.

Operaciones relacionadas (sin guía dedicada aún)

• ITBMS (/dgi/itbms) — cálculo y control del Impuesto de Transferencia de Bienes Muebles y Servicios de Panamá.
• Reconciliación (/dgi/reconciliation) — cruce de e-facturas contra los registros contables.
• Auditoría (/dgi/audit) — bitácora de cambios de configuración y envíos DGI.

¿Qué sigue?

Ayuda contextual pendiente en la app

Las pantallas /dgi/* de DigiConta aún no traen el botón de ayuda (HelpKey) enlazado a esta guía — es un seguimiento de una línea en el repo DigiConta, fuera del alcance de este PR (solo contenido de Guías).

Ver también

• Resumen de DigiConta — todas las guías.
• Problemas comunes y FAQ — soluciones rápidas.
• Abrir DigiConta →