Fiscal / Facturación Electrónica (FEL)

Módulo requerido: sales
→ Módulos y permisos

¿Qué es la FEL?

La Facturación Electrónica en Línea (FEL) es el sistema obligatorio de la Dirección General de Ingresos (DGI) de Panamá para validar y reportar documentos fiscales.

Cada factura y nota de crédito emitida en Sonata se transmite a la DGI a través de un PAC (Proveedor Autorizado de Certificación). La DGI valida el documento y devuelve el CUFE (Código Único de Factura Electrónica).

PAC configurados

Sonata soporta múltiples proveedores:

PAC	Notas
TFHKA	Proveedor principal. Soporte completo para todos los tipos de documento y operaciones (incluida la anulación en línea).
FacturaFácil	Proveedor alternativo. Algunas operaciones avanzadas pueden no estar disponibles.

Configurar el PAC (solo administradores)

1. Ve a Configuración → Datos de la empresa → sección Facturación electrónica.
2. Selecciona el proveedor (TFHKA o FacturaFácil).
3. Ingresa las credenciales proporcionadas por el PAC (se guardan cifradas).
4. Selecciona el ambiente — QA (pruebas) o Producción.
5. Guarda. Puedes consultar los folios restantes del PAC desde la misma pantalla.

Ambiente de producción

Asegúrate de cambiar el ambiente a Producción antes de emitir facturas reales. Las facturas emitidas en QA no son válidas fiscalmente.

Flujo de envío

Guardar FAC / DEV
    ↓
PAC (TFHKA / FacturaFácil)
    ↓
DGI Panamá
    ↓
CUFE asignado → estado FEL: Enviada

Si la DGI no responde o rechaza, el documento queda Pendiente o Rechazada y puede reintentarse en cualquier momento.

El hub Fiscal

El ítem Fiscal del menú lateral centraliza la operación FEL:

• Documentos con problemas — facturas Rechazadas o Pendientes, con el motivo de la DGI y botón Reintentar envío.
• Validar RUC — consulta un RUC contra la DGI antes de crear el cliente.
• Descarga masiva de PDFs — genera un ZIP con todos los PDF fiscales del mes (nombrados de forma descriptiva), listo para enviarlo al contador.

Anulación de documentos: "DGI primero, luego local"

Al anular una factura o devolución que ya tiene CUFE:

1. El sistema envía la solicitud de anulación a la DGI a través del PAC.
2. Solo si la DGI acepta, el documento se anula localmente (stock, contabilidad).
3. Si la DGI rechaza la anulación, el documento permanece vigente y el sistema muestra el motivo.

Si una anulación fiscal quedó pendiente (p. ej. sin conexión), el detalle del documento ofrece el botón Anular en DGI para reintentarla manualmente.

Motivos de rechazo comunes y solución

Mensaje DGI	Causa	Solución
RUC inválido	El RUC del cliente no existe en DGI.	Corrige el RUC en el catálogo de clientes. → Validar RUC
Dígito verificador incorrecto	El DV no corresponde al RUC.	Recalcula el DV en el catálogo del cliente.
Tasa de ITBMS no válida	Tasa inexistente en la legislación vigente.	Revisa la tasa del producto (0 %, 7 %, 10 %, 15 %).
Ubicación requerida	Los tipos de contribuyente 01/03 exigen ubicación.	Completa provincia/distrito/corregimiento en la ficha del cliente.
Secuencia de folios agotada	Se agotó el rango contratado con el PAC.	Contacta al PAC para ampliar folios (revisa el contador de folios en Configuración).
Credenciales incorrectas	Las credenciales del PAC cambiaron o vencieron.	Actualiza en Configuración → Datos de la empresa.

Validar RUC

Antes de crear un cliente puedes verificar su RUC contra la DGI:

1. Ve a Fiscal → Validar RUC.
2. Ingresa el RUC.
3. El sistema consulta la DGI y devuelve el nombre y DV oficial.
4. Usa esos datos al crear el cliente.

CUFE y código QR

El CUFE es el identificador oficial de la DGI que certifica la autenticidad del documento. Aparece en:

• El detalle de la factura en el sistema.
• El PDF de la factura (código QR + número al pie).
• El ticket térmico (el QR enlaza a la consulta pública del documento en la DGI).

Una factura sin CUFE no es válida como documento fiscal.

Documentos que se envían a FEL

Documento	Tipo DGI
Factura de venta (FAC)	Factura de operación interna
Devolución de venta (DEV)	Nota de crédito
Factura recurrente (generada automáticamente)	Factura de operación interna

Las cotizaciones (COT) y pedidos (PED) no se envían a la DGI.

Preguntas frecuentes

¿Puedo facturar si la DGI está caída?
Sí. Las facturas quedan con estado Pendiente y puedes reintentarlas cuando el servicio se restablezca (desde el hub Fiscal o desde la propia factura).

¿Puedo anular una factura ya enviada a la DGI?
Sí, pero la anulación primero debe aceptarla la DGI; el documento no se anula localmente hasta que eso ocurre. → Anulación

¿Cómo entrego los PDF fiscales al contador?
Usa la descarga masiva del hub Fiscal: un ZIP con todos los PDF del mes, nombrados por tipo, número y cliente.

¿Qué pasa si cambio de PAC?
Las facturas históricas quedan con el PAC anterior. Las nuevas usan el nuevo PAC. Coordina el cambio con tu contador y con el nuevo PAC.