# Pierwsze kroki Informacje o historii zmian, instalacji, aktualizacji oraz licencji modulu PUQ KSeF Integrator. # Instalacja / Aktualizacja ### KSeF Integrator addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/whmcs-addon-puq-ksef-integrator.php) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-KSeF-Integrator/) | [FAQ](https://community.puqcloud.com/) ## 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](https://puqcloud.com/index.php?rp=/store/whmcs-addon-puq-ksef-integrator) - **FAQ:** [https://community.puqcloud.com/](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/](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 1. Zaloguj sie do panelu administracyjnego WHMCS 2. Przejdz do **Setup** > **Addon Modules** 3. Znajdz **PUQ KSeF Integrator** na liscie 4. 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 1. Po aktywacji kliknij **Configure** obok modulu 2. Wpisz klucz licencyjny w polu **License key** 3. Wybierz grupy administratorow, ktore maja miec dostep do modulu 4. Kliknij **Save Changes** Po zapisaniu, pod polem klucza licencyjnego pojawi sie status weryfikacji (np. `success: 2026-03-12T18:22:48+01:00`). ![Konfiguracja modulu z kluczem licencyjnym i kontrola dostepu](https://doc.puq.info/uploads/images/gallery/2026-02/embedded-image-bxcmfron.png) *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 1. Zaloguj sie do panelu administracyjnego WHMCS 2. Przejdz do **Addons** > **PUQ KSeF Integrator** 3. Sprawdz numer wersji w prawym gornym rogu nawigacji (np. `v1.0`) 4. 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. 1. Przejdz do **Setup** > **Addon Modules** 2. Kliknij **Deactivate** obok PUQ KSeF Integrator 3. Potwierdz dezaktywacje # Licencja ### KSeF Integrator addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/whmcs-addon-puq-ksef-integrator.php) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-KSeF-Integrator/) | [FAQ](https://community.puqcloud.com/) ## 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: 1. Baner z ostrzezeniem znika 2. Wszystkie funkcje modulu sa dostepne 3. 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](https://panel.puqcloud.com/index.php/store/whmcs-addon/ksef-integrator)** W razie pytan dotyczacych licencji prosimy o kontakt przez system zgloszeniowy: **[https://puqcloud.com/submitticket.php](https://puqcloud.com/submitticket.php?step=2&deptid=1)**