SfepEmitirNota

Descripción

Emite una Nota de Crédito (04) o una Nota de Débito (05) a la DGI de Panamá bajo el modelo SFEP, referenciando siempre a la Factura Electrónica de origen mediante su CUFE. El nodo arma el XML de la nota, opcionalmente lo firma si hay un certificado propio cargado en la credencial, y lo envía al PAC configurado para que la autorice.

Al igual que con las facturas, si no hay certificado propio es el PAC quien firma el documento. La nota autorizada recibe su propio CUFE, distinto al de la FE referenciada.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SFEP
nota	json	No	Nota (JSON): tipo (04 crédito, 05 débito), referencia `{cufe, numero, fecha}` del FE de origen, receptor, items (precioUnitario sin ITBMS). Si se omite, se toma del `data` de entrada

Credenciales

Este módulo requiere una credencial de tipo sfep (RUC y razón social del emisor, proveedor del PAC, token/usuario del PAC, certificado .p12 opcional, ambiente).

Salida

{
  "numero": "0000045",
  "puntoFacturacion": "001",
  "tipo": "04",
  "estado": "authorized",
  "cufe": "FE0120000000000001000045320260805...",
  "cafeUrl": "https://pac.example.pa/cafe/FE01200000...",
  "qrUrl": "https://pac.example.pa/qr/FE01200000...",
  "cufeReferencia": "FE0120000000000001000012320260805...",
  "total": 1120.5,
  "itbms": 70.5
}

Ejemplo de Uso

{
  "credentials_id": "cred-sfep-prod",
  "nota": {
    "tipo": "04",
    "referencia": {
      "cufe": "FE0120000000000001000012320260805..."
    },
    "receptor": {
      "ruc": "8-888-8888",
      "dv": "77",
      "nombre": "Consumidor Final"
    },
    "items": [
      {
        "descripcion": "Devolución de servicio",
        "cantidad": 1,
        "precioUnitario": 1050,
        "tasaItbms": "01"
      }
    ]
  }
}

Notas

Si nota no se envía en la configuración, el nodo toma el objeto completo recibido en data como nota.
El nodo rechaza el envío si tipo no es 04 o 05, si items está vacío, o si no se indica referencia.cufe (o numeroDocumento) del FE de origen.
El cufe devuelto identifica a la nota, no a la FE referenciada: guardalo aparte si necesitás anular o representar la nota más adelante.
El ITBMS se calcula al 7%, igual que en la factura de origen.

Nodos Relacionados

SfepEmitirFactura - Emitir la factura de origen
SfepAnular - Anular una FE o nota ya autorizada
SfepRepresentación - Generar la representación impresa (CAFE) con QR