LMS z KSeF

Słowo wstępne

To jest ksef2lms — darmowy łącznik LMS z KSeF 2.0 (LMS w KSeF, wysyłka faktur z LMS do Krajowego Systemu e-Faktur). Działa z LMS Chilka, nie jest częścią oficjalnego repozytorium.

Cześć! Na samym wstępie muszę się przyznać — jestem wieloletnim i oddanym fanem systemu LMS :D Poniższy projekt powstawał momentami w bólach, prawdopodobnie bywa pełen chaosu i z pewnością nie wygra konkursu na najlepiej udokumentowany kod w historii. Początkowo tworzyłem to wyłącznie na swoje własne, absolutnie prywatne potrzeby, żeby jakoś okiełznać nadchodzącego potwora zwanego KSeF. Nie ukrywam! W dużej mierze pomogła tutaj sztuczna inteligencja...

Jednak, ulegając presji tłumu i na prośbę wielu z Was, postanowiłem podzielić się tym dziełem zupełnie nieodpłatnie. Musisz jednak wiedzieć o jednym: nie działam w porozumieniu z autorami ani programistami oficjalnego LMS-a. Oznacza to, że wszelkie ich poprawki i aktualizacje mogą znacząco wpłynąć na (nie)działanie niniejszej integracji. Mój projekt nie jest oficjalną częścią systemu. Oczywiście bardzo się starałem, by całość była jak najbardziej spójna i niczego nie zepsuła, ale korzystasz z tego na własną odpowiedzialność! Oczywiście udostępniony kod może być także inspiracją dla innych, śmiało korzystaj! Zachęcam również do dzielenia się :P

Wymagania

Jeśli brak biblioteki ksef-php-client (pierwsza instalacja, nie aktualizacja):

cd /twoja/sciezka/lms
composer require n1ebieski/ksef-php-client --no-dev

Po aktualizacji Chilka — konkretna paczka, nie goły composer update:

cd /twoja/sciezka/lms
composer update n1ebieski/ksef-php-client --with-dependencies --no-dev
composer show n1ebieski/ksef-php-client | grep versions

Aktualna wersja biblioteki: 1.9.0. jQuery UI (js/jqueryui/dist/) jest w procedurze B/C przy pobieraniu — bez tego GUI kręci kółko, to nie jest KSeF.

Krok 1 Certyfikat PKCS12

