Skip to main content
KSeF is Poland’s national e-invoicing system. Hyperline’s integration uses Invopop to send invoices and credit notes in FA(3) XML format for business and government customers.

​
Supported invoices

The issuing entity must be based in Poland and have a Polish tax ID (NIP). Complete the customer’s billing address and provide their tax ID when applicable. A domestic 0% VAT rate is not the same as VAT exemption. Do not change the tax treatment of an invoice to bypass a validation error.

​
Register your invoicing entity

  1. Open Settings > Invoicing and select your Polish invoicing entity.
  2. Check its company name, billing address, NIP, and contact details.
  3. Enable e-invoicing with KSeF and save your changes.
  4. Follow the registration link shown in Hyperline to complete sender registration.
  5. In production, follow the registration wizard to provide your KSeF authentication certificate, matching private key, and password. See Invopop’s supplier registration guide for the certificate steps.
  6. Wait until the registration status is Registered before transmitting invoices.
Registration is separate for test and production accounts. See Sandbox and test mode when preparing test invoices.

​
Track transmission and download the PDF

Once your entity is registered and transmission is enabled, Hyperline automatically submits eligible finalized invoices. Follow the e-invoicing status on the invoice details page. Hyperline preserves your invoice number, and KSeF assigns a separate reference. When Invopop returns the KSeF number and verification link, Hyperline refreshes the stored invoice PDF. The verification QR code appears at the bottom, with the KSeF number below it. If only the number is available, the PDF displays that reference without a QR code. Download the refreshed PDF after transmission completes. A previously downloaded copy does not update. Hyperline also retains the acquisition date returned by KSeF with the transmission result. This is separate from your invoice’s issue date and does not change it.

​
Credit notes

For a credit note linked to an invoice transmitted through KSeF, Hyperline includes the original invoice’s KSeF number. If the original transmission is still processing or has not returned that number, Hyperline blocks the credit note’s KSeF transmission until the reference is available.

​
KSeF unavailability and failed transmissions

This integration supports online transmission. It does not implement offline24 issuance or the additional certificate verification QR code required for offline flows. If KSeF is unavailable, check the invoice’s transmission status and error. A processing or failed transmission does not confirm KSeF acceptance. Resolve the reported issue before retrying. If you cannot determine whether KSeF received the invoice, contact the team through the in-app chat. Mark as transmitted only records a transmission performed outside Hyperline. It does not send the invoice to KSeF, retrieve its KSeF number, or generate a verification QR code. See Mark as transmitted. For general retry guidance, see Troubleshoot accounting and e-invoicing sync errors.