Profil CDA — orzeczenie lekarskie MP

Profil prywatny KAMSOFT dokumentu HL7 CDA dla orzeczenia lekarskiego z badania profilaktycznego medycyny pracy. Jest to dokument następczy po skierowaniu — wystawiany przez lekarza w PSMP i przekazywany pracodawcy. Specyfikacja techniczna, wersja robocza 0.1.

Status: propozycja / draft · Standard: HL7 CDA R2 · Wzorzec: HL7POL IK 1.3.2 (templateId 2.16.840.1.113883.3.4424.13.10.1.52) · Profil: prywatny KAMSOFT · Wymiana: lokalna · nie przez P1

01 · Kontekst biznesowy i zakres

Po przeprowadzeniu badania profilaktycznego lekarz medycyny pracy wydaje orzeczenie lekarskie, które stanowi wynik badania i jest podstawą decyzji pracodawcy o dopuszczeniu lub niedopuszczeniu pracownika do pracy na danym stanowisku. Orzeczenie opiera się bezpośrednio na skierowaniu wystawionym przez pracodawcę.

Cel dokumentu

Zdefiniowanie elektronicznej formy orzeczenia lekarskiego z badania medycyny pracy, wymienialnej między podmiotem służby medycyny pracy (PSMP — Podmiot Służby Medycyny Pracy) a systemem kadrowo-płacowym pracodawcy (KS-ZZL). Profil jest prywatny dla ekosystemu KAMSOFT — nie jest przeznaczony do wymiany przez Platformę P1.

Zakres i granice

Dokument obejmuje wyłącznie orzeczenie lekarskie (wynik badania profilaktycznego). Poza zakresem:

skierowanie MP — osobna specyfikacja: profil-cda.md
karta badania profilaktycznego
wyniki badań konsultacyjnych i dodatkowych (audiogram, spirometria itd.)

Kierunek wymiany

Kierunek jest odwrotny niż w skierowaniu:

Etap	Strona	Rola
Emisja	System kliniczny PSMP → API.MED	Lekarz wystawia i przekazuje orzeczenie
Odbiór	API.ERP → KS-ZZL	Pracodawca odbiera; aktualizacja rejestru badań pracownika

Tryby wystawienia

Orzeczenie może być wystawione w dwóch trybach:

Tryb	Kod	Opis
Zwykły	`Z`	Standardowe orzeczenie po zakończeniu badania
Odwoławczy	`O`	Wystawione w wyniku odwołania pracownika lub pracodawcy — ostateczne; sekcja Pouczenie jest pomijana

Podstawa prawna

Podstawa	Opis
art. 229 § 4 KP	obowiązek wydania orzeczenia lekarskiego po każdym badaniu profilaktycznym
art. 43 pkt 2 KP	dopuszczenie do pracy bez aktualnego orzeczenia (przypadek szczególny)
Rozp. MZiOS z 30.05.1996	wzór orzeczenia (zał. 8) i symbole zdolności do pracy (21–51)
art. 79–81 Ustawy o medycynie pracy	tryb odwołania od orzeczenia

Scenariusz użycia

flowchart LR
  subgraph psmp [PSMP · System kliniczny]
    A1[Lekarz przeprowadza badanie MP]
    A2[Plugin systemowy generuje orzeczenie CDA]
    A3[Podpis XAdES lub bez podpisu]
    A4[Przekazanie jako DocumentReference: B2B, e-mail]
  end
  subgraph zzl [Pracodawca · KS-ZZL]
    B1[API.ERP odbiera Attachment]
    B2[Plugin systemowy parsuje CDA]
    B3[Aktualizacja rejestru badań]
    B4[Decyzja o dopuszczeniu do pracy]
  end
  psmp --> zzl

02 · Architektura dokumentu

Warstwa integracji: plugin systemowy, API.MED i API.ERP

Analogicznie do skierowania — tworzenie, konwersja i podpisywanie orzeczenia CDA leży po stronie pluginu systemowego wbudowanego w system kliniczny PSMP. API.MED traktuje dokument CDA jako DocumentReference, API.ERP jako Attachment — obie strony przesyłają go bez analizy wewnętrznej struktury XML.

