KSeF Integrator

KSeF Integrator

Developed By Rimset

Compatible with WHMCS v8.13

KSeF Integrator v2.0 – National e-Invoice System for WHMCS

Be ready for the upcoming changes in the Polish tax system without interrupting your company operations. KSeF Integrator v2.0 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. Version 2.0 introduces full support for Correction Invoices and a dedicated Client Area panel.

Key Functionalities

  • Correction Invoices (New in v2.0): Full support for issuing corrections directly from WHMCS. The module handles Zeroing Invoices, Formal Data Corrections, and Position Adjustments.
  • Client Area Panel (New in v2.0): A dedicated "KSeF Documents" page where clients can track invoice status and download PDF without contacting support.
  • PDF Generator for Corrections (New in v2.0): Since WHMCS does not natively generate PDFs for corrections, our module includes a built-in engine to generate compliant PDF visualizations with QR codes.
  • Anti-Fraud Protection (New in v2.0): Protect your business from sending invoices for fake orders. The mechanism blocks auto-sending for unverified emails or newly registered accounts (based on hours since registration).
  • 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.
  • 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 account.
  • Smart Tags: Simplified integration with Invoice PDF and HTML templates using a single line of code.

Advantages for the Administrator

  • Correction Wizard: An intuitive interface for creating corrections (refunds, data changes) that guides you through the KSeF requirements step-by-step.
  • Detailed Logging: The module records the full API communication history (Module Log), which significantly facilitates the diagnostics of potential issues.
  • Security and Validation: Communication utilizes RSA-2048/AES-256 encryption. The system validates Tax IDs (NIP) and prevents sending documents with errors.

KSeF Integrator v2.0 – Krajowy System e-Faktur dla WHMCS

Bądź gotowy na nadchodzące zmiany w polskim systemie podatkowym bez przerywania pracy Twojej firmy. KSeF Integrator v2.0 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. Wersja 2.0 wprowadza pełną obsługę Faktur Korygujących oraz Panel Klienta.

Kluczowe Funkcjonalności

  • Obsługa Faktur Korygujących (Nowość w v2.0): Pełne wsparcie dla wystawiania korekt bezpośrednio z WHMCS. Moduł obsługuje Korekty Zerujące, Korekty Danych Formalnych oraz Korekty Pozycji.
  • Panel Klienta Moje Dokumenty (Nowość w v2.0): Dedykowana zakładka w strefie klienta, gdzie użytkownicy mogą samodzielnie pobierać PDF oraz podglądać statusy dokumentów.
  • Generator PDF dla Korekt (Nowość w v2.0): Ponieważ WHMCS nie generuje natywnie plików PDF dla korekt, moduł posiada wbudowany silnik tworzący wizualizacje PDF korekt wraz z wymaganym kodem QR.
  • Ochrona Anti-Fraud (Nowość w v2.0): Zabezpiecz się przed wysyłką faktur dla fałszywych zamówień. System blokuje auto-wysyłkę dla niezweryfikowanych adresów e-mail lub świeżych kont.
  • 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).
  • 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.
  • Smart Tags: Uproszczona integracja z szablonami PDF i HTML. Wystarczy wkleić jedną linijkę kodu.

Zalety dla Administratora

  • Kreator Korekt: Intuicyjny interfejs w panelu admina, który krok po kroku przeprowadzi Cię przez proces wystawiania korekty (zwrotu lub zmiany danych).
  • Szczegółowe Logowanie: Moduł rejestruje pełną historię komunikacji API (Module Log), co znacząco ułatwia diagnostykę ewentualnych problemów.
  • Bezpieczeństwo i Walidacja: Komunikacja szyfrowana RSA/AES. System automatycznie sprawdza poprawność NIP i danych przed wysyłką.

 

Reviews

5 stars
2
2
4 stars
0
0
3 stars
0
0
2 stars
0
0
1 star
0
0
Jakub  avatar

Jakub @jakub5433

February 26, 2026 at 11:03:21 PM

I’ve been using KSeF Integrator about 2 weeks and I’m very happy with it. Everything works smoothly, invoices are sent correctly to KSeF, and correction invoices are handled without any problems.

What really stands out is the excellent support – fast, helpful, and professional. It’s great to know you can rely on the team if you have any questions.

