Build a Polish Medical Event Document (HL7 CDA for P1)
Skill: Convert a clinical encounter into an HL7 CDA medical event reported to the P1 platform
Region: Poland (Polska) Category: Health care — e-health (e-zdrowie / P1) Does: Takes a clinical encounter (visit, hospitalisation, procedure) and assembles the structured medical event (zdarzenie medyczne) record plus the linked electronic medical documentation (EDM) as an HL7 CDA document, reported by the healthcare provider to the P1 platform operated by CeZ, and made available to NFZ / other entitled entities. Spec: Centrum e-Zdrowia (CeZ) — Polish HL7 CDA Implementation Guide (Polska Implementacja Krajowa, PIK HL7 CDA) for zdarzenia medyczne / EDM (current version)
Polish providers must report medical events to P1 and, for designated document types, exchange EDM in HL7 CDA Release 2 (PL implementation). The medical-event report carries the who/when/where/what of the encounter and a reference to the EDM document index; the CDA documents themselves (e.g. discharge summary, e-referral results, lab report) follow the national CDA templates. Element/template names below follow the PIK HL7 CDA structures, not a verbatim XSD.
When this applies
- Providers (świadczeniodawcy) of inpatient and outpatient care must report each medical event to P1 (the obligation is in force for the defined event types) and index the related EDM.
- Reporting is per encounter, generally close to the event; EDM is shared on request via P1 to entitled entities (other providers, the patient via IKP, NFZ where applicable).
Structure (ENCOUNTER → CDA)
ClinicalDocument (HL7 CDA R2, PL header)
recordTarget patient: PESEL (or other ID), name, DOB, sex
author practitioner: PWZ number (prawo wykonywania zawodu), role
custodian provider: REGON / part-VII RPWDL identifier, NPWZ where used
componentOf encounter: type (visit/hospitalisation), period (effectiveTime), place
documentationOf serviceEvent: procedure/diagnosis codes (ICD-10 dx, ICD-9 procedures)
component/body EDM sections per the document-type template
Medical-event report (zdarzenie medyczne) to P1:
event type, patient ID, provider ID, practitioner PWZ, dates, ICD-10/ICD-9, EDM index ref
Data rules
- Patient identity by PESEL where available (otherwise document type+number for foreign patients); must match the entitlement check.
- Practitioner identified by PWZ (numer prawa wykonywania zawodu); provider by its RPWDL / REGON identifier.
- Clinical coding — diagnoses in ICD-10, procedures in ICD-9 PL; these are mandatory on the event report.
- Event ↔ EDM linkage — the medical-event report references the EDM document (CDA) by its identifier so entitled entities can retrieve it via P1.
- Templates & validation — CDA documents must conform to the national CDA template for the document type; P1 validates against the PIK HL7 CDA rules.
Worked example (outline)
Outpatient cardiology visit 2025-09-12, provider RPWDL XXXX, practitioner PWZ 1234567:
recordTarget: PESEL 75030312345
documentationOf: dx ICD-10 I10 (hypertension); no ICD-9 procedure
EDM: porada ambulatoryjna CDA document, id urn:…:doc:987
Medical-event report → P1: event type "porada", dates, codes, EDM ref doc:987
Emitted as an HL7 CDA document plus the medical-event report sent to P1 (CeZ); EDM retrievable by entitled entities and visible to the patient via IKP.
Validation checklist
- Current PIK HL7 CDA template/version for the document type used
- Patient PESEL/identity, practitioner PWZ, and provider RPWDL/REGON present
- Encounter type, period, and place recorded
- Diagnoses in ICD-10, procedures in ICD-9 PL
- Medical-event report references the EDM document identifier
- CDA validates against P1 rules; event reported to P1 (CeZ) for the encounter
- EDM made available to entitled entities / IKP
Last updated: 2026-06-04 — confirm the current CeZ PIK HL7 CDA implementation guide, the reportable event types, identifier and coding requirements (PESEL/PWZ/RPWDL, ICD-10/ICD-9), and P1 validation rules against current Centrum e-Zdrowia (cez.gov.pl) guidance before use.