Import legitymacji uczniów z pliku xml – przygotowanie pliku

Data ostatniej modyfikacji:

23 grudnia 2025

Import legitymacji uczniów z pliku xml – przygotowanie pliku

W SIO zostanie udostępniona możliwość zaimportowania legitymacji oraz zdjęć uczniów do rejestru legitymacji za pomocą pliku xml.

Ogólne informacje o strukturze pliku xml:

Wszystkie wymagane pola w pliku xml powinny mieć wartość różną od pustego ciągu znaków.
Format pliku dopuszczonego do importu w SIO: xml.
Legitymacje i zdjęcia można zaimportować jedynie dla uczniów posiadających numer PESEL.

Występujące pola:

Nazwa pola	Typ / format	Opis	Czy wymagane
rspoNumber	cyfry	Numer RSPO jednostki oświatowej (szkoły).	Tak
pesel	11 cyfr	Numer PESEL	Tak
firstName	tekst	Pierwsze imię Maksymalna ilość znaków: 50	Tak
secondname	tekst	Drugie imię Maksymalna ilość znaków: 50	Nie
lastName	tekst	Nazwisko Maksymalna ilość znaków: 50	Tak
issueDate	YYYY-MM-DD	Data wydania legitymacji YYYY – Rok MM – miesiąc w formacie dwóch cyfr np. Marzec jako 03 DD – dzień w formacie dwóch cyfr np. pierwszy dzień miesiąca jako 01	Tak
number	tekst	Numer legitymacji Maksymalna ilość znaków: 50	Tak
photo	base64Binary	Zdjęcie ucznia RFC 4648: The Base16, Base32, and Base64 Data Encodings	Nie
disability	0 lub 1	Oznaczenie (flaga), legitymacji dla osoby z niepełnosprawnością. Wartość jeden (1) oznacza legitymacje dla osoby z niepełnosprawnością. Wartość zero (0) oznacza legitymację dla osoby bez niepełnosprawności.	Tak
endDate	YYYY-MM-DD	Data ważności legitymacji YYYY – Rok MM – miesiąc w formacie dwóch cyfr np. Marzec jako 03 DD – dzień w formacie dwóch cyfr np. pierwszy dzień miesiąca jako 01	Tak
type	enum	Typ legitymacji: enum (’Plastic’, 'Paper’)	Tak
duplicate	0 lub 1	Wartość oznaczająca duplikat dokumentu legitymacji. W systemie brak wiązania z pierwotnym dokumentem. Pole dodatkowe dla zachowania spójności po stronie systemów zewnętrznych.	Nie

Link do xsd

Pod adresem https://xml.sio.gov.pl można zweryfikować poprawność struktury pliku.

UWAGA: aplikacja weryfikuje jedynie poprawność struktury pliku, a nie danych w nim się znajdujących. Walidacja danych następuje po zaimportowaniu pliku xml w rejestrze legitymacji SIO.

Odpowiedzi w aplikacji walidującej

Plik poprawny:

HTTP/1.1 200

Content-Type: application/json

Transfer-Encoding: chunked

Date: Mon, 15 Dec 2025 09:57:55 GMT

{

„success”: true,

„errors”: [],

„warnings”: []

}

Plik niepoprawny, nie przeszedł walidacji:

HTTP/1.1 400

Content-Type: application/json

Transfer-Encoding: chunked

Date: Mon, 15 Dec 2025 09:59:28 GMT

Connection: close

{

„success”: false,

„errors”: [

„Wartość '12345678901321′ nie pasuje do wzorca '\\d{11}’ (typ: 'PeselType’).”,

„Wartość '12345678901321′ jest niepoprawna dla elementu 'sc:pesel’.”,

„Wartość 'Wooden’ nie należy do dozwolonego zbioru wartości. Dozwolone wartości to '[Plastic, Paper]’.”,

„Wartość 'Wooden’ jest niepoprawna dla elementu 'sc:type’.”,

„Niepoprawna struktura XML — znaleziono nieoczekiwany element 'randomInvalidTag’. W tym miejscu oczekiwano elementu '{\”http://www.sio.gov.pl/student_cards\”:student, \”http://www.sio.gov.pl/student_cards\”:rspoNumber}’.”

„warnings”: []

}

Błędy techniczne:

HTTP/1.1 500

Content-Type: application/json

Transfer-Encoding: chunked

Date: Mon, 15 Dec 2025 10:24:22 GMT

Connection: close

{

„timestamp”: „2025-12-15T10:24:22.143+00:00”,

„status”: 500,

„error”: „Internal Server Error”,

„path”: „/api/leg/xml/validate”

}

Instrukcje techniczne

Import legitymacji uczniów z pliku xml – przygotowanie pliku