> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# KSeF in Poland

> Enable KSeF eInvoicing for Poland to generate invoices in a mandatory structured format and automatically sync them to KSeF

Spacebring supports eInvoicing via KSeF for Poland and helps you stay compliant by:

* Automatically generating eInvoices and credit notes in Poland's mandatory FA(3) structured format
* Submitting invoices to Krajowy System e-Faktur (KSeF) in real time for validation and receiving a unique KSeF identifier
* Automatically validating Tax IDs to improve reconciliation and tracking the synchronization status with KSeF
* Adding QR codes and KSeF identifiers to the PDF invoices sent to customers, allowing them to verify invoices directly in KSeF.

<Info>
  This feature is currently in beta. Its functionality and appearance are subject to change, and it may not be fully stable. We welcome your feedback at [support@spacebring.com](mailto:support@spacebring.com).
</Info>

## Prerequisities

To enable eInvoicing, ensure the following requirements are completed:

### Complete location billing details

Your location billing details, tax, and currency must be complete and accurate.

1. Go to **Location settings** > **General** page > "Billing details" tab.
2. Fill in your location's billing details.
   * Legal business name
   * Address (Country (Poland), Address line 1, City, and Postal code are mandatory)
   * Tax ID
   * Contact details (Email is mandatory).

<Frame>
  <img src="https://mintcdn.com/spacebring/UR6_03lSO7Mm1pGF/images/billing-einvoicing-ksef-1.png?fit=max&auto=format&n=UR6_03lSO7Mm1pGF&q=85&s=78cbe1f6494001388c423c00916f604d" alt="Location billing details form for Poland showing fields for legal business name, address, tax ID, and contact email" width="1594" height="835" data-path="images/billing-einvoicing-ksef-1.png" />
</Frame>

3. Go to **Location settings** > **Billing** page > ["Taxes" tab.](/billing/taxes)
   * In the "Tax rate" field, enter a tax rate valid in Poland.
   * If you use [custom tax rates](/billing/taxes/custom-tax-rates) in individual customers' subscriptions or invoices, ensure they are also valid Polish tax rates. Otherwise, the invoice will fail to sync with KSeF.
4. Go to **Location settings** > **Billing** page > "Currencies" tab.
   * Make sure your main location currency is set as PLN, Polish Zloty.
   * If your primary location currency is different, [add PLN Polish Zloty as an alternative currency](/billing/currencies) and apply it to all customer profiles for whom you want to generate eInvoices.

<Info>
  Only invoices issued in PLN can be synced to KSeF.
</Info>

### Complete customer billing details

Each customer must also have accurate billing details.

1. Go to **Location settings > Customers** and manage the ["Require billing details"](/customer-management/billing-details) setting depending on your needs:
   * Enable this requirement for both individual users and companies
   * Or only for companies, if you need to generate eInvoices only for companies.
     If "Require billing details" is enabled for a customer type:
   * New customers will be prompted to fill out their billing details at the first payment.
   * Existing customers missing billing details will be prompted to update their details during their next payment.
2. To review or update customer details manually:
   * Go to the **Customers** page > open each customer profile > locate [**Billing details**](/customer-management/billing-details) [section](/customer-management/billing-details) on the right side panel. Fill in any missing billing details as an administrator.
   * Alternatively, ask customers to update billing details on their own under [**Membership > Billing**.](/customer-management/billing-details)

#### Requirements for companies

For companies, complete billing details are required for eInvoices to be generated and synced.

If a certain company's billing details are incomplete or invalid, invoices for that company will remain in "Draft" status with a warning and cannot be issued.

#### Requirements for individual users

For individual members, only fill in billing details if you want their invoices to be generated as eInvoices and synced to KSeF as well.

* If you do not want to generate eInvoices for individual members, leave their billing details, especially the "Legal business name" and "Tax ID", empty.
* If at least one of these fields is filled for an individual member, Spacebring will attempt to sync their invoices as eInvoices to KSeF.

## Enable eInvoicing

1. Go to **Location settings > Billing >** "Invoices" tab.
2. Enable the "eInvoicing" switch.
3. In the "KSeF registration" section, click `Start verification process`.
4. Follow the instructions in the registration form to generate and upload your KSeF certificate.
5. Your KSeF certificate will be submitted for verification.
   * Verification may take a few business days. You can monitor it using the `Track verification status`.
   * If prompted, click `Restart verification` to update your certificate or take any required actions.

<Frame>
  <img src="https://mintcdn.com/spacebring/UR6_03lSO7Mm1pGF/images/billing-einvoicing-ksef-2.png?fit=max&auto=format&n=UR6_03lSO7Mm1pGF&q=85&s=e93627389b4f85227776cad57314e92d" alt="KSeF registration section in Location settings showing the Start verification process button and verification status tracker" width="1359" height="559" data-path="images/billing-einvoicing-ksef-2.png" />
</Frame>

## How eInvoicing works

After eInvoicing is enabled:

* All invoices for customers with valid billing details are automatically generated in the KSeF-compliant eInvoice format.
* During issuance, invoices are also submitted to KSeF for validation and assigning a unique KSeF identifier in real time.
* In parallel, customers receive the standard human-readable PDF invoice, which includes a QR code and KSeF ID allowing them to verify their invoice directly against KSeF.

<Frame>
  <img src="https://mintcdn.com/spacebring/TaO7ez5_73tcFYXb/images/billing-einvoicing-ksef-how-einvoicing-works.png?fit=max&auto=format&n=TaO7ez5_73tcFYXb&q=85&s=113076e03d1ec3bb87e0219c30a7c67d" alt="Billing Einvoicing Ksef How Einvoicing Works" width="670" height="636" data-path="images/billing-einvoicing-ksef-how-einvoicing-works.png" />
</Frame>

* Credit notes are also submitted to KSeF if their original invoice was successfully synced.
* When eInvoicing is enabled, voiding invoices and credit notes is not supported, because this is not allowed in KSeF. Instead, you can:
  * [Issue a credit note](/billing/invoicing/credit-notes) to correct the invoice
  * If necessary, issue a credit note for the full invoice amount to void it.

### Track eInvoice syncing

Each invoice has the eInvoice sync status indicated.

<Frame>
  <img src="https://mintcdn.com/spacebring/UR6_03lSO7Mm1pGF/images/billing-einvoicing-ksef-4.png?fit=max&auto=format&n=UR6_03lSO7Mm1pGF&q=85&s=c87fa0a813ea555ab4160bf8edaf2db5" alt="Invoice list showing eInvoice sync status indicators next to each invoice" width="1323" height="612" data-path="images/billing-einvoicing-ksef-4.png" />
</Frame>

If an eInvoice fails to sync (for example, due to invalid or missing customer billing details):

* The invoice will not be issued.
* The system will display:
  * "eInvoice sync failed" status
  * A red warning triangle next to the affected invoice
  * A red warning triangle next to the customer's name on the **Customers** page.

<Frame>
  <img src="https://mintcdn.com/spacebring/UR6_03lSO7Mm1pGF/images/billing-einvoicing-ksef-5.png?fit=max&auto=format&n=UR6_03lSO7Mm1pGF&q=85&s=d66c8f8de21df1bd670b73e986a7bcb9" alt="Invoice list showing a red warning triangle and eInvoice sync failed status next to a customer with incomplete billing details" width="1594" height="789" data-path="images/billing-einvoicing-ksef-5.png" />
</Frame>

If prompted, update the customer's billing details or complete any required actions, and click `Issue` again.

You can also see the eInvoice sync status for all invoices in the ["Invoices" report](/analytics/create-custom-reports).
