DocumentReferences represent all documents stored in the patient record:
Document references are assigned to a patient and may be searched. A search request (GET) for patient document references returns a bundle of one or more FHIR items of type KBV_PR_AW_Anlage.
{{baseURL}}/{{tenant}}/DocumentReference?page=1&subject=Patient/6006 |
Example: this search requests fetches all document references of patient 6006 using paging to limit the number of results
For an example see RED Interchange API - Postman Collection 0115 - Patient - All DocumentReferences
A search request for document references will return a base64 string representing the document content rendered as PDF file for each document item. In order to fetch document metadata only the request can be extended by adding the summary parameter to the request. A request with summary=true will return all document references with metadata but without document content. This is preferred if only selected documents with full content are to be fetched.
{{baseURL}}/{{tenant}}/DocumentReference?page=1&_summary=true&subject=Patient/6006 |
For an example see RED Interchange API - Postman Collection 0116 - Patient - All DocumentReferences Summary
Data of a specific document reference may be fetched using a read request (GET) with the identifier of the specific document reference The request returns a FHIR item of type KBV_PR_AW_Anlage.
{{baseURL}}/{{tenant}}/DocumentReference/ehcRBg8T0ejevvTb |
Example: this read request returns the FHIR item for document reference with ID ehcRBg8T0ejevvTb. The ID may be retrieved by a search request sent before this request.
For an example see RED Interchange API - Postman Collection 0117 - Patient - Specific DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
<id value="ehcRBg8T0ejevvTb"/>
<meta>
<versionId value="1"/>
<lastUpdated value="2022-06-23T00:00:00+00:00"/>
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Anlage|1.2.0"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml">Referenz auf Dokument vom 23.06.2022 (V1) | ID ehcRBg8T0ejevvTb | Name Heilmittel Physiotherapie (ab 01.10.2020) | Anlagetyp KV-Muster_13 | Filetyp file_type_pdf | erstellt am 23.06.2022 | zuletzt bearbeitet 2022-06-23T00:00:00+00:00</div>
</text>
<masterIdentifier>
<type>
<coding>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_AW_Anlage_Identifiertyp"/>
<code value="Spezifikationsversion"/>
</coding>
</type>
<value value="4Q2020"/>
</masterIdentifier>
<identifier>
<type>
<coding>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_AW_Anlage_Identifiertyp"/>
<code value="Bezeichnung"/>
</coding>
</type>
<value value="Heilmittel Physiotherapie (ab 01.10.2020)"/>
</identifier>
<status value="current"/>
<type>
<coding>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_AW_Anlagetyp"/>
<code value="KV-Muster_13"/>
</coding>
</type>
<category>
<coding>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_AW_Ressourcentyp"/>
<code value="Anlage"/>
</coding>
</category>
<date value="2022-06-23T00:00:00+00:00"/>
<description value="Heilmittel Physiotherapie (ab 01.10.2020)"/>
<content>
<attachment>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_AW_Anlage_Version">
<valueCodeableConcept>
<coding>
<system value="http://www.redmedical.de/identifiers/documents"/>
<code value="1.00"/>
</coding>
</valueCodeableConcept>
</extension>
<contentType value="application/pdf"/>
<data value="JVBERi0xLjQKJfbk/N8K.....M3NTMKJSVFT0YK"/> // base64-string with document content
<url value="Heilmittel Physiotherapie (ab 01.10.2020)"/>
<title value="Heilmittel Physiotherapie (ab 01.10.2020)"/>
<creation value="2022-06-23T00:00:00+00:00"/>
</attachment>
</content>
</DocumentReference> |