Convert - FHIR (R4) to CDA
POST /convert/v1/fhirr4tocda
This operation converts a FHIR R4 bundle (including one from HL7-to-FHIR or Combine Bundles) into an aggregated CDA document.
Inputs and Outputs
The input for the CDA conversion is a FHIR R4 bundle for a single patient.
The output is an aggregated CCDA R2.1 document in XML format.
If your FHIR bundle contains multiple FHIR Patient resources (all of which should be from the same person), use the combine FHIR bundles operation prior to the CDA conversion.
Data Format
The output format is in XML, so be sure to specify accept: application/xml in your request header.
Error Handling
If the input data is invalid (such as improperly-formatted FHIR data), the request will return an error response (see API basics). However, in many cases Rosetta can continue processing even when there are issues with the input data, such as missing fields or unexpected data types. In such cases, the invalid data will be omitted from the finished CDA document.
Example
Try out the operations, with examples, in the Rosetta Sandbox.
FHIR Bundles and CDA documents are verbose, so this just shows a small sample to illustrate how the data is structured. For a more complete example, try out the API in one of the Quickstart Tools.
For example, a FHIR Patient resource:
"resource": {
"resourceType": "Patient",
"id": "35b77437-425d-419c-90b5-af4bc433ebe9",
"name": [
{
"use": "official",
"family": "Smith",
"given": [
"John"
]
}
],
...
}would be converted to a patient node in the CDA XML:
<patient classCode="PSN" determinerCode="INSTANCE">
<name>
<given>John</given>
<family>Smith</family>
</name>
...
</patient>