Warstwa	Odpowiedzialność
Plugin systemowy (PSMP)	generacja orzeczenia CDA z danych klinicznych; walidacja struktury profilu; podpis elektroniczny
API.MED	transport DocumentReference; korelacja z wpisem pacjenta; status po stronie PSMP
API.ERP	transport Attachment do pracodawcy; idempotencja dostarczenia
Plugin systemowy (KS-ZZL)	parsowanie i walidacja orzeczenia CDA; aktualizacja rejestru badań pracownika

Konwencja ścieżek (ilustracyjnie): MED — np. …/occupational-medicine/certificates lub …/mp/certificates; ERP — np. …/occupational-health/incoming-certificates — ostateczna struktura według katalogu API KAMSOFT.

Standard bazowy

Instancja ClinicalDocument z HL7 CDA Release 2 + extPL z IK 1.3.2 CeZ. Wzorowany na szablonie P1 Orzeczenie lekarza medycyny pracy (templateId 2.16.840.1.113883.3.4424.13.10.1.52, ext. 1.3.2) z adaptacjami wynikającymi z profilu prywatnego KAMSOFT.

Profil prywatny KAMSOFT

Podobnie jak skierowanie, dokument używa własnego templateId pod 1.2.616.1.113769. Kluczowe adaptacje wobec P1:

custodian wskazuje PSMP (nie CSIOZ/CeZ)
author to lekarz z numerem PWZ (root: 2.16.840.1.113883.3.4424.1.6.2)
Dokument nie przechodzi przez Platformę P1
inFulfillmentOf jest obowiązkowy i zawiera identyfikator skierowania z gałęzi klienta KAMSOFT

Diagram uczestników nagłówka

ClinicalDocument

Nagłówek CDA	`component` · structuredBody
`recordTarget` — pracownik (PIK HL7CDA, identyczny jak w skierowaniu)	Sekcja 1 · Orzeczenie lekarskie
`author` — lekarz PSMP z PWZ; `representedOrganization` = PSMP	Sekcja 2 · Ograniczenia i zalecenia (opcjonalna)
`custodian` — PSMP	Sekcja 3 · Pouczenie (pominięta w trybie O)
`legalAuthenticator` — lekarz (zwykle ten sam co `author`)
`inFulfillmentOf` — referencja do skierowania (obowiązkowy)

Identyfikacja dokumentu

Kod główny 104988-1 z LOINC (Medical fitness certificate), z translacją na KLAS_DOK_P1 09.00 i kwalifikatorem trybu wystawienia:

<templateId root="1.2.616.1.113769.5.2" extension="0.1"/>
<code
  code="104988-1"
  codeSystem="2.16.840.1.113883.6.1"
  codeSystemName="LOINC"
  displayName="Medical fitness certificate">
  <translation
    code="09.00"
    codeSystem="2.16.840.1.113883.3.4424.11.1.32"
    codeSystemName="KLAS_DOK_P1"
    displayName="Orzeczenie lekarza medycyny pracy">
    <qualifier>
      <name code="TWOMP"
            codeSystem="2.16.840.1.113883.3.4424.13.5.1"
            codeSystemName="PolskieKlasyfikatoryHL7v3"
            displayName="Tryb wystawienia orzeczenia medycyny pracy"/>
      <value code="Z"
             codeSystem="2.16.840.1.113883.3.4424.13.5.31.6"
             codeSystemName="TrybWystawieniaOrzeczeniaMedycynyPracy"
             displayName="Tryb zwykły"/>
    </qualifier>
  </translation>
</code>

Uwaga OID: templateId root="1.2.616.1.113769.5.2" — do nadania przez właściciela drzewa OID (TL). OIDs kodu TWOMP i słownika trybu (5.31.6) są przejęte z IK 1.3.2 CeZ.

03 · Struktura nagłówka

recordTarget — pracownik

Identyczna konstrukcja jak w skierowaniu: PESEL jako priorytet I wg PIK HL7CDA, opcjonalnie wewnętrzny ID kadrowy pracownika u pracodawcy. Pełna tabela priorytetów identyfikatorów — profil-cda.md § recordTarget.

Dane pracodawcy nie są w nagłówku recordTarget — trafiają do obserwacji stanowiska w sekcji 1 jako participant typeCode="IND".

