Skip to main content

Bundle Uploader

The Bundle Uploader lets you upload FHIR Bundle files to the server in bulk. Open it from Tools > Bundle Uploader in the sidebar.

note

Requires the bundle-upploader UI feature code or administrator access.

Overview

Bundle Uploader

The page provides a drag-and-drop area for uploading .json files containing FHIR Bundles.

Uploading a Bundle

  1. Drag and drop one or more .json files onto the upload area, or click the area to open a file picker.
  2. The uploader validates that each file contains a valid FHIR Bundle.
  3. The bundle is submitted to the server for processing.
  4. Results are displayed below the upload area, showing the outcome for each entry in the bundle.

Supported Bundle Types

The uploader accepts all standard FHIR bundle types:

TypeBehavior
transactionAll-or-nothing processing. If any entry fails, the entire bundle is rolled back.
batchEach entry is processed independently. Failures in one entry do not affect others.
collectionA group of resources imported as-is.
documentClinical document bundles (Composition + referenced resources).
messageFHIR messaging bundles (MessageHeader + payload resources).

Interpreting Results

After upload, each entry in the bundle is listed with its HTTP status:

  • 201 Created - the resource was successfully created.
  • 200 OK - the resource was successfully updated.
  • 4xx / 5xx errors - the entry failed, with an error message explaining the reason.

For transaction bundles, either all entries succeed or all are rolled back with an error.