Pierwsze kroki
Informacje o historii zmian, instalacji, aktualizacji oraz licencji modulu PUQ KSeF Integrator.
Instalacja / Aktualizacja
KSeF Integrator addon WHMCS
Order now | Download | FAQ
Wymagania systemowe
| Wymaganie | Minimalna wersja |
|---|---|
| PHP | 8.1, 8.2 lub nowszy |
| WHMCS | 8.x, 9.x lub nowszy |
| ionCube Loader | v13 lub nowszy (v14, v15) |
| Rozszerzenie PHP | OpenSSL, GD, cURL, DOM |
Uwaga: Modul uzywa kodowania ionCube. Upewnij sie, ze ionCube Loader jest zainstalowany i aktywny na serwerze.
Pobieranie
Modul mozna zamowic i pobrac na stronie PUQ Cloud:
- Zamow / Pobierz: https://puqcloud.com/index.php?rp=/store/whmcs-addon-puq-ksef-integrator
- FAQ: https://community.puqcloud.com/
- Bezposredni link do pobrania najnowszej wersji:
PHP 8.1:
wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-KSeF-Integrator/php81/PUQ_WHMCS-KSeF-Integrator-latest.zip
PHP 8.2+:
wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-KSeF-Integrator/php82/PUQ_WHMCS-KSeF-Integrator-latest.zip
W przypadku problemow z pobraniem pliku, wszystkie wersje dostepne sa pod adresem: https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-KSeF-Integrator/
Po pobraniu rozpakuj archiwum:
unzip PUQ_WHMCS-KSeF-Integrator-latest.zip
Instalacja
Krok 1: Przesylanie plikow
Rozpakuj archiwum modulu i przeslij katalog puq_ksef_integrator do katalogu modulow dodatkowych WHMCS:
/twoj-whmcs/modules/addons/puq_ksef_integrator/
Struktura katalogu po przeslaniu:
modules/addons/puq_ksef_integrator/
puq_ksef_integrator.php
hooks.php
whmcs.json
version
logo.png
lib/
puqKSeFIntegrator.php
puqKSeFClient.php
puqKSeFIntegratorQrCode.php
puqKSeFIntegratorPdfHelper.php
lang/
english.php
polish.php
templates/
...
Krok 2: Aktywacja modulu
- Zaloguj sie do panelu administracyjnego WHMCS
- Przejdz do Setup > Addon Modules
- Znajdz PUQ KSeF Integrator na liscie
- Kliknij Activate
Podczas aktywacji modul automatycznie tworzy trzy tabele w bazie danych:
-
puq_ksef_certificates— certyfikaty do uwierzytelniania -
puq_ksef_invoices— rejestr faktur KSeF -
puq_ksef_settings— ustawienia modulu
Krok 3: Konfiguracja klucza licencyjnego
- Po aktywacji kliknij Configure obok modulu
- Wpisz klucz licencyjny w polu License key
- Wybierz grupy administratorow, ktore maja miec dostep do modulu
- Kliknij Save Changes
Po zapisaniu, pod polem klucza licencyjnego pojawi sie status weryfikacji (np. success: 2026-03-12T18:22:48+01:00).
01-whmcs-addon-config-license.png
Krok 4: Konfiguracja modulu
Przejdz do Addons > PUQ KSeF Integrator > Ustawienia > Konfiguracja i skonfiguruj dane firmy, certyfikaty oraz tryb wysylki. Szczegoly opisane sa na stronie Konfiguracja.
Aktualizacja
Krok 1: Kopia zapasowa
Przed aktualizacja zalecamy wykonanie kopii zapasowej:
- Bazy danych WHMCS (szczegolnie tabel
puq_ksef_*) - Plikow modulu w
modules/addons/puq_ksef_integrator/
Krok 2: Przeslanie nowych plikow
Rozpakuj nowa wersje archiwum i nadpisz wszystkie pliki w katalogu:
/twoj-whmcs/modules/addons/puq_ksef_integrator/
Krok 3: Weryfikacja
- Zaloguj sie do panelu administracyjnego WHMCS
- Przejdz do Addons > PUQ KSeF Integrator
- Sprawdz numer wersji w prawym gornym rogu nawigacji (np.
v1.0) - Przejdz do Ustawienia > Sprawdz srodowisko, aby upewnic sie, ze wszystkie wymagania sa spelnione
Modul automatycznie wykrywa brakujace kolumny w tabelach i dodaje je podczas pierwszego uruchomienia po aktualizacji. Nie jest wymagana ponowna aktywacja.
Dezaktywacja
Uwaga: Dezaktywacja modulu trwale usuwa wszystkie tabele modulu z bazy danych (
puq_ksef_certificates,puq_ksef_invoices,puq_ksef_settings). Wszystkie dane o certyfikatach, fakturach KSeF i ustawieniach zostana utracone.
- Przejdz do Setup > Addon Modules
- Kliknij Deactivate obok PUQ KSeF Integrator
- Potwierdz dezaktywacje
Licencja
KSeF Integrator addon WHMCS
Order now | Download | FAQ
Jak dziala licencja
Modul PUQ KSeF Integrator wymaga aktywnej licencji do pelnego funkcjonowania. Licencja jest weryfikowana za posrednictwem serwera licencji PUQ Cloud.
Weryfikacja licencji
- Modul okresowo sprawdza waznosc licencji na serwerze
https://license.puqcloud.com/ - Wyniki weryfikacji sa cachowane w bazie danych, dzieki czemu modul nie wymaga stalego polaczenia z serwerem licencji
- Okres cachowania wynosi 5 dni — w tym czasie modul korzysta z zapisanego wyniku weryfikacji
- Jesli serwer licencji jest tymczasowo niedostepny, modul korzysta z ostatniego zapisanego wyniku
Co jest wysylane do serwera licencji
Podczas weryfikacji modul wysyla:
- Klucz licencyjny
- Kod produktu
- Nazwe serwera (System URL z konfiguracji WHMCS)
Ograniczenia bez aktywnej licencji
Gdy licencja jest nieaktywna lub wygasla, modul dziala w trybie ograniczonym:
Co dziala bez licencji
- Zbieranie faktur — faktury sa nadal automatycznie zbierane i zapisywane w kolejce ze statusem "oczekuje" (pending) po oplaceniu w WHMCS
- Przegladanie danych — lista faktur, statystyki, podglad XML, pobieranie UPO
- Sprawdzanie srodowiska — strona diagnostyki srodowiska
- Widget na dashboardzie — statystyki faktur na stronie glownej
Co jest zablokowane bez licencji
- Wysylka faktur do KSeF — przyciski "Wyslij do KSeF" i "Wyslij teraz" sa zablokowane
- Ponowna wysylka — przycisk "Ponow" dla faktur z bledem jest zablokowany
- Automatyczna wysylka — nawet w trybie "natychmiast po oplaceniu" faktury nie sa automatycznie wysylane, lecz zapisywane jako "oczekujace"
- Zmiana ustawien — zapis konfiguracji modulu jest zablokowany
- Zarzadzanie certyfikatami — dodawanie i usuwanie certyfikatow jest zablokowane
- Oznaczanie jako nieoplacone — przycisk "Oznacz nieoplacona" jest zablokowany
Komunikaty
- Na kazdej stronie modulu wyswietlany jest czerwony baner z informacja o braku licencji i linkiem do zakupu
- Na dashboardzie WHMCS wyswietlane jest ostrzezenie
- Przy probie wykonania zablokowanej akcji uzytkownik otrzymuje komunikat: "License is not active. Please activate your license to perform this action."
Po aktywacji licencji
Po wpisaniu prawidlowego klucza licencyjnego i zapisaniu konfiguracji:
- Baner z ostrzezeniem znika
- Wszystkie funkcje modulu sa dostepne
- Faktury ze statusem "oczekuje" (pending), ktore zebraly sie podczas okresu bez licencji, moga byc wyslane recznie przyciskiem "Wyslij teraz" lub ponownie przetworzone
Zakup licencji
Licencje mozna zakupic na stronie:
https://panel.puqcloud.com/index.php/store/whmcs-addon/ksef-integrator
W razie pytan dotyczacych licencji prosimy o kontakt przez system zgloszeniowy: