Download the PHP package szymon-s292/ksef-client without Composer
On this page you can find all versions of the php package szymon-s292/ksef-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download szymon-s292/ksef-client
More information about szymon-s292/ksef-client
Files in szymon-s292/ksef-client
Package ksef-client
Short Description A KSeF 2.0 client library for PHP with support for XAdES authentication.
License
Informations about the package ksef-client
KSeF Client
Biblioteka PHP do komunikacji z API KSeF 2.0 z możliwością autoryzacji przez certyfikat KSeF - jedyną możliwość autoryzacji od 1 stycznia 2027 roku. Biblioteka jest bardzo prosta w użyciu i nie wielka.
Setup
Klasy biblioteki
-
Enum 'KsefMode' - dostępne środowiska KSeF w jakim ma działać biblioteka. (::TEST - Testowe, ::DEMO - Przedprodukcyjne, ::PROD - Produkcyjne)
-
Klasa 'Auth' - uwierzytelnianie przez certyfikat, token i możliwość automatycznego nimi zarządzania w bazie MySQL (TokenManager).
-
Klasa 'InteractiveSession' - zarządzanie sesją interaktywną do wysyłki faktur i pobierania ich statusu.
- Klasa 'KsefApi' - bezpośrednia interakcja z API
Przykłady użycia
Autoryzacja
Pobranie tokenów dostępowych przy użyciu autoryzacji certyfikatem.
Pobranie tokenów dostępowych przy użyciu autoryzacji tokenem.
W obu powyższych przpadkach należy samodzielnie zapisać pobrane tokeny
Funkcja automatycznego zarządzenia i odświeżania tokenów. Klasa 'Auth' zarządza wtedy tokenami w tabelach tokens i subjects i odświeża je automatycznie.
-
Należy utworzyć tabele
tokensisubjects(dump struktury znajduje się w pliku db.php). -
W tabeli
subjectsdodać swój podmiot dla którego się uwierzytelnia - Przed użyciem klasy 'Auth' zdefiniować 4 zmienne połączeniowe do bazy MySQL
Uwierzytelnienie KSeF z automatycznym odświeżaniem i zapisywaniem tokenów
Nie należy używać metod auth_with_token() lub auth_with_xades() ponieważ powodują one rozpoczęcie nowego procesu autoryzacji. Funckja get_access_token() wywoła je automatycznie jeżeli token wygaśnie.
Wysyłka faktur i pobieranie ich statusu i UPO
Rozpoczęcie sesji interaktywnej do wysyłki faktur.
Wysyłka faktury do KSeF w sesji interaktywnej.
Zamykanie sesji interaktywnej.
Pobieranie statusu faktury z sesji interaktywnej.
Pobieranie UPO faktury
Pobieranie faktur
In progress...