KSeF Integrator – National e-Invoice System for WHMCS

Be ready for the upcoming changes in the Polish tax system without interrupting your company's operations. KSeF Integrator is an advanced module for WHMCS that automates communication with the National e-Invoice System [KSeF] ministerial gateway.

The module was designed with the hosting industry in mind – it supports not only standard service sales but also unique WHMCS mechanisms, such as deposit payments (Credit) through a dedicated compensation system.

Key Functionalities

• Full Automation (Auto-Send): The system automatically generates an XML file and sends it to the Ministry of Finance immediately after an invoice is marked as paid.
• Compliance with FA(3): The module generates structured invoices in accordance with the latest FA (3) technical specification.
• QR Codes and UPO: The system automatically retrieves the KSeF number and Official Receipt Acknowledgement (UPO). It generates QR codes on PDF invoices and in the client area, enabling quick document verification.
• Balance Handling (Compensations): Unique logic allows for correct reporting to KSeF of invoices paid in full or in part using funds stored in the customer's account.
• Security: Communication with the API utilizes RSA-2048 key encryption and AES-256 symmetric session encryption.
• Demo/Production Mode: Built-in support for the Ministry of Finance's test environment allows for safe configuration verification before the production launch.

Advantages for the Administrator

• Intuitive UI: Submission buttons, KSeF statuses, and UUID identifiers are integrated directly into the invoice edit view in the admin panel.
• Detailed Logging: The module records the full API communication history (Module Log), which significantly facilitates the diagnostics of potential issues.
• Data Validation: The system automatically checks the correctness of the Tax ID (NIP), PLN currency, and the presence of required address data before attempting to send.

KSeF Integrator – Krajowy System e-Faktur dla WHMCS

Bądź gotowy na nadchodzące zmiany w polskim systemie podatkowym bez przerywania pracy Twojej firmy. KSeF Integrator to zaawansowany moduł dla WHMCS, który w pełni automatyzuje komunikację z ministerialną bramką Krajowego Systemu e-Faktur (KSeF).

Moduł został zaprojektowany z myślą o branży hostingowej – wspiera nie tylko standardową sprzedaż usług, ale także unikalne mechanizmy WHMCS, takie jak płatności z depozytu (Credit) poprzez dedykowany system kompensat.

Kluczowe Funkcjonalności

• Pełna Automatyzacja (Auto-Send): System automatycznie generuje plik XML i wysyła go do Ministerstwa Finansów natychmiast po oznaczeniu faktury jako opłacona.
• Zgodność z FA(3): Moduł generuje faktury ustrukturyzowane zgodnie z najnowszą specyfikacją techniczną FA(3).
• Kody QR i UPO: System automatycznie pobiera numer KSeF oraz Urzędowe Poświadczenie Odbioru (UPO). Generuje kody QR na fakturach PDF oraz w panelu klienta, umożliwiając szybką weryfikację dokumentu.
• Obsługa salda (Kompensaty): Unikalna logika pozwalająca na poprawne raportowanie do KSeF faktur opłaconych w całości lub częściowo ze środków zgromadzonych na koncie klienta.
• Bezpieczeństwo: Komunikacja z API wykorzystuje szyfrowanie kluczem RSA-2048 oraz symetryczne szyfrowanie sesyjne AES-256.
• Tryb Demo/Produkcja: Wbudowana obsługa środowiska testowego Ministerstwa Finansów pozwala na bezpieczną weryfikację konfiguracji przed wdrożeniem produkcyjnym.

Zalety dla Administratora

• Intuicyjny UI: Przyciski wysyłki, statusy KSeF oraz identyfikatory UUID są zintegrowane bezpośrednio z widokiem edycji faktury w panelu admina.
• Szczegółowe Logowanie: Moduł rejestruje pełną historię komunikacji API (Module Log), co znacząco ułatwia diagnostykę ewentualnych problemów.
• Walidacja Danych: System automatycznie sprawdza poprawność NIP, walutę PLN oraz obecność wymaganych danych adresowych przed próbą wysyłki.