Aby uwierzytelnić się w systemie KSeF, potrzebujesz certyfikatu. W portalu KSeF Ministerstwa Finansów (Aplikacja Podatnika → Certyfikaty) generujesz parę plików o rozszerzeniach .crt oraz .key, a także podajesz dla nich hasło, które musisz zapamiętać i wpisać do pliku lms.ini. Z tych danych generujesz docelowy plik .p12 (PKCS#12) tym poleceniem:

# Połącz .crt i .key w plik .p12
openssl pkcs12 -export \
  -in certyfikat.crt \
  -inkey certyfikat.key \
  -out /etc/lms/ksef_cert.p12   # lub inna wybrana ścieżka \
  -passout pass:TwojeHaslo123!

# Zabezpiecz plik
chmod 640 /etc/lms/ksef_cert.p12
chown root:www-data /etc/lms/ksef_cert.p12

# Certyfikat offline musi być ECDSA (EC P-256) — nie RSA
cat ksef_offline.key ksef_offline.crt > /etc/lms/ksef_offline.pem
chmod 640 /etc/lms/ksef_offline.pem

# Weryfikacja że to EC (a nie RSA):
openssl pkey -in /etc/lms/ksef_offline.pem -text -noout | grep "EC\|prime256"
# Oczekiwany wynik: id-ecPublicKey, prime256v1

offline_certificate = /etc/lms/ksef_offline.pem
offline_password    =       # hasło do pliku .pem (zazwyczaj puste)
offline_support     = 1     # zezwól na wysyłkę e-mail faktur bez numeru KSeF

Krok 2 Konfiguracja lms.ini

Edytuj swój plik lms.ini (zazwyczaj /etc/lms/lms.ini lub inna ścieżka podana przy instalacji LMS) i dodaj / uzupełnij poniższe sekcje. Pamiętaj, by we wszystkich komendach zamienić /sciezka/do/lms.ini na własną ścieżkę:

[phpui]
plugins = KSeFSubmit           # dodaj do istniejącej listy pluginów

[ksef]
environment    = prod          # prod / test / demo
auth_method    = certificate   # certificate (zalecane) lub token
certificate    = /etc/lms/ksef_cert.p12
password       = "TwojeHaslo123!"
boundary_date  = 2026/04/01    # data od której wysyłamy faktury
encryption_key = Wpisz32ZnakowyLosowyKluczAES256!
encryption_iv  = 16ZnakowIV1234
debug          = 0              # 1 = loguj plugin do PHP error_log, 0 = cisza

[invoices]
issuer            = 'Dział obsługi rozliczeń'        ; podpis wystawcy na fakturze PDF
show_balance_summary = 0                              ; 0 = nie pokazuj salda klienta na fakturze PDF (zalecane dla ISP)
show_pricing_method  = 0
info_box_text     = '<center><b>Informacja</b>\nFaktura wystawiona w KSeF.\nDokument w KSeF stanowi fakturę właściwą.\nPDF ma charakter informacyjny.</center>'
;                  ↑ ramka na fakturach B2B — obsługuje HTML, \n = nowa linia
info_box_text_b2c = '<center>Dziękujemy za korzystanie z naszych usług</center>'
;                  ↑ ramka na fakturach B2C — jeśli brak: używana info_box_text

[sendinvoices]            ; faktury B2B — firmy, klienci z NIPem
smtp_host             = poczta.twojadomena.pl     ; serwer SMTP
smtp_port             = 587                       ; 587=STARTTLS, 465=SSL, 25=plain
smtp_auth             = PLAIN                     ; PLAIN lub LOGIN
smtp_user             = nadawca@twojadomena.pl    ; login SMTP
smtp_pass             = "HasloDoSMTP!"            ; haslo SMTP
smtp_ssl_verify_peer  = 0                        ; 0 = nie weryfikuj certyfikatu SSL (webstorage itp.)
smtp_ssl_verify_peer_name = 0
smtp_ssl_allow_self_signed = 0
lms_url              = https://adres.twojego.lms/ ; URL do LMS (do linkow w mailach)
lms_user             = uzytkownik_lms            ; uzytkownik LMS do generowania PDF
lms_password         = "HasloUzytkownikaLMS!"
customergroups       = nazwa-grupy               ; grupy klientow do wysylki (spacja = separator)
sender_name          = Nazwa Twojej Firmy
sender_email         = biuro@twojadomena.pl
invoice_filename     = Faktura_%number           ; nazwa pliku PDF w zalacznik
mail_subject         = Faktura VAT %invoice
mail_body            = /etc/lms/mail_body_b2b.txt
mail_format          = html
; debug_email = twoj@email.pl  ; jesli ustawione — mail idzie TYLKO na ten adres (do testow)

[sendinvoices-b2c]        ; faktury B2C — osoby fizyczne
smtp_host             = poczta.twojadomena.pl
smtp_port             = 587
smtp_auth             = PLAIN
smtp_user             = nadawca@twojadomena.pl
smtp_pass             = "HasloDoSMTP!"
smtp_ssl_verify_peer  = 0
smtp_ssl_verify_peer_name = 0
smtp_ssl_allow_self_signed = 0
lms_url              = https://adres.twojego.lms/
lms_user             = uzytkownik_lms
lms_password         = "HasloUzytkownikaLMS!"
customergroups       = nazwa-grupy
sender_name          = Nazwa Twojej Firmy
sender_email         = biuro@twojadomena.pl
invoice_filename     = Faktura_%number
mail_subject         = Faktura %invoice
mail_body            = /etc/lms/mail_body_b2c.txt
mail_format          = html

Przykładowe pliki treści maili

Pliki wskazane w mail_body to szablony HTML. Zmienne dostępne w treści:

/etc/lms/mail_body_b2b.txt — dla firm (B2B):

Szanowni Państwo,<br><br>
informujemy, że została wystawiona faktura VAT nr <b>%invoice</b>.<br><br>
<b>Numer KSeF: </b> %ksef-number<br>
Faktura została wystawiona w KSeF.<br>
Dokument dostępny w KSeF stanowi fakturę właściwą.<br><br>
Załączony plik PDF ma charakter poglądowy.<br><br>
W razie pytań prosimy o kontakt.<br><br>
Z poważaniem,<br>
<b>Twoja Firma</b>

/etc/lms/mail_body_b2c.txt — dla osób fizycznych (B2C):

Szanowny Kliencie,<br><br>
w załączniku przesyłamy fakturę nr <b>%invoice</b>.<br><br>
Dziękujemy za korzystanie z naszych usług.<br><br>
Pozdrawiamy,<br>
<b>Twoja Firma</b>

Generowanie kluczy szyfrowania

# encryption_key — 32 znaki losowe
openssl rand -base64 24 | tr -d '=+/' | head -c 32

# encryption_iv — 16 znaków losowych
openssl rand -base64 12 | tr -d '=+/' | head -c 16

Krok 3 Instalacja łącznika

LMS musi już działać. Tu dokładasz tylko łącznik KSeF: plugin, skrypty w bin/ i jedną linijkę w pliku Chilka (setlocale). Który zip pobrać i czego nie wklejać — sekcja Pobierz. Tam są trzy osobne przypadki, nie mieszaj ich.

Instalator lms-npi.sh z paczki 30.08 kopiuje plugin i skrypty, potem nakłada setlocale. Nie rusza lib/KSeF/KSeF.php (zamiast kopiowania — patcher) ani szablonu PDF. Najpierw dry-run:

# 1. Wgraj paczkę na serwer i rozpakuj
unzip lms-ksef-netlink-*.zip -d /tmp/ksef-pack

# 2. Dry-run — podgląd, nic nie zmienia
bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini --dry-run

# 3. Właściwa instalacja
bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini

W lms.ini w [phpui] plugins musi być KSeFSubmit (krok 2). Bibliotekę KSeF dociągasz composerem z sekcji wymagań, jeśli jej jeszcze nie ma. Po instalacji: cd /sciezka/lms && bash bin/check-netlink-patches.sh — brak ramki info_box_text na PDF Chilka to nie błąd.

Opcje instalatora

bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini --dry-run
bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini
bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini --no-backup      # bez tar i dumpa
bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini --no-backup-dir  # bez tar katalogu LMS
bash /tmp/ksef-pack/lms-npi.sh -c /etc/lms/lms.ini --no-backup-db   # bez dumpa bazy

PACK=/tmp/ksef-pack      # katalog z rozpakowaną paczką
LMS=/twoja/sciezka/lms      # katalog instalacji LMS

mkdir -p $LMS/plugins/KSeFSubmit/handlers $LMS/plugins/KSeFSubmit/lib
cp $PACK/plugins/KSeFSubmit/KSeFSubmit.php                 $LMS/plugins/KSeFSubmit/
cp $PACK/plugins/KSeFSubmit/handlers/KSeFSubmitHandler.php $LMS/plugins/KSeFSubmit/handlers/
cp $PACK/plugins/KSeFSubmit/lib/KSeFApiService.php         $LMS/plugins/KSeFSubmit/lib/

cp $PACK/bin/lms-ksef.php $PACK/bin/lms-ksef-download.php \
   $PACK/bin/lms-ksef-sync.php $PACK/bin/lms-ksef-bulk-correct.php \
   $PACK/bin/lms-ksef-upo-download.php $PACK/bin/gen-xml.php \
   $PACK/bin/patch-netlink.py $LMS/bin/
cp $PACK/bin/check-netlink-patches.sh $LMS/bin/ 2>/dev/null || \
  cp $PACK/check-netlink-patches.sh $LMS/bin/
chmod +x $LMS/bin/lms-ksef*.php $LMS/bin/patch-netlink.py
python3 $LMS/bin/patch-netlink.py $LMS

Skrypty

To jest w paczce. Cron i GUI wołają te same rzeczy.

[phpui]
plugins = KSeFSubmit           ; dodaj do istniejącej listy pluginów

Poprawki w lib/KSeF/KSeF.php

Chilek trzyma lib/KSeF/KSeF.php w swoim repo. Po git pull / rsync ten plik wraca do wersji Chilka i znika setlocale. W zipie łącznika ten plik może leżeć, ale go nie kopiuj na ślepo — npi z 30.08 go nie wgrywa. Setlocale dokłada bin/patch-netlink.py (instalator odpala go sam na końcu).

P1 — setlocale(LC_NUMERIC, 'C')

LMS przestawia separator dziesiętny na przecinek (locale pl_PL). KSeF wymaga kropki w XML — bez tej poprawki pola P_13_*, P_14_*, P_15 (podstawy VAT, kwoty VAT, suma) generowane przez sprintf('%.2f', ...) zawierają przecinki i MF odrzuca fakturę.

# Co robi poprawka P1:
public function getInvoiceXml(array $invoice)
{
    setlocale(LC_NUMERIC, 'C'); // NETLink P1
    ...

Saldo na fakturze — jak skonfigurować?

Jeśli chcesz żeby faktury PDF i XML zawierały saldo klienta (sekcja <Rozliczenie>) — skonfiguruj to w GUI LMS:

Administracja → Konfiguracja → KSeF → Ustawienia oddziałów → Pokazuj rozliczenie salda

Krok 4 Po instalacji — weryfikacja

Sprawdź czy patche zostały poprawnie nałożone:

# Uruchom z katalogu LMS
cd /twoja/sciezka/lms && bash bin/check-netlink-patches.sh

UPO — Urzędowe Poświadczenie Odbioru

UPO to dokument XML wystawiony przez MF potwierdzający że faktura przeszła walidację i została przyjęta przez KSeF. MF przechowuje UPO przez 10 lat — możesz je pobrać w każdej chwili, nie ma pośpiechu.

ls -la /twoja/sciezka/lms/storage/ksef/
# Powinno byc: drwxr-xr-x apache apache ... upo

# Jesli brak:
mkdir -p /twoja/sciezka/lms/storage/ksef/upo
chown apache:apache /twoja/sciezka/lms/storage/ksef/upo
chmod 750 /twoja/sciezka/lms/storage/ksef/upo

Plugin GUI (KSeFSubmit) od wersji 17.04.2026 fix3 pobiera i zapisuje UPO automatycznie — razem z numerem KSeF, w tym samym żądaniu HTTP co wysyłka faktury. UPO trafia do tego samego katalogu co przy wysyłce przez CLI:
{sys_dir}/storage/ksef/upo/{NIP}/{YYYYMMDD}/{numerKSeF}.xml
Jeśli plugin nie zdążył pobrać UPO (timeout 45s) — lms-ksef.php --status-only pobierze je automatycznie przy kolejnym uruchomieniu crona.

Krok 5 Sync historycznych faktur zakupowych

Pierwsze uruchomienie — pobierz wszystkie faktury które wystawcy przesłali do KSeF na Twój NIP. Skrypt używa Export API (jeden zaszyfrowany ZIP zamiast setek osobnych zapytań):

cd /twoja/sciezka/lms/bin

# Najpierw dry-run — sprawdź ile faktur zostanie pobranych
./lms-ksef-sync.php -C /sciezka/do/lms.ini --from=2026/01/01 --dry-run

# Właściwy sync (zakres maksymalnie 3 miesiące, podziel jeśli większy)
./lms-ksef-sync.php -C /sciezka/do/lms.ini --from=2026/01/01 --to=2026/03/31
./lms-ksef-sync.php -C /sciezka/do/lms.ini --from=2026/04/01

Wysyłka historycznych faktur sprzedaży do KSeF

# Dry-run — sprawdź ile faktur do wysłania
./lms-ksef.php -C /sciezka/do/lms.ini --dry-run

# Właściwa wysyłka
./lms-ksef.php -C /sciezka/do/lms.ini

Krok 6 Konfiguracja Cron

Zamień /twoja/sciezka/lms i /sciezka/do/lms.ini na własne ścieżki.

Wariant A — faktury generowane 1. dnia miesiąca

Klasyczny model: LMS generuje faktury 1. dnia, skrypty wysyłają je do KSeF i e-mailem tego samego dnia. Ważne: lms-ksef.php startuje 20 minut po generowaniu — żeby faktury były już gotowe w bazie.

# crontab -e

# Generowanie faktur i płatności — 1. dnia o 02:00
 0  2 1 * *  /twoja/sciezka/lms/bin/lms-payments.php -C /sciezka/do/lms.ini

# Wysyłka do KSeF — 20 minut po generowaniu
20  2 1 * *  php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini >> /var/log/lms-ksef.log 2>&1

# Wysyłka e-mail B2B (tylko faktury z numerem KSeF)
40  2 1 * *  /twoja/sciezka/lms/bin/lms-sendinvoices.php -C /sciezka/do/lms.ini --ksef

# Wysyłka e-mail B2C (osoby fizyczne — nie wymagają KSeF)
45  2 1 * *  /twoja/sciezka/lms/bin/lms-sendinvoices.php -C /sciezka/do/lms.ini --without-ksef --section=sendinvoices-b2c

# Sprawdzanie statusów KSeF co godzinę (przez cały miesiąc)
 0  * * * *  php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini --status-only >> /var/log/lms-ksef.log 2>&1

# Pobieranie faktur zakupowych od dostawców — codziennie o 06:15
15  6 * * *  php /twoja/sciezka/lms/bin/lms-ksef-download.php -C /sciezka/do/lms.ini -q >> /var/log/lms-ksef-download.log 2>&1

Wariant B — faktury generowane codziennie (różne dni dla różnych klientów)

Jeśli Twoi klienci mają zobowiązania rozłożone na różne dni miesiąca, lms-payments.php generuje faktury codziennie tylko dla tych którzy mają zobowiązanie na dany dzień. Wtedy warto też codziennie wysyłać do KSeF:

# Generowanie faktur — codziennie o 02:00
 0  2 * * *  /twoja/sciezka/lms/bin/lms-payments.php -C /sciezka/do/lms.ini

# Wysyłka do KSeF — 20 min po generowaniu, codziennie
20  2 * * *  php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini >> /var/log/lms-ksef.log 2>&1

# Wysyłka e-mail B2B
40  2 * * *  /twoja/sciezka/lms/bin/lms-sendinvoices.php -C /sciezka/do/lms.ini --ksef

# Wysyłka e-mail B2C
45  2 * * *  /twoja/sciezka/lms/bin/lms-sendinvoices.php -C /sciezka/do/lms.ini --without-ksef --section=sendinvoices-b2c

# Sprawdzanie statusów KSeF co godzinę
 0  * * * *  php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini --status-only >> /var/log/lms-ksef.log 2>&1

# Pobieranie faktur zakupowych — codziennie
15  6 * * *  php /twoja/sciezka/lms/bin/lms-ksef-download.php -C /sciezka/do/lms.ini -q >> /var/log/lms-ksef-download.log 2>&1

Wariant C — bez crona (ręczne uruchamianie)

Możesz uruchamiać wszystkie skrypty ręcznie kiedy chcesz — cron tylko to automatyzuje:

php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini --dry-run  # sprawdź ile faktur czeka
php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini             # wyślij do KSeF
php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini --status-only # odbierz numery
/twoja/sciezka/lms/bin/lms-sendinvoices.php -C /sciezka/do/lms.ini --ksef  # wyślij e-maile

Szablony e-mail

/sciezka/do/mail_body_b2b.txt — dla firm (B2B)

Szanowni Państwo,<br>
<br>
w załączniku faktura VAT <b>%invoice</b>.<br>
Numer KSeF: <b>%ksef-number</b><br>
Kwota do zapłaty: <b>%value PLN</b><br>
Numer konta: %bankaccount<br>
<br>
Z poważaniem

/sciezka/do/mail_body_b2c.txt — dla osób fizycznych (B2C)

Szanowny Kliencie,<br>
<br>
w załączniku faktura <b>%invoice</b>.<br>
Kwota do zapłaty: <b>%value PLN</b><br>
Numer konta: %bankaccount<br>
<br>
Dziękujemy!

Test generowania XML

Przed wysyłką do KSeF warto sprawdzić czy XML faktury wygląda poprawnie. Skrypt gen-xml.php generuje XML bez wysyłki:

cd /twoja/sciezka/lms
php bin/gen-xml.php -C /sciezka/do/lms.ini ID_FAKTURY

# XML zapisywany jest do /tmp/ID_FAKTURY.xml
cat /tmp/ID_FAKTURY.xml

Sprawdź w wygenerowanym XML:

• Kwoty mają kropki dziesiętne (nie przecinki) np. 2595.30
• Sekcja <Rozliczenie> zawiera kwotę faktury i <DoZaplaty>
• Dla klientów B2B jest sekcja <Podmiot2> z NIPem

Awarie KSeF i tryb offline

KSeF bywa niedostępny — czy to przez kilka godzin, czy przez kilka dni. Skrypty są zaprojektowane tak, żeby nic nie ginęło i żebyś nie musiał robić niczego ręcznie w większości przypadków.

Scenariusz 1 — KSeF chwilowo nie odpowiada (kilka godzin)

Co się dzieje automatycznie: skrypty przed wysyłką sprawdzają dostępność KSeF przez oficjalny endpoint MF (tzw. Latarnia). Jeśli KSeF nie działa — skrypt kończy pracę z komunikatem i faktury czekają w kolejce.

Co Ty robisz: nic. Po powrocie MF cron automatycznie wyśle wszystkie zaległe faktury i odbierze numery KSeF. Możesz też uruchomić ręcznie:

# Sprawdź ile faktur czeka
php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini --dry-run

# Wyślij zaległe i odbierz numery KSeF
php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini

Scenariusz 2 — MF ogłasza oficjalny tryb offline

Czasem Ministerstwo Finansów oficjalnie ogłasza tryb offline — oznacza to, że faktury można wystawiać bez wysyłania ich do KSeF, a po powrocie systemu masz kilka dni na uzupełnienie. W tym czasie:

• Wystawiasz faktury normalnie w LMS — nie czekasz na KSeF
• Wysyłasz e-maile z fakturami bez numeru KSeF — przez Chilek dodaną flagę:

# Wyślij e-mailem faktury które czekają na numer KSeF (tryb offline MF)
/twoja/sciezka/lms/bin/lms-sendinvoices.php -C /sciezka/do/lms.ini --ksef-offline

Jeśli masz skonfigurowany certyfikat offline — na fakturach PDF pojawi się specjalny kod QR podpisany Twoim kluczem ECDSA, który można zweryfikować bez internetu. Po powrocie KSeF wystarczy uruchomić lms-ksef.php — skrypt sam wyśle zaległe faktury.

Co to jest Latarnia KSeF?

Latarnia (ang. lighthouse) to oficjalny publiczny endpoint Ministerstwa Finansów, który informuje o aktualnym stanie systemu KSeF. Nie wymaga logowania ani certyfikatu — każdy może go odpytać.

Nasze skrypty pytają Latarnię przed każdą próbą wysyłki faktur. Jeśli KSeF jest niedostępny — skrypt nie próbuje wysyłać, tylko loguje informację i kończy pracę. Faktury czekają bezpiecznie w bazie. Przy kolejnym uruchomieniu crona (lub ręcznym) — procedura powtarza się.

Możliwe stany Latarni:

Scenariusz 3 — Faktura odrzucona przez KSeF (błąd danych)

Jeśli MF odrzuci fakturę (np. brakujący NIP, błędna stawka VAT) — faktura trafia do bazy ze statusem błędu. Nie zniknie i nie zostanie wysłana ponownie automatycznie — musisz to naprawić ręcznie:

# Sprawdź które faktury mają błąd (w bazie danych)
SELECT d.fullnumber, kd.status, kd.statusdescription
FROM ksefdocuments kd
JOIN documents d ON d.id = kd.docid
WHERE kd.status >= 400
ORDER BY d.cdate DESC;

# Po poprawieniu danych klienta/faktury — ponów wysyłkę
php /twoja/sciezka/lms/bin/lms-ksef.php -C /sciezka/do/lms.ini --retry-errors

Tabela typowych problemów

composer update components/jqueryui --with-dependencies --no-dev
mkdir -p js/jqueryui/dist
if [ -f vendor/components/jqueryui/dist/jquery-ui.min.js ]; then
  cp -a vendor/components/jqueryui/dist/jquery-ui.min.js js/jqueryui/dist/
else
  ln -sf ../jquery-ui.min.js js/jqueryui/dist/jquery-ui.min.js
fi

Co nowego — 30.08.2026

composer update n1ebieski/ksef-php-client --with-dependencies --no-dev

INSERT INTO ksefconfig (divisionid, delay, allconsumers, boundarydate, showbalancesummary, xmladdallvalues)
VALUES (1, 0, 0, UNIX_TIMESTAMP('2026-04-01'), 0, 0);

INSERT INTO ksefconfig (divisionid, delay, allconsumers, boundarydate, showbalancesummary, xmladdallvalues)
VALUES (1, 0, 0, EXTRACT(EPOCH FROM TIMESTAMP '2026-04-01')::bigint, 0, 0);

Pobieranie plików

Są dwa zipy. Nie pobieraj obu „na wszelki wypadek” i nie odpalaj obu procedur pod spodem — to dwa różne światy.

• lms-master-30082026.zip
  Kod LMS-a Chilka z dnia 30.08.2026. Potrzebny tylko wtedy, gdy nie masz gita i aktualizujesz LMS ręcznie. Przy git merge ten plik zostaw w spokoju.
• lms-ksef-netlink-30082026.zip
  Łącznik: plugin, skrypty bin/lms-ksef*.php, patcher. To nie jest cały LMS. Z tej paczki nie wgrywaj lib/KSeF/KSeF.php ani szablonu PDF.

cd /tmp
wget -O lms-ksef-netlink-30082026.zip "https://ksef2lms.idzik.pl/?track=lms-ksef-netlink-30082026.zip"
unzip -o lms-ksef-netlink-30082026.zip -d ksef-pack
cp /tmp/ksef-pack/bin/lms-ksef.php /sciezka/lms/bin/lms-ksef.php

cd /sciezka/lms
git status -sb
git fetch origin
git checkout -- lib/KSeF/KSeF.php
git merge --ff-only origin/master

cd /sciezka/lms
composer update n1ebieski/ksef-php-client components/jqueryui --with-dependencies --no-dev
mkdir -p js/jqueryui/dist
if [ -f vendor/components/jqueryui/dist/jquery-ui.min.js ]; then
  cp -a vendor/components/jqueryui/dist/jquery-ui.min.js js/jqueryui/dist/
else
  ln -sf ../jquery-ui.min.js js/jqueryui/dist/jquery-ui.min.js
fi
composer show n1ebieski/ksef-php-client | grep versions
ls -l js/jqueryui/dist/jquery-ui.min.js

cd /sciezka/lms
python3 bin/patch-netlink.py /sciezka/lms
php devel/upgradedb.php -C /etc/lms/lms.ini
find templates_c -type f ! -name '.gitkeep' -delete
bash bin/check-netlink-patches.sh

cd /tmp
wget -O lms-master-30082026.zip "https://ksef2lms.idzik.pl/?track=lms-master-30082026.zip"
unzip -q lms-master-30082026.zip -d /tmp/lms-src

rsync -a --exclude vendor --exclude templates_c --exclude cache --exclude .git \
  /tmp/lms-src/lms-master/ /sciezka/lms/

cd /sciezka/lms
composer update n1ebieski/ksef-php-client components/jqueryui --with-dependencies --no-dev
mkdir -p js/jqueryui/dist
if [ -f vendor/components/jqueryui/dist/jquery-ui.min.js ]; then
  cp -a vendor/components/jqueryui/dist/jquery-ui.min.js js/jqueryui/dist/
else
  ln -sf ../jquery-ui.min.js js/jqueryui/dist/jquery-ui.min.js
fi
python3 bin/patch-netlink.py /sciezka/lms
php devel/upgradedb.php -C /etc/lms/lms.ini
find templates_c -type f ! -name '.gitkeep' -delete
bash bin/check-netlink-patches.sh

Uwagi lub zapytania dotyczące działania integracji można zgłaszać na adres: cocoban78@gmail.com.