SfepAnular

Descripción

Anula una Factura Electrónica previamente autorizada por la DGI de Panamá, identificándola por su CUFE. El nodo envía la solicitud de anulación al PAC configurado en la credencial y, si es aceptada, actualiza el estado del documento a cancelled en la base de datos de Floogos.

La anulación requiere obligatoriamente un motivo (mínimo 5 caracteres), que queda registrado en el historial local del documento.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SFEP
cufe	text	Sí	CUFE del FE a anular
motivo	textarea	Sí	Motivo de la anulación

Credenciales

Este módulo requiere una credencial de tipo sfep (datos del PAC, token, entorno, etc. según metadata).

Salida

{
  "cufe": "FE0120000000000001000012320260805...",
  "estado": "cancelled",
  "motivo": "Error en el RUC del receptor"
}

Ejemplo de Uso

{
  "credentials_id": "cred-sfep-prod",
  "cufe": "FE0120000000000001000012320260805...",
  "motivo": "Error en el RUC del receptor"
}

Notas

• El motivo debe tener al menos 5 caracteres; si no se envía, el nodo corta la ejecución antes de contactar al PAC.
• No todos los adaptadores de PAC soportan anulación; si el proveedor configurado en la credencial no la implementa, el nodo devuelve error indicándolo.
• Una vez anulada, la FE queda marcada como cancelled en la tabla sfep_documents y ya no debería usarse como referencia para notas de crédito/débito.
• La DGI establece plazos para poder anular una FE; pasado ese plazo el PAC rechazará la anulación.

Nodos Relacionados

• SfepEmitirFactura - Emitir la factura a anular
• SfepEmitirNota - Emitir una nota de crédito/débito
• SfepRepresentación - Generar la representación impresa (CAFE) con QR