View Source

RED interchange API allows to send FHIR bundles to RED in order to create new data using a POST request.

{{baseURL}}/{{tenant}}/Bundle

Example: this POST requests creates data in RED if a FHIR bundle is attached

The request header should set the content-type to "Content-Type": "application/fhir+xml; charset=UTF-8"

The request body must include a valid FHIR bundle with the items to create.

patients are identified by their patient ID (Patient.id). If patients are created by interface RED will use the Patient.id from the Patient bundle for patient identification, and patient references of incoming data must always refer to this ID. That allows external systems to create patients in RED using their identifiers and to use the same ID in both systems.
all bundle items will be referenced by their IDs, their data in RED can be updated by sending a bundle with the same ID.

See RED Interchange API - Postman Collection 0210 - Patient Coverage with provenance

Example: RED creates a new episode for an existing person (with ID 6202)

<Bundle xmlns="http://hl7.org/fhir">
    <id value="10000"/>
    <meta>
        <versionId value="1"/>
        <lastUpdated value="2021-08-11T12:52:00+00:00"/>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Bundle_Patientenakte|1.2.0"/>
    </meta>
    <type value="history"/>
    <entry>
        <resource>
            <Coverage>
                <id value="TCI7596-1-1629639837586"/>
                <meta>
                    <versionId value="1"/>
                    <lastUpdated value="2021-08-22T15:43:57+0200"/>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Krankenversicherungsverhaeltnis|1.2.0"/>
                </meta>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://fhir.de/CodeSystem/identifier-type-de-basis"/>
                            <code value="GKV"/>
                        </coding>
                    </type>
                    <system value="http://fhir.de/NamingSystem/gkv/kvid-10"/>
                    <value value="Y681518688"/>
                </identifier>
                <extension url="http://fhir.de/StructureDefinition/gkv/versichertenart">
                    <valueCoding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_VERSICHERTENSTATUS"/>
                        <code value="1"/>
                    </valueCoding>
                </extension>
                <extension url="http://fhir.de/StructureDefinition/gkv/besondere-personengruppe">
                    <valueCoding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_PERSONENGRUPPE"/>
                        <code value="00"/>
                        <display value="nicht gesetzt"/>
                    </valueCoding>
                </extension>
                <status value="active"/>
                <type url="http://fhir.de/StructureDefinition/gkv/besondere-personengruppe">
                    <coding>
                        <system value="http://fhir.de/CodeSystem/versicherungsart-de-basis"/>
                        <version value="0.2.3"/>
                        <code value="GKV"/>
                    </coding>
                </type>
                <beneficiary>
                    <reference value="Patient/6202"/>
                </beneficiary>
                <payor>
                    <identifier>
                        <system value="http://fhir.de/NamingSystem/arge-ik/iknr"/>
                        <value value="109577006"/>
                    </identifier>
                </payor>
                <period>
                    <start value="2022-01-02"/>
                    <end value="2022-03-31"/>
                </period>
            </Coverage>
        </resource>
    </entry>
</Bundle>