El hook outbound KSeF automatiza el registro de facturas salientes en el Krajowy System e-Faktur (KSeF), el sistema nacional de facturación electrónica polaco. Las facturas se transforman del formato Peppol BIS Billing 3.0 al formato polaco FA(3) y se registran como lote. Tras el procesamiento correcto, el hook devuelve el UPO (Urzędowe Poswiadczenie Odbioru, el acuse de recibo oficial) y una prueba en PDF a través de la plataforma PSB.

El hook admite tanto un flujo en línea (registro directo) como un flujo fuera de línea (cuando KSeF no está disponible temporalmente, por ejemplo, durante el corte diario). En el flujo fuera de línea se genera un PDF fuera de línea basado en el certificado fuera de línea.

• Un certificado en línea válido para KSeF
• Un certificado fuera de línea válido para KSeF
• Las contraseñas correspondientes de ambos certificados
• El hook debe estar activado en la configuración

Tras recibir una notificación de factura, el hook pasa por siete pasos:

Cuando KSeF no está disponible (corte diario o avería), el flujo fuera de línea se inicia automáticamente: se genera un PDF fuera de línea mediante el certificado fuera de línea, tras lo cual la factura se envía por el canal regular.

Registre el hook a través de la API de Hooks:

{
  "id": "ksef-sender",
  "action": "ksef",
  "name": "KSeF Hook Sender",
  "topics": [
    "ClearInvoiceBatched"
  ],
  "output": [
    {
      "when": "200",
      "topic": "SendInvoice"
    },
    {
      "when": "410",
      "topic": "SendInvoice"
    }
  ],
  "init": {
    "onlineCertificate": "{{ruta-al-certificado-en-linea}}",
    "onlineCertificatePassword": "{{contraseña}}",
    "offlineCertificate": "{{ruta-al-certificado-fuera-de-linea}}",
    "offlineCertificatePassword": "{{contraseña}}"
  },
  "isActive": true
}

Importante: Los cuatro campos de certificado son obligatorios. El certificado en línea es necesario para la autenticación durante el flujo en línea. El certificado fuera de línea es necesario para la generación de códigos QR en el PDF, tanto en el procesamiento en línea como fuera de línea.

Con el código de estado 410, la PSB inicia automáticamente el flujo fuera de línea. La factura se procesa entonces localmente con el certificado fuera de línea y se envía cuando KSeF vuelve a estar disponible. Con 429, la PSB programa un reintento automático.

KSeF tiene un periodo de corte diario durante el cual el sistema no está disponible para el registro en lotes. La PSB lo detecta automáticamente (código de estado 410) y cambia al flujo fuera de línea:

• En línea: la factura se registra directamente en KSeF, se recupera el UPO y se genera un PDF con códigos QR
• Fuera de línea: la factura se procesa localmente, se genera un PDF fuera de línea con códigos QR mediante el certificado fuera de línea, y la factura se envía por el canal regular

Tras el regreso de KSeF, las facturas procesadas fuera de línea se registran igualmente y la factura recibe el código de estado 201 (InvoiceCleared).

¿Desea saber más sobre la facturación electrónica en Polonia? Consulte la página del país sobre la obligación KSeF polaca.