author — lekarz medycyny pracy

Odmienność kluczowa wobec skierowania: autor jest lekarzem z numerem prawa wykonywania zawodu (PWZ), a representedOrganization to PSMP. Zawiera functionCode z kodem roli LEK.

<author>
  <functionCode code="LEK"
                codeSystem="2.16.840.1.113883.3.4424.11.3.18"
                displayName="Lekarz"/>
  <time value="20250811"/>
  <assignedAuthor>
    <!-- PWZ lekarza -->
    <id extension="9999999"
        root="2.16.840.1.113883.3.4424.1.6.2"
        displayable="true"/>
    <assignedPerson>
      <name>
        <given>Aleksander</given>
        <family>Nowak</family>
      </name>
    </assignedPerson>
    <representedOrganization>
      <!-- RPWDL komórki organizacyjnej PSMP -->
      <id extension="000000001007-01"
          root="2.16.840.1.113883.3.4424.2.3.2"
          displayable="true"/>
      <name>Centrum Medycyny Pracy S.C. A. Nowak</name>
      <telecom use="PUB" value="tel:52 522 00 00"/>
      <addr>
        <country>Polska</country>
        <postalCode>85-001</postalCode>
        <city>Bydgoszcz</city>
        <streetName>Jagiellońska</streetName>
        <houseNumber>1</houseNumber>
      </addr>
      <asOrganizationPartOf>
        <wholeOrganization>
          <!-- RPWDL podmiotu leczniczego -->
          <id extension="000000001007"
              root="2.16.840.1.113883.3.4424.2.3.1"
              displayable="true"/>
          <!-- REGON-14 podmiotu -->
          <id extension="19040792678999"
              root="2.16.840.1.113883.3.4424.2.2.2"/>
        </wholeOrganization>
      </asOrganizationPartOf>
    </representedOrganization>
  </assignedAuthor>
</author>

custodian — PSMP

Opiekun dokumentu to podmiot medyczny (PSMP), identyfikowany przez RPWDL podmiotu. W profilu prywatnym KAMSOFT nie używamy CSIOZ/CeZ jako custodian (inaczej niż P1).

legalAuthenticator

Lekarz wystawiający orzeczenie — zwykle ten sam co author. Identyfikator PWZ (root: 2.16.840.1.113883.3.4424.1.6.2) oraz numer prawa do wykonywania specjalności (root: 2.16.840.1.113883.3.4424.1.13.1). signatureCode="S".

inFulfillmentOf — powiązanie ze skierowaniem

Obowiązkowy element. Łączy orzeczenie z wystawiającym je skierowaniem przez identyfikator dokumentu skierowania:

<inFulfillmentOf>
  <order moodCode="RQO" classCode="ACT">
    <id extension="MP-2025-000457"
        root="1.2.616.1.113769.4.1.1.000007.81234.15"
        displayable="true"/>
  </order>
</inFulfillmentOf>

root musi odpowiadać gałęzi dokumentów Referral danego klienta (1.2.616.1.113769.4.z.i.w.l.15) — ten sam OID, który był w nagłówku id skierowania. extension to numer skierowania.

04 · Struktura sekcji body

Trzy sekcje: dwie obowiązkowe (1, 3), jedna opcjonalna (2).

#	Sekcja	LOINC	templateId	Status
1	Orzeczenie lekarskie	`104988-1`	`1.2.616.1.113769.5.2.1` ❓	obowiązkowa
2	Ograniczenia i zalecenia	`18776-5`	`1.2.616.1.113769.5.2.2` ❓	opcjonalna
3	Pouczenie	`48767-8`	`1.2.616.1.113769.5.2.3` ❓	obowiązkowa (pomijana w trybie `O`)

❓ OID do nadania przez właściciela drzewa OID (TL) — analogicznie do gałęzi 5.1.* dla skierowania.

Sekcja 1 · Orzeczenie lekarskie

Główna sekcja dokumentu. Kod sekcji to ten sam LOINC 104988-1 co kod dokumentu.

Wpisy strukturalne (entry) sekcji 1

