Stodap Logo

Niezgodność schematów danych KSeF z rekomanedacjami

14 min. czytania

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

  1. Schematy danych KSeF w obecnym kształcie nie są zgodne z Rekomendacją w sprawie atomowych struktur danych.
  2. Niezgodność dotyczy w szczególności sposobu modelowania danych adresowych.
  3. Zastosowane rozwiązanie ma charakter prezentacyjny, a nie interoperacyjny.
  4. 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.