Nota de crédito electrónica en Panamá: estructura XML, campos obligatorios y validación DGI

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.

La nota de crédito electrónica es el documento de ajuste más usado en el SFEP de Panamá, pero también uno de los que genera mayor cantidad de rechazos en producción. El motivo no suele ser un error de negocio, sino de construcción del XML: el campo DocumentoReferencia mal formado, el ITBAM calculado sobre la base incorrecta, o el MotivoAjuste con un valor fuera del catálogo aceptado por el DGI.

Esta guía detalla campo por campo la estructura XML de la NCE en el SFEP, con los valores aceptados, las reglas de cálculo del impuesto y los patrones de error más comunes devueltos por el PAC. El objetivo es que cualquier desarrollador pueda construir una NCE válida en el primer intento.

Qué es la nota de crédito electrónica en el contexto del SFEP

En el Sistema de Facturación Electrónica de Panamá, la nota de crédito electrónica (NCE) es un documento fiscal que reduce el valor de una factura previamente emitida y aceptada por el DGI. No cancela la factura: la complementa con un ajuste negativo. El DGI registra tanto la factura original como la NCE en el expediente fiscal del emisor.

La NCE puede reducir una o varias líneas de la factura, o el total completo. No puede generar un saldo negativo: el monto de la NCE no puede superar el monto de la factura referenciada. Si el ajuste requerido supera el valor de la factura, deben emitirse NCEs separadas referenciando distintas facturas.

Estructura XML de la NCE: sección por sección

El XML de la NCE en Panamá sigue el estándar DGI-XML v2.1. Tiene cinco secciones principales: Encabezado, DocumentoReferencia, Emisor, Receptor y DetalleItems. Cada sección tiene campos obligatorios y opcionales. A continuación se detalla cada una.

Sección Encabezado

TipoDocumento: valor fijo "04" para NCE (no confundir con "05" que corresponde a NDE). NumeroDocumento: correlativo interno del emisor, formato alfanumérico, máximo 20 caracteres. FechaEmision: formato ISO 8601 en hora local de Panamá (UTC-5). TipoOperacion: "1" para emisión normal. NaturalezaOperacion: "1" si la venta original fue de bienes, "2" si fue de servicios. FormaPago: mismo valor que en la factura de referencia si el ajuste afecta el pago.

Sección DocumentoReferencia (crítica)

Esta sección vincula la NCE con la factura original. Es obligatoria y su construcción incorrecta genera el 60% de los rechazos. Campos: NumeroDocumentoRef: número de la factura original exactamente como fue emitida, sin espacios adicionales. TipoDocumentoRef: "01" para factura de compra/venta, "02" para factura de débito fiscal. FechaDocumentoRef: fecha de la factura original. MotivoAjuste: razón del ajuste, valores aceptados por DGI: "01" Devolución de bienes, "02" Descuento comercial, "03" Error en precio, "04" Error en cantidad, "05" Otros (requiere descripción adicional).

Sección DetalleItems

Cada ítem ajustado debe listarse con: CodigoItem (mismo código de la factura original), Descripcion, CantidadDevuelta (positivo, aunque sea un ajuste negativo), PrecioUnitario, DescuentoItem si aplica, MontoItem calculado como CantidadDevuelta × PrecioUnitario − Descuento. No se incluyen ítems que no estén siendo ajustados.

Cálculo correcto del ITBAM en la NCE

El ITBAM (Impuesto de Transferencia de Bienes Muebles y Servicios) debe calcularse sobre el monto neto de la nota de crédito, no sobre el monto de la factura original. Error frecuente: tomar el ITBAM de la factura original y prorratearlo. El DGI rechaza este enfoque con el error E-055 (base imponible incorrecta).

Fórmula correcta: BaseImponibleNCE = SumaMontoItems (con descuentos ya aplicados). ITBAM = BaseImponibleNCE × TasaITBAM. La tasa general es 7%. Productos de la canasta básica y medicamentos están exentos (tasa 0%). Si la factura original mezclaba ítems gravados y exentos, la NCE debe replicar esa misma distribución.

Ejemplo XML de NCE válida (pseudocódigo)

