>Instrukcje techniczne>Rejestracja legitymacji szkolnych>Import legitymacji uczniów z pliku xml – przygotowanie pliku

Instrukcje techniczne

Import legitymacji uczniów z pliku xml – przygotowanie pliku

Powrót do listy

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:

  1. Wszystkie wymagane pola w pliku xml powinny mieć wartość różną od pustego ciągu znaków.
  2. Format pliku dopuszczonego do importu w SIO: xml.
  3. 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

 

Pobierz plik 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

  1. 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”: []

}
  1. 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”: []

}
  1. 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”

}