Errores comunes al emitir notas de crédito, débito y anulaciones en el SFEP de Panamá

Por Ing. Carlos Méndez | 10 de septiembre de 2026

Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.

Los documentos de ajuste en el SFEP de Panamá (notas de crédito, notas de débito y anulaciones) tienen tasas de rechazo en producción significativamente más altas que las facturas ordinarias. La razón es directa: mientras que el flujo de emisión de facturas suele probarse exhaustivamente en sandbox, los flujos de ajuste se implementan de forma reactiva, muchas veces bajo presión de un caso real.

Este artículo documenta los códigos de error más frecuentes que retorna el PAC y el DGI al procesar NCEs, NDEs y anulaciones en el SFEP, con la causa técnica exacta y la solución para cada uno.

Errores en la sección DocumentoReferencia

La sección DocumentoReferencia es la fuente más frecuente de rechazos en NCEs y NDEs. Los errores en esta sección representan aproximadamente el 60% de los rechazos en producción.

E-070 — Referencia inválida

Causa: el campo NumeroDocumentoRef no coincide exactamente con el número del documento emitido. Puede incluir espacios adicionales, diferencias de mayúsculas/minúsculas, o el formato del correlativo interno difiere del registrado en el PAC. También ocurre cuando se referencia un documento de un tipo distinto al declarado en TipoDocumentoRef. Solución: recuperar el número exacto del documento desde el registro del PAC (endpoint GET /documentos/{id}), no desde el sistema interno del ISV, y usarlo tal como lo almacenó el PAC.

E-071 — Documento referenciado no existe en el sistema

Causa: el documento original fue emitido por un PAC diferente, o fue rechazado y nunca quedó en el registro del DGI, o el número de RUC del emisor en la NCE/NDE no coincide con el del documento original. Solución: verificar que el documento existe con estado ACEPTADO en el PAC actual antes de construir el documento de ajuste.

E-072 — Documento de referencia fuera de plazo (NCE)

Causa: la NCE intenta referenciar una factura emitida hace más de 12 meses. Solución: verificar la fecha de emisión del documento original antes de iniciar el flujo de NCE. Si supera los 12 meses, el ajuste debe gestionarse fuera del SFEP (contabilidad manual o acuerdo entre las partes).

E-073 — Monto acumulado supera la factura original

Causa: la suma de todas las NCEs previamente aceptadas sobre la factura de referencia, más el monto de la nueva NCE, supera el total de la factura original. Solución: consultar el saldo disponible de la factura antes de emitir la NCE. El PAC no expone siempre este saldo directamente; puede calcularse consultando el historial de NCEs asociadas al documento.

E-074 — Documento de referencia fuera de plazo (NDE)

Causa: la NDE intenta referenciar una factura emitida hace más de 6 meses. Solución: emitir el cargo adicional como una nueva factura ordinaria con referencia contractual en Observaciones. La restricción de 6 meses para NDE es más corta que la de NCE (12 meses) por diseño del DGI.

Errores de cálculo de impuestos

E-055 — Base imponible incorrecta

Causa: el ITBAM declarado en el documento no coincide con el cálculo sobre la base imponible real. Frecuente cuando el equipo calcula el ITBAM sobre el monto de la factura original en lugar del monto de la nota. Solución: calcular el ITBAM solo sobre el MontoItem de la NCE o NDE, no sobre el total del documento referenciado. Si hay ítems exentos, separar los montos antes de aplicar la tasa.

E-056 — Impuesto no declarado en documento gravado

Causa: el documento incluye ítems gravados con ITBAM pero el campo ITBAM está ausente o en cero. Solución: verificar la naturaleza fiscal de cada ítem antes de construir los Totales. Si cualquier ítem tiene TasaITBAM mayor a 0, el campo ITBAM en Totales debe ser mayor que cero.

Errores de firma digital

E-100 — Firma inválida o certificado vencido

Causa: el certificado digital del emisor está vencido, fue revocado, o la firma no corresponde al contenido del documento (el XML fue modificado después de firmarlo). También ocurre cuando se usa un certificado de sandbox en producción o viceversa. Solución: verificar la vigencia del certificado antes de cada lote de emisión. Implementar alertas proactivas 30 días antes del vencimiento.

E-101 — Firma no corresponde al payload (anulaciones)

Causa: el payload de anulación fue firmado usando una cadena diferente a la canonicalizada. Frecuente cuando el desarrollador reutiliza la firma del documento original en la solicitud de anulación. Solución: generar una firma nueva sobre el payload de anulación, no reutilizar la del documento original.

