Notas de crédito, débito y anulaciones en el SFEP de Panamá: guía técnica completa para ISVs

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.

Un desarrollador termina de integrar la emisión de facturas electrónicas en el SFEP de Panamá. Todo funciona en sandbox. Llega a producción y el primer caso real es una devolución parcial: el cliente recibe una factura por B/. 3,200 pero solo devuelve el 40% de la mercancía. ¿Nota de crédito o anulación? ¿Qué campos cambian en el XML? ¿Cuánto tiempo tiene antes de que el DGI rechace el documento? Preguntas que la documentación oficial responde de forma fragmentada.

Esta guía consolida el comportamiento técnico del SFEP ante notas de crédito, notas de débito y anulaciones de documentos electrónicos. Al terminar de leerla, el equipo de desarrollo tendrá claro qué tipo de documento emitir en cada escenario, cómo estructurar el XML para pasar la validación DGI, y qué errores ocurren con mayor frecuencia en producción.

Marco normativo: documentos de ajuste en el SFEP panameño

El Sistema de Facturación Electrónica de Panamá (SFEP) está regulado por la Dirección General de Ingresos (DGI) bajo el Decreto Ejecutivo N.° 1 de 2021 y sus resoluciones complementarias. Este marco define tres mecanismos para corregir o reversar documentos electrónicos ya transmitidos al PAC (Proveedor Autorizado de Certificación): la nota de crédito electrónica (NCE), la nota de débito electrónica (NDE) y la anulación de documento.

Cada mecanismo tiene un propósito específico, una ventana de tiempo permitida y una estructura XML diferente. No son intercambiables. Usar una nota de crédito donde correspondía una anulación genera inconsistencias en el registro fiscal del emisor y puede resultar en rechazo del documento o multas por descuadre contable.

Cuándo aplica cada documento: tabla de decisión rápida

La siguiente tabla resume los tres mecanismos de ajuste:

Escenario → Documento correcto: Devolución total o parcial de bienes/servicios → Nota de crédito (NCE). Error de precio o cantidad en la factura original → Nota de crédito (NCE) si el monto baja; Nota de débito (NDE) si el monto sube. Factura emitida por error a nombre del receptor equivocado → Anulación. Documento duplicado antes de las 24 horas → Anulación. Cargo adicional por flete o penalidad → Nota de débito (NDE). Descuento comercial posterior a la venta → Nota de crédito (NCE).

Nota de crédito electrónica (NCE): cuándo y cómo emitirla

La nota de crédito electrónica reduce el valor de una factura previamente emitida. Es el mecanismo más usado en producción porque cubre devoluciones, descuentos posteriores y correcciones de precio a la baja. A diferencia de la anulación, la NCE no requiere que el documento original esté dentro de un plazo corto: puede emitirse hasta 12 meses después de la fecha de la factura de referencia, siempre que la operación esté justificada.

El campo crítico en la NCE es DocumentoReferencia, que contiene el número CUFE o correlativo interno del documento original. Si este campo está mal formado, el PAC rechaza la NCE con el código de error E-070 (referencia inválida). El monto en la NCE debe ser igual o menor al monto de la factura original.

Campos obligatorios de la NCE en el XML DGI

Además de los campos comunes a todos los documentos SFEP (TipoDocumento, NumeroDocumento, FechaEmision, Emisor, Receptor), la NCE requiere: DocumentoReferencia con NumeroDocumento y TipoDocumento del origen; MotivoAjuste describiendo la causa (devolución, descuento, corrección); y el desglose de líneas ajustadas con CantidadDevuelta y PrecioUnitario. El campo ITBAM (Impuesto de Transferencia de Bienes Muebles) debe recalcularse sobre el monto neto de la nota, no sobre el total de la factura original.

Nota de débito electrónica (NDE): casos de uso y restricciones

La nota de débito electrónica aumenta el valor de una factura ya emitida. Se usa cuando el monto final supera al facturado originalmente: fletes adicionales calculados después del despacho, penalidades contractuales, o correcciones de precio al alza por acuerdo comercial documentado. Su uso es menos frecuente que la NCE, pero igualmente necesario para ISVs que manejan contratos con ajustes variables.

La NDE no puede usarse para crear un nuevo cobro independiente: siempre debe referenciar una factura existente. Si el cargo no tiene relación con una factura previa, debe emitirse una nueva factura electrónica ordinaria. La restricción de plazo para la NDE es de 6 meses desde la fecha de la factura de referencia.

Anulación de documentos en el SFEP: ventana de tiempo y proceso técnico

La anulación cancela completamente un documento electrónico, como si no hubiese existido. El DGI permite anular documentos dentro de las primeras 24 horas desde su emisión. Pasado ese plazo, el mecanismo correcto es la nota de crédito por el valor total del documento. Esta restricción es técnica y no negociable: el PAC rechaza solicitudes de anulación con timestamp superior a 24 horas con el error E-090 (ventana de anulación expirada).