Overall, a reliable and well-built module that does exactly what it promises. Highly recommended!

  • 6 days ago
Al. Jerozolimskie 85/21 02-001 Warszawa avatar

Al. Jerozolimskie 85/21 02-001 Warszawa @maksymilian6400

February 6, 2026 at 09:49:32 PM

This well-thought-out, automated, and efficient module completely solves all KSeF invoice-related issues in Poland. Support is responsive and eager to answer questions about the module and expand its functionality. I highly recommend it.

  • 3 weeks ago
  • Version Number 1.1.0

Version Compatibility


Compatible with WHMCS v8.13

Full Version Compatibility


  • All versions of WHMCS v8.13
  • All versions of WHMCS v8.12
  • All versions of WHMCS v8.11
  • Selected versions of WHMCS v8.10
        8.10.0
  • Selected versions of WHMCS v8.9
        8.9.0
  • Selected versions of WHMCS v8.8
        8.8.0

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By Rimset

Changelog

v2.0.2 Released February 25th, 2026

Latest Version


Changelog

  • New Feature: Dashboard Widget. Quick preview of daily KSeF statistics, errors, and recent system logs directly on the WHMCS admin homepage.
  • Improvement: Credit & Compensation Handling. Enhanced automated processing of client credit payments and accurate mapping of compensation items to KSeF invoices.
  • Improvement: Anti-Fraud Enhancements. Optimized block triggers for unverified emails and suspicious new accounts to prevent fake invoice submissions.

Zmiany

  • Nowa Funkcja: Widżet na Pulpicie. Szybki podgląd dziennych statystyk KSeF, błędów i logów systemowych bezpośrednio na głównej stronie panelu administratora WHMCS.
  • Ulepszenie: Obsługa Kompensat i Salda. Ulepszona automatyczna obsługa płatności z salda klienta (Credit) oraz poprawne mapowanie pozycji kompensacyjnych.
  • Ulepszenie: Poprawki Anti-Fraud. Zoptymalizowane działanie mechanizmów blokujących wysyłkę w przypadku niezweryfikowanych adresów e-mail oraz podejrzanych, nowych kont.

 

Previous Versions


v2.0.1 Released February 18th, 2026

View/hide detailed changelog

Changelog

  • New Feature: Automated Correction Email Notifications. Sends a download link to the client immediately after KSeF approval.
  • New Feature: Settlement Status indicators. Visual "To Refund" and "To Pay" markers in Admin Area for easier accounting control.
  • mprovement: Intelligent Email Filtering. Automatically suppresses standard WHMCS emails for B2B KSeF invoices to prevent duplicates.
  • Improvement: Enhanced Anti-Fraud logging. Provides clear, specific reasons for blocked transfers in the System Activity Log.

Zmiany

  • Nowa Funkcja: Automatyczne Powiadomienia E-mail o Korektach. Wysyła klientowi link do pobrania dokumentu natychmiast po zatwierdzeniu przez KSeF.
  • Nowa Funkcja: Statusy Rozliczeń Korekt. Wizualne oznaczenia "Do Zwrotu" i "Do Dopłaty" w panelu administratora ułatwiające kontrolę księgową.
  • Ulepszenie: Inteligentne Filtrowanie E-maili. Automatycznie blokuje standardowe powiadomienia WHMCS dla faktur B2B, zapobiegając duplikatom wiadomości.
  • Ulepszenie: Rozszerzone logowanie Anti-Fraud. Jasne komunikaty w logach aktywności wyjaśniające powód blokady wysyłki (np. brak weryfikacji email).

 

v2.0.0 Released February 15th, 2026

View/hide detailed changelog

Changelog

  • New Feature: Full support for Correction Invoices including Zeroing, Formal Data and Position adjustments directly from WHMCS Admin Area.
  • New Feature: Dedicated Client Area Page for KSeF Documents allowing clients to track status and download PDF.
  • New Feature: Built-in PDF Generator for Corrections with QR codes. Addresses WHMCS native limitation regarding correction PDFs.
  • New Feature: Anti-Fraud Protection mechanism. Prevents auto-sending for unverified emails or new accounts based on registration time.
  • Improvement: Introduced Smart Tags for simplified, single line integration with Invoice PDF and HTML templates.
  • Improvement: Automatic database schema adjustments to support correction history storage.

