Monitor KSeF – User Guide

1. What is Monitor KSeF?

Monitor KSeF is an iPhone application that lets you browse invoices from the National e-Invoicing System (KSeF) operated by the Polish Ministry of Finance.

What the application can do

• Connects directly to the official KSeF system of the Ministry of Finance.
• Retrieves and displays invoices associated with your NIP (Polish Tax Identification Number).
• Plus: export to PDF and download of original XML files.

What the application does not do

• Does not issue invoices – it is a read-only viewer.
• Does not modify or delete invoices in KSeF.
• Does not send your data to external servers – everything stays on your device.
• Is not an official product of the Ministry of Finance.

What you need

• An iPhone with iOS 17.0 or later.
• A NIP (10 digits).
• A KSeF authorisation token (section 4).

2. First launch and PIN setup

On first launch the application will ask you to create a PIN code (4–6 digits). The PIN protects access to the application and your tax data.

1. Enter a PIN (4–6 digits).
2. Re-enter the PIN to confirm.

Changing the PIN

1. Configuration → Security.
2. Select "Change app PIN."
3. Enter your current PIN and set a new one.

3. Unlocking the application

The application requires unlocking on launch and after returning from the background.

Unlocking with a PIN code

1. Enter the PIN on the numeric keypad.
2. The application unlocks automatically after a correct entry.

Unlocking with Face ID / Touch ID

You can enable biometrics in Configuration → Security.

Incorrect PIN and lockout

4. Configuring the KSeF connection

To retrieve invoices, provide your NIP and KSeF token.

What is a KSeF token?

A KSeF token is a key confirming that you are authorised to view invoices associated with a given NIP. The token is issued by the Ministry of Finance.

How to obtain a KSeF token

1. Go to podatki.gov.pl and log in.
2. Navigate to: KSeF → Token management.
3. Generate a token with read-only permissions ("Faktura Odczyt / Invoice Read").
4. Copy the generated token (it is displayed only once).

Entering credentials in the application

1. Configuration → Access credentials.
2. Enter your NIP (10 digits).
3. Paste the token into the appropriate field (you can use the eye icon to verify it).
4. Tap "Save."

The application connects to the production KSeF server at api.ksef.mf.gov.pl.

Query settings

You can choose roles (e.g. Buyer, Seller) and date type (issuance, acceptance, permanent record).

5. Browsing invoices

1. Invoices tab.
2. Set the date range (defaults to the current day).
3. Tap "Check invoices."

The application can automatically check for invoices from the current day on unlock (once per day).

6. Invoice details (Monitor KSeF Plus)

Viewing invoice details requires an active Monitor KSeF Plus subscription.

• Header: number, document type, dates.
• Parties: seller and buyer.
• Amounts: net/gross/VAT.
• Invoice line items.
• XML preview (FA(3)).

7. Exporting invoices to PDF and XML (Plus)

Export uses the standard iOS Share Sheet. Files are created temporarily.

8. Monitor KSeF Plus – subscription

Purchase and restore

• Purchases are processed by Apple.
• After reinstallation: Info → "Restore Purchases."
• Management: iOS Settings → Subscriptions.

9. Settings and personalisation

The Configuration tab includes access credentials, query settings, theme/icon, security and data clearing options.

10. Security of your data

• NIP, token and PIN are stored in encrypted system storage (Keychain).
• Invoices are processed temporarily in RAM and are not written to disk.
• No proprietary servers; the only server is the KSeF API.
• Encrypted connections (TLS 1.2+), plus certificate pinning.
• Screen content masked in the app switcher.
• Diagnostic logs redact sensitive data.

11. Communication logs (diagnostics)

Logs can help diagnose connection issues. You can export them from the Info tab (e.g. via email to support).

12. Frequently asked questions and troubleshooting

Invalid configuration

• Check that the NIP is 10 digits.
• Make sure the token is complete and has not expired.

No invoices found

• Check the date range (defaults to the current day).
• Verify the role (Buyer/Seller) and date type.

Forgotten PIN

The PIN is irreversible – reinstallation of the application and reconfiguration are required.

13. Legal information and contact

Developer: KrzewiLabs

E-mail: kontakt@krzewilabs.pl

Privacy Policy: privacy-policy.html

Application Terms of Use: terms-ios.html

Monitor KSeF is not an official product of the public administration and is not affiliated with the Ministry of Finance or the National Revenue Administration (KAS).