Brontekst bekijken van vpk:V3.1 FHIR eOverdracht Proeftuin phase 2

{{DISPLAYTITLE:eOverdracht Proeftuin phase 2 FHIR Implementation Guide}}
{{IssueBox|Work in progress - See [[vpk:V3.1_FHIR_eOverdracht_Proeftuin|official publication]] here.}}
=Introduction=

This page will detail the HL7 requirments for exhcanging the data in the eOverdracht Proeftuin phase 2 as described in [[vpk:V3.1 eOverdracht Proeftuin|the functional design]].Imnplementation of the eOverdracht Proeftuin is spread over 3 different phases. Phase 1 and 3 can be found by navigated the following links in the table listed below.

{| class="wikitable"
! colspan="2" | Phase 1 and Phase 3 of the eOverdracht Proeftuin
|-
| style="text-align: center;" | Phase 1
| style="text-align: center;" | Phase 3
|-
| [[vpk:V3.1_FHIR_eOverdracht_Proeftuin|Proeftuin Phase 1 page]]
| [[vpk:V3.1_FHIR_eOverdracht|eOverdracht FHIR implementation guide]]
|-
|}
* For the implementation of Phase 3, which is the complete message we recommend visitting [[vpk:Draft_FHIR_eOverdracht|eOverdracht FHIR implementation guide]]
Phase two consists of the complete Aanmeldbericht as well as an incomplete Overdrachtsbericht. The Overdrachtsbericht is a subset of 11 HCIM's (complete set used in Aanmeldbericht) and an unstructured PDF containing the remaining data which are not part of the HCIM's.

