> ## 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

> Activate 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) at issuance 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.

> [!NOTE]
>
> 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).

## Prerequisities

To activate KSeF 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).

![Location billing details form for Poland showing fields for legal business name, address, tax ID, and contact
email](https://mintcdn.com/spacebring/1si1BHI1uQtbcXFE/images/billing-einvoicing-ksef-1.png?fit=max\&auto=format\&n=1si1BHI1uQtbcXFE\&q=85\&s=a7095719658c72f25d8f88353a4180df)

3. Go to **Location settings** > **Billing** page > [**Taxes** tab.](https://www.spacebring.com/docs/billing/taxes.md)
   * In the **Tax rate** field, enter a tax rate valid in Poland.
   * If you use [custom tax rates](https://www.spacebring.com/docs/billing/taxes.md#custom-tax-rates-for-different-products) in individual customers' subscriptions or invoices, ensure they are also valid Polish tax rates. Otherwise, the invoice will fail to sync with KSeF.
   * For a customer outside Poland, use a 0% tax rate: the invoice is reported to KSeF as reverse charge for a business in the EU, and as outside the scope of Polish VAT for a customer elsewhere.
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](https://www.spacebring.com/docs/billing/currencies.md) and apply it to all customer profiles for whom you want to generate eInvoices.

> [!NOTE]
>
> An invoice issued in another currency is submitted with the National Bank of Poland exchange rate of the business day before the issue
> date, and its VAT is also stated in PLN.

### Complete customer billing details

Each customer must also have accurate billing details.

1. Go to **Location settings > Customers** and manage the [billing details settings](https://www.spacebring.com/docs/customer-management/billing-details.md) depending on your needs:

   * Set the company billing details fields to **Required**.
   * Set the user billing details fields to **Required** too, if you need to generate eInvoices for individual users.

   If a billing details field is set to **Required** 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.

![Company billing details and User billing details fields set to Required, Optional, or Hidden in Location settings on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/JPWAnlu6LQM7DEh4/images/customer-management-billing-details-1.png?fit=max\&auto=format\&n=JPWAnlu6LQM7DEh4\&q=85\&s=9140f6d1045b7646ac95732966318fe2)

2. To review or update customer details manually:
   * Go to the **Customers** page > open each customer profile > locate [**Billing details**](https://www.spacebring.com/docs/customer-management/billing-details.md) [section](https://www.spacebring.com/docs/customer-management/billing-details.md) 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**.](https://www.spacebring.com/docs/customer-management/billing-details.md)

#### 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.

## Activate KSeF eInvoicing

Spacebring submits your invoices to KSeF with a KSeF token issued for your location's tax ID.

1. Generate a token in the [KSeF application](https://ksef.podatki.gov.pl/) for your location's tax ID, with the permissions to issue and read invoices.
   * Copy the token when it is shown. KSeF shows it only once.
2. In Spacebring, go to **Location settings** > **Billing** > **Invoices** tab.
3. Enable the **eInvoicing** switch.
4. In the **KSeF registration** section, paste the token in the **KSeF token** field and click **Connect**.
   * Spacebring signs in to KSeF with the token right away. If KSeF rejects it, check that the token was generated for the tax ID in your billing details and has the permissions to issue and read invoices.
   * Once connected, the token isn't shown again. To use another token, click **Disconnect**, then paste the new one and click **Connect**.

### Change your location's tax ID

A KSeF token is issued for one tax ID. If you change your location's tax ID, the KSeF connection becomes invalid and invoices aren't submitted to KSeF until you connect a token for the new tax ID.

1. Generate a new token in the [KSeF application](https://ksef.podatki.gov.pl/) for the new tax ID.
2. In the **KSeF registration** section, paste the new token and click **Connect**.

To stop using KSeF without connecting a new token, click **Disconnect**.

> [!NOTE]
>
> Spacebring stores the token encrypted and uses it only to submit and read your location's invoices. If the connection fails later, for example after the token is revoked in KSeF, administrators with the [**Integrations > Failures**](https://www.spacebring.com/docs/account/notifications.md) notification enabled are notified on the **Inbox** page, by push, and by email.

## How KSeF eInvoicing works

After KSeF eInvoicing is activated:

* All invoices for customers with valid billing details are automatically generated in the KSeF-compliant eInvoice format.
* During issuance, invoices are validated and submitted to KSeF. An invoice that fails validation or that KSeF refuses isn't issued.
* KSeF assigns a unique KSeF identifier to each submitted invoice, usually within a minute or two, and the customer receives the invoice once it does.
* 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.

![Sample PDF invoice with a KSeF QR code and KSeF identifier that customers can use to verify the invoice in KSeF](https://mintcdn.com/spacebring/1si1BHI1uQtbcXFE/images/billing-einvoicing-ksef-how-einvoicing-works.png?fit=max\&auto=format\&n=1si1BHI1uQtbcXFE\&q=85\&s=0b59db4c6ec31ac1d9622466cdea2649)

* Credit notes are also submitted to KSeF if their original invoice was successfully synced. A credit note that KSeF rejects isn't created, so you can fix the issue and create it again. A credit note created automatically for a refund is created anyway with the "eInvoice sync failed" status, and administrators are notified.
* When KSeF eInvoicing is active, voiding invoices and credit notes is not supported, because KSeF does not allow it. Instead, you can:
  * [Issue a credit note](https://www.spacebring.com/docs/billing/invoices/credit-notes.md) 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.

![Invoice list showing eInvoice sync status indicators next to each invoice](https://mintcdn.com/spacebring/UR6_03lSO7Mm1pGF/images/billing-einvoicing-peppol-4.png?fit=max\&auto=format\&n=UR6_03lSO7Mm1pGF\&q=85\&s=02b98bb9839b47f4a6fcf2c56106432b)

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.
  * A notification to administrators with the [**Integrations > Failures**](https://www.spacebring.com/docs/account/notifications.md) notification enabled, on the **Inbox** page, by push, and by email.

![Invoice list showing a red warning triangle and eInvoice sync failed status next to a customer with incomplete billing
details](https://mintcdn.com/spacebring/UR6_03lSO7Mm1pGF/images/billing-einvoicing-peppol-5.png?fit=max\&auto=format\&n=UR6_03lSO7Mm1pGF\&q=85\&s=af86919c3d151d39ee774c18ddcc2cf4)

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

In rare cases, KSeF rejects an invoice after it was issued. The invoice then shows the same "eInvoice sync failed" status, and administrators are notified.

You can also see the eInvoice sync status for all invoices in the [invoices report](https://www.spacebring.com/docs/billing/invoices/track-and-manage.md#export-an-invoices-report).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.