{"openapi":"3.1.0","info":{"title":"CRU API – Umowy","description":"Dokument integracyjny dostępny pod: https://jsfp-rejestrumow.gov.pl/docs","version":"1.3.2"},"servers":[{"url":"https://jsfp.rejestrumow.gov.pl","description":"Generated server url"}],"tags":[{"name":"API do obsługi umów","description":"Publiczne API do odczytu i publikacji umów: udostępnia punkty końcowe do pobrania umowy po numerze systemowym, przeglądania podsumowań oraz wysyłania paczek umów do utworzenia lub aktualizacji"}],"paths":{"/v1/api/publish/withdraw":{"post":{"tags":["API do obsługi umów"],"summary":"Wycofanie umów z publikacji.","description":"Wycofuje opublikowane umowy z publikacji.\n\nOperacja jest dostępna wyłącznie dla umów:\n- posiadających status „Opublikowana”,\n- niebędących w trakcie modyfikacji.\n\nDla każdej umowy wymagane jest przekazanie uzasadnienia wycofania.\n\nPole `agreementIds` pozwala na jednoczesne wycofanie wielu umów.\n\nOperacja jest rejestrowana w historii zmian umowy wraz z przekazanym komentarzem.\n","operationId":"withdrawFromPublicationBatch","requestBody":{"description":"Żądanie wycofania opublikowanych umów z publikacji.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Wycofanie umów z publikacji"},"example":{"umowy":[{"agreementId":"2d3ff111-fee7-4477-8556-c4c2102039cc","komentarz":"Informacja stanowi tajemnicę przedsiębiorstwa."},{"agreementId":"7b47cb4e-d15f-43ca-b9c7-7a48c7a8f47d","komentarz":"Wycofanie na wniosek jednostki."}]}}},"required":true},"responses":{"200":{"description":"Żądanie zostało przetworzone. Każda umowa może zostać wycofana lub zwrócona jako błąd biznesowy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzPublikacjiUmowy_Public"},"example":{"message":"Wycofano 1 umów. Liczba elementów z błędami: 2","successCount":1,"errorCount":2,"success":{"0":{"status":"UPDATED","message":"Umowa została wycofana z publikacji.","agreementId":"02ca948c-fc84-493c-bfc8-0444015ba7a2","externalSystemId":"EXT_B"}},"errors":{"1":{"status":"VALIDATION_ERROR","message":"Umowę można wycofać z publikacji tylko ze statusu Opublikowana.","agreementId":"a0faa3b8-def2-4144-af41-65be6e60148d"},"2":{"status":"NOT_EXISTS","message":"Nie znaleziono umowy dla podanego identyfikatora.","agreementId":"cddab2be-6cb3-4e45-960b-9af4d9eeb551"}}}}}},"400":{"description":"Błędne dane wejściowe lub niepoprawny format żądania.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"403":{"description":"Brak uprawnień lub niepoprawny X-API-KEY.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"404":{"description":"Nie znaleziono umowy dla podanego identyfikatora.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"500":{"description":"Błąd serwera.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/api/publish/agreements":{"post":{"tags":["API do obsługi umów"],"summary":"Publikacja oraz aktualizacja umów.","description":"Tworzy lub aktualizuje umowy przekazane w żądaniu).\n\n- Jeśli `agreementId` jest podany → aktualizacja istniejącej umowy.\n- Jeśli `agreementId` nie jest podany → utworzenie nowej umowy.\n\nPole `numerPorzadkowy` służy do mapowania błędów w odpowiedzi (w liście `errors` oraz w liście 'success').","operationId":"upsertAgreementsBatch","requestBody":{"description":"Lista umów do publikacji oraz aktualizacji.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Umowa"}},"example":[{"numerPorzadkowy":1,"externalSystemId":"ABC/100","komorkaWewnetrznaJsfp":"Oddział II","finansowanaZeSrodkow":true,"podstawoweDane":{"statusUmowy":"Aktywna","numerUmowy":"02_16.10_923","brakNumeruUmowy":false,"dataZawarciaUmowy":"21.08.2026"},"okresObowiazywania":{"umowaNaCzasNieoznaczony":false,"okresLiczba":10,"okresJednostka":"dzień"},"szczegolyUmowy":{"przedmiotUmowy":"Przykładowy przedmiot umowy","niejawnoscWartosciPrzedmiotu":{"zakres":"SC04","podstawa":"art_5_ust_1","organLubOsobaWylaczajaca":"PKS"}},"stronyUmowy":[{"rodzaj":"SU03","regon":"123456789"},{"rodzaj":"SU02","kraj":"PL","imie":"Krzysztof","nazwisko":"Laban","czyKonsorcjum":true},{"kraj":"PL","rodzaj":"SU01","nip":"1234567890","czyKonsorcjum":true},{"kraj":"PL","rodzaj":"SU03","regon":"123456777","czyKonsorcjum":false},{"kraj":"DE","rodzaj":"SU01","nazwa":"Example GmbH","czyKonsorcjum":false,"daneAdresowe":{"ulica":"Hauptstrasse","numerNieruchomosci":"10","numerLokalu":"2","miejscowosc":"Berlin","kodPocztowy":"10115"}}],"zmianyUmowy":[{"rodzajZmiany":"TSU02","dataZmiany":"20.09.2026","komentarz":"Przykładowy komentarz"}]}]}},"required":true},"responses":{"200":{"description":"Batch przetworzony. Każdy element żądania może zakończyć się sukcesem albo błędem biznesowym/walidacyjnym.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzPublikacjiUmowy_Public"},"example":{"message":"Wczytano 1 umów. Liczba elementów z błędami: 2","successCount":1,"errorCount":2,"success":{"1":{"status":"CREATED","message":"Umowa została utworzona.","agreementId":"b6969777-f044-42de-ad29-5a298971c90d","externalSystemId":"ABC/123"}},"errors":{"2":{"status":"VALIDATION_ERROR","message":"Wystąpiły błędy walidacji.","fields":{"stronyUmowy[1].nip":"Dla strony umowy z Polski wymagane jest przekazanie numeru NIP albo REGON.","stronyUmowy[1].regon":"Dla strony umowy z Polski wymagane jest przekazanie numeru NIP albo REGON.","stronyUmowy[1].czyKonsorcjum":"Pole jest wymagane."}},"3":{"status":"VALIDATION_ERROR","message":"Wystąpiły błędy walidacji.","fields":{"stronyUmowy[1].nazwa":"Dla strony umowy z Polski nie należy przekazywać nazwy. Nazwa jest pobierana z rejestru REGON.","stronyUmowy[1].daneAdresowe":"Dla strony umowy typu JSFP nie można przekazywać danych adresowych. Adres jest pobierany z rejestru REGON."}}}}}}},"400":{"description":"Błędne dane wejściowe / niepoprawny format JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"403":{"description":"Brak uprawnień.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"500":{"description":"Błąd serwera.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/api/publish/{agreementId}":{"get":{"tags":["API do obsługi umów"],"summary":"Pobranie szczegółów umowy po numerze systemowym","description":"Endpoint służy do pobrania szczegółów umowy na podstawie numeru systemowego.\n\n**Ważne:**\n- endpoint jest dostępny wyłącznie dla użytkowników posiadających rolę `Publikujący` w kontekście JSFP (weryfikacja po REGON),\n\nUprawnienia:\n- wymagane posiadanie roli `Publikujący` w kontekście JSFP.\n\nInformacje dodatkowe:\n- do pobrania danych potrzebny jest 'numer systemowy', bo umowa może nie mieć nadanego numeru umowy.\n","operationId":"getAgreementByIdForApi","parameters":[{"name":"agreementId","in":"path","description":"ID umowy (identyfikator wewnętrzny w systemie) używany do pobrania szczegółów umowy","required":true,"schema":{"type":"string","format":"uuid"},"example":"1d46ae8a-dc4b-46dd-bf4a-1e1e94b3781e"}],"responses":{"200":{"description":"Zwrócono szczegóły umowy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzSzczegolowUmowy_Public"},"example":{"statusProcesowy":"Opublikowana","numerSystemowy":1182,"komorkaWewnetrznaJsfp":"Oddział III","podstawoweDane":{"statusUmowy":"Aktywna","numerUmowy":"02_16.10_92","brakNumeruUmowy":false,"dataZawarciaUmowy":"20.08.2026"},"okresObowiazywania":{"umowaNaCzasNieoznaczony":false,"okres":"10 dni"},"szczegolyUmowy":{"przedmiotUmowy":"Przykładowy przedmiot umowy","niejawnoscPrzedmiotu":null,"wartoscPrzedmiotu":null,"niejawnoscWartosciPrzedmiotu":{"podstawa":"ART_5_UST_1","zakres":"SC04","komentarz":"Nowy komentarz","organLubOsobaWylaczajaca":"PKS"},"opisWartosciPrzedmiotu":"Wartość przykładowego przedmiotu"},"stronyUmowy":[{"kraj":"PL","rodzaj":"SU03","czyKonsorcjum":true,"nazwa":"Urząd Miasta","nip":"5212978434","regon":"551112229","daneAdresowe":{"ulica":"Rzymowskiego","numerNieruchomosci":"11","numerLokalu":"12","wojewodztwo":"Mazowieckie","powiat":"Warszawa","gminaMiastoDzielnica":"Wesoła","miejscowosc":"Warszawa","kodPocztowy":"12-234"}},{"kraj":"PL","rodzaj":"SU02","niejawnoscStrony":{"podstawa":"ART_5_UST_1","zakres":"SC02","komentarz":"Przykładowy komentarz","organLubOsobaWylaczajaca":"Marcin Nowak"},"czyKonsorcjum":true},{"kraj":"PL","rodzaj":"SU01","czyKonsorcjum":true,"nazwa":"Przedsiębiorstwo Mazowieckie","nip":"5212978434","regon":"146123459","daneAdresowe":{"ulica":"Konopieja","numerNieruchomosci":"33","numerLokalu":"12","wojewodztwo":"Mazowieckie","powiat":"Warszawa","gminaMiastoDzielnica":"Wesoła","miejscowosc":"Warszawa","kodPocztowy":"12-234"}}],"finansowanaZeSrodkow":true,"zmianyUmowy":[{"rodzajZmiany":"TSU02","dataZmiany":"20.09.2026","komentarz":"Przykładowy komentarz"}],"dataPublikacji":"24.02.2026"}}}},"400":{"description":"Niepoprawne dane wejściowe lub błąd walidacji.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"},"example":{"message":"Niepoprawny numer systemowy."}}}},"403":{"description":"Brak uprawnień do wykonania operacji.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"},"example":{"message":"Brak uprawnień."}}}},"404":{"description":"Nie znaleziono umowy dla podanego numeru systemowego.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"},"example":{"message":"Nie znaleziono umowy o podanym numerze systemowym."}}}},"500":{"description":"Błąd serwera.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"},"example":{"message":"Wystąpił nieoczekiwany błąd serwera."}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/api/publish/summary":{"get":{"tags":["API do obsługi umów"],"summary":"Lista streszczeń umów - do uzyskania numeru systemowego","description":"Endpoint umożliwia pobranie listy streszczeń umów z zastosowaniem filtrowania, sortowania oraz stronicowania wyników.\n\nFiltry tekstowe (`numerUmowy`, `przedmiotUmowy`) realizowane są jako dopasowanie typu *LIKE* (wyszukiwanie fragmentu, bez rozróżniania wielkości liter).\n\nFiltry dat (`dataZawarciaUmowyOd`, `dataZawarciaUmowyDo`) zawężają wynik do zakresu dat (wartości graniczne włącznie).\n\nKryteria filtrowania łączone są logicznie operatorem AND.","operationId":"getAgreementsSummary","parameters":[{"name":"numerUmowy","in":"query","description":"Filtr po numerze umowy (dopasowanie typu LIKE, bez rozróżniania wielkości liter).","required":false,"schema":{"type":"string"},"example":"UM/2026"},{"name":"przedmiotUmowy","in":"query","description":"Filtr po przedmiocie umowy (dopasowanie typu LIKE, bez rozróżniania wielkości liter).","required":false,"schema":{"type":"string"},"example":"sprzęt komputerowy"},{"name":"agreementIds","in":"query","description":"Filtr po identyfikatorach umów.","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"uniqueItems":true},"example":"1d46ae8a-dc4b-46dd-bf4a-1e1e94b3781e, 1c04ad5d-a136-4783-b3f6-3c42bf2d164d"},{"name":"externalSystemIds","in":"query","description":"Filtr po identyfikatorach zewnętrznych.","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true},"example":"ABC/1000, ABC/2000"},{"name":"dataZawarciaUmowyOd","in":"query","description":"Początek zakresu daty zawarcia umowy (wartość włącznie). Format: dd.MM.yyyy.","required":false,"schema":{"type":"string","format":"date"},"example":"01.01.2026"},{"name":"dataZawarciaUmowyDo","in":"query","description":"Koniec zakresu daty zawarcia umowy (wartość włącznie). Format: dd.MM.yyyy.","required":false,"schema":{"type":"string","format":"date"},"example":"01.01.2026"},{"name":"sortDirection","in":"query","description":"Kierunek sortowania wyników (ASC – rosnąco, DESC – malejąco). Domyślnie: DESC.","required":false,"schema":{"type":"string","enum":["ASC","DESC"]},"example":"DESC"},{"name":"offset","in":"query","description":"Offset – indeks pierwszego rekordu w zwracanym zbiorze (mechanizm paginacji). Domyślnie: 0.","required":false,"schema":{"type":"string","minimum":0},"example":0},{"name":"limit","in":"query","description":"Limit – maksymalna liczba rekordów zwracanych w jednej odpowiedzi. Domyślnie: 20.","required":false,"schema":{"type":"string","minimum":1},"example":20}],"responses":{"200":{"description":"Lista streszczeń umów.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedResponse_Public"},"example":{"content":[{"przedmiotUmowy":"PL","numerSystemowy":123456789,"numerUmowy":"UM/2026/001","statusUmowy":"Aktywna","dataZawarciaUmowy":"11.02.2026"}],"total":1,"offset":0,"limit":20}}}},"400":{"description":"Błędne parametry zapytania (np. niepoprawny format daty).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"403":{"description":"Brak uprawnień / niepoprawny X-API-KEY.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"500":{"description":"Błąd serwera.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/api/publish/status":{"get":{"tags":["API do obsługi umów"],"summary":"Lista statusów umów - do uzyskania statusów wgranych umów.","description":"Endpoint umożliwia pobranie informacji o statusie publikacji umów na podstawie listy identyfikatorów systemu zewnętrznego oraz/lub listy identyfikatorów umów CRU.\n\nParametr `externalSystemIds` przyjmuje listę identyfikatorów systemu zewnętrznego, co pozwala na jednoczesne sprawdzenie statusu wielu umów.\n\nParametr `agreementIds` przyjmuje listę identyfikatorów umów CRU, co pozwala na jednoczesne sprawdzenie statusu wielu umów.\n\nW przypadku braku podanych parametrów zwracane są wszystkie dostępne wyniki.","operationId":"getAgreementsStatus","parameters":[{"name":"agreementIds","in":"query","description":"Filtr po identyfikatorach umów.","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"uniqueItems":true},"example":"1d46ae8a-dc4b-46dd-bf4a-1e1e94b3781e, 1c04ad5d-a136-4783-b3f6-3c42bf2d164d"},{"name":"externalSystemIds","in":"query","description":"Filtr po identyfikatorach zewnętrznych.","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true},"example":"ABC/1000, ABC/2000"},{"name":"offset","in":"query","description":"Offset – indeks pierwszego rekordu w zwracanym zbiorze (mechanizm paginacji). Domyślnie: 0.","required":false,"schema":{"type":"string","minimum":0},"example":0},{"name":"limit","in":"query","description":"Limit – maksymalna liczba rekordów zwracanych w jednej odpowiedzi. Domyślnie: 20.","required":false,"schema":{"type":"string","minimum":1},"example":20}],"responses":{"200":{"description":"Lista statusów umów.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedResponse_Public"},"example":{"content":[{"agreementId":"c59cdd10-1691-44b6-812d-529ad0173cbe","externalSystemId":"1/100","status":"EXISTS","message":"Taka umowa już istnieje w systemie."},{"externalSystemId":"2222/22","status":"NOT_EXISTS","message":"Nie znaleziono umowy dla podanego identyfikatora."}],"total":2,"offset":0,"limit":20}}}},"400":{"description":"Błędne parametry zapytania (np. niepoprawny format UUID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"403":{"description":"Brak uprawnień / niepoprawny X-API-KEY.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}},"500":{"description":"Błąd serwera.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdpowiedzBledow_Public"}}}}},"security":[{"ApiKeyAuth":[]}]}}},"components":{"schemas":{"ElementWycofaniaUmowy":{"type":"object","description":"Dane pojedynczej umowy przeznaczonej do wycofania z publikacji.","properties":{"agreementId":{"type":"string","format":"uuid","description":"Identyfikator umowy przeznaczonej do wycofania z publikacji.","example":"2d3ff111-fee7-4477-8556-c4c2102039cc"},"komentarz":{"type":"string","description":"Uzasadnienie wycofania umowy z publikacji.","example":"Informacja stanowi tajemnicę przedsiębiorstwa.","maxLength":500,"minLength":0}},"required":["agreementId","komentarz"],"title":"ElementWycofaniaUmowy"},"Wycofanie umów z publikacji":{"type":"object","description":"Żądanie wycofania opublikowanych umów z publikacji przez system integrujący się z CRU API.","properties":{"umowy":{"type":"array","description":"Lista umów przeznaczonych do wycofania z publikacji wraz z uzasadnieniem.","items":{"$ref":"#/components/schemas/ElementWycofaniaUmowy"},"minItems":1}},"required":["umowy"],"title":"Wycofanie umów z publikacji"},"AgreementBatchErrorResponseDto_Public":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"agreementId":{"type":"string","format":"uuid"},"fields":{"type":"object","additionalProperties":{"type":"string"}}}},"AgreementBatchSuccessResponseDto_Public":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"agreementId":{"type":"string","format":"uuid"},"externalSystemId":{"type":"string"}}},"OdpowiedzPublikacjiUmowy_Public":{"type":"object","description":"Odpowiedź z podsumowaniem przetwarzania umów","properties":{"message":{"type":"string","description":"Komunikat wynikowy","example":"Wczytano 0 umów. Liczba elementów z błędami: 3"},"successCount":{"type":"integer","format":"int32","description":"Liczba poprawnie przetworzonych umów","example":0},"errorCount":{"type":"integer","format":"int32","description":"Liczba elementów zakończonych błędem","example":3},"success":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/AgreementBatchSuccessResponseDto_Public"},"description":"Mapa poprawnie przetworzonych elementów. Klucz jest wartością numeru porządkowego z żądania, a wartość zawiera wynik operacji wraz z identyfikatorami umowy.","example":{"0":{"status":"UPDATED","message":"Umowa została zaktualizowana.","agreementId":"c59cdd10-1691-44b6-812d-529ad0173cbe","externalSystemId":"122/222"},"1":{"status":"CREATED","message":"Umowa została utworzona.","agreementId":"a12cdd10-1691-44b6-812d-529ad0173caa","externalSystemId":"123/333"}}},"errors":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/AgreementBatchErrorResponseDto_Public"},"description":"Mapa elementów zakończonych błędem. Klucz jest wartością numeru porządkowego z żądania, a wartość zawiera szczegóły błędu. W przypadku błędów walidacyjnych pole 'fields' zawiera listę błędnych pól wraz z komunikatami.","example":{"2":{"status":"VALIDATION_ERROR","message":"Wystąpiły błędy walidacji.","fields":{"okresDo":"Pole 'okresDo' jest wymagane, gdy umowaNaCzasNieoznaczony = false.","okresOd":"Pole 'okresOd' jest wymagane, gdy umowaNaCzasNieoznaczony = false."}},"3":{"status":"ALREADY_EXISTS","message":"Taka umowa już istnieje w systemie.","agreementId":"c59cdd10-1691-44b6-812d-529ad0173cbe"}}}},"title":"OdpowiedzPublikacjiUmowy"},"OdpowiedzBledow_Public":{"type":"object","description":"Odpowiedź z podsumowaniem błędów podczas próby przetworzenia umów","properties":{"code":{"type":"string","enum":["UNAUTHORIZED","FORBIDDEN","INTERNAL_SERVER_ERROR","NOT_FOUND","JSON_PARSE_ERROR","UNSUPPORTED_MEDIA_TYPE","BAD_REQUEST"]},"message":{"type":"string"},"details":{"type":"object","additionalProperties":{"type":"string"}}},"title":"OdpowiedzBledow"},"DaneAdresowe":{"type":"object","description":"Adres podmiotu/strony umowy.","properties":{"ulica":{"type":"string","description":"Ulica.","example":"Marszałkowska","maxLength":351,"minLength":1},"numerNieruchomosci":{"type":"string","description":"Numer nieruchomości (np. numer budynku).","example":"10A","maxLength":20,"minLength":1},"numerLokalu":{"type":"string","description":"Numer lokalu (jeśli dotyczy).","example":15,"maxLength":20,"minLength":1},"wojewodztwo":{"type":"string","description":"Województwo.","example":"mazowieckie","maxLength":100,"minLength":1},"powiat":{"type":"string","description":"Powiat.","example":"warszawski","maxLength":100,"minLength":1},"gminaMiastoDzielnica":{"type":"string","description":"Gmina / miasto / dzielnica.","example":"Warszawa-Śródmieście","maxLength":100,"minLength":1},"miejscowosc":{"type":"string","description":"Miejscowość.","example":"Warszawa","maxLength":100,"minLength":1},"kodPocztowy":{"type":"string","description":"Dla adresu z Polski: Kod pocztowy (format: NN-NNN).","example":"00-001","maxLength":12,"minLength":1}},"title":"DaneAdresowe"},"DaneWylaczeniaJawnosci":{"type":"object","description":"Informacje o wyłączeniu jawności danych (podstawa prawna, zakres, komentarz, organ/osoba).","properties":{"podstawa":{"type":"string","description":"Podstawa wyłączenia jawności.","enum":["ART_5_UST_1","ART_5_UST_2","ART_5_UST_2A","ART_5_UST_2B","INNA"],"example":"ART_5_UST_2"},"zakres":{"type":"string","description":"Zakres danych objętych wyłączeniem jawności.\n- SC02: Dane strony umowy\n- SC03: Przedmiot umowy\n- SC04: Wartość umowy","enum":["SC02","SC03","SC04"],"example":"SC03"},"komentarz":{"type":"string","description":"Komentarz/uzasadnienie wyłączenia jawności - wymagalność zależna od wyboru podstawy (INNA).","example":"Informacja stanowi tajemnicę przedsiębiorstwa.","maxLength":500},"organLubOsobaWylaczajaca":{"type":"string","description":"Organ lub osoba wyłączająca jawność.","example":"Dyrektor Departamentu Zakupów"}},"required":["organLubOsobaWylaczajaca","podstawa","zakres"],"title":"DaneWylaczeniaJawnosci"},"PrzedsiebiorcaRequest":{"allOf":[{"$ref":"#/components/schemas/StronaUmowyRequest"},{"type":"object","properties":{"nazwa":{"type":"string","description":"Pełna nazwa przedsiębiorcy.","example":"ABC Spółka z ograniczoną odpowiedzialnością","maxLength":2000,"minLength":2},"nip":{"type":"string","description":"Numer NIP przedsiębiorcy (opcjonalny).","example":5250001009,"maxLength":10,"minLength":10},"regon":{"type":"string","description":"Numer REGON przedsiębiorcy.","example":123456789,"maxLength":14,"minLength":9},"daneAdresowe":{"$ref":"#/components/schemas/DaneAdresowe","description":"Dane adresowe przedsiębiorcy."}}}],"description":"Strona umowy typu Przedsiębiorca (rodzaj = SU01). Wymagane pola: nazwa, regon, daneAdresowe. Opcjonalne: nip.","required":["czyKonsorcjum","kraj","rodzaj"],"title":"Strona umowy – Przedsiębiorca Request"},"OsobaFizycznaRequest":{"allOf":[{"$ref":"#/components/schemas/StronaUmowyRequest"},{"type":"object","properties":{"imie":{"type":"string","description":"Imię osoby fizycznej.","example":"Jan","maxLength":200,"minLength":1},"nazwisko":{"type":"string","description":"Nazwisko osoby fizycznej.","example":"Kowalski","maxLength":200,"minLength":1}}}],"description":"Strona umowy typu Osoba fizyczna (rodzaj = SU02). Wymagane pola: imie, nazwisko.","required":["czyKonsorcjum","imie","kraj","nazwisko","rodzaj"],"title":"Strona umowy – Osoba fizyczna Request"},"JSFPRequest":{"allOf":[{"$ref":"#/components/schemas/StronaUmowyRequest"},{"type":"object","properties":{"nazwa":{"type":"string","description":"Pełna nazwa jednostki sektora finansów publicznych.","example":"Urząd Miasta Stołecznego Warszawy","maxLength":2000,"minLength":2},"nip":{"type":"string","description":"Numer NIP jednostki (opcjonalny).","example":5252248481,"maxLength":10,"minLength":10},"regon":{"type":"string","description":"Numer REGON jednostki.","example":"015259640","maxLength":14,"minLength":9},"daneAdresowe":{"$ref":"#/components/schemas/DaneAdresowe","description":"Dane adresowe jednostki."}}}],"description":"Strona umowy typu JSFP (rodzaj = SU03 – Jednostka sektora finansów publicznych). Wymagane pola: nazwa, regon, daneAdresowe. Opcjonalne: nip.","required":["czyKonsorcjum","daneAdresowe","kraj","nazwa","regon","rodzaj"],"title":"Strona umowy – JSFP Request"},"ZmianyUmowyRequest":{"type":"object","description":"Dane o wprowadzonych zmianach w umowie np. Aneks, Odstąpienie od umowy, Korekta danych.","properties":{"rodzajZmiany":{"type":"string","description":"Rodzaj zmiany.\nDozwolone wartości pola 'rodzajZmiany' to: 'TSU01' - Korekta danych,'TSU02' - Aneks do umowy,'TSU03' - Zmiana w zakresie wyłączenia jawności danych,'TSU04' - Zmiana danych strony umowy,'TSU05' - Rozwiązanie umowy,'TSU06' - Wypowiedzenie umowy,'TSU07' - Odstąpienie od umowy,'TSU10' - Wygaśniecie umowy,'TSU11' - Cesja umowy,'inne' - Inne","example":"TSU02"},"dataZmiany":{"type":"string","format":"date","description":"Data zmiany w formacie dd.MM.yyyy.","example":"11.02.2026"},"komentarz":{"type":"string","description":"Komentarz/opis zmiany.","example":"Aneks nr 1 - zmiana wartości umowy."}},"required":["dataZmiany","komentarz","rodzajZmiany"],"title":"DaneZmianUmowyRequest"},"OkresObowiazywania":{"type":"object","description":"Dane dotyczące okresu obowiązywania umowy.","properties":{"umowaNaCzasNieoznaczony":{"type":"boolean","description":"Czy umowa jest na czas nieoznaczony. ","example":false},"okresLiczba":{"type":"integer","format":"int32","description":"Liczba jednostek okresu (np. 12).","example":12,"minimum":0},"okresJednostka":{"type":"string","description":"Jednostka okresu. Dozwolone: 'dzień', 'miesiąc', 'rok'.","example":"miesiąc"},"okresOd":{"type":"string","format":"date","description":"Okres obowiązywania umowy od.","example":"01.01.2025"},"okresDo":{"type":"string","format":"date","description":"Okres obowiązywania umowy do.","example":"30.01.2026"}},"title":"OkresObowiazywania"},"PodstawoweDane":{"type":"object","description":"Podstawowe dane umowy.\n\nReguła spójności pól:\n- gdy 'brakNumeruUmowy' = true - pole 'numerUmowy' nie może być przekazane,\n- gdy 'brakNumeruUmowy' = false - pole 'numerUmowy' jest wymagane.","properties":{"statusUmowy":{"type":"string","description":"Status umowy. Dozwolone: 'Aktywna' lub 'Nieaktywna'.","example":"Aktywna"},"numerUmowy":{"type":"string","description":"Numer umowy. Wymagany, gdy 'brakNumeruUmowy' = false. Nie może być przekazany, gdy 'brakNumeruUmowy' = true.","example":"UM/2026/001"},"brakNumeruUmowy":{"type":"boolean","description":"Flaga braku numeru umowy. Jeśli true, pole 'numerUmowy' nie może być przekazane. Jeśli false, pole 'numerUmowy' jest wymagane.","example":false},"dataZawarciaUmowy":{"type":"string","format":"date","description":"Data zawarcia umowy w formacie dd.MM.yyyy.","example":"11.02.2026"},"dataZakonczeniaUmowy":{"type":"string","format":"date"}},"required":["brakNumeruUmowy","dataZawarciaUmowy","statusUmowy"],"title":"PodstawoweDaneUmowy"},"StronaUmowyRequest":{"type":"object","description":"Podstawowe dane strony umowy","discriminator":{"propertyName":"rodzaj"},"properties":{"kraj":{"type":"string","description":"Kod kraju strony umowy (ISO-3166 alpha-2).","example":"PL","maxLength":2},"rodzaj":{"type":"string","description":"Rodzaj strony umowy (discriminator).\n- SU01: Przedsiębiorca\n- SU02: Osoba fizyczna\n- SU03: JSFP\n","example":"SU03"},"niejawnoscStrony":{"$ref":"#/components/schemas/DaneWylaczeniaJawnosci"},"czyKonsorcjum":{"type":"boolean","description":"Czy strona występuje jako konsorcjum.","example":false}},"required":["czyKonsorcjum","kraj","rodzaj"],"title":"StronaUmowyRequest"},"SzczegolyUmowy":{"type":"object","description":"Dane dotyczące szczegółów umowy.\n\nReguły spójności:\n- jeśli przekazano 'niejawnoscPrzedmiotu': pole 'przedmiotUmowy' nie może być przekazane,\n- jeśli przekazano 'niejawnoscWartosciPrzedmiotu': pole 'wartoscPrzedmiotu' nie może być przekazane.","properties":{"przedmiotUmowy":{"type":"string","description":"Przedmiot umowy. Nie może być przekazany, jeżeli ustawiono wyłączenie jawności przedmiotu (pole 'niejawnoscPrzedmiotu').","example":"Dostawa sprzętu komputerowego","maxLength":1500,"minLength":1},"niejawnoscPrzedmiotu":{"$ref":"#/components/schemas/DaneWylaczeniaJawnosci","description":"Wyłączenie jawności przedmiotu umowy (zakres SC03). Jeśli przekazane, pole 'przedmiotUmowy' musi być puste (null)."},"wartoscPrzedmiotu":{"type":"string","description":"Wartość umowy. Nie może być przekazana, jeżeli ustawiono wyłączenie jawności wartości (pole 'niejawnoscWartosciPrzedmiotu').","example":12000.0,"maximum":1000000000000.00,"minimum":0},"niejawnoscWartosciPrzedmiotu":{"$ref":"#/components/schemas/DaneWylaczeniaJawnosci","description":"Wyłączenie jawności wartości umowy (zakres SC04). Jeśli przekazane, pola 'wartoscPrzedmiotu' oraz 'opisWartosciPrzedmiotu' muszą być puste (null)."},"opisWartosciPrzedmiotu":{"type":"string","description":"Opis wartości umowy (uzasadnienie/komentarz do wartości).","example":"Cena zgodnie z ofertą i protokołem odbioru.","maxLength":1500,"minLength":1}},"title":"SzczegolyUmowy"},"Umowa":{"type":"object","description":"Wszystkie dane umowy","properties":{"agreementId":{"type":"string","format":"uuid","description":"Identyfikator umowy nadawany przez system CRU. Przekazanie pola oznacza aktualizację istniejącej umowy. Brak pola oznacza utworzenie nowej umowy.","example":"b6969777-f044-42de-ad29-5a298971c90d"},"externalSystemId":{"type":"string","description":"Identyfikator nadawany przez system zewnętrzny (integratora).\n\nDozwolone znaki:\n- litery a-z, A-Z (w tym polskie znaki)\n- cyfry 0-9\n- myślnik (-)\n- kropka (.)\n- slash (/)\n- dwukropek (:)\n- podkreślenie (_)\n","example":"CRU/20260701/1000"},"numerPorzadkowy":{"type":"integer","format":"int32","description":"Numer porządkowy elementu w liście żądania. Służy do mapowania błędów w odpowiedzi (pole errors). Umowy ze zduplikowanymi numerami porządkowymi w żądaniu będą ignorowane.","example":1},"komorkaWewnetrznaJsfp":{"type":"string","description":"Komórka wewnętrzna JSFP odpowiedzialna za umowę.","example":"DW/ABC/123","maxLength":100,"minLength":1},"podstawoweDane":{"$ref":"#/components/schemas/PodstawoweDane","description":"Podstawowe dane umowy."},"okresObowiazywania":{"$ref":"#/components/schemas/OkresObowiazywania"},"szczegolyUmowy":{"$ref":"#/components/schemas/SzczegolyUmowy"},"stronyUmowy":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/PrzedsiebiorcaRequest"},{"$ref":"#/components/schemas/OsobaFizycznaRequest"},{"$ref":"#/components/schemas/JSFPRequest"}]},"minItems":1},"finansowanaZeSrodkow":{"type":"boolean","description":"Informacja czy umowa jest finansowana ze środków.","example":true},"zmianyUmowy":{"type":"array","items":{"$ref":"#/components/schemas/ZmianyUmowyRequest"}}},"required":["finansowanaZeSrodkow","numerPorzadkowy","okresObowiazywania","podstawoweDane","stronyUmowy","szczegolyUmowy"],"title":"Umowa"},"DaneAdresowe_Public":{"type":"object","description":"Adres podmiotu/strony umowy.","properties":{"ulica":{"type":"string","description":"Ulica.","example":"Marszałkowska","maxLength":351,"minLength":1},"numerNieruchomosci":{"type":"string","description":"Numer nieruchomości (np. numer budynku).","example":"10A","maxLength":20,"minLength":1},"numerLokalu":{"type":"string","description":"Numer lokalu (jeśli dotyczy).","example":15,"maxLength":20,"minLength":1},"wojewodztwo":{"type":"string","description":"Województwo.","example":"mazowieckie","maxLength":100,"minLength":1},"powiat":{"type":"string","description":"Powiat.","example":"warszawski","maxLength":100,"minLength":1},"gminaMiastoDzielnica":{"type":"string","description":"Gmina / miasto / dzielnica.","example":"Warszawa-Śródmieście","maxLength":100,"minLength":1},"miejscowosc":{"type":"string","description":"Miejscowość.","example":"Warszawa","maxLength":100,"minLength":1},"kodPocztowy":{"type":"string","description":"Dla adresu z Polski: Kod pocztowy (format: NN-NNN).","example":"00-001","maxLength":12,"minLength":1}},"title":"DaneAdresowe"},"DaneWylaczeniaJawnosci_Public":{"type":"object","description":"Informacje o wyłączeniu jawności danych (podstawa prawna, zakres, komentarz, organ/osoba).","properties":{"podstawa":{"type":"string","description":"Podstawa wyłączenia jawności.","enum":["ART_5_UST_1","ART_5_UST_2","ART_5_UST_2A","ART_5_UST_2B","INNA"],"example":"ART_5_UST_2"},"zakres":{"type":"string","description":"Zakres danych objętych wyłączeniem jawności.\n- SC02: Dane strony umowy\n- SC03: Przedmiot umowy\n- SC04: Wartość umowy","enum":["SC02","SC03","SC04"],"example":"SC03"},"komentarz":{"type":"string","description":"Komentarz/uzasadnienie wyłączenia jawności - wymagalność zależna od wyboru podstawy (INNA).","example":"Informacja stanowi tajemnicę przedsiębiorstwa.","maxLength":500},"organLubOsobaWylaczajaca":{"type":"string","description":"Organ lub osoba wyłączająca jawność.","example":"Dyrektor Departamentu Zakupów"}},"required":["organLubOsobaWylaczajaca","podstawa","zakres"],"title":"DaneWylaczeniaJawnosci"},"JSFPResponse_Public":{"allOf":[{"$ref":"#/components/schemas/StronaUmowyResponse_Public"},{"type":"object","properties":{"nazwa":{"type":"string","description":"Pełna nazwa jednostki sektora finansów publicznych.","example":"Urząd Miasta Stołecznego Warszawy"},"nip":{"type":"string","description":"Numer NIP jednostki.","example":5252248481},"regon":{"type":"string","description":"Numer REGON jednostki.","example":"015259640"},"daneAdresowe":{"$ref":"#/components/schemas/DaneAdresowe_Public","description":"Dane adresowe jednostki."}}}],"description":"Strona umowy typu JSFP zwracana w odpowiedzi.","title":"Strona umowy – JSFP Response"},"OdpowiedzSzczegolowUmowy_Public":{"type":"object","description":"Odpowiedź zawierająca szczegółowe dane umowy.","properties":{"idUmowy":{"type":"string","format":"uuid","description":"Identyfikator umowy nadawany przez system CRU. Wartość zwracana w formacie UUID i wykorzystywana do jednoznacznej identyfikacji umowy w systemie.","example":"1d46ae8a-dc4b-46dd-bf4a-1e1e94b3781e"},"statusProcesowy":{"type":"string","description":"Status procesowy umowy w systemie CRU.","example":"OPUBLIKOWANA"},"numerSystemowy":{"type":"integer","format":"int64","description":"Numer systemowy umowy nadany przez system CRU. Jest to główny identyfikator umowy używany w integracji.","example":123456789},"externalSystemId":{"type":"string","description":"Identyfikator zewnętrzny umowy nadawany przez system integratora. Wartość przekazana w żądaniu jest zwracana w odpowiedzi w celu ułatwienia powiązania danych pomiędzy systemami.","example":"ABC/1000, CDE/2000"},"komorkaWewnetrznaJsfp":{"type":"string","description":"Nazwa komórki wewnętrznej JSFP wskazanej dla umowy.","example":"Wydział Zamówień Publicznych"},"podstawoweDane":{"$ref":"#/components/schemas/PodstawoweDane_Public","description":"Podstawowe dane umowy (m.in. status umowy, numer umowy, data zawarcia)."},"okresObowiazywania":{"$ref":"#/components/schemas/OkresObowiazywania_Public","description":"Dane dotyczące okresu obowiązywania umowy."},"szczegolyUmowy":{"$ref":"#/components/schemas/SzczegolyUmowy_Public","description":"Szczegóły umowy (m.in. przedmiot umowy, wartość, informacje o wyłączeniu jawności)."},"stronyUmowy":{"type":"array","description":"Lista stron umowy.","items":{"oneOf":[{"$ref":"#/components/schemas/StronaUmowyResponse_Public"},{"$ref":"#/components/schemas/JSFPResponse_Public"},{"$ref":"#/components/schemas/OsobaFizycznaResponse_Public"},{"$ref":"#/components/schemas/PrzedsiebiorcaResponse_Public"}]}},"finansowanaZeSrodkow":{"type":"boolean","description":"Informacja, czy umowa jest finansowana ze środków publicznych.","example":true},"zmianyUmowy":{"type":"array","description":"Lista zmian umowy (jeśli występują).","items":{"$ref":"#/components/schemas/ZmianyUmowyResponse_Public"}},"dataPublikacji":{"type":"string","format":"date","description":"Data publikacji umowy w systemie CRU. Format: dd.MM.yyyy.","example":"26.02.2026"},"zmianaDanych":{"type":"object","additionalProperties":{"type":"string"}}},"required":["okresObowiazywania","podstawoweDane","szczegolyUmowy"],"title":"OdpowiedzSzczegolowUmowy"},"OkresObowiazywania_Public":{"type":"object","description":"Dane dotyczące okresu obowiązywania umowy.","properties":{"umowaNaCzasNieoznaczony":{"type":"boolean","description":"Czy umowa jest na czas nieoznaczony. ","example":false},"okresLiczba":{"type":"integer","format":"int32","description":"Liczba jednostek okresu (np. 12).","example":12,"minimum":0},"okresJednostka":{"type":"string","description":"Jednostka okresu. Dozwolone: 'dzień', 'miesiąc', 'rok'.","example":"miesiąc"},"okresOd":{"type":"string","format":"date","description":"Okres obowiązywania umowy od.","example":"01.01.2025"},"okresDo":{"type":"string","format":"date","description":"Okres obowiązywania umowy do.","example":"30.01.2026"},"okresDni":{"type":"integer","format":"int32","description":"Okres obowiązywania umowy w dniach.","example":12},"okresPrezentacja":{"type":"string","description":"Okres obowiązywania w formacie prezentacji.","example":12}},"title":"OkresObowiazywania"},"OsobaFizycznaResponse_Public":{"allOf":[{"$ref":"#/components/schemas/StronaUmowyResponse_Public"},{"type":"object","properties":{"imie":{"type":"string","description":"Imię osoby fizycznej.","example":"Jan"},"nazwisko":{"type":"string","description":"Nazwisko osoby fizycznej.","example":"Kowalski"}}}],"description":"Strona umowy typu Osoba fizyczna zwracana w odpowiedzi.","title":"Strona umowy – Osoba fizyczna Response"},"PodstawoweDane_Public":{"type":"object","description":"Podstawowe dane umowy.\n\nReguła spójności pól:\n- gdy 'brakNumeruUmowy' = true - pole 'numerUmowy' nie może być przekazane,\n- gdy 'brakNumeruUmowy' = false - pole 'numerUmowy' jest wymagane.","properties":{"statusUmowy":{"type":"string","description":"Status umowy. Dozwolone: 'Aktywna' lub 'Nieaktywna'.","example":"Aktywna"},"numerUmowy":{"type":"string","description":"Numer umowy. Wymagany, gdy 'brakNumeruUmowy' = false. Nie może być przekazany, gdy 'brakNumeruUmowy' = true.","example":"UM/2026/001"},"brakNumeruUmowy":{"type":"boolean","description":"Flaga braku numeru umowy. Jeśli true, pole 'numerUmowy' nie może być przekazane. Jeśli false, pole 'numerUmowy' jest wymagane.","example":false},"dataZawarciaUmowy":{"type":"string","format":"date","description":"Data zawarcia umowy w formacie dd.MM.yyyy.","example":"11.02.2026"},"dataZakonczeniaUmowy":{"type":"string","format":"date"}},"required":["brakNumeruUmowy","dataZawarciaUmowy","statusUmowy"],"title":"PodstawoweDaneUmowy"},"PrzedsiebiorcaResponse_Public":{"allOf":[{"$ref":"#/components/schemas/StronaUmowyResponse_Public"},{"type":"object","properties":{"nazwa":{"type":"string","description":"Pełna nazwa przedsiębiorcy.","example":"ABC Spółka z ograniczoną odpowiedzialnością"},"nip":{"type":"string","description":"Numer NIP przedsiębiorcy.","example":5250001009},"regon":{"type":"string","description":"Numer REGON przedsiębiorcy.","example":123456789},"daneAdresowe":{"$ref":"#/components/schemas/DaneAdresowe_Public","description":"Dane adresowe przedsiębiorcy."}}}],"description":"Strona umowy typu Przedsiębiorca zwracana w odpowiedzi.","title":"Strona umowy – Przedsiębiorca Response"},"StronaUmowyResponse_Public":{"type":"object","description":"Podstawowe dane strony umowy zwracane w odpowiedzi","discriminator":{"propertyName":"rodzaj"},"properties":{"kraj":{"type":"string","description":"Kod kraju strony umowy (ISO-3166 alpha-2).","example":"PL"},"rodzaj":{"type":"string","description":"Rodzaj strony umowy.","example":"SU03"},"niejawnoscStrony":{"$ref":"#/components/schemas/DaneWylaczeniaJawnosci_Public"},"czyKonsorcjum":{"type":"boolean","description":"Czy strona występuje jako konsorcjum.","example":false}},"title":"StronaUmowyResponse"},"SzczegolyUmowy_Public":{"type":"object","description":"Dane dotyczące szczegółów umowy.\n\nReguły spójności:\n- jeśli przekazano 'niejawnoscPrzedmiotu': pole 'przedmiotUmowy' nie może być przekazane,\n- jeśli przekazano 'niejawnoscWartosciPrzedmiotu': pole 'wartoscPrzedmiotu' nie może być przekazane.","properties":{"przedmiotUmowy":{"type":"string","description":"Przedmiot umowy. Nie może być przekazany, jeżeli ustawiono wyłączenie jawności przedmiotu (pole 'niejawnoscPrzedmiotu').","example":"Dostawa sprzętu komputerowego","maxLength":1500,"minLength":1},"niejawnoscPrzedmiotu":{"$ref":"#/components/schemas/DaneWylaczeniaJawnosci_Public","description":"Wyłączenie jawności przedmiotu umowy (zakres SC03). Jeśli przekazane, pole 'przedmiotUmowy' musi być puste (null)."},"wartoscPrzedmiotu":{"type":"string","description":"Wartość umowy. Nie może być przekazana, jeżeli ustawiono wyłączenie jawności wartości (pole 'niejawnoscWartosciPrzedmiotu').","example":12000.0,"minimum":0},"niejawnoscWartosciPrzedmiotu":{"$ref":"#/components/schemas/DaneWylaczeniaJawnosci_Public","description":"Wyłączenie jawności wartości umowy (zakres SC04). Jeśli przekazane, pola 'wartoscPrzedmiotu' oraz 'opisWartosciPrzedmiotu' muszą być puste (null)."},"opisWartosciPrzedmiotu":{"type":"string","description":"Opis wartości umowy (uzasadnienie/komentarz do wartości).","example":"Cena zgodnie z ofertą i protokołem odbioru.","maxLength":1500,"minLength":1}},"title":"SzczegolyUmowy"},"ZmianyUmowyResponse_Public":{"type":"object","description":"Dane o zmianach umowy zwracane w odpowiedzi.","properties":{"rodzajZmiany":{"type":"string","description":"Rodzaj zmiany.","example":"TSU02"},"dataZmiany":{"type":"string","format":"date","description":"Data zmiany w formacie dd.MM.yyyy.","example":"11.02.2026"},"komentarz":{"type":"string","description":"Komentarz/opis zmiany.","example":"Aneks nr 1 - zmiana wartości umowy."}},"title":"DaneZmianUmowyResponse"},"PagedResponse_Public":{"type":"object","description":"Standardowa odpowiedź stronicowana. Zawiera listę elementów (`content`), łączną liczbę rekordów spełniających kryteria (`total`) oraz parametry paginacji zastosowane w zapytaniu (`offset`, `limit`).","properties":{"content":{"type":"array","items":{}},"totalElements":{"type":"integer","format":"int64"},"offset":{"type":"integer","format":"int32"},"limit":{"type":"integer","format":"int32"}},"title":"Odpowiedź stronicowana"}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","description":"Autoryzacja poprzez klucz API przekazywany w nagłówku X-API-KEY.","name":"X-API-KEY","in":"header"}}}}