Added iti44 endpoint and update to upcoming changes for pmp v0.4.0

CARA-ch · Apr 24, 2024 · 1febd82 · 1febd82
1 parent 4d6ce95
commit 1febd82
Show file tree

Hide file tree

Showing 3 changed files with 29 additions and 3 deletions.
diff --git a/docs/endpoints.md b/docs/endpoints.md
@@ -10,6 +10,7 @@ This page lists the different endpoints available to use the e-medication servic
 ## PIX EndPoints
 | Transaction | Path | Documentation |
 | --- | --- | --- |
+|Patient Identity Feed HL7 V3 (ITI-44)|`/services/iti44`| [ITI-44](transactions/iti44.md). See also the [IHE documentation](https://profiles.ihe.net/ITI/TF/Volume2/ITI-44.html).|
 |PIXV3 Query (ITI-45)|`/services/iti45`| [ITI-45](transactions/iti45.md). See also the [IHE documentation](https://profiles.ihe.net/ITI/TF/Volume2/ITI-45.html).|
 
 ## XDS EndPoints

diff --git a/docs/other/upcoming_changes.md b/docs/other/upcoming_changes.md
@@ -1,9 +1,33 @@
-Next release dates:
+## Currently Deployed
 
-- Next CH EMED EPR version release: *TBD - early 2024*
-- Next aggregator deployment: *TBD - early 2024*
+- dev:
+  - PMP (aggregator) v0.4.0 (deployed 2024-04-23, DB recreated), works with [https://fhir.ch/ig/ch-emed-epr/index.html](CH EMED EPR 1.0.0).
+  - alpage v0.0.3 (deployed 2024-04-23 due to VM migration, same version as prev. VM, DB recreated)
+- int:
+  - PMP (aggregator) v0.3.0 (deployed ~2024-04-15, DB recreated), works with [https://fhir.ch/ig/ch-emed-epr/index.html](CH EMED EPR 1.0.0).
+  - alpage v0.0.3 (deployed ~2024-04-15 due to VM migration, same version as prev. VM, DB recreated)
 
 
+## Next Release Dates
+
+- Next CH EMED EPR version release: *TBD*
+- Next aggregator release: *TBD*
+- Next aggregator deployment: *TBD*
+
+## Relevant Changes
+
+### PMP v0.4.0
+The PMP is abandoning the use of CARA's MPI-PID as XAD-PID and with the v0.4.0 starts a transition period towards the use of a PMP-PID (*PMP assigned patient id*) as XAD-PID in order to pave the road to support systems with patients from other reference communities. What this entails for PMP v0.4.0:
+  - Patient registration:
+    - Query: an ITI-45 query (added with v0.3.0) allows a system to know if a patient has a PMP registration (whether active or not) and to fetch the PMP-PID.
+	- Add: to register a patient, the following steps will be needed:
+	  1) Perform an ITI-44 query (PIXV3 feed) to add the new patient to the PMP.
+	  2) Fetch the PMP-PID with an ITI-45 query to the PMP.
+	  3) Perform an ITI-41 with the APPC document to activate the registration. Until this is done, no other transaction for providing, fetching or searching documents will be accepted.
+  - All requests (other than PIX) expect now the use of PMP-PID ids (SubmissionSet.patientId and DocumentEntry.patientId). Systems can continue to use CARA's MPI-PIDs for this and the aggregator will perform a translation but include a warning with the response. The grace period for transitioning towards PMP-PIDs has not been defined.
+Note that PMP-PIDs will not be the same for the same patients in different environments, see [OIDs](oids.html) for the each deployed platform's patient identification domain id.
+
+### PMP v0.3.0
 Relevant changes from (upcoming) CH EMED EPR 1.0.0 based on CH EMED 4.0.0 (the latter should be published before the end of the current year):
 
   - Authorship and authorship timestamps. Please refer to the [CH EMED authorship guidance page](https://build.fhir.org/ig/hl7ch/ch-emed/authorship.html) for further reading:

diff --git a/docs/transactions/iti44.md b/docs/transactions/iti44.md
@@ -0,0 +1 @@
+todo