Lp	Nazwa	Kod obserwacji	Źródło wartości	Status
1.1	Numer orzeczenia	LOINC `91886-2`	`xsi:type="ST"` — tekst wolny	obowiązkowy
1.2	Data skierowania	LOINC `57202-4`	`xsi:type="TS"` — data	obowiązkowy
1.3	Rodzaj badania	`RBMP` · DaneOrzMedPracy	`oh-exam-type` (`1.2.616.1.113769.1.9`)	obowiązkowy
1.4	Rodzaj zatrudnienia	`SZMP` · DaneOrzMedPracy	RodzajZatrudnienia P1 (`5.31.2`)	obowiązkowy
1.5	Stanowisko + pracodawca	LOINC `85658-3`	`xsi:type="ST"` + participant IND	obowiązkowy
1.6	Podstawa prawna	`PPMP` · DaneOrzMedPracy	PodstawaPrawnaOrzMedPracy P1 (`5.31.7`)	obowiązkowy
1.7	Treść orzeczenia	`OLMP` · DaneOrzMedPracy	RodzajOrzMedPracy P1 (`5.31.3`)	obowiązkowy
1.8	Data następnego badania	LOINC `57070-5`	`xsi:type="TS"` — data	opcjonalny
1.9	Miejscowość wydania	LOINC `80412-0`	`xsi:type="ST"` — tekst	obowiązkowy

DaneOrzMedPracy = DaneOrzeczeniaMedycynyPracy · OID: 2.16.840.1.113883.3.4424.13.5.31.5 (IK 1.3.2 CeZ, reużyty)

1.3 Rodzaj badania — mapowanie oh-exam-type ↔ P1

W obserwacji RBMP używamy oh-exam-type (1.2.616.1.113769.1.9) jako codeSystem primary — ten sam słownik co w skierowaniu, dla spójności modelu. Opcjonalnie <translation> na RodzajBadaniaMedycynyPracy P1 (2.16.840.1.113883.3.4424.13.5.31.1).

Kod oh-exam-type	Wyświetlana nazwa	Kod P1 (RodzajBadania)
`01`	Wstępne	`1`
`02`	Okresowe	(brak w P1 — stosujemy oh-exam-type)
`03`	Kontrolne	`2`
`04`	Końcowe	(brak w P1)
`05`	Sanitarno-epidemiologiczne	(brak w P1)
`06`	Celowane	(brak w P1)

1.4 Rodzaj zatrudnienia — słownik P1

Wartości z RodzajZatrudnienia (2.16.840.1.113883.3.4424.13.5.31.2):

Kod	Wyświetlana nazwa
`1`	Pracownik
`2`	Osoba przyjmowana do pracy
`3`	Uczniowie i studenci
`4`	Pracownicy tymczasowi (agencja pracy)

1.5 Stanowisko + pracodawca — participant IND

Obserwacja z kodem LOINC 85658-3. Wartość: tekstowa nazwa stanowiska (xsi:type="ST"). Dane pracodawcy kodowane w participant typeCode="IND":

<observation classCode="OBS" moodCode="EVN">
  <code code="85658-3" codeSystem="2.16.840.1.113883.6.1"
        codeSystemName="LOINC" displayName="Occupation [Type]"/>
  <text><reference value="#OBS_5"/></text>
  <statusCode code="completed"/>
  <value xsi:type="ST">Operator pieca elektrycznego</value>
  <participant typeCode="IND">
    <participantRole>
      <!-- NIP pracodawcy -->
      <id extension="554-11-11-234" root="2.16.840.1.113883.3.4424.2.1"/>
      <!-- REGON-9 pracodawcy -->
      <id extension="191919191" root="2.16.840.1.113883.3.4424.2.2.1"/>
      <addr>
        <city>Dąbrowa Górnicza</city>
        <postalCode>41-300</postalCode>
        <streetName>Stalowa</streetName>
        <houseNumber>1</houseNumber>
      </addr>
      <telecom value="tel:32 774 00 00"/>
      <playingEntity>
        <name>Huta Katowice S.A.</name>
      </playingEntity>
    </participantRole>
  </participant>
</observation>

1.7 Treść orzeczenia — słownik RodzajOrzeczeniaMedycynyPracy

