POP icon

POP

Interact with POP Cloud API (v2) for e-invoicing (SdI and Peppol)

Actions9

Invoice → Create KSeF Invoice (FA(3) XML)

AI-generated

Summary

Builds a POP API request to create a Polish KSeF FA(3) invoice or credit note, optionally adding the integration instruction to submit it through POP’s KSeF provider. Sends the request with POST to the configured endpoint path in the selected input mode.

Inputs

  • Environment and endpoint — Environment defaults to Production; endpoint path defaults to create-ksef-xml. Both can be configured.
  • Submit via KSeF Provider — Defaults to No. Yes adds integration: { "use": "ksef-via-pop", "action": "create" } to passthrough, form, or JSON request bodies.
  • Input Mode — Choose Use Incoming JSON to send the current input item’s JSON, Form Fields to construct the POP KSeF payload, JSON to provide a complete request body, or Raw to send a string body.
  • Form Fields — Available only in Form Fields mode. Includes required invoice/order ID, filename, customer type, invoice number, date, and total amount, plus transmitter, sender, recipient, invoice details, line items, payment, bank, and optional advanced fields. Bank beneficiary, financial institution, and IBAN are required when Bank Transfer is selected. A discount percent is required for each discounted line item.
  • License Key — In Form Fields mode, an optional key is sent as X-API-Key; the form payload also includes license_key. If omitted, the configured POP API credential can be used.
  • Target Environment — In Form Fields mode, optionally select Live or Sandbox; leaving it at Default omits the environment from the payload.
  • JSON Body — In JSON mode, provide the complete POP API KSeF request body. If Submit via KSeF Provider is Yes, the handler adds or replaces its integration property.
  • Raw Body — In Raw mode, sends this string as the request body and defaults Content-Type to application/xml unless overridden.
  • Extra Headers — Optional JSON object of request headers, usable in every mode.

Output shape

A single POP API response object per input item, wrapped as n8n output JSON.

The request is POSTed to POP’s configured API environment and endpoint. In passthrough mode it sends the current input item’s JSON; in Form Fields mode it builds the request payload from the supplied invoice details. Raw mode sends a string body. Request failures are surfaced as node API errors unless Continue On Fail is enabled.

Links

Discussion