Integracja KSeF w Java

Java to jeden z najpopularniejszych języków do integracji z KSeF. Przedstawiamy przykład z Spring Boot.

Wymagania

•Java 17+

•Spring Boot 3.x

•JAXB (generowanie XML)

•HttpClient lub RestTemplate

Konfiguracja projektu

Dodaj zależności w pom.xml:

•spring-boot-starter-web

•jakarta.xml.bind-api

•jaxb-runtime

Generowanie klas z XSD

Użyj JAXB do wygenerowania klas Java ze schematu XSD faktury KSeF:

xjc -d src/main/java -p pl.ksef.model schema_fa2.xsd

Klient API KSeF

Utwórz serwis KSeFClient z metodami:

•openSession(token) — otwarcie sesji

•sendInvoice(sessionToken, invoiceXml) — wysyłka faktury

•getInvoiceStatus(sessionToken, referenceNumber) — status

•closeSession(sessionToken) — zamknięcie sesji

Generowanie XML faktury

Użyj JAXB Marshaller do serializacji obiektu faktury do XML:

JAXBContext context = JAXBContext.newInstance(Faktura.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

Obsługa certyfikatów

Do podpisywania użyj Java KeyStore i XMLDSig API:

•Załaduj certyfikat z pliku .p12 lub karty PKCS#11

•Podpisz XML zgodnie z wymaganiami KSeF

Testy

•Użyj środowiska testowego KSeF

•Mockuj API w testach jednostkowych

•Testuj integracyjnie z prawdziwym API

Uproszczenie — Proxy KSeF

Zamiast implementować pełną integrację, możesz użyć proxy KSeF i komunikować się prostym REST API.

Integracja KSeF w Java — przykład z Spring Boot