EPD Playground - Contributions [fr]

Transaction examples

2024-11-21T10:46:29Z

Heg2 : /* Upload a document */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|[https://fhir.ch/ig/ch-epr-fhir/iti-104.html Patient Identity Feed FHIR]
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example registers a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment).

⚠️ Please use own example patient name and identifiers when experimenting with the playground. ⚠️

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir/</code>

{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://profiles.ihe.net/ITI/MHD/StructureDefinition/IHE.MHD.Comprehensive.ProvideBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:25747cb2-b718-4b0f-877c-05f65e575973",
"resource": {
"resourceType": "Binary",
"contentType": "text/plain",
"data": "dGVzdA=="
},
"request": {
"method": "POST",
"url": "urn:uuid:25747cb2-b718-4b0f-877c-05f65e575973"
}
},
{
"fullUrl": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd",
"resource": {
"resourceType": "List",
"id": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd",
"meta": {
"profile": [
"http://profiles.ihe.net/ITI/MHD/StructureDefinition/IHE.MHD.Comprehensive.SubmissionSet"
]
},
"extension": [
{
"url": "http://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-designationType",
"valueCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
}
},
{
"url": "http://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-sourceId",
"valueIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5"
}
}
],
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd"
}
],
"status": "current",
"mode": "working",
"title": "EPD Playground Testdokument (2024)",
"code": {
"coding": [
{
"system": "http://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes",
"code": "submissionset",
"display": "Submission Set"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"entry": [
{
"item": {
"reference": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b"
}
}
],
"date": "2024-11-20"
},
"request": {
"method": "POST",
"url": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd"
}
},
{
"fullUrl": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "pat1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true
}
],
"masterIdentifier": {
"value": "urn:oid:2.16.756.5.30.1.178.1.1.1.2295230"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2024-11-20",
"description": "EPD Playground Testdokument (2024)",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/plain",
"language": "de-CH",
"url": "urn:uuid:25747cb2-b718-4b0f-877c-05f65e575973"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#pat1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-11-21T10:45:42Z

Heg2 : /* Upload a document */

Transaction examples

2024-11-21T10:44:13Z

Heg2 : /* Upload a document */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|[https://fhir.ch/ig/ch-epr-fhir/iti-104.html Patient Identity Feed FHIR]
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example registers a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment).

⚠️ Please use own example patient name and identifiers when experimenting with the playground. ⚠️

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir/</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://profiles.ihe.net/ITI/MHD/StructureDefinition/IHE.MHD.Comprehensive.ProvideBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:25747cb2-b718-4b0f-877c-05f65e575973",
"resource": {
"resourceType": "Binary",
"contentType": "text/plain",
"data": "dGVzdA=="
},
"request": {
"method": "POST",
"url": "urn:uuid:25747cb2-b718-4b0f-877c-05f65e575973"
}
},
{
"fullUrl": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd",
"resource": {
"resourceType": "List",
"id": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd",
"meta": {
"profile": [
"http://profiles.ihe.net/ITI/MHD/StructureDefinition/IHE.MHD.Comprehensive.SubmissionSet"
]
},
"extension": [
{
"url": "http://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-designationType",
"valueCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
}
},
{
"url": "http://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-sourceId",
"valueIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5"
}
}
],
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd"
}
],
"status": "current",
"mode": "working",
"title": "EPD Playground Testdokument (2024)",
"code": {
"coding": [
{
"system": "http://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes",
"code": "submissionset",
"display": "Submission Set"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"entry": [
{
"item": {
"reference": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b"
}
}
],
"date": "2024-11-20"
},
"request": {
"method": "POST",
"url": "urn:uuid:d25755c4-dbe3-4bcf-bb8b-2e4aeeab6edd"
}
},
{
"fullUrl": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "pat1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true
}
],
"masterIdentifier": {
"value": "urn:oid:2.16.756.5.30.1.178.1.1.1.2295230"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2024-11-20",
"description": "EPD Playground Testdokument (2024)",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/plain",
"language": "de-CH",
"url": "urn:uuid:25747cb2-b718-4b0f-877c-05f65e575973"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#pat1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:b04df41d-2e7a-4553-a7ec-81d737328d3b"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-10-31T10:22:39Z

Heg2 :

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|[https://fhir.ch/ig/ch-epr-fhir/iti-104.html Patient Identity Feed FHIR]
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example registers a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment).

⚠️ Please use own example patient name and identifiers when experimenting with the playground. ⚠️

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-10-31T09:55:38Z

Heg2 : /* Create / Register Patient */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Patient Identity Feed FHIR
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example registers a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment).

⚠️ Please use own example patient name and identifiers when experimenting with the playground. ⚠️

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-10-31T09:54:43Z

Heg2 : /* Create / Register Patient */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Create / Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Patient Identity Feed FHIR
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example registers a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment).

⚠️ Please use own example patient name and identifiers when experimenting with the playground. ⚠️

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-10-31T09:54:13Z

Heg2 : /* Create / Register Patient */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Create / Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Patient Identity Feed FHIR
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment).

⚠️ Please use own example patient name and identifiers when experimenting with the playground. ⚠️

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-10-25T14:27:26Z

Heg2 :

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground. You can also find transaction examples in the [https://fhir.ch/ig/ch-epr-fhir/index.html CH EPR FHIR Implementation Guide].

=== Create / Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Patient Identity Feed FHIR
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment). Please use own example patient and identifiers when experimenting with the playground.

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2024-10-25T14:25:21Z

Heg2 : Replace ITI-93 with newer ITI-104

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create / Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Patient Identity Feed FHIR
|[ITI-104]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment). Please use own example patient and identifiers when experimenting with the playground.

PUT https://test.ahdis.ch/mag-bfh/fhir/Patient/?identifier=urn:oid:2.16.756.5.30.1.178.1.1|PATIENT1

{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
}
]
},
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1", // this is the local ID, please use own value
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO" // this is the EPR SPID, please use own value
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"identifier": {
"system": "urn:oid:2.51.1.3",
"value": "7640166732006" // this is the GLP of the responsible health care provider, in this case Dr. med. Marianne Loser.
// see https://epdplayground.ch/index.php?title=Demo_Data
}
}
}

* The identifier values in the PUT url must match with your local id given in Patient.identifier

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

End points & Transactions

2024-10-14T11:36:37Z

Heg2 :

===ATNA Audit Record Repository (ARR) FHIR===