<!-- Pseudocodigo - estructura orientativa, no ejecutable sin certificado -->
<DGI-NCE version="2.1">
  <Encabezado>
    <TipoDocumento>04</TipoDocumento>
    <NumeroDocumento>NCE-2026-001234</NumeroDocumento>
    <FechaEmision>2026-09-10T09:00:00-05:00</FechaEmision>
    <TipoOperacion>1</TipoOperacion>
    <NaturalezaOperacion>1</NaturalezaOperacion>
  </Encabezado>
  <DocumentoReferencia>
    <NumeroDocumentoRef>FAC-2026-005678</NumeroDocumentoRef>
    <TipoDocumentoRef>01</TipoDocumentoRef>
    <FechaDocumentoRef>2026-08-15</FechaDocumentoRef>
    <MotivoAjuste>01</MotivoAjuste>
  </DocumentoReferencia>
  <Emisor>
    <RUC>888-123-45678</RUC>
    <RazonSocial>Empresa Ejemplo S.A.</RazonSocial>
  </Emisor>
  <Receptor>
    <RUC>777-987-65432</RUC>
    <RazonSocial>Cliente Final S.A.</RazonSocial>
  </Receptor>
  <DetalleItems>
    <Item>
      <CodigoItem>PROD-001</CodigoItem>
      <Descripcion>Caja de herramientas devuelta</Descripcion>
      <CantidadDevuelta>2</CantidadDevuelta>
      <PrecioUnitario>150.00</PrecioUnitario>
      <MontoItem>300.00</MontoItem>
    </Item>
  </DetalleItems>
  <Totales>
    <TotalGravado>300.00</TotalGravado>
    <ITBAM>21.00</ITBAM>
    <TotalDocumento>321.00</TotalDocumento>
  </Totales>
</DGI-NCE>

Firma digital de la NCE: mismos requisitos que la factura

La NCE debe firmarse digitalmente con el mismo certificado usado para emitir facturas, siguiendo el estándar XAdES-BES. La firma se aplica sobre el XML canonicalizado (C14N) antes de enviarlo al PAC. Si el certificado está vencido o fue revocado, el PAC rechaza la NCE con error E-100 (firma inválida) independientemente de que el contenido del documento sea correcto.

Los certificados para el SFEP deben ser emitidos por entidades de certificación autorizadas por la Autoridad de Innovación Gubernamental (AIG) de Panamá. La lista actualizada de entidades autorizadas está disponible en el portal del DGI.

Flujo de emisión de la NCE a través del PAC

El proceso tiene 5 pasos: (1) El sistema ISV construye el XML de la NCE con todos los campos obligatorios. (2) El XML se firma digitalmente con el certificado XAdES-BES del emisor. (3) El XML firmado se envía al endpoint de emisión del PAC mediante POST con autenticación por token. (4) El PAC valida la firma, la estructura XML y la referencia al documento origen. Si pasa, transmite al DGI. (5) El PAC retorna el estado de la NCE: PENDIENTE, ACEPTADO o RECHAZADO con código de error si aplica.

Preguntas frecuentes sobre la NCE en el SFEP de Panamá

¿Cuál es el plazo máximo para emitir una nota de crédito en Panamá?

El DGI acepta NCEs hasta 12 meses después de la fecha de emisión de la factura de referencia. Después de ese plazo, el PAC rechaza la NCE con el error E-072 (documento de referencia fuera de plazo permitido). Para devolución de bienes en contratos de largo plazo, se recomienda emitir la NCE en el mismo período fiscal de la devolución.

¿Cómo puedo emitir una NCE si la factura original fue emitida por un PAC diferente al que uso ahora?

La NCE debe emitirse a través del mismo PAC que emitió la factura original. Si el emisor cambió de PAC, debe solicitar al PAC anterior el número de registro DGI de la factura original y usarlo en DocumentoReferencia. Algunos PACs ofrecen migración del historial de documentos al cambiar de proveedor.

¿Qué diferencia hay entre MotivoAjuste "01" y "02" en la NCE?

MotivoAjuste 01 (devolución de bienes) implica que el producto fue físicamente retornado al emisor. MotivoAjuste 02 (descuento comercial) indica que el bien o servicio no fue devuelto, pero el precio se redujo por acuerdo comercial. Ambos tienen el mismo tratamiento fiscal en el SFEP, pero el DGI puede usarlos para auditorías de inventario.

¿Es posible emitir una NCE sobre una factura que ya tiene una NCE previa aplicada?

Sí, siempre que el saldo ajustado acumulado no supere el monto original de la factura. El DGI valida que la suma de todas las NCEs emitidas sobre una misma factura no exceda el total de esa factura. Si se intenta emitir una NCE que supere el saldo disponible, el PAC rechaza con error E-073 (monto acumulado de notas de crédito supera el monto de la factura).

---

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.