This implementation guide assumes that the reader is familiar with [https://www.hl7.org/fhir/stu3/ FHIR(STU3)].

==Overarching FHIR principles==
* This implementation guide does not provide information on finding the right XIS, nor does it provide information about security. It is assumed that the sending XIS is able to make a connection with the receiving XIS.
* All FHIR resources used within eOverdracht SHALL conform to the profiles listed in this implementation guide and SHALL include the profile canonical URL in their <code>meta.profile</code> element.

==Package and dependencies==
eOverdracht uses the FHIR Packaging mechanism to conveniently bundle all examples, profiles and other conformance resources you need into a single download. The eOverdracht package has a dependency on the [https://simplifier.net/NictizSTU3-Zib2017/~packages Nictiz Zib2017 package {{VersieInfo|package|release=V2019.01}}].
==Example instances==
Example instances of the FHIR messages can be found on [https://simplifier.net/nictiz-stu3-eoverdracht Simplifier]:
* [https://simplifier.net/nictiz-stu3-eoverdracht/~resources?category=Example&exampletype=Composition Composition examples]
* [https://simplifier.net/nictiz-stu3-eoverdracht/~resources?category=Example&exampletype=Bundle Bundle examples]

=Use case 1A: Send Overdrachtsbericht volwassenen (PUSH)=
==Introduction==
The Send Overdrachtsbericht scenario is used by the sending XIS to send the relevant data for the patient care to the receiving XIS. The structure of the eventual scenario is described in the functional design and additionally in [[vpk:V3.1_Opbouw_eOverdracht_volwassenen|Opbouw Overdrachtsbericht Volwassenen]]. For the pilot a limited subset is implemented.
==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;" rowspan="2"|Send Overdrachtbericht (PUSH)
|style="background-color: white;" rowspan="2"|Send Overdrachtsbericht
|style="background-color: white;"|Healthcare professional at organization A (using a XIS)
|style="background-color: white;"|Sends Overdrachtsbericht
|-
|style="background-color: white;"|Healthcare professional at organization B (using a XIS)
|style="background-color: white;"|Receives Overdrachtsbericht
|}
==Invocation==
The Send Overdrachtsbericht transaction is an HTTP POST method on the target XIS's base, where the body of the POST request is a FHIR document according to [[#Structure of the Overdrachtsbericht (4 HCIMs + PDF)]]. See [[#Sending documents]] for more information.
===Trigger events===
This transaction is invoked when the sending XIS needs to send the Overdrachtsbericht to the receiving XIS.
===Expected response===
The document Bundle should be processed as a [http://hl7.org/fhir/STU3/http.html#transaction transaction] by the receiving XIS. See [[#Processing documents]] for more information.
==Structure of the Overdrachtsbericht (11 HCIMs + PDF)==
The Overdrachtsbericht consists of multiple FHIR resources, which are assembled into a FHIR document. See [[#Creating documents]] for information on how to assemble this document.

During phase 2, the Overdrachtsbericht is based on 11 HCIMs which expand on the HCIMs from the Aanmeldbericht. The table below lists the FHIR profiles<ref name="nopackage">Please note that the direct links to the various conformance resources below will take you to the latest version, which might not match the package version. At time of writing, there is no way to render the conformance resource as found in the package. This is on the roadmap for Simplifier.</ref> that are applicable for the pilot implementation of the Overdrachtsbericht transaction.

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:400px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:400px" | FHIR profile
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | FHIR resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | HCIM name
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | HCIM version
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | Remarks
|-
| 
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eOverdracht-overdrachtsbericht-volwassenen-phase-two|eOverdracht Overdrachtsbericht volwassenen phase two}}
| Composition
| -
| -
| Declaration of the Send Overdrachtsbericht volwassenen phase two transaction.
|-
|-
| Datum overplaatsing
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eOverdracht-TransferDate|eOverdracht-TransferDate}}
| -
| -
| -
| DateTime extension used in eOverdracht composition profiles
|-
| rowspan="3"|Persoonsgegevens
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient|nl-core-patient}}
| Patient
| Patient
| v3.1(2017NL)
| -
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Payer|zib-Payer}}
| Coverage
| Betaler
| v3.1(2017NL)
| -
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-relatedperson|nl-core-relatedperson}}
| RelatedPerson
| Contactpersoon
| v3.1(2017NL)
| -
|-
| rowspan="3"|Sturende organisatie
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nl-core-organization}}
| Organization
| Zorgaanbieder
| v3.1.1(2017NL)
| -
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner|nl-core-practitioner}}
| Practitioner
| rowspan="2" |Zorgverlener
| rowspan="2" |v3.2(2017NL)
| rowspan="2" | - 
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole|nl-core-practitionerrole}}
| PractitionerRole
|-
| rowspan="3"|Ontvangende organisatie
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nl-core-organization}}
| Organization
| Zorgaanbieder
| v3.1.1(2017NL)
| -
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner|nl-core-practitioner}}
| Practitioner
| rowspan="2" |Zorgverlener
| rowspan="2" |v3.2(2017NL)
| rowspan="2" | - 
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole|nl-core-practitionerrole}}
| PractitionerRole
|-
| Medische diagnose
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Problem|zib-Problem}}
| Condition
| Probleem
| v4.1(2017NL
| -
|-
|-
| Voorgeschiedenis
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Problem|zib-Problem}}
| Condition
| Probleem
| v4.1(2017NL
| -
|-
| Let op
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Alert|zib-Alert}}
| Flag
| Alert
| v3.2(2017NL)
| -
|-
| Vrijheidsbeperking
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-FreedomRestrictingMeasures|zib-FreedomRestrictingMeasures}}
| Procedure
| VrijheidsBeperkendeMaatregelen
| v3.1(2017NL)
| -
|-
| Actuele patiëntenproblemen
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Problem|zib-Problem}}
| Condition
| Probleem
| v4.1(2017NL)
| -
|-
| Afspraken patiënt
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest|zib-ProcedureRequest}}
| ProcedureRequest
| OverdrachtGeplandeZorgActiviteit
| v3.1(2017NL)
| -
|-
| Wensen en behoeften patiënt en/of naasten
| -
| -
| -
| -
| Declared as a text section. See {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eOverdracht-overdrachtsbericht-volwassenen-phase-two|Overdrachtsbericht Volwassenen phase two composition profile}}.
|-
| rowspan="2"| Voeding/vocht
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-FeedingTubeSystem|zib-FeedingTubeSystem}}
| DeviceUseStatement
| SondeSysteem
| v3.2(2017NL)
| -
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Infusion|zib-Infusion}}
| DeviceUseStatement
| Infuus
| v3.2(2017NL)
| -
|- 
| Uitscheiding
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Stoma|zib-Stoma}}
| Observation
| Stoma
| v3.2(2017NL)
| -
|-
| PDF
| [https://www.hl7.org/fhir/binary.html Binary]
| Binary
| -
| -
| Should be used to send unstructured PDF data.
|}

