API nacionalnog registra laboratorijskih usluga

Nacionalni registar laboratorijskih usluga (eUput) izlaže REST API za integraciju bolničkih (BIS), laboratorijskih (LIS) i uputnih sistema. Svi odgovori su JSON. Svi podaci potiču iz nacionalne nomenklature: NU usluge (NU-XXXX), NK komponente (NU-KO-XXXX), LOINC i RFZO L-šifre veze, tipovi uzorkovanja (TU-XXX) i lokalna mapiranja ustanova.

REST + JSONFHIR $translateLOINC · RFZO L-šifre12 endpointa

Za AI coding agente

Kompletna specifikacija API-ja u markdown formatu dostupna je na /llms.txt (engleski), a mašinski čitljiv OpenAPI 3.1 dokument na /api/openapi. Dajte agentu jedan od ta dva URL-a i API ključ vaše ustanove — to je sve što je potrebno za integraciju.

Prvi koraci

1. Nabavite API ključ
Administrator registra izdaje ključ pri onboarding-u ustanove. Ključ je tajna — čuvajte ga na serveru, nikad u browser kodu ili javnom repozitorijumu.
2. Pošaljite prvi zahtev
Svaki poziv nosi zaglavlja x-api-key i x-institution-id. Probajte pretragu: GET /api/registry/services?q=glukoza.
3. Integrišite tok uputa
Pretraga usluga → izbor NU šifre → /services/{code}/institutions za ustanove koje je rade → /institutions/nearest za najbližu.
4. Integrišite LIS tok
Obrnuta pretraga: /resolve prevodi vašu lokalnu šifru u nacionalni zapis; /institutions/{code}/services/{concept} vraća kako VI radite datu uslugu.
5. Održavajte sinhronizaciju
Periodično čitajte /changelog za delta izmene između izdanja nomenklature.
6. Ili: offline dnevni import
Ako ne želite live API: jednom dnevno pozovite /export/manifest (javno) i uporedite publishedAt — ako je novo izdanje, preuzmite /export (JSON/XML/CSV). Ime fajla nosi datum objave.

Autentikacija

