Home > Solutions > Codarius KSeF

Codarius KSeF

Invoicing and integration module for the National e-Invoicing System

About the project

 

 

Invoicing module and integration with the National e-Invoice System.

The Codarius KSeF project included the development of the Codarius platform with an invoice management module and integration with the Polish KSeF system (National System for Invoices).

The goal was to enable manual issuing of invoices from the administration panel and to automate the process of generating and sending them to customers and to the KSeF system.

The system has been designed to enable the configuration of invoicing strategies for various sales channels and to provide full support for the invoicing process – from document creation to its dispatch and accounting.

 

 

 

Business goal

 

The aim of the project was to extend the Codarius platform with a module enabling:

  • manual creation of invoices in the administration panel
  • automatic generation of invoices based on orders
  • configuration of invoicing strategies for various sales channels
  • automatic sending of invoices to customers
  • integration with the KSeF system

The solution was also intended to enable the management of invoicing configurations separately for each sales channel and provide flexibility in automating the process of issuing and sending invoices.

 

 

 

 

 

 

 

 

 

Design challenges

The main design challenge was to design an intuitive user interface for creating and managing invoices. Another important element was planning asynchronous handling of processes related to generating, issuing and sending invoices. – both to customers and to the KSeF system.

Particular attention was required:

  • appropriate design of queues in Symfony Messenger
  • handling of mass operations (e.g. sending many invoices at the same time)
  • secure management of access tokens to KSeF

 

 

 

 

 

Our approach – scope of the solution

 

The project developed a complete invoicing module, covering both the backend layer and the user interface.On the backend side, controllers were created that are responsible for:

  • creating and managing invoices
  • communication with the KSeF system
  • handling invoicing configuration for sales channels
  • automatic document issuance and shipping processes

On the frontend side, a new user interface has been prepared enabling the creation and editing of invoices and management of the invoicing module configuration. The system also enables automatic completion of invoice data based on information from orders and handling of various types of corrective invoices.

 

 

 

 

 

Architecture and technologies

 

The solution was implemented as an extension of the Codarius platform.

Technology stack

  • Backend: Symfony
  • Frontend: React + TypeScript + Material UI
  • Asynchronous processes: Symfony Messenger
  • Integration: KSeF API

One of the key technological decisions was the use of React and TypeScript to create a modern interface for the invoicing module. This approach was also consistent with the development direction of the Sylius platform, which in subsequent versions uses React technology in the frontend layer. During the project, AI tools (GitHub Copilot) were also used to support the development process and accelerate the implementation of some functionalities.

 

 

 

 

 

Performance and safety

 

In order to ensure the stability of the system, asynchronous processing of operations related to the generation and sending of invoices was used. Symfony Messenger queues support, among others:

  • generating documents
  • issuing invoices
  • sending invoices to KSeF
  • sending documents to clients

Thanks to this, operations are performed in the background, without affecting the responsiveness of the user interface.

The project also includes secure management of KSeF access tokens and mechanisms for handling mass operations, such as sending multiple invoices simultaneously.

 

 

 

Results
  • automation of the invoicing process in the Codarius platform

     

     

  • integration of the system with the National e-Invoice System

     

     

  • configuration of invoicing strategies for various sales channels

     

     

  • improving the work of sales administrators

     

     

  • preparing the system for further development in line with the Sylius technology direction

     

     

More projects

Let's talk about your project

Describe your needs and we will come back with a proposal tailored to your business.

 

Contact