Skip to main content

Submission Status & UPO

The Submission Status view allows you to monitor the processing status of invoices sent to KSeF and download the UPO (Official Receipt Confirmation) for successfully processed invoices.

Accessing the View​

Navigate to the Submission Status page via the side menu. The page consists of two main sections:

  1. Check Submission Status β€” query KSeF regarding the status of a specific submission.
  2. Download UPO β€” download the official confirmation for a processed invoice.

Checking Submission Status​

To check the status of an invoice submission:

  1. Enter the Reference Number β€” this is the session reference number returned during the invoice submission.
  2. Select the submission Type:
    • Online β€” for single invoices sent directly.
    • Batch β€” for batches of offline invoices.
  3. Click Check Status.

The response includes:

  • Processing Code β€” indicates whether KSeF has finished processing (200 = completed).
  • Processing Description β€” a human-readable status message.
  • Invoice List β€” all invoices in the session, including KSeF numbers, original invoice numbers, and acceptance timestamps.
Why might the invoice list be empty?

If the processing code is not yet 200, KSeF is still processing the submission. Please try again after a short while.

Downloading UPO​

Once an invoice is processed, you can download its UPO:

  1. Enter the Session Reference Number and the Invoice KSeF Number.
  2. Select the document format:
    • XML β€” the official UPO in XML format.
    • PDF β€” a printable version of the UPO in PDF format.
  3. Click Download.

The UPO file will be downloaded to your device.

What is a UPO?

UPO (Official Receipt Confirmation) is the formal acknowledgement from KSeF that an invoice has been received and registered. It serves as legal proof that the invoice was successfully submitted to the national e-invoice system.

Session Reference Synchronization​

Synchronizing Session Data

When you start using the application, not all data is synchronized immediately. Invoices sent before session tracking was implemented (or before you began using the app) may not have a session reference number (session_reference_number) assigned in the local database.

The checkbox "Synchronize session info (complete session reference in local DB)" in the status check form allows you to bridge this gap. When checked:

  • Online Invoices (synced_invoices) β€” rows with matching KSeF numbers that lack a session reference will be updated.
  • Batch Invoices (offline_invoices) β€” rows matching the batch reference number will be updated.

Establishing this link improves the performance of data presentation within the service, as the system can quickly determine which session an invoice belongs to without re-querying KSeF.