[https://epdplayground.i4mi.bfh.ch:7443/ARR/fhir https://epdplayground.i4mi.bfh.ch:7443/ARR/fhir]

*ATC-81 Retrieve ATNA Audit Record

===ATNA Audit Record Repository (ARR) Syslog===

{| class="wikitable"
|-
! Protocol !! Port !! Remark
|-
| UDP || 5230 ||
|-
| TCP unencrypted || 5232 || epdplayground.i4mi.bfh.ch:5232 or 147.87.232.72:5232 in case DNS resolution does not work
|-
| TCP encrypted (TLS) || 5234 || epdplayground.i4mi.bfh.ch:5234 or 147.87.232.72:5234 in case DNS resolution does not work
|}

*ITI-20 Record Audit Event

===HPD===

[https://epdplayground.i4mi.bfh.ch:7443/HPD/services/HPDService https://epdplayground.i4mi.bfh.ch:7443/HPD/services/HPDService]

*ITI-58 Provider Information Query
*ITI-59 Provider Information Feed

===UPI Proxy===

[https://epdplayground.i4mi.bfh.ch:7443/UPIProxy/services/PIXPDQV3ManagerService https://epdplayground.i4mi.bfh.ch:7443/UPIProxy/services/PIXPDQV3ManagerService]

*ITI-47 Patient Demographics Query HL7V3
*ITI-44 Patient Identity Feed HL7V3
*ITI-45 PIXV3 Query

===PIX/PDQ Manager===

[https://epdplayground.i4mi.bfh.ch:7443/PIXPDQ/services/PIXPDQV3ManagerService https://epdplayground.i4mi.bfh.ch:7443/PIXPDQ/services/PIXPDQV3ManagerService]

*ITI-47 Patient Demographics Query HL7V3
*ITI-44 Patient Identity Feed HL7V3
*ITI-45 PIXV3 Query

===Repository===

[https://epdplayground.i4mi.bfh.ch:6443/Repository/services/RepositoryService https://epdplayground.i4mi.bfh.ch:6443/Repository/services/RepositoryService]

*ITI-41 Provide and Register Document Set
*ITI-43 Retrieve Document Set

===Registry===

[https://epdplayground.i4mi.bfh.ch:7443/Registry/services/RegistryService https://epdplayground.i4mi.bfh.ch:7443/Registry/services/RegistryService]

*ITI-18 RegistryStoredQuery

===Valueset Repository (Sharing Value Sets SVS)===

[https://epdplayground.i4mi.bfh.ch:7443/ValueSetRepository/services/ValueSetRepositoryService https://epdplayground.i4mi.bfh.ch:7443/ValueSetRepository/services/ValueSetRepositoryService]

*ITI-48 Retrieve Value Set
*ITI-60 Retrieve Multiple Value Sets

=== Transaction examples (using Mobile Access Gateway) ===
For using the [[Mobile Access Gateway]] to access the EPD Playground, we provide some [[Transaction examples]].

Demo Data

2024-05-02T08:40:56Z

Heg2 : /* Institutions and Healthcare Providers */

== Institutions and Healthcare Providers ==

{| class="wikitable"
!Type
!Name
!Identifier
!Parent
|-
|Organization
|BFH Medizininformatik
|OID: 2.16.756.5.30.1.178
|
|-
|Organization
|Klinik Höheweg
|OID: 2.16.756.5.30.1.178.1.1
|BFH Medizininformatik
|-
|Organization
|Klinik Höheweg - Innere Medizin
|OID: 2.16.756.5.30.1.178.1.1.1
|Klinik Höheweg
|-
|Organization
|Klinik Höheweg - Chirurgie
|OID: 2.16.756.5.30.1.178.1.1.2
|Klinik Höheweg
|-
|Organization
|Klinik Höheweg - Radiologie
|OID: 2.16.756.5.30.1.178.1.1.3
|Klinik Höheweg
|-
|Organization
|Praxis am Kreuzweg
|OID: 2.16.756.5.30.1.178.1.2
|BFH Medizininformatik
|-
|Organization
|Kreuzweg Apotheke
|OID: 2.16.756.5.30.1.178.1.3
|BFH Medizininformatik
|-
|Application
|Impfmodul
|OID: 2.16.756.5.30.1.178.2.1
|
|-
|Individual
|Dr. med. Marianne Loser
|GLN: 7640166732006
|Klinik Höheweg - Innere Medizin
|-
|Individual
|Dr. med. Florian Meier
|GLN: 7640166732013
|Klinik Höheweg - Chirurgie
|-
|Individual
|Bernhard Kocher
|GLN: 7640166732075
|Kreuzweg Apotheke
|-
|Individual
|Dr. med. Hanspeter Wenger
|GLN: 7640166732204
|Praxis am Kreuzweg
|}

== Patients ==

{| class="wikitable"
!Name
!Firstname
!Date of birth
!AHVN13
!EPR-SPID
!MPI-ID
!Remark
|-
!colspan="3"|OID
!2.16.756.5.32
!2.16.756.5.30.1.127.3.10.3
!1.1.1.99.1
!
|-
|ALPHA
|ALAN
|
|
|DEMO
|0f5a8034-3c8a-4796-bd39-d3ea877a4155
|Gazelle test patient
|-
|Calame
|Daniel
|07.05.1963
|
|EPR-SPID-VNF001
|3cb69165-fbc7-4f80-830d-dcb3a837099d
|I4MI test patient
|-
|Piazza-Baumann
|Eliane
|15.01.1967
|7560520482340
|761337637673823141
|2dc7a783-78b1-4627-94fb-610a23135c42
|Patient from UPI mock
|-
|Dubois
|Cécile
|04.08.1961
|7561894552349
|761337615395845832
|e2d9dbec-9f49-4944-8b6b-790e88d2bd0f
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Favre
|Daniel
|23.10.1962
|7561854932433
|761337615358493254
|1ce9e25d-18f1-49f4-8b0d-d404d7682f02
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Jeanneret
|Alice
|12.09.1938
|7561836220657
|761337615337957326
|c64b6912-e15d-4b6e-8904-6d4aed84e2be
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Laurent
|Patricia
|18.08.1967
|7561845324865
|761337615346721130
|8688b0e8-cbf8-4cc2-971a-84c1959f64d7
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]", AllergyIntolerance Use Case
|-
|Leroy
|Simon
|20.07.1976
|7561867658337
|761337615367859263
|fbd9cee8-734f-4b64-9f3b-e6d0f75548ec
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Winter
|Markus
|14.06.1965
|7561874599326
|761337615374833126
|2e4cb1c6-704a-4e9a-a8e1-024bc48305c8
|Persona of LC1 & LC2 eMedication by BFH students
|}

== Patient identifiers ==

Here is a short extract out of the "Bearbeitungsreglement über die Patientenidentifikationsnummer für das elektronische Patientendossier":

Gestützt auf die rechtlichen Grundlagen zur Einführung des elektronischen Patientendossiers errichtet die ZAS einen mit der AHVN13 verknüpften, spezifischen Identifikator (sektorieller Identifikator). Mit diesem Identifikator, genannt EPR-SPID, soll der Patient oder die Patientin eindeutig identifiziert werden. Das Gesetz und die entsprechenden Verordnungen (EPDG, EPDV, EPDV-EDI mit Anhängen) regeln die Form und die Verwendung dieses Identifikators abschliessend.

{| class="wikitable"
!AHVN13
|AHVN13 («dreizehnstellige AHV-Nummer») ist ein von der ZAS vergebener administrativer Identifikator für natürliche Personen, der Organisationen und Gemeinwesen mit gesetzlicher Grundlage für die systematische Verwendung zur Verfügung steht.
|-
!UPI
|UPI («Unique Person Identification») ist ein von der ZAS geführtes Informatiksystem für die administrative Identifikation der natürlichen Personen und die Verwaltung des Identifikators AHVN13.
|-
!EPR-SPID
|EPR-SPID (Kurzwort für Patientenidentifikationsnummer für das elektronische Patientendossier) ist ein an die AHVN13 gekoppelter sektorieller Personenidentifikator, im Rahmen des elektronischen Patientendossiers für die Identifikation der Patientinnen und Patienten verwendeter Personenidentifikator.
|-
!Gemeinschaft
|Gemeinschaft (Abkürzung: G): Eine Gemeinschaft ist gemäss Artikel 2 Buchstabe d EPDG eine organisatorische Einheit von Gesundheitsfachpersonen und deren Einrichtungen.
|-
!Stammgemeinschaft
|Stammgemeinschaft (Abkürzung: SG): Eine Stammgemeinschaft ist gemäss Artikel 2 Buchstabe e EPDG eine Gemeinschaft, die zusätzliche Aufgaben wahrnimmt (u. a. die Eröffnung und Verwaltung der Patientendossiers).
|-
!MPI-ID
|Die MPI-ID ist die Stammgemeinschaft-interne ID der Patientinnen und Patienten.
|}

=== AHVN13 ===

'''Aufbau der neuen AHV-Nummer (Sozialversicherungsnummer)'''

Quelle: [https://www.sozialversicherungsnummer.ch/aufbau-neu.htm https://www.sozialversicherungsnummer.ch/aufbau-neu.htm]

{| class="wikitable"
!Stelle
|N1
|N2
|N3
|N4
|N5
|N6
|N7
|N8
|N9
|N10
|N11
|N12
|N13
|-
!Bezeichnung
|colspan="3"|Ländercode
|colspan="9"|Personenidentifikation
|Prüfziffer
|-
!Wert
|7
|5
|6
|I1
|I2
|I3
|I4
|I5
|I6
|I7
|I8
|I9
|P
|}

Die neue 13-stellige Sozialversicherungsnummer der Schweiz verschlüsselt drei Informationen:
* Stelle 1-3 enthält den Ländercode (756 für die Schweiz)
* Stelle 4-12 enthält die Personenidentifikationsnummer
* Stelle 13 enthält die Prüfziffer (kann bei [https://www.gs1.ch/home/angebot/barcode/prüfzifferrechner-barcodegenerator GS1] berechnet werden)

'''OID'''

Quelle: [http://fhir.ch/ig/ch-core/NamingSystem-ahvn13-navs13.html http://fhir.ch/ig/ch-core/NamingSystem-ahvn13-navs13.html]

2.16.756.5.32

=== EPR-SPID ===

'''Aufbau der Patientenidentifikationsnummer'''

Quelle: [https://www.fedlex.admin.ch/eli/cc/2017/205/de#annex_1 https://www.fedlex.admin.ch/eli/cc/2017/205/de#annex_1]

{| class="wikitable"
!Stelle
|N1
|N2
|N3
|N4
|N5
|N6
|N7
|N8
|N9
|N10
|N11
|N12
|N13
|N14
|N15
|N16
|N17
|N18
|-
!Bezeichnung
|colspan="2"|Ländercode
|colspan="5"|Teilnehmernummer
|Anwendungsbereichs EPD
|colspan="9"|Identifikationsnummer
|Prüfziffer
|-
!Wert
|7
|6
|1
|3
|3
|7
|6
|1
|I1
|I2
|I3
|I4
|I5
|I6
|I7
|I8
|I9
|P
|}

Die Patientenidentifikationsnummer besteht aus:
* einem zweistelligen Ländercode (76 für die Schweiz)
* einer fünfstelligen Nummer für die Bezeichnung des registrierten Teilnehmers «Bundesamt für Gesundheit» (13376)
* einer einstelligen Nummer für die Bezeichnung des Anwendungsbereichs «Elektronisches Patientendossier» (1)
* einer neunstelligen Nummer für die Identifikation der Patientin oder des Patienten
* einer einstelligen Prüfziffer (kann bei [https://www.gs1.ch/home/angebot/barcode/prüfzifferrechner-barcodegenerator GS1] berechnet werden)

'''OID'''

Quelle: [https://fhir.ch/ig/ch-core/NamingSystem-epr-spid.html https://fhir.ch/ig/ch-core/NamingSystem-epr-spid.html]

2.16.756.5.30.1.127.3.10.3

=== MPI-ID ===

'''OID'''

1.1.1.99.1

=== Links ===

* [https://www.zas.admin.ch/zas/de/home/partenaires-et-institutions-/unique-person-identification--upi-/identifiant-du-dossier-electronique-du-patient.html Zentrale Ausgleichsstelle ZAS – Der Identifikator für das elektronische Patientendossier]
* [https://www.e-health-suisse.ch/de/technik-semantik/epd-projectathon/programmierhilfen-epd.html eHealth Suisse – Programmierhilfen EPD]

Transaction examples

2024-03-13T10:12:38Z

Heg2 : /* Create Patient */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create / Register Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Main Page

2023-10-30T11:57:20Z

Heg2 : /* Mobile Access Gateway */

[[File:BFH_Logo_C_de_fr_en_100_4CU_L2000px.png|180x180px|right]] [[File:ehealthsuisse.png|180x180px|right]] [[File:Post.png|180x180px|right]] [[File:EPD Logo.png|180x180px]] [[File:EPD_Playground400.png|180x180px]]

Welcome to the EPD Playground

The EPD Playground is a standalone instance of an EPDG conform ([https://www.bag.admin.ch/bag/de/home/gesetze-und-bewilligungen/gesetzgebung/gesetzgebung-mensch-gesundheit/gesetzgebung-elektronisches-patientendossier.html Gesetzgebung Elektronisches Patientendossier]) EPR platform.

It completes the existing available platforms by offering access without any security barrier, for a first discovery of the EPR world and for the realization of demonstrators of use cases with added value.

[[File:EPD_Platforms.png|800px]]

== End points & Transactions ==

The EPD Playground is provided by the [https://i4mi.bfh.ch Institute of Medical Informatics I4MI] at the [https://bfh.ch Bern University of Applied Sciences BFH], [https://e-health-suisse.ch eHealth Suisse] and the [https://www.post.ch/de/geschaeftsloesungen/digital-health/e-health-plattform Swiss Post]. It is running on a virtual machine hosted at BFH and is free to use. The end points and available transactions are documented under [[End points & Transactions]].

The EPD Playground is aimed to experiment the connection of mHealth apps to the national EPR. The primary goal is to create and demonstrate use cases showing the benefit of integrating the EPR. To ease the connection to the EPD Playground, '''all authentication and authorisation hurdles''' – that a productive EPR instance enforces – '''have been disabled''', so the access is straight forward and does not require the use of any access and authorization tokens.

To facilitate implementation, the [[Mobile Access Gateway]] has been developed, allowing the use of FHIR-based mHealth profiles. One instance of the Mobile Access Gateway is connected to the EPD Playground (see further down).

== Demo Data ==

Demo organizations, healthcare providers and patients are listed under [[Demo Data]]. These demo data are intended to be permanent and will be extended in the context of the realization of use cases.

== Mobile Access Gateway ==

The [[Mobile Access Gateway]] provides following FHIR-based profiles:

* [https://profiles.ihe.net/ITI/PIXm/ Patient Identifier Cross-referencing for Mobile (PIXm)]
* [https://profiles.ihe.net/ITI/PDQm/ Patient Demographics Query for Mobile (PDQm)]
* [https://profiles.ihe.net/ITI/MHD/index.html Mobile Access to Health Documents (MHD)]

[[Transaction examples]] are provided to demonstrate how to access the EPD Playground using the [[Mobile Access Gateway]]. For SOAP transactions, see [https://github.com/ehealthsuisse/EPD-by-example/ EPD by example from eHealth Suisse].

== Swiss Implementation Guides ==

Among all brand new [http://fhir.ch Swiss Implementation Guides], the mHealth profiles PIXm, PDQm and MHD specified in the implementation guide [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ CH EPR mHealth] might be tested against the EPD Playground.

==Links to EPD Themes==

* eHealth Suisse
** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung.html EPD-Anbindung – Anbindung von Primärsystemen]
*** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung/techniker.html Relevante Schnittstellen für die EPD-Integration]
*** [https://github.com/ehealthsuisse/EPD-by-example GitHub – EPD-by-example]
** [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ Implementation Guide CH EPR mHealth (R4)]
*** [https://github.com/ehealthsuisse/ch-epr-mhealth/ GitHub – CH EPR mHealth]
** [https://www.e-health-suisse.ch/fileadmin/user_upload/Dokumente/D/Bericht-Interoperabilitaet_de.pdf Grundlagen für interoperable Prozesse im Gesundheitswesen]

* IHE
** [https://profiles.ihe.net/ITI/MHD/index.html Profile – Mobile access to Health Documents (MHD)]
*** [https://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) Wiki – Mobile access to Health Documents (MHD)]

Main Page

2023-10-30T11:56:41Z

Heg2 : /* Mobile Access Gateway */

[[File:BFH_Logo_C_de_fr_en_100_4CU_L2000px.png|180x180px|right]] [[File:ehealthsuisse.png|180x180px|right]] [[File:Post.png|180x180px|right]] [[File:EPD Logo.png|180x180px]] [[File:EPD_Playground400.png|180x180px]]

Welcome to the EPD Playground

The EPD Playground is a standalone instance of an EPDG conform ([https://www.bag.admin.ch/bag/de/home/gesetze-und-bewilligungen/gesetzgebung/gesetzgebung-mensch-gesundheit/gesetzgebung-elektronisches-patientendossier.html Gesetzgebung Elektronisches Patientendossier]) EPR platform.

It completes the existing available platforms by offering access without any security barrier, for a first discovery of the EPR world and for the realization of demonstrators of use cases with added value.

[[File:EPD_Platforms.png|800px]]

== End points & Transactions ==

The EPD Playground is provided by the [https://i4mi.bfh.ch Institute of Medical Informatics I4MI] at the [https://bfh.ch Bern University of Applied Sciences BFH], [https://e-health-suisse.ch eHealth Suisse] and the [https://www.post.ch/de/geschaeftsloesungen/digital-health/e-health-plattform Swiss Post]. It is running on a virtual machine hosted at BFH and is free to use. The end points and available transactions are documented under [[End points & Transactions]].

The EPD Playground is aimed to experiment the connection of mHealth apps to the national EPR. The primary goal is to create and demonstrate use cases showing the benefit of integrating the EPR. To ease the connection to the EPD Playground, '''all authentication and authorisation hurdles''' – that a productive EPR instance enforces – '''have been disabled''', so the access is straight forward and does not require the use of any access and authorization tokens.

To facilitate implementation, the [[Mobile Access Gateway]] has been developed, allowing the use of FHIR-based mHealth profiles. One instance of the Mobile Access Gateway is connected to the EPD Playground (see further down).

== Demo Data ==

Demo organizations, healthcare providers and patients are listed under [[Demo Data]]. These demo data are intended to be permanent and will be extended in the context of the realization of use cases.

== Mobile Access Gateway ==

The [[Mobile Access Gateway]] provides following FHIR-based profiles:

* [https://profiles.ihe.net/ITI/PIXm/ Patient Identifier Cross-referencing for Mobile (PIXm)]
* [https://profiles.ihe.net/ITI/PDQm/ Patient Demographics Query for Mobile (PDQm)]
* [https://profiles.ihe.net/ITI/MHD/index.html Mobile Access to Health Documents (MHD)]

[[Transaction examples]] are provided to demonstrate how to access the EPD Playground using the [[Mobile Access Gateway]]. For SOAP transactions, see [https://github.com/ehealthsuisse/EPD-by-example/(EPD by example from eHealth Suisse].

== Swiss Implementation Guides ==

Among all brand new [http://fhir.ch Swiss Implementation Guides], the mHealth profiles PIXm, PDQm and MHD specified in the implementation guide [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ CH EPR mHealth] might be tested against the EPD Playground.

==Links to EPD Themes==

* eHealth Suisse
** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung.html EPD-Anbindung – Anbindung von Primärsystemen]
*** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung/techniker.html Relevante Schnittstellen für die EPD-Integration]
*** [https://github.com/ehealthsuisse/EPD-by-example GitHub – EPD-by-example]
** [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ Implementation Guide CH EPR mHealth (R4)]
*** [https://github.com/ehealthsuisse/ch-epr-mhealth/ GitHub – CH EPR mHealth]
** [https://www.e-health-suisse.ch/fileadmin/user_upload/Dokumente/D/Bericht-Interoperabilitaet_de.pdf Grundlagen für interoperable Prozesse im Gesundheitswesen]

* IHE
** [https://profiles.ihe.net/ITI/MHD/index.html Profile – Mobile access to Health Documents (MHD)]
*** [https://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) Wiki – Mobile access to Health Documents (MHD)]

Main Page

2023-10-30T11:56:15Z

Heg2 : /* Mobile Access Gateway */

[[File:BFH_Logo_C_de_fr_en_100_4CU_L2000px.png|180x180px|right]] [[File:ehealthsuisse.png|180x180px|right]] [[File:Post.png|180x180px|right]] [[File:EPD Logo.png|180x180px]] [[File:EPD_Playground400.png|180x180px]]

Welcome to the EPD Playground

The EPD Playground is a standalone instance of an EPDG conform ([https://www.bag.admin.ch/bag/de/home/gesetze-und-bewilligungen/gesetzgebung/gesetzgebung-mensch-gesundheit/gesetzgebung-elektronisches-patientendossier.html Gesetzgebung Elektronisches Patientendossier]) EPR platform.

It completes the existing available platforms by offering access without any security barrier, for a first discovery of the EPR world and for the realization of demonstrators of use cases with added value.

[[File:EPD_Platforms.png|800px]]

== End points & Transactions ==

The EPD Playground is provided by the [https://i4mi.bfh.ch Institute of Medical Informatics I4MI] at the [https://bfh.ch Bern University of Applied Sciences BFH], [https://e-health-suisse.ch eHealth Suisse] and the [https://www.post.ch/de/geschaeftsloesungen/digital-health/e-health-plattform Swiss Post]. It is running on a virtual machine hosted at BFH and is free to use. The end points and available transactions are documented under [[End points & Transactions]].

The EPD Playground is aimed to experiment the connection of mHealth apps to the national EPR. The primary goal is to create and demonstrate use cases showing the benefit of integrating the EPR. To ease the connection to the EPD Playground, '''all authentication and authorisation hurdles''' – that a productive EPR instance enforces – '''have been disabled''', so the access is straight forward and does not require the use of any access and authorization tokens.

To facilitate implementation, the [[Mobile Access Gateway]] has been developed, allowing the use of FHIR-based mHealth profiles. One instance of the Mobile Access Gateway is connected to the EPD Playground (see further down).

== Demo Data ==

Demo organizations, healthcare providers and patients are listed under [[Demo Data]]. These demo data are intended to be permanent and will be extended in the context of the realization of use cases.

== Mobile Access Gateway ==

The [[Mobile Access Gateway]] provides following FHIR-based profiles:

* [https://profiles.ihe.net/ITI/PIXm/ Patient Identifier Cross-referencing for Mobile (PIXm)]
* [https://profiles.ihe.net/ITI/PDQm/ Patient Demographics Query for Mobile (PDQm)]
* [https://profiles.ihe.net/ITI/MHD/index.html Mobile Access to Health Documents (MHD)]

[[Transaction examples]] are provided to demonstrate how to access the EPD Playground using the [[Mobile Access Gateway]]. For SOAP transaction, see [https://github.com/ehealthsuisse/EPD-by-example/(EPD by example from eHealth Suisse)].

== Swiss Implementation Guides ==

Among all brand new [http://fhir.ch Swiss Implementation Guides], the mHealth profiles PIXm, PDQm and MHD specified in the implementation guide [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ CH EPR mHealth] might be tested against the EPD Playground.

==Links to EPD Themes==

* eHealth Suisse
** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung.html EPD-Anbindung – Anbindung von Primärsystemen]
*** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung/techniker.html Relevante Schnittstellen für die EPD-Integration]
*** [https://github.com/ehealthsuisse/EPD-by-example GitHub – EPD-by-example]
** [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ Implementation Guide CH EPR mHealth (R4)]
*** [https://github.com/ehealthsuisse/ch-epr-mhealth/ GitHub – CH EPR mHealth]
** [https://www.e-health-suisse.ch/fileadmin/user_upload/Dokumente/D/Bericht-Interoperabilitaet_de.pdf Grundlagen für interoperable Prozesse im Gesundheitswesen]

* IHE
** [https://profiles.ihe.net/ITI/MHD/index.html Profile – Mobile access to Health Documents (MHD)]
*** [https://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) Wiki – Mobile access to Health Documents (MHD)]

Demo Data

2022-08-31T08:54:33Z

Heg2 : /* Patients */

== Institutions and Healthcare Providers ==

{| class="wikitable"
!Type
!Name
!Identifier
!Parent
|-
|Organization
|BFH Medizininformatik
|OID: 2.16.756.5.30.1.178
|
|-
|Organization
|Klinik Höheweg
|OID: 2.16.756.5.30.1.178.1.1
|BFH Medizininformatik
|-
|Organization
|Klinik Höheweg - Innere Medizin
|OID: 2.16.756.5.30.1.178.1.1.1
|Klinik Höheweg
|-
|Organization
|Klinik Höheweg - Chirurgie
|OID: 2.16.756.5.30.1.178.1.1.2
|Klinik Höheweg
|-
|Organization
|Praxis am Kreuzweg
|OID: 2.16.756.5.30.1.178.1.2
|BFH Medizininformatik
|-
|Organization
|Kreuzweg Apotheke
|OID: 2.16.756.5.30.1.178.1.3
|BFH Medizininformatik
|-
|Individual
|Dr. med. Marianne Loser
|GLN: 7640166732006
|Klinik Höheweg - Innere Medizin
|-
|Individual
|Dr. med. Florian Meier
|GLN: 7640166732013
|Klinik Höheweg - Chirurgie
|-
|Individual
|Bernhard Kocher
|GLN: 7640166732075
|Kreuzweg Apotheke
|-
|Individual
|Dr. med. Hanspeter Wenger
|GLN: 7640166732204
|Praxis am Kreuzweg
|}

== Patients ==

{| class="wikitable"
!Name
!Firstname
!Date of birth
!AHVN13
!EPR-SPID
!MPI-ID
!Remark
|-
!colspan="3"|OID
!2.16.756.5.32
!2.16.756.5.30.1.127.3.10.3
!1.1.1.99.1
!
|-
|ALPHA
|ALAN
|
|
|DEMO
|0f5a8034-3c8a-4796-bd39-d3ea877a4155
|Gazelle test patient
|-
|Calame
|Daniel
|07.05.1963
|
|EPR-SPID-VNF001
|3cb69165-fbc7-4f80-830d-dcb3a837099d
|I4MI test patient
|-
|Piazza-Baumann
|Eliane
|15.01.1967
|7560520482340
|761337637673823141
|2dc7a783-78b1-4627-94fb-610a23135c42
|Patient from UPI mock
|-
|Dubois
|Cécile
|04.08.1961
|7561894552349
|761337615395845832
|e2d9dbec-9f49-4944-8b6b-790e88d2bd0f
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Favre
|Daniel
|23.10.1962
|7561854932433
|761337615358493254
|1ce9e25d-18f1-49f4-8b0d-d404d7682f02
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Jeanneret
|Alice
|12.09.1938
|7561836220657
|761337615337957326
|c64b6912-e15d-4b6e-8904-6d4aed84e2be
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Laurent
|Patricia
|18.08.1967
|7561845324865
|761337615346721130
|8688b0e8-cbf8-4cc2-971a-84c1959f64d7
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]", AllergyIntolerance Use Case
|-
|Leroy
|Simon
|20.07.1976
|7561867658337
|761337615367859263
|fbd9cee8-734f-4b64-9f3b-e6d0f75548ec
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Winter
|Markus
|14.06.1965
|7561874599326
|761337615374833126
|2e4cb1c6-704a-4e9a-a8e1-024bc48305c8
|Persona of LC1 & LC2 eMedication by BFH students
|}

== Patient identifiers ==

Here is a short extract out of the "Bearbeitungsreglement über die Patientenidentifikationsnummer für das elektronische Patientendossier":

Gestützt auf die rechtlichen Grundlagen zur Einführung des elektronischen Patientendossiers errichtet die ZAS einen mit der AHVN13 verknüpften, spezifischen Identifikator (sektorieller Identifikator). Mit diesem Identifikator, genannt EPR-SPID, soll der Patient oder die Patientin eindeutig identifiziert werden. Das Gesetz und die entsprechenden Verordnungen (EPDG, EPDV, EPDV-EDI mit Anhängen) regeln die Form und die Verwendung dieses Identifikators abschliessend.

{| class="wikitable"
!AHVN13
|AHVN13 («dreizehnstellige AHV-Nummer») ist ein von der ZAS vergebener administrativer Identifikator für natürliche Personen, der Organisationen und Gemeinwesen mit gesetzlicher Grundlage für die systematische Verwendung zur Verfügung steht.
|-
!UPI
|UPI («Unique Person Identification») ist ein von der ZAS geführtes Informatiksystem für die administrative Identifikation der natürlichen Personen und die Verwaltung des Identifikators AHVN13.
|-
!EPR-SPID
|EPR-SPID (Kurzwort für Patientenidentifikationsnummer für das elektronische Patientendossier) ist ein an die AHVN13 gekoppelter sektorieller Personenidentifikator, im Rahmen des elektronischen Patientendossiers für die Identifikation der Patientinnen und Patienten verwendeter Personenidentifikator.
|-
!Gemeinschaft
|Gemeinschaft (Abkürzung: G): Eine Gemeinschaft ist gemäss Artikel 2 Buchstabe d EPDG eine organisatorische Einheit von Gesundheitsfachpersonen und deren Einrichtungen.
|-
!Stammgemeinschaft
|Stammgemeinschaft (Abkürzung: SG): Eine Stammgemeinschaft ist gemäss Artikel 2 Buchstabe e EPDG eine Gemeinschaft, die zusätzliche Aufgaben wahrnimmt (u. a. die Eröffnung und Verwaltung der Patientendossiers).
|-
!MPI-ID
|Die MPI-ID ist die Stammgemeinschaft-interne ID der Patientinnen und Patienten.
|}

=== AHVN13 ===

'''Aufbau der neuen AHV-Nummer (Sozialversicherungsnummer)'''

Quelle: [https://www.sozialversicherungsnummer.ch/aufbau-neu.htm https://www.sozialversicherungsnummer.ch/aufbau-neu.htm]

{| class="wikitable"
!Stelle
|N1
|N2
|N3
|N4
|N5
|N6
|N7
|N8
|N9
|N10
|N11
|N12
|N13
|-
!Bezeichnung
|colspan="3"|Ländercode
|colspan="9"|Personenidentifikation
|Prüfziffer
|-
!Wert
|7
|5
|6
|I1
|I2
|I3
|I4
|I5
|I6
|I7
|I8
|I9
|P
|}

Die neue 13-stellige Sozialversicherungsnummer der Schweiz verschlüsselt drei Informationen:
* Stelle 1-3 enthält den Ländercode (756 für die Schweiz)
* Stelle 4-12 enthält die Personenidentifikationsnummer
* Stelle 13 enthält die Prüfziffer (kann bei [https://www.gs1.ch/home/angebot/barcode/prüfzifferrechner-barcodegenerator GS1] berechnet werden)

'''OID'''

Quelle: [http://fhir.ch/ig/ch-core/NamingSystem-ahvn13-navs13.html http://fhir.ch/ig/ch-core/NamingSystem-ahvn13-navs13.html]

2.16.756.5.32

=== EPR-SPID ===

'''Aufbau der Patientenidentifikationsnummer'''

Quelle: [https://www.fedlex.admin.ch/eli/cc/2017/205/de#annex_1 https://www.fedlex.admin.ch/eli/cc/2017/205/de#annex_1]

{| class="wikitable"
!Stelle
|N1
|N2
|N3
|N4
|N5
|N6
|N7
|N8
|N9
|N10
|N11
|N12
|N13
|N14
|N15
|N16
|N17
|N18
|-
!Bezeichnung
|colspan="2"|Ländercode
|colspan="5"|Teilnehmernummer
|Anwendungsbereichs EPD
|colspan="9"|Identifikationsnummer
|Prüfziffer
|-
!Wert
|7
|6
|1
|3
|3
|7
|6
|1
|I1
|I2
|I3
|I4
|I5
|I6
|I7
|I8
|I9
|P
|}

Die Patientenidentifikationsnummer besteht aus:
* einem zweistelligen Ländercode (76 für die Schweiz)
* einer fünfstelligen Nummer für die Bezeichnung des registrierten Teilnehmers «Bundesamt für Gesundheit» (13376)
* einer einstelligen Nummer für die Bezeichnung des Anwendungsbereichs «Elektronisches Patientendossier» (1)
* einer neunstelligen Nummer für die Identifikation der Patientin oder des Patienten
* einer einstelligen Prüfziffer (kann bei [https://www.gs1.ch/home/angebot/barcode/prüfzifferrechner-barcodegenerator GS1] berechnet werden)

'''OID'''

Quelle: [https://fhir.ch/ig/ch-core/NamingSystem-epr-spid.html https://fhir.ch/ig/ch-core/NamingSystem-epr-spid.html]

2.16.756.5.30.1.127.3.10.3

=== MPI-ID ===

'''OID'''

1.1.1.99.1

=== Links ===

* [https://www.zas.admin.ch/zas/de/home/partenaires-et-institutions-/unique-person-identification--upi-/identifiant-du-dossier-electronique-du-patient.html Zentrale Ausgleichsstelle ZAS – Der Identifikator für das elektronische Patientendossier]
* [https://www.e-health-suisse.ch/de/technik-semantik/epd-projectathon/programmierhilfen-epd.html eHealth Suisse – Programmierhilfen EPD]

Demo Data

2022-08-31T08:54:09Z

Heg2 : /* Patients */

== Institutions and Healthcare Providers ==

{| class="wikitable"
!Type
!Name
!Identifier
!Parent
|-
|Organization
|BFH Medizininformatik
|OID: 2.16.756.5.30.1.178
|
|-
|Organization
|Klinik Höheweg
|OID: 2.16.756.5.30.1.178.1.1
|BFH Medizininformatik
|-
|Organization
|Klinik Höheweg - Innere Medizin
|OID: 2.16.756.5.30.1.178.1.1.1
|Klinik Höheweg
|-
|Organization
|Klinik Höheweg - Chirurgie
|OID: 2.16.756.5.30.1.178.1.1.2
|Klinik Höheweg
|-
|Organization
|Praxis am Kreuzweg
|OID: 2.16.756.5.30.1.178.1.2
|BFH Medizininformatik
|-
|Organization
|Kreuzweg Apotheke
|OID: 2.16.756.5.30.1.178.1.3
|BFH Medizininformatik
|-
|Individual
|Dr. med. Marianne Loser
|GLN: 7640166732006
|Klinik Höheweg - Innere Medizin
|-
|Individual
|Dr. med. Florian Meier
|GLN: 7640166732013
|Klinik Höheweg - Chirurgie
|-
|Individual
|Bernhard Kocher
|GLN: 7640166732075
|Kreuzweg Apotheke
|-
|Individual
|Dr. med. Hanspeter Wenger
|GLN: 7640166732204
|Praxis am Kreuzweg
|}

== Patients ==

{| class="wikitable"
!Name
!Firstname
!Date of birth
!AHVN13
!EPR-SPID
!MPI-ID
!Remark
|-
!colspan="3"|OID
!2.16.756.5.32
!2.16.756.5.30.1.127.3.10.3
!1.1.1.99.1
!
|-
|ALPHA
|ALAN
|
|
|DEMO
|0f5a8034-3c8a-4796-bd39-d3ea877a4155
|Gazelle test patient
|-
|Calame
|Daniel
|07.05.1963
|
|EPR-SPID-VNF001
|3cb69165-fbc7-4f80-830d-dcb3a837099d
|I4MI test patient
|-
|Piazza-Baumann
|Eliane
|15.01.1967
|7560520482340
|761337637673823141
|2dc7a783-78b1-4627-94fb-610a23135c42
|Patient from UPI mock
|-
|Dubois
|Cécile
|04.08.1961
|7561894552349
|761337615395845832
|e2d9dbec-9f49-4944-8b6b-790e88d2bd0f
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Favre
|Daniel
|23.10.1962
|7561854932433
|761337615358493254
|1ce9e25d-18f1-49f4-8b0d-d404d7682f02
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Jeanneret
|Alice
|12.09.1938
|7561836220657
|761337615337957326
|c64b6912-e15d-4b6e-8904-6d4aed84e2be
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Laurent
|Patricia
|18.08.1967
|7561845324865
|761337615346721130
|8688b0e8-cbf8-4cc2-971a-84c1959f64d7
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”], AllergyIntolerance Use Case"
|-
|Leroy
|Simon
|20.07.1976
|7561867658337
|761337615367859263
|fbd9cee8-734f-4b64-9f3b-e6d0f75548ec
|Persona of project "[https://aider-les-proches-aidants.ch/documents/ Aider les proches aidants”]"
|-
|Winter
|Markus
|14.06.1965
|7561874599326
|761337615374833126
|2e4cb1c6-704a-4e9a-a8e1-024bc48305c8
|Persona of LC1 & LC2 eMedication by BFH students
|}

== Patient identifiers ==

Here is a short extract out of the "Bearbeitungsreglement über die Patientenidentifikationsnummer für das elektronische Patientendossier":

Gestützt auf die rechtlichen Grundlagen zur Einführung des elektronischen Patientendossiers errichtet die ZAS einen mit der AHVN13 verknüpften, spezifischen Identifikator (sektorieller Identifikator). Mit diesem Identifikator, genannt EPR-SPID, soll der Patient oder die Patientin eindeutig identifiziert werden. Das Gesetz und die entsprechenden Verordnungen (EPDG, EPDV, EPDV-EDI mit Anhängen) regeln die Form und die Verwendung dieses Identifikators abschliessend.

{| class="wikitable"
!AHVN13
|AHVN13 («dreizehnstellige AHV-Nummer») ist ein von der ZAS vergebener administrativer Identifikator für natürliche Personen, der Organisationen und Gemeinwesen mit gesetzlicher Grundlage für die systematische Verwendung zur Verfügung steht.
|-
!UPI
|UPI («Unique Person Identification») ist ein von der ZAS geführtes Informatiksystem für die administrative Identifikation der natürlichen Personen und die Verwaltung des Identifikators AHVN13.
|-
!EPR-SPID
|EPR-SPID (Kurzwort für Patientenidentifikationsnummer für das elektronische Patientendossier) ist ein an die AHVN13 gekoppelter sektorieller Personenidentifikator, im Rahmen des elektronischen Patientendossiers für die Identifikation der Patientinnen und Patienten verwendeter Personenidentifikator.
|-
!Gemeinschaft
|Gemeinschaft (Abkürzung: G): Eine Gemeinschaft ist gemäss Artikel 2 Buchstabe d EPDG eine organisatorische Einheit von Gesundheitsfachpersonen und deren Einrichtungen.
|-
!Stammgemeinschaft
|Stammgemeinschaft (Abkürzung: SG): Eine Stammgemeinschaft ist gemäss Artikel 2 Buchstabe e EPDG eine Gemeinschaft, die zusätzliche Aufgaben wahrnimmt (u. a. die Eröffnung und Verwaltung der Patientendossiers).
|-
!MPI-ID
|Die MPI-ID ist die Stammgemeinschaft-interne ID der Patientinnen und Patienten.
|}

=== AHVN13 ===

'''Aufbau der neuen AHV-Nummer (Sozialversicherungsnummer)'''

Quelle: [https://www.sozialversicherungsnummer.ch/aufbau-neu.htm https://www.sozialversicherungsnummer.ch/aufbau-neu.htm]

{| class="wikitable"
!Stelle
|N1
|N2
|N3
|N4
|N5
|N6
|N7
|N8
|N9
|N10
|N11
|N12
|N13
|-
!Bezeichnung
|colspan="3"|Ländercode
|colspan="9"|Personenidentifikation
|Prüfziffer
|-
!Wert
|7
|5
|6
|I1
|I2
|I3
|I4
|I5
|I6
|I7
|I8
|I9
|P
|}

Die neue 13-stellige Sozialversicherungsnummer der Schweiz verschlüsselt drei Informationen:
* Stelle 1-3 enthält den Ländercode (756 für die Schweiz)
* Stelle 4-12 enthält die Personenidentifikationsnummer
* Stelle 13 enthält die Prüfziffer (kann bei [https://www.gs1.ch/home/angebot/barcode/prüfzifferrechner-barcodegenerator GS1] berechnet werden)

'''OID'''

Quelle: [http://fhir.ch/ig/ch-core/NamingSystem-ahvn13-navs13.html http://fhir.ch/ig/ch-core/NamingSystem-ahvn13-navs13.html]

2.16.756.5.32

=== EPR-SPID ===

'''Aufbau der Patientenidentifikationsnummer'''

Quelle: [https://www.fedlex.admin.ch/eli/cc/2017/205/de#annex_1 https://www.fedlex.admin.ch/eli/cc/2017/205/de#annex_1]

{| class="wikitable"
!Stelle
|N1
|N2
|N3
|N4
|N5
|N6
|N7
|N8
|N9
|N10
|N11
|N12
|N13
|N14
|N15
|N16
|N17
|N18
|-
!Bezeichnung
|colspan="2"|Ländercode
|colspan="5"|Teilnehmernummer
|Anwendungsbereichs EPD
|colspan="9"|Identifikationsnummer
|Prüfziffer
|-
!Wert
|7
|6
|1
|3
|3
|7
|6
|1
|I1
|I2
|I3
|I4
|I5
|I6
|I7
|I8
|I9
|P
|}

Die Patientenidentifikationsnummer besteht aus:
* einem zweistelligen Ländercode (76 für die Schweiz)
* einer fünfstelligen Nummer für die Bezeichnung des registrierten Teilnehmers «Bundesamt für Gesundheit» (13376)
* einer einstelligen Nummer für die Bezeichnung des Anwendungsbereichs «Elektronisches Patientendossier» (1)
* einer neunstelligen Nummer für die Identifikation der Patientin oder des Patienten
* einer einstelligen Prüfziffer (kann bei [https://www.gs1.ch/home/angebot/barcode/prüfzifferrechner-barcodegenerator GS1] berechnet werden)

'''OID'''

Quelle: [https://fhir.ch/ig/ch-core/NamingSystem-epr-spid.html https://fhir.ch/ig/ch-core/NamingSystem-epr-spid.html]

2.16.756.5.30.1.127.3.10.3

=== MPI-ID ===

'''OID'''

1.1.1.99.1

=== Links ===

* [https://www.zas.admin.ch/zas/de/home/partenaires-et-institutions-/unique-person-identification--upi-/identifiant-du-dossier-electronique-du-patient.html Zentrale Ausgleichsstelle ZAS – Der Identifikator für das elektronische Patientendossier]
* [https://www.e-health-suisse.ch/de/technik-semantik/epd-projectathon/programmierhilfen-epd.html eHealth Suisse – Programmierhilfen EPD]

Main Page

2022-04-15T09:15:53Z

Heg2 : /* End points & Transactions */

[[File:BFH_Logo_C_de_fr_en_100_4CU_L2000px.png|180x180px|right]] [[File:ehealthsuisse.png|180x180px|right]] [[File:Post.png|180x180px|right]] [[File:EPD Logo.png|180x180px]] [[File:EPD_Playground400.png|180x180px]]

Welcome to the EPD Playground

The EPD Playground is a standalone instance of an EPDG ([https://www.bag.admin.ch/bag/de/home/gesetze-und-bewilligungen/gesetzgebung/gesetzgebung-mensch-gesundheit/gesetzgebung-elektronisches-patientendossier.html Gesetzgebung Elektronisches Patientendossier]) conform platform.

== End points & Transactions ==

The EPD Playground is provided by the [https://i4mi.bfh.ch Institute of Medical Informatics I4MI] at the [https://bfh.ch Bern University of Applied Sciences BFH], [https://e-health-suisse.ch eHealth Suisse] and the [https://www.post.ch/de/geschaeftsloesungen/digital-health/e-health-plattform Swiss Post]. It is running on a virtual machine hosted at BFH and is free to use. The end points and available transactions are documented under [[End points & Transactions]].

The EPD Playground is aimed to experiment the connection of mHealth apps to the EPD. The primary goal is to create and demonstrate use cases showing the benefit of integrating the EPD. To ease the connection to the EPD Playground, '''all authentication and authorisation hurdles''' – that an productive EPD instance enforces – '''have been disable''', so the access is straight forward and does not require the use of any access tokens.

To make the connection easier, the [[Mobile Access Gateway]] has been developed, one instance being connected to the EPD Playground (see further down).

== Demo Data ==

Demo organizations, healthcare providers and patients are listed under [[Demo Data]]. These demo data are intended to be permanent and will be extended in the context of the realization of use cases.

== Mobile Access Gateway ==

The [[Mobile Access Gateway]] provides the FHIR based profiles PIXm, PDQm and MHD required for the profile "[https://profiles.ihe.net/ITI/MHD/index.html Mobile access to Health Documents (MHD)]".

For using the [[Mobile Access Gateway]] to access the EPD Playground, we provide some [[Transaction examples]].

== Swiss Implementation Guides ==

Among all brand new [http://fhir.ch Swiss Implementation Guides], the mHealth profiles PIXm, PDQm and MHD specified in the implementation guide [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ CH EPR mHealth] might be tested against the EPD Playground.

==Links to EPD Themes==

* eHealth Suisse
** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung.html EPD-Anbindung – Anbindung von Primärsystemen]
*** [https://www.e-health-suisse.ch/technik-semantik/epd-anbindung/techniker.html Relevante Schnittstellen für die EPD-Integration]
*** [https://github.com/ehealthsuisse/EPD-by-example GitHub – EPD-by-example]
** [http://build.fhir.org/ig/ehealthsuisse/ch-epr-mhealth/ Implementation Guide CH EPR mHealth (R4)]
*** [https://github.com/ehealthsuisse/ch-epr-mhealth/ GitHub – CH EPR mHealth]
** [https://www.e-health-suisse.ch/fileadmin/user_upload/Dokumente/D/Bericht-Interoperabilitaet_de.pdf Grundlagen für interoperable Prozesse im Gesundheitswesen]

* IHE
** [https://profiles.ihe.net/ITI/MHD/index.html Profile – Mobile access to Health Documents (MHD)]
*** [https://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) Wiki – Mobile access to Health Documents (MHD)]

Transaction examples

2022-04-13T09:43:36Z

Heg2 : /* Update a document */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "List",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2022-04-13T06:43:44Z

Heg2 :

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource. The EPD Playground then sets the status of the replaced DocumentResource to ''superseded'', so it won't show up in searches for current documents anymore.

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2022-04-13T06:40:09Z

Heg2 : Add "update Document"

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 encoded file content>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Update a document ===
You can not directly update a document. You will to replace it, by uploading a new document with a reference to the other document it replaces. The reference points to the Resource ID of the document to replace (keep in mind here, this is not the temporary ID you assigned to it in the ITI-65 Provide Document Bundle, but the ID assigned by the server.
So the Document Bundle is the same as in Upload a Document, with the difference of the additional relatesTo reference in the DocumentReference resource:
<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
...
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
...
''' "relatesTo": [
''' {
''' "code": "replaces",
''' "target": {
''' "reference": "5d7b180a-1407-48e6-99c2-141a9fa303b7"''' // this is the resource ID of the document reference to replace
''' }
''' }
''' ]
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2021-12-02T15:41:50Z

Heg2 : /* Search patient by gender */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 kodierter Dokumenteninhalt>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2021-11-12T07:33:39Z

Heg2 : /* Upload a document */

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===

Notice: the newest PIXm specifications don't allow anymore to query all patient id's at once. A "target system" has to be given in the query.

==== Search MPI Identifier using the EPR-SPID (PIXm) ====

* OID of the EPD Playground's MPI: 1.1.1.99.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:1.1.1.99.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID (PIXm) ====

* OID of the Klinik Höheweg: 2.16.756.5.30.1.178.1.1
* OID of the EPR-SPID: 2.16.756.5.30.1.127.3.10.3

<code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1 https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1]</code>

Which should get you the following response body:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier (PDQm) ====

When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>

This returns a FHIR Bundle:

{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

==== Search patient by gender ====

<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient?gender=male</code>

=== Upload a document ===

{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 kodierter Dokumenteninhalt>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2021-09-22T15:00:41Z

Heg2 :

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===
==== Search MPI Identifier using the EPR-SPID ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO</code>

Which should get you the following response body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1</code>

Which should get you the following response body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier ====
When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>
This returns a FHIR Bundle:
{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

==== Search patient by gender ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient?gender=male</code>

=== Upload a document ===
{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 kodiertes Dokumenteninhalt>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).

<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.

<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2021-09-22T15:00:12Z

Heg2 :

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===
==== Search MPI Identifier using the EPR-SPID ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO</code>

Which should get you the following response body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1</code>

Which should get you the following response body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier ====
When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>
This returns a FHIR Bundle:
{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

==== Search patient by gender ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient?gender=male</code>

=== Upload a document ===
{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 kodiertes Dokumenteninhalt>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).
<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.
<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:

<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2021-09-22T14:59:59Z

Heg2 :

This page lists examples of transactions using the [[Mobile Access Gateway]] to access the EPD Playground.

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

=== Search patient ===
==== Search MPI Identifier using the EPR-SPID ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO</code>

Which should get you the following response body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
}
]
}

==== Search local id using the EPR-SPID ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:2.16.756.5.30.1.127.3.10.3|DEMO&targetSystem=urn:oid:2.16.756.5.30.1.178.1.1</code>

Which should get you the following response body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "targetIdentifier",
"valueIdentifier": {
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1"
}
}
]
}

==== Search patient by any identifier ====
When known, a patient can be searched by any identifier, like the EPR-SPID, the communitys MPI or a local id (e.g. from a primary system):
* EPR-SPID: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3|DEMO]</code>
* MPI: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155]</code>
* local id: <code>GET [https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1 https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.178.1.1|PATIENT1]</code>
This returns a FHIR Bundle:
{
"resourceType": "Bundle",
"id": "47b0e100-5475-45e3-9dd2-0ae422bdbed9",
"meta": {
"lastUpdated": "2021-03-25T10:28:44.250+00:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://test.ahdis.ch/mag-bfh/fhir/Patient?identifier=2.16.756.5.30.1.127.3.10.3%7CDEMO"
}
],
"entry": [
{
"fullUrl": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"resource": {
"resourceType": "Patient",
"id": "1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155",
"identifier": [
{
"system": "urn:oid:1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
],
"active": true,
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
]
}
}
]
}

==== Search patient by gender ====
<code>GET https://test.ahdis.ch/mag-bfh/fhir/Patient?gender=male</code>

=== Upload a document ===
{| class="wikitable"
|Profile
|Mobile Access to Health Documents
|(MHD)
|-
|Transaction
|Provide Document Bundle
|[ITI-65]
|-
|SOAP Transaction
|Provide and Register Document Set
|[ITI-41]
|}
The following example creates a document for the patient ALAN ALPHA:

<code>POST https://test.ahdis.ch/mag-bfh/fhir</code>
{
"id": "2-7-BundleProvideDocument",
"resourceType": "Bundle",
"meta": {
"profile": [
"http://ihe.net/fhir/StructureDefinition/IHE_MHD_Provide_Minimal_DocumentBundle"
]
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"resource": {
"resourceType": "Binary",
"contentType": "text/xml",
"data": "<Base64 kodiertes Dokumenteninhalt>"
},
"request": {
"method": "POST",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b"
}
},
{
"fullUrl": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc",
"resource": {
"resourceType": "DocumentManifest",
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.6.2955"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:8c3e40b2-3cf9-4980-b4fb-cc84ba8a181a"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "71388002",
"display": "Procedure (procedure)"
}
]
},
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"content": [
{
"reference": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"created": "2020-06-29T12:01:30+00:00",
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"description": "Hello World example neu"
},
"request": {
"method": "POST",
"url": "urn:uuid:68a928c0-df48-4743-a291-bfb0609bbddc"
}
},
{
"fullUrl": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f",
"resource": {
"resourceType": "DocumentReference",
"contained": [
{
"resourceType": "Patient",
"id": "1",
"identifier": [
{
"use": "official",
"system": "1.1.1.99.1",
"value": "0f5a8034-3c8a-4796-bd39-d3ea877a4155"
}
]
}
],
"masterIdentifier": {
"value": "urn:oid:1.3.6.1.4.1.12559.11.13.2.1.2956"
},
"identifier": [
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:50383ae5-49e5-4dea-b0e6-660cb9e7b91f"
}
],
"status": "current",
"type": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "721912009",
"display": "Medication summary document (record artifact)"
}
]
},
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "422735006",
"display": "Summary clinical document (record artifact)"
}
]
}
],
"subject": {
"reference": "https://test.ahdis.ch/mag-bfh/fhir/Patient/1.1.1.99.1-0f5a8034-3c8a-4796-bd39-d3ea877a4155"
},
"source": "urn:oid:1.3.6.1.4.1.12559.11.13.2.5",
"date": "2020-06-29T11:58:00.000+00:00",
"description": "2-7-MedicationCard",
"securityLabel": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "17621005",
"display": "Normal (qualifier value)"
}
]
}
],
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "urn:uuid:d8d1fe44-07e9-4a84-985f-fde97d77d54b",
"size": 309219
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
"context": {
"facilityType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "264358009",
"display": "General practice premises (environment)"
}
]
},
"practiceSetting": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394802001",
"display": "General medicine (qualifier value)"
}
]
},
"sourcePatientInfo": {
"reference": "#1"
}
}
},
"request": {
"method": "POST",
"url": "urn:uuid:5604f114-bf96-4c12-8dac-25715a05cf3f"
}
}
]
}

=== Search and retrieve a document ===
==== Search for DocumentReferences ====
A FHIR search for DocumentReferences returns a Bundle of DocumentReference resources. Each DocumentReference represents one available document and contains the link for retrieving the document (see below).
<code>GET https://test.ahdis.ch/mag-bfh/fhir/DocumentReference?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Search for SubmissionSets ====
A FHIR search for List returns a Bundle of List resources. Each List resource represents a submission set, which are documents for a patient that were uploaded together. The List resources refer to the DocumentReference resources, that then contain the link to the actual document.
<code>GET https://test.ahdis.ch/mag-bfh/fhir/List?status=current&patient.identifier=urn:oid:1.1.1.99.1|0f5a8034-3c8a-4796-bd39-d3ea877a4155</code>

==== Retrieve a document ====
In the DocumentReference resource, under <code>content[0].attachment.url</code>, you find the link to the actual document.
{
"resourceType": "DocumentReference",
...
"content": [
{
"attachment": {
"contentType": "text/xml",
"language": "de-CH",
"url": "http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31",
"size": 80461,
"hash": "ZGU4YzRmNDM4ZjAzNmRmNDM0MDUyZWRjYjIzMTNjNDUzOTMyNzg1MQ==",
"creation": "2020-06-29T11:58:00+00:00"
},
"format": {
"system": "urn:oid:1.3.6.1.4.1.19376.1.2.3",
"code": "urn:ihe:pharm:pml:2013",
"display": "Community Medication List"
}
}
],
...
}

Using this link, you can fetch the document with a GET request:
<code>GET http://test.ahdis.ch/mag-bfh/camel/xdsretrieve?uniqueId=92100cf9-e6e8-4bf8-a61c-2ee66e69eb2c&repositoryUniqueId=1.1.1.2.31</code>

Transaction examples

2021-09-22T14:51:19Z

Heg2 :

Transaction examples

2021-09-22T14:45:54Z

Heg2 :

Main Page

2021-09-22T14:43:09Z

Heg2 :

Main Page

2021-09-22T14:42:50Z

Heg2 :

Main Page

2021-09-22T14:42:41Z

Heg2 :

End points & Transactions

2021-09-22T14:41:58Z

Heg2 :

===ATNA Audit Record Repository (ARR) FHIR===

[https://epdplayground.i4mi.bfh.ch:7443/ARR/fhir https://epdplayground.i4mi.bfh.ch:7443/ARR/fhir]

*ATC-81 Retrieve ATNA Audit Record

===ATNA Audit Record Repository (ARR) Syslog===
UDP on port 5230

TCP on port 5232

[https://epdplayground.i4mi.bfh.ch:5232 https://epdplayground.i4mi.bfh.ch:5232]

*ITI-20 Record Audit Event

===HPD===

[https://epdplayground.i4mi.bfh.ch:7443/HPD/services/HPDService https://epdplayground.i4mi.bfh.ch:7443/HPD/services/HPDService]

*ITI-58 Provider Information Query
*ITI-59 Provider Information Feed

===UPI Proxy===

[https://epdplayground.i4mi.bfh.ch:7443/UPIProxy/services/PIXPDQV3ManagerService https://epdplayground.i4mi.bfh.ch:7443/UPIProxy/services/PIXPDQV3ManagerService]

*ITI-47 Patient Demographics Query HL7V3
*ITI-44 Patient Identity Feed HL7V3
*ITI-45 PIXV3 Query

===PIX/PDQ Manager===

[https://epdplayground.i4mi.bfh.ch:7443/PIXPDQ/services/PIXPDQV3ManagerService https://epdplayground.i4mi.bfh.ch:7443/PIXPDQ/services/PIXPDQV3ManagerService]

*ITI-47 Patient Demographics Query HL7V3
*ITI-44 Patient Identity Feed HL7V3
*ITI-45 PIXV3 Query

===Repository===

[https://epdplayground.i4mi.bfh.ch:6443/Repository/services/RepositoryService https://epdplayground.i4mi.bfh.ch:6443/Repository/services/RepositoryService]

*ITI-41 Provide and Register Document Set
*ITI-43 Retrieve Document Set

===Registry===

[https://epdplayground.i4mi.bfh.ch:7443/Registry/services/RegistryService https://epdplayground.i4mi.bfh.ch:7443/Registry/services/RegistryService]

*ITI-18 RegistryStoredQuery

===Valueset Repository (Sharing Value Sets SVS)===

[https://epdplayground.i4mi.bfh.ch:7443/ValueSetRepository/services/ValueSetRepositoryService https://epdplayground.i4mi.bfh.ch:7443/ValueSetRepository/services/ValueSetRepositoryService]

*ITI-48 Retrieve Value Set
*ITI-60 Retrieve Multiple Value Sets

=== Transaction examples (using Mobile Access Gateway) ===
For using the [[Mobile Access Gateway]] to access the EPD Playground, we provide some [[Transaction examples]].

Transaction examples

2021-09-22T14:40:32Z

Heg2 :

Transaction examples

2021-09-22T14:39:06Z

Heg2 :

Transaction examples

2021-09-22T14:38:04Z

Heg2 :

Transaction examples

2021-09-22T14:34:32Z

Heg2 :

Transaction examples

2021-09-22T14:33:11Z

Heg2 :

Transaction examples

2021-09-22T14:30:12Z

Heg2 :

Transaction examples

2021-09-22T14:27:21Z

Heg2 :

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

Transaction examples

2021-09-22T14:27:01Z

Heg2 :

=== Create Patient ===
{| class="wikitable"
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}
Folgender Beispiel legt den Patient ALAN ALPHA an, der übrigens auch in der Gazelle Referenzumgebung vorhanden ist:
The following example creates a patient ALAN ALPHA (which, by the way, also exists in the gazelle reference environment):

POST https://test.ahdis.ch/mag-bfh/fhir/$process-message

{
"resourceType": "Bundle",
"type": "message",
"entry": [
{
"fullUrl": "http://example.com/fhir/MessageHeader/1",
"resource": {
"resourceType": "MessageHeader",
"id": "1",
"eventUri": "urn:ihe:iti:pmir:2019:patient-feed",
"source": {
"endpoint": "http://example.com/patientSource"
},
"focus": [
{
"reference": "Patient/123"
}
],
"destination": [
{
"endpoint": "http://example.com/patientEndpoint"
}
]
}
},
{
"fullUrl": "http://example.com/fhir/Patient/123",
"resource": {
"resourceType": "Patient",
"id": "123",
"contained": [
{
"resourceType": "Organization",
"id": "1",
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "Klinik H\u00f6heweg"
}
],
"name": "Klinik H\u00f6heweg",
"contact": [
{
"name": {
"family": "Test",
"given": [
"Hugo"
]
}
}
]
}
],
"identifier": [
{
"system": "urn:oid:2.16.756.5.30.1.178.1.1",
"value": "PATIENT1",
"assigner": {
"display": "Klinik H\u00f6heweg"
}
},
{
"system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
"value": "DEMO"
}
],
"name": [
{
"family": "ALPHA",
"given": [
"ALAN"
]
}
],
"gender": "male",
"birthDate": "1938-02-24",
"address": [
{
"line": "1_PINETREE",
"city": "WEBSTER",
"state": "MD",
"postalCode": "63119"
}
],
"managingOrganization": {
"reference": "#1"
}
},
"request": {
"method": "POST"
}
}
]
}

* The id in the Patient resource (e.g. "123") does not matter, but has to match the id linked in the Messageheader (<kbd>focus.reference: "Patient/123"</kbd>).
* The creating organization must be present as a contained resource Organization and linked from the Patient resource under <kbd>managingOrganization</kbd> ("#1").
* In the point identifier the local patient-id in the creating organization (e.g. the "Klinik Höheweg" with OID 2.16.756.5.30.1.178.1.1) as well as the EPR-SPID (with the official OID 2.16.756.5.30.1.127.3.10.3) are listed.

Transaction examples

2021-09-22T14:12:33Z

Heg2 :

=== Create Patient ===
{|
|**Profile**
|Patient Master Identity Registry
|(PMIR)
|-
|**Transaction**
|Mobile Patient Identity Feed
|[ITI-93]
|-
|**SOAP Transaction**
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

Transaction examples

2021-09-22T14:12:23Z

Heg2 :

=== Create Patient ===
{|
|*Profile*
|Patient Master Identity Registry
|(PMIR)
|-
|*Transaction*
|Mobile Patient Identity Feed
|[ITI-93]
|-
|*SOAP Transaction*
|Patient Identity Feed HL7 V3
|[ITI-44]
|}

Transaction examples

2021-09-22T14:12:08Z

Heg2 : Created page with "=== Create Patient === {| |Profile |Patient Master Identity Registry |(PMIR) |- |Transaction |Mobile Patient Identity Feed |[ITI-93] |- |SOAP Transaction |Patient Identity Fee..."

=== Create Patient ===
{|
|Profile
|Patient Master Identity Registry
|(PMIR)
|-
|Transaction
|Mobile Patient Identity Feed
|[ITI-93]
|-
|SOAP Transaction
|Patient Identity Feed HL7 V3
|[ITI-44]
|}