=Use case 3A: Send Aanmeldbericht (PUSH)=
==Introduction==
The Send Aanmeldbericht scenario is used by the sending XIS to send the relevant data for the patient intake to the receiving XIS, and constitutes a subset of the Overdrachtsbericht. The structure of the eventual scenario is described in the functional design and additionally in [[vpk:V3.1_Opbouw_eOverdracht_aanmelding|Opbouw Aanmeldbericht]]. The Phase Two aanmeldbericht implements the complete aanmeldbericht as described in the functional design.
==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;" rowspan="2"|Send Aanmeldbericht(PUSH)
|style="background-color: white;" rowspan="2"|Send Aanmeldbericht
|style="background-color: white;"|Healthcare professional at organization A (using a XIS)
|style="background-color: white;"|Sends Aanmeldbericht
|-
|style="background-color: white;"|Healthcare professional at organization B (using a XIS)
|style="background-color: white;"|Receives Aanmeldbericht
|}
==Invocation==
The Send Aanmeldbericht transaction is an HTTP POST method on the target XIS's base, where the body of the POST request is a FHIR document according to [[#Structure of the Aanmeldbericht (4 HCIMs + PDF)]]. See [[#Sending documents]] for more information.
===Trigger events===
This transaction is invoked when the sending XIS needs to send the Overdrachtsbericht to the receiving XIS.
===Expected response===
The document Bundle should be processed as a [http://hl7.org/fhir/STU3/http.html#transaction transaction] by the receiving XIS. See [[#Processing documents]] for more information.
==Structure of the Aanmeldbericht phase 2 (complete)==
The Aanmeldbericht consists of multiple FHIR resources, which are assembled into a FHIR document. See [[#Creating documents]] for information on how to assemble this document.

During phase 2, the Aanmeldbericht is based 4 HCIMs (Patient, Betaler, Contactpersoon en Zorgaanbieder) and uses a PDF to send the remaining data unstructured. The table below lists the FHIR profiles<ref name="nopackage"/> that are applicable for the pilot implementation of the Aanmeldbericht transaction. All resources SHALL conform to the profiles listed in this table and SHALL include the profile canonical URL in the <code>meta.profile</code> element.

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:400px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:400px" | FHIR profile
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | FHIR resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | HCIM name
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | HCIM version
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left;  background-color: #E3E3E3 width:50px" | Remarks
|-
| -
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eOverdracht-aanmeldbericht|eOverdracht aanmeldbericht}}
| Composition
| -
| -
| Declaration of the Send Aanmeldbericht transaction.
|-
| Datum overplaatsing
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eOverdracht-TransferDate|eOverdracht-TransferDate}}
| -
| -
| -
| DateTime extension used in eOverdracht composition profiles
|-
| rowspan="3"|Persoonsgegevens
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient|nl-core-patient}}
| Patient
| Patient
| v3.1(2017NL)
| -
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Payer|zib-Payer}}
| Coverage
| Betaler
| v3.1(2017NL)
| -
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-relatedperson|nl-core-relatedperson}}
| RelatedPerson
| Contactpersoon
| v3.1(2017NL)
| -
|-
| Sturende organisatie
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nl-core-organization}}
| rowspan="2"| Organization
| rowspan="2"| Zorgaanbieder
| rowspan="2"| v3.1.1(2017NL)
| rowspan="2"| -
|-
| Ontvangende organisatie
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nl-core-organization}}
|-
| Medische diagnose
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Problem|zib-Problem}}
| Condition
| Probleem
| v4.1(2017NL
| -
|-
|-
| Voorgeschiedenis
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Problem|zib-Problem}}
| Condition
| Probleem
| v4.1(2017NL
| -
|-
| Let op
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Alert|zib-Alert}}
| Flag
| Alert
| v3.2(2017NL)
| -
|-
| Vrijheidsbeperking
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-FreedomRestrictingMeasures|zib-FreedomRestrictingMeasures}}
| Procedure
| VrijheidsBeperkendeMaatregelen
| v3.1(2017NL)
| -
|-
| Actuele patiëntenproblemen
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Problem|zib-Problem}}
| Condition
| Probleem
| v4.1(2017NL)
| -
|-
| Afspraken patiënt
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest|zib-ProcedureRequest}}
| ProcedureRequest
| OverdrachtGeplandeZorgActiviteit
| v3.1(2017NL)
| -
|-
| Wensen en behoeften patiënt en/of naasten
| -
| -
| -
| -
| Declared as a text section. See {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eOverdracht-aanmeldbericht|eOverdracht aanmeldbericht profile}}.
|-
| rowspan="2"| Voeding/vocht
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-FeedingTubeSystem|zib-FeedingTubeSystem}}
| DeviceUseStatement
| SondeSysteem
| v3.2(2017NL)
| -
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Infusion|zib-Infusion}}
| DeviceUseStatement
| Infuus
| v3.2(2017NL)
| -
|- 
| Uitscheiding
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Stoma|zib-Stoma}}
| Observation
| Stoma
| v3.2(2017NL)
| -
|}

