Biblioteka pozwala na tworzenie dokumentów JPK_FA(3), wysyłkę faktur do KSeF jako pojedynczych dokumentów, a także jako wysyłkę wsadową. Daje możliwość konfiguracji serwisu KSEFDispatcher.
Do poprawnego działania potrzebujemy bibliotek:
pKSeF.dll
plazaKSeFLib.dll
plazaKSeFLibNE.dll
PlazaKSeFLib.runtimeconfig.json
PlazaKSeFLib.deps.json
Do generowania kodów QR dodatkowo potrzebna jest bibloteka:
libSkiaSharp.dll
Aby poprawnie skonfigurować kominikację niezbędne jest posiadanie:
a) certyfikatu i klucza. lub
b) tokenu
Zarówno certyfikat, token jak i klucz można uzyskać ze strony ministerstwa finansów
Certyfikaty mogą być wydane na konkretnego użytkownika. Z certyfikatu w konfiguracji system skorzysta jeśli użytkownik nie ma prywatnego certyfikatu.
rys 1 konfiguracja interfejsu
1. Baza danych - ważne tylko dla testów samej biblioteki. Podczas pracy Plaza się łączy z właściwą bazą danych na której pracuje użytkownik
2. Certyfikat, token - jak wyżej. System będzie korzystał tylko wtedy, gdy dane te nie będą zdefiniowane w danych użytkownika. Każdy użytkownik może mieć inny certyfikat lub token
3. Środowisko - istotne. Proszę wybrać "produkcja" dla rzeczywistej wysyłki.
4. Serwis - tylko podczas korzystania KSeFDispatcher. Jeśli wybierzemy tryb interaktywny system będzie sam wysyłał faktury i żądał odpowiedzi.
okno bibliotek
Wybieramy właściwa metodę wysyłki. Jeśli chcemy skorzystać z zewnętrznego dostawcy (np certum czy LibGovPl) możemy wybrać je w tym oknie. Wybór dostawcy jest istotny dla sposobu uwierzytelniania i szczegółowo to opisujemy w tematach poświęconych wysyłce.
Polecamy pKSeF (lub plazaKSeFLib) i uwierzytelnienie token
Dostawca Xades może być zewnętrzny - dotyczy tylko certyfikatów.
Do walidacji JPK używamy pliku XSD. Jeśli ten plik nie jest zdefiniowany używamy walidacji wbudowanej w bibliotekę. Każda zmiana struktury JPK wymaga zmianę pliku XSD.
Położenie OpenSSL - istotne do wysyłki oraz certyfikatów
Położenie bibliotek i konfiguracji
plazaKSeFLib.dll
plazaKSeFLibNE.dll
PlazaKSeFLib.runtimeconfig.json
libSkiaSharp.dll
- nie musza one znajdować się w bieżącym katalogu. Jeśli korzystamy z KSeFDispatcher mogą się w katalogu tego programu. Ważne aby wskazać w konfiguracji ich położenie.
Ważne - błędy sa raportowane w pliku
KSeF.NET.log w katalogu Logs