Wartości z OID 2.16.840.1.113883.3.4424.13.5.31.3 (IK 1.3.2), odpowiadające symbolom z Rozp. MZiOS 1996 (zał. 8):

Kod	Symbol wg rozp.	Skrótowa treść orzeczenia
`21`	21	Brak p/wskazań zdrowotnych — zdolny/a do podjęcia / wykonywania pracy na wskazanym stanowisku
`22`	22	Czasowo niezdolny/a — wskazane ponowne badanie po upływie …
`23`	23	Istnieją p/wskazania zdrowotne do wykonywania pracy na wskazanym stanowisku
`31`	31	Zdolny/a z ograniczeniami — opis w sekcji 2
`32`	32	Niezdolny/a do dotychczasowej pracy — choroba zawodowa, konieczne przeniesienie
`33`	33	Zakaz pracy dla młodocianych na danym stanowisku
`34`	34	Niezdolny/a — podejrzenie powstania choroby zawodowej
`41`	41	Niezdolny/a do pracy — sanitarno-epidemiologiczne

Pełne teksty zgodne z IK 1.3.2. Element displayName przenosi treść czytelną dla człowieka; <text><reference> wskazuje na fragment prezentacyjny sekcji.

Sekcja 2 · Ograniczenia i zalecenia (opcjonalna)

Używana gdy wynik orzeczenia to kod 31 (zdolny z ograniczeniami) lub inne wymagające konkretnych warunków pracy. Zawiera tekst wolny w <text> opisujący ograniczenia (np. zakaz pracy w nadgodzinach, wymagane przerwy, ograniczenie dźwigania). Opcjonalne wpisy strukturalne z moodCode="INT" lub moodCode="RQO" — do decyzji na etapie wdrożenia.

Sekcja 3 · Pouczenie (obowiązkowa w trybie Z; pomijana w trybie O)

Standardowy tekst prawny o trybie odwołania. Treść stała — bez struktury <entry>:

<section>
  <code code="48767-8" codeSystem="2.16.840.1.113883.6.1"
        codeSystemName="LOINC" displayName="Annotation comment [Interpretation] Narrative"/>
  <title>Pouczenie</title>
  <text>
    <list listType="ordered">
      <item>Osoba badana lub pracodawca może w terminie 7 dni od dnia otrzymania
        orzeczenia lekarskiego wnieść odwołanie wraz z jego uzasadnieniem
        za pośrednictwem lekarza, który je wydał, do jednego z podmiotów
        odwoławczych, którymi są:
        <list listType="ordered">
          <item>wojewódzkie ośrodki medycyny pracy właściwe ze względu na
            miejsce świadczenia pracy lub siedzibę jednostki organizacyjnej,
            w której jest zatrudniony pracownik;</item>
          <item>instytuty badawcze w dziedzinie medycyny pracy lub Uniwersyteckie
            Centrum Medycyny Morskiej i Tropikalnej w Gdyni, w przypadku
            orzeczenia lekarskiego wydanego przez lekarza zatrudnionego
            w wojewódzkim ośrodku medycyny pracy;</item>
          <item>podmioty lecznicze utworzone i wyznaczone przez Ministra
            Obrony Narodowej.</item>
        </list>
      </item>
      <item>Orzeczenie lekarskie wydane w trybie odwołania jest ostateczne.</item>
    </list>
  </text>
</section>

W trybie odwoławczym (qualifier code="O") sekcja pouczenia jest pomijana — orzeczenie jest już ostateczne.

05 · Rejestr OID i słowników

Zewnętrzne (reużycie z IK 1.3.2 i standardów globalnych)

