Skip to content

Hgear Transformation

Transform HL7 v2 and C-CDA data into FHIR.

Convert HL7 v2 messages and C-CDA clinical documents into FHIR resources. Review source-to-resource mapping and normalization before validating the output for your receiving system.

HL7 v2 → FHIRC-CDA → FHIRMapping & normalizationSame engine in the REST API

Transformation tools

Convert HL7 v2 messages and C-CDA documents.

Keep the source and the generated FHIR close together so teams can see what changed, where it mapped, and what to inspect next.

HL7 v2 → FHIR

Turn message-based data into structured FHIR resources.

Follow message segments into mapped Patient, Observation and Encounter resources without losing the source context.

HL7v2MSH · PID · PV1 · OBX
→
FHIR BundlePatient · Observation · Encounter
Open HL7 to FHIR Converter

C-CDA → FHIR

Convert clinical documents into modern FHIR structures.

Bring document sections forward into resource-based workflows while keeping the transformation easy to review.

C-CDAClinical document
→
CompositionPatientAllergyIntolerance
Open C-CDA to FHIR Converter

How it works

From a message or document to a FHIR bundle.

Each step stays visible, so a mapping tested in the browser becomes a repeatable pipeline with no surprises.

  1. Load a message or document

    Paste an HL7 v2 message or upload a C-CDA document, using synthetic or de-identified data for evaluation.

  2. Map segments and sections to resources

    Segments such as PID, PV1 and OBX, or document sections such as problems and medications, map to Patient, Encounter, Observation and related resources.

  3. Normalize values along the way

    Dates, identifiers, units and code systems are normalized so the output is consistent across sources.

  4. Review, validate and hand off

    Compare source and result side by side, validate the bundle, then move the same mapping into your API-driven workflow.

Mapping & normalization

See exactly how source data becomes FHIR.

Every generated element can be traced back to the field that produced it, with the normalized value shown beside the original.

  • Field-level mapping from HL7 v2 segments and C-CDA sections
  • Normalized dates, identifiers, units and codes
  • Source values kept beside the generated resources for review
HL7 v2 fieldFHIR elementNormalized
PID-5Patient.nameDoe, John
PID-7Patient.birthDate1980-01-01
PV1-2Encounter.classinpatient
OBX-3Observation.codeLOINC 8302-2
OBX-5/6Observation.value180 cm

Why transformation is the first step in FHIR interoperability.

Most clinical data exchanged today still arrives as HL7 v2 messages from lab, ADT and order feeds, or as C-CDA documents from EHRs and health information exchanges. Modern applications, APIs and analytics platforms expect FHIR resources instead. Transformation is the bridge: it turns message segments and document sections into Patient, Encounter, Observation, Condition and other resources that downstream systems can use directly.

The hard part is not producing JSON, it is producing FHIR you can trust. Hgear keeps the source and the generated resources side by side so mapping decisions stay reviewable, normalizes dates, identifiers, units and code systems on the way through, and runs the same transformation engine in the browser tools and the REST API. A mapping you have tested interactively becomes a repeatable pipeline without changing tools.

Workflow integration

Use transformation in your workflow.

Move from browser-based testing to repeatable transformation inside your applications and pipelines.

01
REST APIs

Call the same converters from your integration layer

02
Batch processing

Transform feeds and document sets on a schedule

03
Deployment

SaaS, private cloud or on-premises

Common questions

Data Transformation FAQ

How are HL7 v2 and C-CDA converted to FHIR?

Transformation maps fields from HL7 v2 messages or sections of C-CDA clinical documents into FHIR resources. Review the source alongside the output to check patient identifiers, clinical values, codes and resource references. The mapping depends on the source format and the target FHIR profiles.

Explore HL7 v2 to FHIR conversion
What should I check after converting a clinical document?

Compare the generated resources with the original document, then validate them against the profiles and terminology your receiving system expects. A successful conversion alone does not establish that the data is complete, clinically accurate or ready for production.

Review FHIR validation checks
How can I evaluate a transformation workflow?

Start with synthetic or de-identified samples representative of your source system. Identify the source format, target FHIR version and profiles, expected volume and deployment requirements. Compare the output with your expected mappings and discuss integration requirements with Hgear before production use.

Explore C-CDA to FHIR conversion

What's next

Validate your FHIR data.

Check transformed data against the profiles, terminology and conformance rules your workflow expects.