Errores de ventana temporal en anulaciones

E-090 — Ventana de anulación expirada

Causa: la solicitud de anulación fue recibida por el PAC más de 24 horas después de la FechaEmision del documento, en hora local de Panamá (UTC-5). Frecuente en sistemas que calculan la ventana en UTC sin conversión de zona horaria. Solución: almacenar la FechaEmision de cada documento en la base de datos del ISV y calcular explícitamente el vencimiento de la ventana en hora Panamá (UTC-5) al momento de evaluar si la anulación es posible.

Errores de MotivoAjuste

E-060 — Código de motivo inválido para el tipo de documento

Causa: el valor de MotivoAjuste no pertenece al catálogo permitido para el tipo de documento. Los catálogos de NCE y NDE son distintos: usar un código de la NCE en una NDE (o viceversa) genera este error. Solución: mantener dos enumeraciones separadas en el código del ISV: una para MotivoAjuste-NCE y otra para MotivoAjuste-NDE.

Tabla resumen de errores y soluciones

Código | Tipo | Causa frecuente | Solución: E-055 | NCE/NDE | ITBAM calculado sobre factura original | Calcular sobre monto neto del ajuste. E-056 | NCE/NDE | ITBAM ausente en documento gravado | Incluir ITBAM en Totales si hay ítems gravados. E-060 | NCE/NDE | Código MotivoAjuste incorrecto para el tipo | Usar enumeraciones separadas por tipo. E-070 | NCE/NDE | NumeroDocumentoRef no coincide con el PAC | Recuperar el número exacto del PAC. E-071 | NCE/NDE | Documento no existe o fue emitido por otro PAC | Verificar estado ACEPTADO antes de construir el ajuste. E-072 | NCE | Referencia fuera de 12 meses | Verificar fecha antes de iniciar el flujo. E-073 | NCE | Monto acumulado NCEs supera factura | Calcular saldo disponible antes de emitir. E-074 | NDE | Referencia fuera de 6 meses | Emitir como factura nueva con referencia en Observaciones. E-090 | Anulación | Solicitud fuera de ventana de 24 horas | Calcular vencimiento en UTC-5, no en UTC. E-100 | Todos | Certificado vencido o firma corrupta | Monitorear vigencia del certificado proactivamente. E-101 | Anulación | Firma reutilizada del documento original | Generar firma nueva sobre el payload de anulación.

Preguntas frecuentes sobre errores en documentos de ajuste SFEP

¿Cuál es el error más frecuente al emitir una nota de crédito en el SFEP de Panamá?

El error E-070 (referencia inválida) es el más frecuente en producción. Ocurre cuando el campo NumeroDocumentoRef no coincide exactamente con el número registrado en el PAC. La causa más común es que el sistema ISV almacena el correlativo interno y no el identificador que asignó el PAC al documento.

¿Cómo puedo implementar un mecanismo de detección temprana de errores antes de enviar al PAC?

Implementar una capa de validación previa en el ISV que verifique: existencia y estado del documento referenciado (consulta al PAC), cálculo del ITBAM sobre el monto correcto, vigencia del certificado digital, y que el MotivoAjuste corresponda al catálogo del tipo de documento. Esta capa puede detectar el 80% de los errores antes de llegar al PAC.

¿Qué diferencia hay entre el error E-070 y el E-071 en el SFEP?

E-070 indica que el formato o contenido del campo NumeroDocumentoRef es inválido (no cumple la estructura esperada). E-071 indica que el documento con ese número no se encontró en el registro del PAC o del DGI. Son errores diferentes: E-070 es un error de formato; E-071 es un error de búsqueda.

¿Es posible reintentar una NCE rechazada con el mismo número de documento?

Sí, si el rechazo fue por error de estructura o de cálculo (no por duplicado). El PAC no reserva el número de una NCE rechazada: puede reemitirse el mismo número de correlativo una vez corregido el error. Si el rechazo fue por duplicado (la NCE ya existía con ese número y fue aceptada), debe usarse un nuevo número de correlativo.

Los proveedores de API que abstraen el SFEP, como la API de facturación electrónica para Panamá de Alanube, incluyen validación previa de los documentos de ajuste antes de transmitir al PAC, reduciendo la tasa de rechazo y simplificando el diagnóstico de errores.

---

Sobre el autor

Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.