Słownik / system	OID	Źródło
LOINC	`2.16.840.1.113883.6.1`	zewn.
KLAS_DOK_P1	`2.16.840.1.113883.3.4424.11.1.32`	CeZ
PESEL	`2.16.840.1.113883.3.4424.1.1.616`	CeZ
REGON-9	`2.16.840.1.113883.3.4424.2.2.1`	CeZ
REGON-14	`2.16.840.1.113883.3.4424.2.2.2`	CeZ
NIP	`2.16.840.1.113883.3.4424.2.1`	CeZ
PWZ lekarza	`2.16.840.1.113883.3.4424.1.6.2`	CeZ
Numer specjalizacji	`2.16.840.1.113883.3.4424.1.13.1`	CeZ
RPWDL komórka org.	`2.16.840.1.113883.3.4424.2.3.2`	CeZ
RPWDL podmiot leczniczy	`2.16.840.1.113883.3.4424.2.3.1`	CeZ
PolskieKlasyfikatoryHL7v3	`2.16.840.1.113883.3.4424.13.5.1`	CeZ/IK
DaneOrzeczeniaMedycynyPracy	`2.16.840.1.113883.3.4424.13.5.31.5`	CeZ/IK 1.3.2
TrybWystawieniaOrzeczeniaMedycynyPracy	`2.16.840.1.113883.3.4424.13.5.31.6`	CeZ/IK 1.3.2
RodzajBadaniaMedycynyPracy	`2.16.840.1.113883.3.4424.13.5.31.1`	CeZ/IK 1.3.2 (translation)
RodzajZatrudnienia	`2.16.840.1.113883.3.4424.13.5.31.2`	CeZ/IK 1.3.2
RodzajOrzeczeniaMedycynyPracy	`2.16.840.1.113883.3.4424.13.5.31.3`	CeZ/IK 1.3.2
PodstawaPrawnaOrzeczeniaMedycynyPracy	`2.16.840.1.113883.3.4424.13.5.31.7`	CeZ/IK 1.3.2

KAMSOFT — istniejące (reużyte ze skierowania)

Słownik / element	OID	Status
Rodzaj badania MP (`oh-exam-type`)	`1.2.616.1.113769.1.9`	prod.
Pracownik (Patient ID)	`1.2.616.1.113769.4.z.i.w.l.10.1`	prod.
Pracodawca (Workplace)	`1.2.616.1.113769.4.z.i.w.l.16.1`	prod.
ID skierowania (Referral) — w `inFulfillmentOf`	`1.2.616.1.113769.4.z.i.w.l.15`	prod.

KAMSOFT — do nadania ❓

Element	OID proponowany	Status
templateId dokumentu Orzeczenie MP	`1.2.616.1.113769.5.2`	do nadania (TL)
templateId sekcji 1 — Orzeczenie	`1.2.616.1.113769.5.2.1`	do nadania (TL)
templateId sekcji 2 — Ograniczenia	`1.2.616.1.113769.5.2.2`	do nadania (TL)
templateId sekcji 3 — Pouczenie	`1.2.616.1.113769.5.2.3`	do nadania (TL)
ID dokumentu orzeczenia klienta	do ustalenia — `4.z.i.w.l.16` lub rozszerzenie `4.z.i.w.l.15`?	decyzja architektoniczna

Propozycja: 1.2.616.1.113769.5.2 jako kolejny numer w gałęzi 5.* (analogicznie do 5.1 = skierowanie).

Konwencja `ValueSet.url` (FHIR)

Orzeczenie reużywa istniejących value setów KAMSOFT (prefiks oh-). Słowniki przejęte z IK 1.3.2 CeZ nie są duplikowane pod api-erp.kamsoft.pl — odwołujemy się do OID źródłowych.

Zakres	Sposób odwołania
Rodzaj badania MP	`oh-exam-type` — istniejący
Tryb wystawienia orzeczenia	OID CeZ `5.31.6` — nie duplikujemy
Rodzaj zatrudnienia	OID CeZ `5.31.2` — nie duplikujemy
Rodzaj orzeczenia	OID CeZ `5.31.3` — nie duplikujemy
Podstawa prawna orzeczenia	OID CeZ `5.31.7` — nie duplikujemy

06 · Prezentacja XSLT

Taki sam arkusz stylów jak w skierowaniu:

<?xml-stylesheet href="CDA_PL_IG_1.3.2.xsl" type="text/xsl"?>

Ścieżka względna — XSLT dystrybuowany razem z aktualizacjami systemów medycznych. Konwencje <text> identyczne z profilem skierowania: <paragraph>, <caption>, <content ID="..."/>, <list>, <table>. Każda strukturalna informacja widoczna użytkownikowi musi być redundantnie wyrażona w <text>.

07 · Podpis i walidacja

Podpis elektroniczny