=FHIR Documents=
Both the Aanmeldbericht and the Overdrachtsbericht are sent as a [https://www.hl7.org/fhir/STU3/documents.html FHIR Document]. A document is a FHIR Bundle that assembles all relevant resources that need to be exchanged, together with a [https://www.hl7.org/fhir/STU3/composition.html Composition resource] that summarizes and references all these resources.

A FHIR document is immutable and considered to be attested by a healthcare professional.
==Creating documents==
To construct a document, a FHIR Composition resource is created that summarizes and references all the resources that need to be exchanged. This Composition resource is then placed together with all referenced resources in a Bundle with <code>Bundle.type</code> set to "document". The Composition resource SHALL be the first entry.

Profiles have been created for both the Composition and the document Bundle resources for each transaction within eOverdracht. All documents SHOULD adhere to these profiles, which are summarized in this implementation guide at the transaction level.
==Sending documents==
The document should be sent as an HTTP POST operation on the target XIS's base:
 POST [base] {?_format=[mime-type]}
where the body of the POST request is the document.
==Processing documents==
The document Bundle should be processed as a [http://hl7.org/fhir/STU3/http.html#transaction transaction] by the receiving XIS and each <code>Bundle.entry</code> should be treated as a <code>create</code> interaction for the <code>Bundle.entry.resource</code>. When the receiving XIS cannot create a new resource because of incorrect data or business rules, it should perform a rollback of the creation of any previous entries.

On success, the target XIS SHALL respond:
* With the HTTP status code 201 Created.
* With the Location header containing the new logical id and version id of the created resource version.
* With a response body set to a Bundle of type "transaction-response", containing one entry for each entry in the request, in the same order, with the outcome of processing the entry. The sender may use the returned Bundle to track the outcomes of processing the entry, and the identities assigned to the resources by the server.

On failure, the target XIS SHALL respond:
* With an HTTP status code set appropriate to the processing outcome:
** When the resource syntax or data is incorrect or invalid, the status code should be 400 Bad Request.
** When the server rejects the content of the resource because of business rules, the status code should be 422 Unprocessable Entity.
** Additional HTTP status code may be used if more appropriate.
* With a response body set to a FHIR [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome] resource with detailed error messages describing the reason for the error.

=FHIR CapabilityStatements=
* {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/eOverdracht-servercapabilities-phase-one|CapabilityStatement server}}
* {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/eOverdracht-clientcapabilities-phase-one|CapabilityStatement server}}

=Footnotes=
<references />