SfepEmitirFactura

Descripción

Emite una Factura Electrónica (FE) a la DGI de Panamá bajo el modelo SFEP (Sistema de Factura Electrónica de Panamá): Operación Interna (01), Importación (02) o Exportación (03). El nodo arma el XML de la FE con los datos del emisor (tomados de la credencial) y del receptor, opcionalmente lo firma si hay un certificado propio cargado, y lo envía al PAC (Proveedor Autorizado de Certificación, por ejemplo The Factory HKA) configurado en la credencial.

Si no hay certificado propio, es el PAC quien firma el documento como parte del servicio de autorización. Una vez autorizada, la FE queda identificada por su CUFE (Código Único de Factura Electrónica) y el PAC entrega también el CAFE (representación gráfica) y la URL del QR. El ITBMS se calcula al 7%.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SFEP
factura	json	No	Factura (JSON): tipo (01/02/03), receptor (ruc, dv, nombre — omitir para consumidor final), items (precioUnitario sin ITBMS, tasaItbms 01=7%). Si se omite, se toma del data de entrada

Credenciales

Este módulo requiere una credencial de tipo sfep con los siguientes campos:

• RUC del emisor y razón social: identifican al contribuyente que emite la FE.
• Proveedor del PAC: por ejemplo thefactoryhka u otro adaptador genérico (que además requiere la URL del PAC).
• Token o usuario del PAC: credenciales de acceso al servicio de autorización.
• Certificado (.p12) (opcional): si se carga, la FE se firma localmente antes de enviarla; si no, firma el PAC.
• Ambiente: test o producción.

Salida

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

Ejemplo de Uso

{
  "credentials_id": "cred-sfep-prod",
  "factura": {
    "tipo": "01",
    "receptor": {
      "ruc": "8-888-8888",
      "dv": "77",
      "nombre": "Consumidor Final"
    },
    "items": [
      {
        "descripcion": "Servicio de automatización",
        "cantidad": 1,
        "precioUnitario": 1050,
        "tasaItbms": "01"
      }
    ]
  }
}

Notas

• Si factura no se envía en la configuración, el nodo toma el objeto completo recibido en data como factura.
• El nodo rechaza el envío si tipo no es 01, 02 o 03, o si items está vacío.
• Para consumidor final, se puede omitir el objeto receptor.
• El cufe devuelto es el que hay que guardar para emitir notas de crédito/débito, anular la FE o generar su representación (CAFE/QR).

Nodos Relacionados

• SfepEmitirNota - Emitir nota de crédito/débito referenciando esta factura
• SfepAnular - Anular una FE ya autorizada
• SfepRepresentación - Generar la representación impresa (CAFE) con QR