Zmiany

  • Nowa Funkcja: Pełna obsługa Faktur Korygujących w tym Zerujące, Danych Formalnych i Pozycji bezpośrednio z panelu administratora WHMCS.
  • Nowa Funkcja: Dedykowana podstrona w Panelu Klienta dla Dokumentów KSeF umożliwiająca śledzenie statusu i pobieranie PDF.
  • Nowa Funkcja: Wbudowany generator PDF dla Korekt z kodami QR. Rozwiązuje brak natywnej obsługi PDF korekt w WHMCS.
  • Nowa Funkcja: Mechanizm ochrony Anti-Fraud. Blokuje auto-wysyłkę dla niezweryfikowanych emaili lub nowych kont.
  • Ulepszenie: Wprowadzono Smart Tags umożliwiające integrację z szablonami PDF i HTML za pomocą jednej linijki kodu.
  • Ulepszenie: Automatyczna modyfikacja schematu bazy danych do obsługi historii korekt.

 

v1.1.0 Released February 5th, 2026

View/hide detailed changelog

Changelog

  • New Feature: Added support for mapping NIP (Tax ID) to Custom Client Fields.
  • New Feature: Added support for cross-border invoices (EU & Non-EU) with automatic VAT rate mapping.
  • Improvement: Enhanced B2B/B2C validation logic with automatic NIP sanitization (removing dashes/spaces).
  • Improvement: Improved connection test diagnostics with detailed API error messages.

Zmiany

  • Nowa Funkcja: Dodano obsługę mapowania numeru NIP do Pól Dodatkowych (Custom Fields).
  • Nowa Funkcja: Dodano pełną obsługę faktur zagranicznych (UE oraz spoza UE) z automatycznym mapowaniem stawek VAT.
  • Ulepszenie: Usprawniona walidacja B2B/B2C z automatycznym czyszczeniem numerów NIP (usuwanie kresek i spacji).
  • Ulepszenie: Rozbudowana diagnostyka testu połączenia wyświetlająca szczegółowe komunikaty błędów z API.

 

v1.0.0 Released January 22nd, 2026

View/hide detailed changelog

Changelog

v1.0.0

  • New Feature: Initial release of the KSeF Integrator module.
  • New Feature: Full compliance with the FA(3) logical structure.
  • New Feature: Automated invoice submission to Ministry of Finance (Auto-Send logic).
  • New Feature: Advanced handling of WHMCS Credit/Deposit payments via compensations.
  • New Feature: QR Code and KSeF Number integration on PDF invoices and Client Area.
  • New Feature: Admin Area integration (status monitoring, manual submission, logs).
  • New Feature: RSA-2048 and AES-256 encryption support for secure API communication.

Changelog

v1.0.0

  • Nowa Funkcja: Pierwsze oficjalne wydanie modułu KSeF Integrator.
  • Nowa Funkcja: Pełna zgodność ze strukturą logiczną FA(3).
  • Nowa Funkcja: Automatyczna wysyłka faktur do KSeF po odnotowaniu płatności.
  • Nowa Funkcja: Zaawansowana obsługa płatności z salda (WHMCS Credit) poprzez kompensaty.
  • Nowa Funkcja: Integracja kodów QR i numerów KSeF na fakturach PDF oraz w Strefie Klienta.
  • Nowa Funkcja: Integracja z Panelem Administratora (monitoring statusów, ręczna wysyłka, logi).
  • Nowa Funkcja: Zabezpieczenie komunikacji API szyfrowaniem RSA-2048 i AES-256.

 

See also

Accept Bitcoin and cryptocurrency payments - CoinGate for WHMCS

Easily accept Bitcoin, Tether, Ethereum and many other crypto payments on your WHMCS website

Free
Account Statements Module

Send account statements to customers

Free
GST WHMCS Module For India

As WHMCS does provide tax rules options where you can configure your GST tax but we have some extra features in our module that makes it stand out and necessary to use.

Commercial
Handling Fees

A handling fee are the costs that business owners incur when processing payments from customers.

Free
Free Opensource Gateway Fees

Gateway no fees Addon

Free