Dwa scenariusze analogicznie do skierowania:

XAdES-BES/T — kwalifikowany podpis lekarza (PWZ). Rekomendowany dla trybu odwoławczego, zapewnia niezaprzeczalność wobec pracownika i pracodawcy.
Brak podpisu elektronicznego — XML bez podpisu; dopuszczalne przy zabezpieczonym kanale B2B lub wydaniu wydruku pracownikowi i pracodawcy.

Element <legalAuthenticator> z signatureCode="S" pozostaje zawsze w dokumencie.

Walidacja schematu

Analogicznie do skierowania: walidacja XSD na poziomie strukturalnym (zgodność z HL7 CDA R2 + extPL). Reguły semantyczne (np. obowiązek next_exam_date dla kodu 21, obowiązek sekcji 2 dla kodu 31) — do rozważenia jako schematron w wersji v0.9.

08 · Wątki otwarte i roadmapa

Decyzje oczekujące

[TL] OID gałęzi 5.2 — nadanie 1.2.616.1.113769.5.2 i podgałęzi 5.2.1–5.2.3 przez właściciela drzewa OID.

[TBD] ID dokumentu orzeczenia — czy klient potrzebuje osobnej gałęzi ID (4.z.i.w.l.16) dla orzeczenia czy reużywa 4.z.i.w.l.15?

[TBD] Mapowanie oh-exam-type ↔ P1 — czy w wpisie 1.3 (RBMP) podajemy oh-exam-type jako codeSystem primary z opcjonalnym <translation> na RodzajBadaniaMedycynyPracy P1, czy używamy P1 jako primary? Propozycja: oh-exam-type primary (spójność ze skierowaniem) + <translation> P1 opcjonalny dla interoperacyjności z zewnętrznymi systemami medycznymi.

[TBD] Sekcja 2 — wpisy strukturalne — określić minimalne wpisy entry dla ograniczeń (moodCode INT) i zaleceń dla pracodawcy. Decyzja na etapie wdrożenia v0.9.

[TBD] Kanał zwrotny — zdefiniować mechanizm dostarczenia orzeczenia do KS-ZZL: push B2B przez API.ERP incoming-certificates endpoint, pull przez API.MED, czy poza API (wydruk / e-mail).

Plan ewolucji

Wersja	Zakres
v0.1	propozycja specyfikacji — ten dokument; kontrakt JSON wejściowy
v0.2	uzupełnienie po decyzjach OID (TL); uzgodnienie z API.MED i API.ERP; przykładowy XML
v0.9	kandydat produkcyjny — pełne OID-y, przykłady XML (tryb Z i O), generator lub mapper JSON→CDA, schematron reguł semantycznych
v1.0	emisja w KS-SOMED / KS-PPS / SERUM / Mediporta (API.MED); odbiór i archiwizacja w KS-ZZL (API.ERP); integracja z kanałami

09 · Repozytorium projektu

Struktura katalogów

Katalog	Zawartość
`profile/`	Ten plik (orzeczenie-cda.md); specyfikacja skierowania (profil-cda.md); rejestr OID (oid-status.md)
`contracts/`	orzeczenie_mp_input.schema.json — schemat JSON wejściowy (propozycja v0.1)
`samples/`	Przykłady XML skierowania; brak przykładu orzeczenia — do dodania w v0.2
`reference/`	Arkusz stylów CeZ, słownik stanowisk i czynników
`tools/`	Generator skierowania v0.3; generator orzeczenia — TBD

Referencje P1 (wzorce IK 1.3.2)

Przykładowe dokumenty orzeczenia z polskiej IG CeZ w samples/p1-referencje/ (OID szablonu 2.16.840.1.113883.3.4424.13.10.1.52) stanowią źródło strukturalne dla tego profilu:

Plik	Zawartość
`…52-1.xml`	Wstępne · tryb zwykły · osoba przyjmowana
`…52-2.xml`	Kontrolne · podejrzenie choroby zawodowej (kod 34)
`…52-3.xml`	Kontrolne · kod 34 · z ograniczeniami i zaleceniami
`…52-4.xml`	Kontrolne · tryb odwoławczy (`qualifier code="O"`)

Powrót do indeksu MP