La solicitud de anulación se realiza mediante un endpoint separado al del PAC, no a través del flujo ordinario de emisión. Requiere: el número de documento original, la fecha de emisión, el RUC del emisor, y el MotivoAnulacion en texto libre (máximo 300 caracteres). El PAC valida la identidad del emisor mediante firma digital antes de transmitir la anulación al DGI.

Flujo técnico de una anulación exitosa

El flujo completo tiene 4 pasos: (1) El sistema ISV detecta el documento a anular dentro de las 24 horas y construye el payload de anulación. (2) El payload se firma digitalmente con el certificado del emisor (mismo certificado usado para la emisión). (3) Se envía al endpoint de anulación del PAC, que valida la firma, la ventana de tiempo y la existencia del documento en su registro. (4) El PAC transmite la anulación al DGI y retorna un código de confirmación. Si el DGI acepta, el documento queda marcado como ANULADO en el sistema y no puede ser referenciado en notas futuras.

Gestión de estados: cómo saber si la nota o anulación fue aceptada

El SFEP procesa los documentos de ajuste de forma asíncrona. El PAC retorna un acuse de recibo inmediato con un identificador de transacción, pero la confirmación definitiva del DGI puede tardar entre 30 segundos y 5 minutos en producción. Los estados posibles son: PENDIENTE, ACEPTADO, RECHAZADO y ANULADO. La consulta de estado se realiza mediante polling al endpoint GET /documentos/{id}/estado del PAC o mediante webhook si el PAC lo soporta.

Los ISVs deben implementar un mecanismo de reconciliación periódica: documentos en estado PENDIENTE por más de 15 minutos deben consultarse activamente. Si el PAC no responde en ese plazo, se recomienda escalar al soporte técnico del PAC antes de reemitir el documento, ya que una doble emisión genera duplicado fiscal.

Comparativa técnica: NCE vs NDE vs Anulación

La siguiente tabla compara los tres mecanismos en las dimensiones relevantes para el desarrollo:

Criterio | NCE | NDE | Anulación — Efecto sobre el monto | Reduce | Aumenta | Cancela total — Plazo máximo | 12 meses | 6 meses | 24 horas — Endpoint | Emisión estándar | Emisión estándar | Endpoint dedicado — Referencia obligatoria | Sí | Sí | Sí — Firma digital requerida | Sí | Sí | Sí — Estado DGI final | ACEPTADO como NCE | ACEPTADO como NDE | ANULADO — Puede referenciarse luego | Sí (para otras NCE) | Sí | No

Implementación práctica: recomendaciones para ISVs

Los ISVs que integran el SFEP deben implementar tres flujos diferenciados en su sistema: uno para NCE, uno para NDE y uno para anulaciones. No es suficiente con reutilizar el flujo de emisión con campos distintos, ya que la lógica de validación previa (cálculo de ITBAM, verificación de plazo, construcción de la referencia) es diferente en cada caso.

Los proveedores de API que abstraen la capa SFEP, como la infraestructura de facturación electrónica para Panamá de Alanube, exponen estos tres flujos como endpoints REST separados con validación previa integrada, lo que reduce el tiempo de implementación y elimina los errores de campo más comunes.

Preguntas frecuentes sobre notas y anulaciones en el SFEP

¿Cuál es la diferencia entre una nota de crédito y una anulación en el SFEP de Panamá?

La nota de crédito reduce parcial o totalmente el valor de una factura y puede emitirse hasta 12 meses después. La anulación cancela el documento completo y solo está disponible dentro de las primeras 24 horas desde la emisión. Después de ese plazo, si se requiere cancelar el total de la factura, debe emitirse una NCE por el valor completo.

¿Cómo puedo saber si el DGI aceptó mi nota de crédito electrónica?

El PAC retorna un código de transacción inmediato al recibir el documento. El estado definitivo debe consultarse mediante el endpoint GET /documentos/{id}/estado o mediante webhook. El estado ACEPTADO del DGI confirma que la nota quedó registrada en el sistema fiscal. El proceso completo toma entre 30 segundos y 5 minutos en producción.

¿Qué diferencia hay entre una NCE por devolución total y una anulación?

La NCE por valor total y la anulación tienen el mismo efecto económico, pero diferente trato fiscal. La anulación elimina el documento del registro como si no hubiera existido (disponible solo en las primeras 24 horas). La NCE crea un documento nuevo que contrarresta la factura original, y ambos quedan en el registro fiscal del emisor y receptor.

¿Es posible emitir una nota de débito sin referenciar una factura previa en el SFEP?

No. Toda nota de débito electrónica en el SFEP debe referenciar obligatoriamente una factura existente mediante el campo DocumentoReferencia. Si el cargo adicional no tiene relación con una factura previa del mismo receptor, debe emitirse como una nueva factura ordinaria, no como NDE.

---

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.