KSeFGPT
Get started for free
Analytics

How to prepare and download a KPiR report

Order the current-month report, review document classifications, and download the finished XLSX file.

Module
Analytics
Reading time
6 min
Difficulty
Published
August 24, 2026
Author
Rafał Zeidler
Format
Written guide and video

Written procedure

What you will do

You will prepare a KPiR report for the current month and year-to-date data. You will review the income, costs, profit, VAT, and income tax advance summaries.

You will open expense line classifications, change a KPiR column if needed, and download kpir_2026_8.xlsx. The year and month in the file name depend on when the report is prepared.

Requirements

Before you start

KSeFGPT creates the report for the current calendar month. This view does not let you select an earlier month or a custom date range.

ItemDescription
AccessThe company owner or an organization member with analytics:read.
PlanA KSeFGPT plan that includes Analytics.
CompanyThe selected company has an active KSeF token or certificate.
Starting pointAfter signing in, select the correct company and open Analytics.
Time requiredAbout 3 minutes plus report generation time.
Effect of a changeSaving a classification correction immediately updates the current report values.

Process recording

PT27.16S

The recording shows ordering a KPiR report, reviewing and changing an expense classification, and downloading the XLSX file.

How to prepare and download a KPiR report - video guide
01Step

Open KPiR and choose an authentication method

Select Analytics in the side menu, then open KPiR. In the top right, choose Token or Certificate.

The list contains only methods configured for the active company. If no report has been prepared this month, you will see No KPiR report.

Step 1
KPiR in Analytics with Certificate selected and a No KPiR report message
02Step

Order the report

Select Order KPiR report. KSeFGPT starts fetching and classifying documents for the current month and year to date.

Generating report appears on the screen. The process may take a few minutes. You can stay on the page or return later.

Step 2
KPiR screen showing Generating report and document classification progress
03Step

Review the report summary

When generation is complete, review KPiR summary. Current shows values for the current month, while Year to date shows cumulative values.

The Profit row shows the difference between total income and costs. The monthly breakdown, VAT summary, and income tax advances appear below.

Month names and KPiR row labels currently come from the API in Polish, so they can remain Polish in the EN, DE, and UK interfaces.

Step 3
Completed KPiR report for August 2026 with current and year-to-date values
04Step

Review line-item classifications

Select column 7, 10, 11, 12, or 13 to open the items assigned to it. The example uses 13 Pozostałe wydatki.

For each item, you can see the invoice number, seller, name, net amount, AI reasoning, and current KPiR column. Automatic fallback identifies a fallback result that needs particular attention.

Step 4
Invoice classifications panel for column 13 with a demonstration Office supplies item and AI reasoning
05Step

Correct the classification if needed

If an item is in the wrong column, open KPiR column and select the correct option. For an expense, you can choose column 10, 11, 12, or 13.

Select Save changes. The panel closes and the amount moves between report columns. Total costs and profit do not change when you move a cost between two expense columns.

Step 5
KPiR report after moving PLN 1,650 from Other expenses to Purchase of goods
06Step

Download the XLSX file

After reviewing the report, select Download XLS in the top right. The browser saves a workbook containing the current report version.

The file is named kpir_YYYY_M.xlsx. For August 2026, it is kpir_2026_8.xlsx.

Step 6
Completed KPiR report with the Download XLS button visible

Final state

Check the result

KPiR shows the current-month report, year-to-date values, and corrected column assignments. Your browser download folder contains kpir_2026_8.xlsx or a file with the corresponding current year and month.

You can also confirm a classification change by opening the original row again. The item no longer appears in its previous column.

Diagnostics

If something does not work

Compare the symptom with the table below.

SymptomLikely causeWhat to do
Analytics is unavailableThe company plan does not include Analytics or analytics:read is missing.Check the plan or ask the organization owner for analytics access.
You are asked to select a companyNo company is selected in the current session.Use the company selector in the bottom left and open KPiR again.
The application requires a KSeF connectionThe company has no active token or certificate.Add KSeF credentials in Settings and return to Analytics.
The report is still generatingDocument fetching and classification have not finished.Wait. The view checks the status about every 15 seconds, and you can also return later.
Generation failedThe KPiR job could not fetch or process the data.Read the message and select Order KPiR report again.
Save changes is disabledNo item's column has been changed.Choose a different KPiR column or close the panel without saving.
No file was downloadedThe report is no longer available or the download failed.Refresh KPiR, confirm that the report is ready, and select Download XLS again.

What next

Keep the downloaded workbook with your accounting records and pass it to the person responsible for settlements.

If you only need a quick comparison of gross totals and invoices for a selected month, follow the instruction for checking income and expenses in Summary.

Prepare a KPiR report in KSeFGPT

Sign in, review document classifications, and download the finished workbook.

Sign in to KSeFGPT

Related instructions