Niezgodność schematów danych KSeF z rekomanedacjami
Stowarzyszenie STODAP skupia w swoich szeregach przede wszystkim profesjonalistów pracujących od lat w branży systemów rozwój sektora usług publicznych.
Nasi Specjaliści od lat zajmują się zagadnieniami jakości danych, interoperacyjności systemów informatycznych oraz zgodności rozwiązań IT administracji publicznej z obowiązującymi rekomendacjami i standardami. W ramach tej działalności analizowaliśmy również schematy danych publikowane w ramach Krajowego Systemu e-Faktur (KSeF). 👉 http://crd.gov.pl/wzor/2025/06/25/13775/

W niniejszym artykule przedstawiamy analizę niezgodności schematu danych KSeF z „ 👉 Rekomendacją w sprawie atomowych struktur danych”, publikowaną w Repozytorium Interoperacyjności ePUAP.
1. Kontekst analizy
Schemat danych będący przedmiotem analizy pochodzi z oficjalnych wzorów schematów XML KSeF, publikowanych na stronie: 👉
Analiza dotyczy w szczególności struktury adresowej stosowanej w schematach faktury (FA), m.in. w wariancie FA(3).
2. Rekomendacja w sprawie atomowych struktur danych – przypomnienie zasad
Zgodnie z Rekomendacją w sprawie atomowych struktur danych:
„Struktury danych wykorzystywane w wymianie informacji pomiędzy systemami administracji publicznej powinny być projektowane w sposób atomowy, tj. każdy element danych powinien opisywać jedną, niepodzielną semantycznie informację.”
Oznacza to w praktyce:
- jeden element XML = jedno znaczenie,
- brak łączenia wielu informacji w jednym polu,
- możliwość jednoznacznej interpretacji danych przez systemy informatyczne,
- możliwość walidacji, mapowania i ponownego wykorzystania danych.
Adres jest klasycznym przykładem danych, które nie są atomowe w formie „liniowej”, a wymagają rozbicia na elementy składowe.
3. Analizowany fragment schematu KSeF
W schematach danych KSeF stosowana jest m.in. następująca struktura:
1 <Adres>2 <KodKraju>PL</KodKraju>3 <AdresL1>ul. Kwiatowa 1 m. 2</AdresL1>4 <AdresL2>00-001 Warszawa</AdresL2>5</Adres>
Analogiczna struktura występuje dla kolejnych podmiotów (sprzedawca, nabywca).
4. Identyfikacja niezgodności z Rekomendacją
4.1. Brak atomowości danych adresowych
Element <AdresL1> zawiera jednocześnie:
- rodzaj drogi („ul.”),
- nazwę ulicy,
- numer budynku,
- numer lokalu.
Element <AdresL2> zawiera jednocześnie:
- kod pocztowy,
- nazwę miejscowości.
Są to odrębne informacje semantyczne, które – zgodnie z Rekomendacją – nie powinny być łączone w jednym elemencie danych.
4.2. Charakter prezentacyjny pól AdresL1 / AdresL2
Zgodnie z interpretacją Rekomendacji interoperacyjności:
- struktury typu „AdresL1”, „AdresL2” mają charakter opisowy i prezentacyjny,
- są dopuszczalne na warstwie wizualnej (np. PDF, HTML),
- nie są zalecane do wymiany danych pomiędzy systemami informatycznymi.
Tymczasem w KSeF pola te stanowią jedyną postać danych adresowych, co wymusza ich użycie w integracjach system–system.
4.3. Skutki praktyczne nieatomowej struktury
Z perspektywy jakości danych i interoperacyjności powoduje to m.in.:
- brak możliwości automatycznej walidacji poszczególnych elementów adresu,
- utrudnione mapowanie danych do innych rejestrów (TERYT, rejestry adresowe, systemy ERP),
- ryzyko niejednoznacznej interpretacji danych,
- problemy przy dalszym przetwarzaniu danych (analizy, raportowanie, integracje międzysystemowe).
5. Przykład struktury zgodnej z Rekomendacją
Dla porównania, adres zgodny z zasadą atomowości mógłby przyjmować postać:
Taka struktura:
1<Adres>2 <KodKraju>PL</KodKraju>3 <RodzajUlicy>ulica</RodzajUlicy>4 <NazwaUlicy>Kwiatowa</NazwaUlicy>5 <NumerBudynku>1</NumerBudynku>6 <NumerLokalu>2</NumerLokalu>7 <KodPocztowy>00-001</KodPocztowy>8 <Miejscowosc>Warszawa</Miejscowosc>9</Adres>
- spełnia wymogi atomowości,
- jest jednoznaczna semantycznie,
- umożliwia interoperacyjność na poziomie technicznym i semantycznym.
6. Wnioski Stowarzyszenia STODAP
- Schematy danych KSeF w obecnym kształcie nie są zgodne z Rekomendacją w sprawie atomowych struktur danych.
- Niezgodność dotyczy w szczególności sposobu modelowania danych adresowych.
- Zastosowane rozwiązanie ma charakter prezentacyjny, a nie interoperacyjny.
- Brak atomowości danych adresowych może w dłuższej perspektywie prowadzić do problemów integracyjnych i jakościowych problemów z danymi.
7. Rekomendacje Stowarzyszenia
Stowarzyszenie STODAP postuluje:
- rewizję struktur adresowych w schematach KSeF,
- wprowadzenie atomowych elementów danych zgodnych z Rekomendacją interoperacyjności,
- zachowanie pól liniowych (AdresL1/AdresL2) wyłącznie jako opcjonalnych pól prezentacyjnych.
Artykuł wyraża stanowisko i uwagi Stowarzyszenia STODAP
i ma na celu merytoryczną dyskusję nad jakością oraz interoperacyjnością danych w systemach administracji publicznej.