Live /api/registry/* pozivi prihvataju DVA oblika kredencijala na x-api-key zaglavlju. (1) Ključ ustanove (prefiks eup_): šalje se UZ x-institution-id (numerički ID ustanove) i izdaje ga administrator registra pri onboarding-u — važi na svim endpointima uključujući razrešavanje lokalnih šifara (/resolve). (2) GENERALNI sistemski ključ (prefiks eur_): za BIS/ZIS i druge spoljne potrošače, šalje se SAM (bez x-institution-id) i važi na nacionalnim read endpointima (liste usluga, ustanove za uslugu, pretraga ustanova, changelog, translate) — NE važi na /resolve. Ključevi se NE dele javno i ne smeju se ugrađivati u klijentski (browser) kod. POST /api/registry/elab/resolve koristi sistemsko zaglavlje x-elab-api-key (samo za nacionalni eLab sistem). Izuzeci od pravila ključa: GET /api/registry/export/manifest je potpuno JAVAN (bez ključa), a GET /api/registry/export je STEPENOVAN — radi i bez ključa (javni nivo sadržaja: čist NU/NK šifarnik bez internih identifikatora), dok ključ ustanove odnosno eLab ključ automatski proširuju sadržaj. Poziv sa POGREŠNIM ključem uvek vraća 401 — poslati kredencijali se nikad tiho ne spuštaju na manji nivo.

curl "https://BASE_URL/api/registry/services?q=glukoza" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-institution-id: YOUR_INSTITUTION_ID"

Zamenite BASE_URL adresom registra, a YOUR_API_KEY ključem koji je vaša ustanova dobila pri registraciji. Dokumentacija je javna — ključevi nisu.

Model podataka

Pojam	Značenje
NU usluga (NU-XXXX)	Nacionalna laboratorijska usluga ili panel — jedinica naručivanja na uputu. Nosi kategoriju, analit, tip uzorkovanja (TU), LOINC i RFZO L-šifre veze.
NK komponenta (NU-KO-XXXX)	Nacionalna komponenta (analit) — jedinica REZULTATA koju LIS izveštava. Panel (NU) sadrži više komponenti; komponenta nasleđuje tip uzorkovanja od panela.
Tip uzorkovanja (TU-XXX)	Stavka nacionalnog šifarnika: klasa uzorka (serum/plazma, urin, likvor...) + način uzimanja (venepunkcija, 24h sakupljanje...).
Ustanova	Zdravstvena ustanova sa statusom live/onboarding. Dva ODVOJENA seta identifikatora koji se sreću na nacionalnoj usluzi: eLab set (elabCode = eLab šifra zapisa, elabId = eLab ID usluge) i LIS set (lisCode = PRAVA lokalna LIS šifra iz uvezenog šifarnika sa potvrđenom nacionalnom odlukom).
Mapiranje	Veza lokalne šifre ustanove na NU uslugu (direktno) ili NK komponentu (posredno). Posredno mapiranje znači: lokalna šifra izveštava analit koji je deo nekog NU panela.

Endpointi

GET/api/registry/servicesključ ustanove ili BIS/ZIS ključ

Pretraga nacionalnih usluga

Glavna pretraga registra. Traži po bilo čemu što imate: NU šifri, srpskom/engleskom nazivu (neosetljivo na dijakritike), RFZO L-šifri, LOINC šifri, lokalnoj LIS šifri ili eLab ID-u. Pokriva i posredni put: lokalna šifra mapirana samo na NK komponentu pronalazi sve panele koji je sadrže. Vraća aktivne usluge sa LOINC/L-šifra vezama, tipom uzorkovanja i ustanovama koje ih rade.

Parametar	Gde	Tip	Obavezan	Opis
q	query	string	ne	Slobodan tekst ili bilo koja šifra (NU, L-šifra, LOINC, lokalna, eLab ID).
category	query	string	ne	Tačna kategorija (npr. Biohemija).
institution	query	string	ne	Šifra ustanove — samo usluge koje ta ustanova radi.
hasLcode	query	boolean	ne	Filtrira po pokrivenosti RFZO L-šifrom.
limit	query	integer	ne	Maks. rezultata (podrazumevano 25, maks. 100).
offset	query	integer	ne	Pomeraj za paginaciju.

Primer poziva

curl "https://BASE_URL/api/registry/services?q=glukoza&limit=5" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "total": 3,
  "returned": 1,
  "items": [{
    "code": "NU-0022",
    "displaySr": "Glukoza",
    "category": "Biohemija",
    "unit": "mmol/L",
    "specimen": "Serum",
    "samplingType": { "code": "TU-001", "nameSr": "Venska krv — serum/plazma", "specimenClass": "Serum/plazma", "collectionMethod": "Venepunkcija" },
    "loinc": [{ "code": "2345-7", "display": "Glucose [Moles/volume] in Serum or Plasma" }],
    "lcodes": [{ "code": "L000414", "display": "Glukoza u serumu" }],
    "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "localCode": "280", "elabId": "1024" }]
  }]
}

GET/api/registry/services/{code}ključ ustanove ili BIS/ZIS ključ

Kompletan karton usluge

Sve što registar zna o jednoj NU usluzi: pun medicinski identitet (analit, uzorak, metoda, skala), tip uzorkovanja, definicije, revizije, sva mapiranja (LOINC, L-šifre), komponente panela sa brojem lokalnih mapiranja i sve ustanove koje uslugu rade.

Parametar	Gde	Tip	Obavezan	Opis
code	path	string	da	NU šifra usluge (npr. NU-0022).

Primer poziva

curl "https://BASE_URL/api/registry/services/NU-0022" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "service": {
    "code": "NU-0022",
    "displaySr": "Glukoza",
    "identity": { "analyte": "Glukoza", "specimen": "Serum", "method": null, "scaleType": "Qn", "unitUcum": "mmol/L" },
    "samplingType": { "code": "TU-001", "nameSr": "Venska krv — serum/plazma", "specimenClass": "Serum/plazma", "collectionMethod": "Venepunkcija" },
    "meta": { "status": "active", "revision": 3 },
    "loinc": [{ "code": "2345-7", "display": "..." }],
    "lcodes": [{ "code": "L000414", "display": "..." }],
    "components": [],
    "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "city": "Ljubovija", "localCode": "280", "elabId": "1024" }]
  }
}

GET/api/registry/services/{code}/institutionsključ ustanove ili BIS/ZIS ključ

Ustanove koje rade uslugu ili komponentu (za uput)

Namenski endpoint za KREIRANJE UPUTA: koje žive ustanove mogu da izvedu ovu uslugu? Radi za OBA tipa nacionalne šifre. Za NU uslugu/panel vraća ustanove sa aktivnim mapiranjem na uslugu. Za NK komponentu vraća ustanove koje komponentu isporučuju direktno (samostalno LIS mapiranje) ILI posredno kroz panel koji je sadrži — polje via razlikuje slučajeve (direct | panel | both), a viaPanels navodi panele koje treba naručiti za posredne. Vraća samo žive ustanove sa koordinatama za prikaz na mapi.

Parametar	Gde	Tip	Obavezan	Opis
code	path	string	da	NU šifra (NU-XXXX) ili NK šifra (NU-KO-XXXX).
city	query	string	ne	Filter po gradu (neosetljivo na velika/mala slova).
type	query	string	ne	Tip ustanove (laboratory \| hospital \| clinic \| private).

Primer poziva

curl "https://BASE_URL/api/registry/services/NU-KO-0039/institutions?city=Beograd" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "kind": "component",
  "component": { "code": "NU-KO-0039", "name": "Kalcijum" },
  "returned": 24,
  "institutions": [{
    "code": "ELAB-881244",
    "name": "Dom zdravlja Ljubovija",
    "city": "Ljubovija",
    "type": "clinic",
    "latitude": 44.23, "longitude": 19.08,
    "via": "both",
    "localCode": "K-155",
    "viaPanels": [{ "code": "NU-0369", "name": "Krvna slika (trodelna)", "elabCode": "955" }]
  }]
}

Za NU šifre odgovor ima kind="service" i svaka ustanova nosi elabCode/elabId umesto via/viaPanels.

GET/api/registry/institutionsključ ustanove ili BIS/ZIS ključ

Pretraga ustanova

Opšta pretraga ustanova za uputne UI-je: po nazivu/šifri/gradu (neosetljivo na dijakritike), tipu i po tome da li aktivno rade zadatu NU uslugu. Vraća samo žive ustanove sa koordinatama i brojem mapiranja kao signalom veličine.

Parametar	Gde	Tip	Obavezan	Opis
q	query	string	ne	Slobodan tekst preko šifre, naziva, grada.
city	query	string	ne	Tačan grad.
type	query	string	ne	Tip ustanove.
service	query	string	ne	NU šifra — samo ustanove koje je rade.
limit	query	integer	ne	Maks. rezultata (podrazumevano 25, maks. 100).
offset	query	integer	ne	Pomeraj za paginaciju.

Primer poziva

curl "https://BASE_URL/api/registry/institutions?q=ljubovija" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "total": 1, "returned": 1,
  "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "city": "Ljubovija", "type": "clinic", "latitude": 44.23, "longitude": 19.08, "mappingCount": 412 }]
}

GET/api/registry/institutions/nearestključ ustanove ili BIS/ZIS ključ

Najbliže ustanove (geo)

Za uputne sisteme: žive ustanove sortirane po udaljenosti od zadate tačke (Haversine — vazdušna linija), opciono filtrirane po radijusu, tipu i NU usluzi koju moraju da rade.

Parametar	Gde	Tip	Obavezan	Opis
lat	query	number	da	Geografska širina (-90..90).
lng	query	number	da	Geografska dužina (-180..180).
limit	query	integer	ne	Maks. rezultata (podrazumevano 10, maks. 50).
maxKm	query	number	ne	Radijus u kilometrima.
type	query	string	ne	Tip ustanove.
service	query	string	ne	NU šifra — samo ustanove koje je rade.

Primer poziva

curl "https://BASE_URL/api/registry/institutions/nearest?lat=44.8&lng=20.46&limit=5" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "returned": 2,
  "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "city": "Ljubovija", "distanceKm": 3.42, "latitude": 44.23, "longitude": 19.08 }]
}

GET/api/registry/institutions/{code}/services/{concept}ključ ustanove ili BIS/ZIS ključ

Kako ustanova radi uslugu (izvršni API za LIS)

Izvršni API za LIS sisteme: „šta je NU-XXXX kod mene?“ Vraća eLab stavke ustanove mapirane na tu nacionalnu uslugu i, odvojeno, lisCodes — stavke LIS šifarnika ustanove sa POTVRĐENOM odlukom na istu NU (item.lisCode = prva od njih). Više stavki = ustanova razlikuje varijante metode; primary označava podrazumevanu. Izbor metode se dešava OVDE, na mestu izvršenja �� nikad na uputu.

Parametar	Gde	Tip	Obavezan	Opis
code	path	string	da	Šifra ustanove ili numerički eLab ID.
concept	path	string	da	NU šifra usluge.

Primer poziva

curl "https://BASE_URL/api/registry/institutions/ELAB-881244/services/NU-0022" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "institution": { "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija" },
  "service": { "code": "NU-0022", "name": "Glukoza" },
  "returned": 1,
  "items": [{ "elabCode": "280", "elabId": "1024", "elabDisplay": "Glukoza u serumu", "lisCode": "GLU-S", "lisDisplay": "Glukoza (serum)", "vendor": null, "method": null, "primary": true }],
  "lisCodes": [{ "lisCode": "GLU-S", "lisDisplay": "Glukoza (serum)" }]
}

Polja localCode/localDisplay su ZASTARELI aliasi za elabCode/elabDisplay — migrirati na elabCode; LIS šifre su u lisCodes.

GET/api/registry/resolveključ ustanove

Obrnuta pretraga lokalne šifre (za BIS/LIS)

Ustanova pošalje svoju šifru i dobije povezan nacionalni zapis. Tri oblika: ?code= (eLab šifra zapisa), ?elab= (eLab ID usluge), ?lis= (PRAVA lokalna LIS šifra iz učitanog kataloga). Ustanova se čita iz auth zaglavlja — može da razrešava samo sopstveni katalog. Odgovor razlikuje tri slučaja poljem match: service (direktno mapirana na NU), components (mapirana samo na NK analite — navodi panele koji ih sadrže), none (nema mapiranja).

Parametar	Gde	Tip	Obavezan	Opis
code	query	string	ne	eLab šifra zapisa (podrazumevani oblik).
elab	query	string	ne	eLab ID usluge.
lis	query	string	ne	PRAVA lokalna LIS šifra.

Primer poziva

curl "https://BASE_URL/api/registry/resolve?code=280" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "match": "service",
  "by": "elabCode",
  "service": { "code": "NU-0022", "displaySr": "Glukoza", "loinc": [], "lcodes": [], "components": [] }
}

GET/api/registry/translateključ ustanove ili BIS/ZIS ključ

Prevod šifre između sistema (FHIR $translate)

FHIR ConceptMap $translate-stil: prevodi šifru iz izvornog sistema u sve odgovarajuće šifre ciljnog sistema, preko nacionalnog koncepta kao čvorišta. Sistemi: rfzo-l, loinc, concept (NU šifra direktno). Odgovor je FHIR Parameters resurs.

Parametar	Gde	Tip	Obavezan	Opis
system	query	string	da	Izvorni sistem: rfzo-l \| loinc \| concept.
code	query	string	da	Šifra u izvornom sistemu.
target	query	string	da	Ciljni sistem: rfzo-l \| loinc \| concept.

Primer poziva

curl "https://BASE_URL/api/registry/translate?system=rfzo-l&code=L000414&target=loinc" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "resourceType": "Parameters",
  "parameter": [
    { "name": "result", "valueBoolean": true },
    { "name": "match", "part": [{ "name": "concept", "valueCoding": { "system": "loinc", "code": "2345-7", "display": "Glucose [Moles/volume] in Serum or Plasma" } }] }
  ]
}

GET/api/registry/changelogključ ustanove ili BIS/ZIS ključ

Changelog izdanja (delta sinhronizacija)

Šta se promenilo između prethodnog objavljenog izdanja i traženog — podrška za delta-sinhronizaciju klijentskih keševa. Bez parametra vraća najnovije objavljeno izdanje.

Parametar	Gde	Tip	Obavezan	Opis
version	query	string	ne	Verzija izdanja (npr. 2026.1). Podrazumevano: najnovije.

Primer poziva

curl "https://BASE_URL/api/registry/changelog" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "version": "2026.1",
  "publishedAt": "2026-07-01T10:00:00Z",
  "previousVersion": "2025.2",
  "changes": { "added": [], "changed": [], "retired": [] }
}

POST/api/registry/elab/resolvesistemski ključ (eLab)

eLab batch razrešavanje (sistemski)

Samo za nacionalni eLab sistem (sistemski ključ x-elab-api-key, ne ključ ustanove). eLab pošalje svoje parove (ID + opis) za JEDNU ustanovu i dobije NU/NK mapiranje za svaki — uključujući statuse za nemapirane: pending_mapping (u redu za AI analizu + pregled), ai_suggested (AI predlog čeka odobrenje — još NIJE upotrebljiv), not_applicable (ID na beloj listi, nije za mapiranje), rejected, needs_description.

Parametar	Gde	Tip	Obavezan	Opis
institutionId	body	number \| string	da	ID ili šifra ustanove (alternativa: institutionCode).
items	body	array	da	Niz stavki: { kind: "service" \| "analysis", id, description?, specimen? }.

Primer poziva

curl -X POST "https://BASE_URL/api/registry/elab/resolve" \
  -H "x-elab-api-key: YOUR_ELAB_SYSTEM_KEY" -H "content-type: application/json" \
  -d '{"institutionId":173,"items":[{"kind":"service","id":"2937","description":"25(OH) vitamin D"}]}'

Primer odgovora

{
  "institution": { "id": 173, "code": "ELAB-881244" },
  "results": [
    { "kind": "service", "id": "2937", "status": "mapped", "target": { "code": "NU-0509", "name": "25(OH) vitamin D" } },
    { "kind": "analysis", "id": "643", "status": "pending_mapping", "requestId": 88 }
  ]
}

GET/api/registry/export/manifestjavno — bez ključa

Manifest izdanja (dnevna provera)

JAVNO, bez ključa. Mali odgovor sa verzijom, datumom objave i imenima fajlova poslednjeg objavljenog izdanja. Preporučeni dnevni tok za offline integracije: pozovite manifest jednom dnevno, uporedite publishedAt sa poslednjim preuzetim izdanjem — ako je novije, preuzmite /api/registry/export. Imena fajlova nose datum objave, pa se novo izdanje prepoznaje i iz samog imena.

Primer poziva

curl "https://BASE_URL/api/registry/export/manifest"

Primer odgovora

{
  "version": "2026.1",
  "publishedAt": "2026-07-29T15:38:12.087Z",
  "publishDate": "2026-07-29",
  "conceptCount": 677,
  "exportUrl": "/api/registry/export",
  "formats": ["json", "xml", "csv"],
  "filenames": {
    "public": { "json": "euput-registar-2026.1-2026-07-29-javni.json" },
    "elab": { "json": "euput-registar-2026.1-2026-07-29-elab.json" },
    "lab": { "json": "euput-registar-2026.1-2026-07-29-lab-{USTANOVA}.json" }
  }
}

GET/api/registry/exportnivo prema ključu

Bulk export izdanja (offline import)

Kompletan šifarnik poslednjeg objavljenog izdanja u jednom fajlu — za ustanove koje preferiraju dnevni offline import umesto live API-ja. Nivo sadržaja se određuje AUTOMATSKI iz kredencijala: bez ključa → javni nivo (čist NU/NK šifarnik sa LOINC/L-šiframa/tipovima uzorkovanja, bez internih ID-jeva); x-api-key + x-institution-id → nivo ustanove (+ lokalna LIS mapiranja SAMO te ustanove); x-elab-api-key → eLab nivo (+ eLab mapiranja svih ustanova). Pogrešan ključ vraća 401 — nikad se tiho ne spušta na manji nivo. Ime fajla u Content-Disposition nosi verziju i datum objave.

Parametar	Gde	Tip	Obavezan	Opis
format	query	string	ne	json (podrazumevano), xml ili csv (UTF-8 BOM, ";" separator).
version	query	string	ne	Konkretno objavljeno izdanje (podrazumevano: poslednje).

Primer poziva

# javni nivo (bez ključa)
curl -o registar.json "https://BASE_URL/api/registry/export?format=json"
# nivo ustanove
curl -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID" \
  -o registar-lab.json "https://BASE_URL/api/registry/export?format=json"

Primer odgovora

{
  "resourceType": "CodeSystem",
  "version": "2026.1",
  "date": "2026-07-29T15:38:12.087Z",
  "scope": { "kind": "public" },
  "count": 677,
  "concept": [{
    "code": "NU-0022",
    "display": "Glukoza",
    "loinc": ["2345-7"],
    "rfzoLCodes": ["L000414"],
    "property": [{ "code": "samplingType", "valueString": "TU-001" }]
  }],
  "component": [{ "code": "NU-KO-0039", "display": "Kalcijum", "loinc": "17861-6" }]
}

Odgovor nosi zaglavlja X-Registry-Version i X-Registry-Published-At za evidenciju importa bez parsiranja tela.

Ime fajla: euput-registar-{verzija}-{YYYY-MM-DD}-{javni|elab|lab-USTANOVA}.{json|xml|csv}.

Isti sadržaj po verzijama: /api/releases/{version}/export (isti nivoi pristupa).

API nacionalnog registra laboratorijskih usluga

REST + JSONFHIR $translateLOINC · RFZO L-šifre12 endpointa

Za AI coding agente

Prvi koraci

1. Nabavite API ključ
Administrator registra izdaje ključ pri onboarding-u ustanove. Ključ je tajna — čuvajte ga na serveru, nikad u browser kodu ili javnom repozitorijumu.
2. Pošaljite prvi zahtev
Svaki poziv nosi zaglavlja x-api-key i x-institution-id. Probajte pretragu: GET /api/registry/services?q=glukoza.
3. Integrišite tok uputa
Pretraga usluga → izbor NU šifre → /services/{code}/institutions za ustanove koje je rade → /institutions/nearest za najbližu.
4. Integrišite LIS tok
Obrnuta pretraga: /resolve prevodi vašu lokalnu šifru u nacionalni zapis; /institutions/{code}/services/{concept} vraća kako VI radite datu uslugu.
5. Održavajte sinhronizaciju
Periodično čitajte /changelog za delta izmene između izdanja nomenklature.
6. Ili: offline dnevni import
Ako ne želite live API: jednom dnevno pozovite /export/manifest (javno) i uporedite publishedAt — ako je novo izdanje, preuzmite /export (JSON/XML/CSV). Ime fajla nosi datum objave.

Autentikacija

curl "https://BASE_URL/api/registry/services?q=glukoza" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-institution-id: YOUR_INSTITUTION_ID"

Zamenite BASE_URL adresom registra, a YOUR_API_KEY ključem koji je vaša ustanova dobila pri registraciji. Dokumentacija je javna — ključevi nisu.

Model podataka

Pojam	Značenje
NU usluga (NU-XXXX)	Nacionalna laboratorijska usluga ili panel — jedinica naručivanja na uputu. Nosi kategoriju, analit, tip uzorkovanja (TU), LOINC i RFZO L-šifre veze.
NK komponenta (NU-KO-XXXX)	Nacionalna komponenta (analit) — jedinica REZULTATA koju LIS izveštava. Panel (NU) sadrži više komponenti; komponenta nasleđuje tip uzorkovanja od panela.
Tip uzorkovanja (TU-XXX)	Stavka nacionalnog šifarnika: klasa uzorka (serum/plazma, urin, likvor...) + način uzimanja (venepunkcija, 24h sakupljanje...).
Ustanova	Zdravstvena ustanova sa statusom live/onboarding. Dva ODVOJENA seta identifikatora koji se sreću na nacionalnoj usluzi: eLab set (elabCode = eLab šifra zapisa, elabId = eLab ID usluge) i LIS set (lisCode = PRAVA lokalna LIS šifra iz uvezenog šifarnika sa potvrđenom nacionalnom odlukom).
Mapiranje	Veza lokalne šifre ustanove na NU uslugu (direktno) ili NK komponentu (posredno). Posredno mapiranje znači: lokalna šifra izveštava analit koji je deo nekog NU panela.

Endpointi

GET/api/registry/servicesključ ustanove ili BIS/ZIS ključ

Pretraga nacionalnih usluga

Parametar	Gde	Tip	Obavezan	Opis
q	query	string	ne	Slobodan tekst ili bilo koja šifra (NU, L-šifra, LOINC, lokalna, eLab ID).
category	query	string	ne	Tačna kategorija (npr. Biohemija).
institution	query	string	ne	Šifra ustanove — samo usluge koje ta ustanova radi.
hasLcode	query	boolean	ne	Filtrira po pokrivenosti RFZO L-šifrom.
limit	query	integer	ne	Maks. rezultata (podrazumevano 25, maks. 100).
offset	query	integer	ne	Pomeraj za paginaciju.

Primer poziva

curl "https://BASE_URL/api/registry/services?q=glukoza&limit=5" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "total": 3,
  "returned": 1,
  "items": [{
    "code": "NU-0022",
    "displaySr": "Glukoza",
    "category": "Biohemija",
    "unit": "mmol/L",
    "specimen": "Serum",
    "samplingType": { "code": "TU-001", "nameSr": "Venska krv — serum/plazma", "specimenClass": "Serum/plazma", "collectionMethod": "Venepunkcija" },
    "loinc": [{ "code": "2345-7", "display": "Glucose [Moles/volume] in Serum or Plasma" }],
    "lcodes": [{ "code": "L000414", "display": "Glukoza u serumu" }],
    "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "localCode": "280", "elabId": "1024" }]
  }]
}

GET/api/registry/services/{code}ključ ustanove ili BIS/ZIS ključ

Kompletan karton usluge

Parametar	Gde	Tip	Obavezan	Opis
code	path	string	da	NU šifra usluge (npr. NU-0022).

Primer poziva

curl "https://BASE_URL/api/registry/services/NU-0022" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "service": {
    "code": "NU-0022",
    "displaySr": "Glukoza",
    "identity": { "analyte": "Glukoza", "specimen": "Serum", "method": null, "scaleType": "Qn", "unitUcum": "mmol/L" },
    "samplingType": { "code": "TU-001", "nameSr": "Venska krv — serum/plazma", "specimenClass": "Serum/plazma", "collectionMethod": "Venepunkcija" },
    "meta": { "status": "active", "revision": 3 },
    "loinc": [{ "code": "2345-7", "display": "..." }],
    "lcodes": [{ "code": "L000414", "display": "..." }],
    "components": [],
    "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "city": "Ljubovija", "localCode": "280", "elabId": "1024" }]
  }
}

GET/api/registry/services/{code}/institutionsključ ustanove ili BIS/ZIS ključ

Ustanove koje rade uslugu ili komponentu (za uput)

Parametar	Gde	Tip	Obavezan	Opis
code	path	string	da	NU šifra (NU-XXXX) ili NK šifra (NU-KO-XXXX).
city	query	string	ne	Filter po gradu (neosetljivo na velika/mala slova).
type	query	string	ne	Tip ustanove (laboratory \| hospital \| clinic \| private).

Primer poziva

curl "https://BASE_URL/api/registry/services/NU-KO-0039/institutions?city=Beograd" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "kind": "component",
  "component": { "code": "NU-KO-0039", "name": "Kalcijum" },
  "returned": 24,
  "institutions": [{
    "code": "ELAB-881244",
    "name": "Dom zdravlja Ljubovija",
    "city": "Ljubovija",
    "type": "clinic",
    "latitude": 44.23, "longitude": 19.08,
    "via": "both",
    "localCode": "K-155",
    "viaPanels": [{ "code": "NU-0369", "name": "Krvna slika (trodelna)", "elabCode": "955" }]
  }]
}

Za NU šifre odgovor ima kind="service" i svaka ustanova nosi elabCode/elabId umesto via/viaPanels.

GET/api/registry/institutionsključ ustanove ili BIS/ZIS ključ

Pretraga ustanova

Parametar	Gde	Tip	Obavezan	Opis
q	query	string	ne	Slobodan tekst preko šifre, naziva, grada.
city	query	string	ne	Tačan grad.
type	query	string	ne	Tip ustanove.
service	query	string	ne	NU šifra — samo ustanove koje je rade.
limit	query	integer	ne	Maks. rezultata (podrazumevano 25, maks. 100).
offset	query	integer	ne	Pomeraj za paginaciju.

Primer poziva

curl "https://BASE_URL/api/registry/institutions?q=ljubovija" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "total": 1, "returned": 1,
  "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "city": "Ljubovija", "type": "clinic", "latitude": 44.23, "longitude": 19.08, "mappingCount": 412 }]
}

GET/api/registry/institutions/nearestključ ustanove ili BIS/ZIS ključ

Najbliže ustanove (geo)

Za uputne sisteme: žive ustanove sortirane po udaljenosti od zadate tačke (Haversine — vazdušna linija), opciono filtrirane po radijusu, tipu i NU usluzi koju moraju da rade.

Parametar	Gde	Tip	Obavezan	Opis
lat	query	number	da	Geografska širina (-90..90).
lng	query	number	da	Geografska dužina (-180..180).
limit	query	integer	ne	Maks. rezultata (podrazumevano 10, maks. 50).
maxKm	query	number	ne	Radijus u kilometrima.
type	query	string	ne	Tip ustanove.
service	query	string	ne	NU šifra — samo ustanove koje je rade.

Primer poziva

curl "https://BASE_URL/api/registry/institutions/nearest?lat=44.8&lng=20.46&limit=5" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "returned": 2,
  "institutions": [{ "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija", "city": "Ljubovija", "distanceKm": 3.42, "latitude": 44.23, "longitude": 19.08 }]
}

GET/api/registry/institutions/{code}/services/{concept}ključ ustanove ili BIS/ZIS ključ

Kako ustanova radi uslugu (izvršni API za LIS)

Parametar	Gde	Tip	Obavezan	Opis
code	path	string	da	Šifra ustanove ili numerički eLab ID.
concept	path	string	da	NU šifra usluge.

Primer poziva

curl "https://BASE_URL/api/registry/institutions/ELAB-881244/services/NU-0022" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "institution": { "code": "ELAB-881244", "name": "Dom zdravlja Ljubovija" },
  "service": { "code": "NU-0022", "name": "Glukoza" },
  "returned": 1,
  "items": [{ "elabCode": "280", "elabId": "1024", "elabDisplay": "Glukoza u serumu", "lisCode": "GLU-S", "lisDisplay": "Glukoza (serum)", "vendor": null, "method": null, "primary": true }],
  "lisCodes": [{ "lisCode": "GLU-S", "lisDisplay": "Glukoza (serum)" }]
}

Polja localCode/localDisplay su ZASTARELI aliasi za elabCode/elabDisplay — migrirati na elabCode; LIS šifre su u lisCodes.

GET/api/registry/resolveključ ustanove

Obrnuta pretraga lokalne šifre (za BIS/LIS)

Parametar	Gde	Tip	Obavezan	Opis
code	query	string	ne	eLab šifra zapisa (podrazumevani oblik).
elab	query	string	ne	eLab ID usluge.
lis	query	string	ne	PRAVA lokalna LIS šifra.

Primer poziva

curl "https://BASE_URL/api/registry/resolve?code=280" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "match": "service",
  "by": "elabCode",
  "service": { "code": "NU-0022", "displaySr": "Glukoza", "loinc": [], "lcodes": [], "components": [] }
}

GET/api/registry/translateključ ustanove ili BIS/ZIS ključ

Prevod šifre između sistema (FHIR $translate)

Parametar	Gde	Tip	Obavezan	Opis
system	query	string	da	Izvorni sistem: rfzo-l \| loinc \| concept.
code	query	string	da	Šifra u izvornom sistemu.
target	query	string	da	Ciljni sistem: rfzo-l \| loinc \| concept.

Primer poziva

curl "https://BASE_URL/api/registry/translate?system=rfzo-l&code=L000414&target=loinc" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "resourceType": "Parameters",
  "parameter": [
    { "name": "result", "valueBoolean": true },
    { "name": "match", "part": [{ "name": "concept", "valueCoding": { "system": "loinc", "code": "2345-7", "display": "Glucose [Moles/volume] in Serum or Plasma" } }] }
  ]
}

GET/api/registry/changelogključ ustanove ili BIS/ZIS ključ

Changelog izdanja (delta sinhronizacija)

Šta se promenilo između prethodnog objavljenog izdanja i traženog — podrška za delta-sinhronizaciju klijentskih keševa. Bez parametra vraća najnovije objavljeno izdanje.

Parametar	Gde	Tip	Obavezan	Opis
version	query	string	ne	Verzija izdanja (npr. 2026.1). Podrazumevano: najnovije.

Primer poziva

curl "https://BASE_URL/api/registry/changelog" \
  -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID"

Primer odgovora

{
  "version": "2026.1",
  "publishedAt": "2026-07-01T10:00:00Z",
  "previousVersion": "2025.2",
  "changes": { "added": [], "changed": [], "retired": [] }
}

POST/api/registry/elab/resolvesistemski ključ (eLab)

eLab batch razrešavanje (sistemski)

Parametar	Gde	Tip	Obavezan	Opis
institutionId	body	number \| string	da	ID ili šifra ustanove (alternativa: institutionCode).
items	body	array	da	Niz stavki: { kind: "service" \| "analysis", id, description?, specimen? }.

Primer poziva

curl -X POST "https://BASE_URL/api/registry/elab/resolve" \
  -H "x-elab-api-key: YOUR_ELAB_SYSTEM_KEY" -H "content-type: application/json" \
  -d '{"institutionId":173,"items":[{"kind":"service","id":"2937","description":"25(OH) vitamin D"}]}'

Primer odgovora

{
  "institution": { "id": 173, "code": "ELAB-881244" },
  "results": [
    { "kind": "service", "id": "2937", "status": "mapped", "target": { "code": "NU-0509", "name": "25(OH) vitamin D" } },
    { "kind": "analysis", "id": "643", "status": "pending_mapping", "requestId": 88 }
  ]
}

GET/api/registry/export/manifestjavno — bez ključa

Manifest izdanja (dnevna provera)

Primer poziva

curl "https://BASE_URL/api/registry/export/manifest"

Primer odgovora

{
  "version": "2026.1",
  "publishedAt": "2026-07-29T15:38:12.087Z",
  "publishDate": "2026-07-29",
  "conceptCount": 677,
  "exportUrl": "/api/registry/export",
  "formats": ["json", "xml", "csv"],
  "filenames": {
    "public": { "json": "euput-registar-2026.1-2026-07-29-javni.json" },
    "elab": { "json": "euput-registar-2026.1-2026-07-29-elab.json" },
    "lab": { "json": "euput-registar-2026.1-2026-07-29-lab-{USTANOVA}.json" }
  }
}

GET/api/registry/exportnivo prema ključu

Bulk export izdanja (offline import)

Parametar	Gde	Tip	Obavezan	Opis
format	query	string	ne	json (podrazumevano), xml ili csv (UTF-8 BOM, ";" separator).
version	query	string	ne	Konkretno objavljeno izdanje (podrazumevano: poslednje).

Primer poziva

# javni nivo (bez ključa)
curl -o registar.json "https://BASE_URL/api/registry/export?format=json"
# nivo ustanove
curl -H "x-api-key: YOUR_API_KEY" -H "x-institution-id: YOUR_INSTITUTION_ID" \
  -o registar-lab.json "https://BASE_URL/api/registry/export?format=json"

Primer odgovora

{
  "resourceType": "CodeSystem",
  "version": "2026.1",
  "date": "2026-07-29T15:38:12.087Z",
  "scope": { "kind": "public" },
  "count": 677,
  "concept": [{
    "code": "NU-0022",
    "display": "Glukoza",
    "loinc": ["2345-7"],
    "rfzoLCodes": ["L000414"],
    "property": [{ "code": "samplingType", "valueString": "TU-001" }]
  }],
  "component": [{ "code": "NU-KO-0039", "display": "Kalcijum", "loinc": "17861-6" }]
}

Odgovor nosi zaglavlja X-Registry-Version i X-Registry-Published-At za evidenciju importa bez parsiranja tela.

Ime fajla: euput-registar-{verzija}-{YYYY-MM-DD}-{javni|elab|lab-USTANOVA}.{json|xml|csv}.

Isti sadržaj po verzijama: /api/releases/{version}/export (isti nivoi pristupa).