Bulk Data Access IG, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 4.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/bulk-data/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/bulkdata/OperationDefinition/bulk-submit | Version: 4.0.0 | ||||
| Standards status: Trial-use | Maturity Level: 2 | Computable Name: BulkSubmit | |||
FHIR Operation through which an authenticated and authorized Data Provider submits Bulk FHIR Data to a Data Consumer and receives status information regarding the Data Consumer's receipt and processing of the data. The Data Provider provides one or more manifest URLs pointing to pre-coordinated FHIR data sets, along with metadata needed for the Data Consumer to retrieve and process the files.
Language: en
URL: [base]/$bulk-submit
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | submitter | 1..1 | Identifier | The submitter SHALL match a system and code specified by the Data Consumer (coordinated out-of-band or in an implementation guide specific to a use case). | ||
| IN | submissionId | 1..1 | string | The value SHALL be unique for the | ||
| IN | submissionStatus | 0..1 | Coding | Submission Status Value Set (Required) | System of | |
| IN | manifestUrl | 0..1 | url | Url pointing to a Bulk Export Manifest with a pre-coordinated FHIR data set. Files in multiple submitted manifests with the same | ||
| IN | replacesManifestUrl | 0..1 | url | The url of a previously submitted manifest that has the same | ||
| IN | outputFormat | 0..1 | string | The format for the Bulk Data files in the manifest. The MIME-type MAY include a MIME-type parameter of | ||
| IN | fhirBaseUrl | 0..1 | url | Base url to be used by the Data Consumer when resolving relative references in the submitted resources. When the | ||
| IN | fileRequestHeader | 0..* | HTTP headers that the Data Consumer SHOULD use when requesting a data file from the Data Provider. | |||
| IN | fileRequestHeader.headerName | 1..1 | string | |||
| IN | fileRequestHeader.headerValue | 1..1 | string | |||
| IN | oauthMetadataUrl | 0..* | url | Location that a Data Consumer can use to obtain the information needed to retrieve files protected using OAuth 2.0. The url SHALL be the path to a FHIR Authorization Endpoint and Capabilities Discovery file or another OAuth 2.0 Protected Resource Metadata file that is registered in the IANA Well-Known URIs Registry. | ||
| IN | fileEncryptionKey | 0..1 | Encryption key information for the Data Consumer to decrypt retrieved data files from the Data Provider. | |||
| IN | fileEncryptionKey.coding | 0..1 | Coding | If omitted, defaults to a system of | ||
| IN | fileEncryptionKey.value | 1..1 | string | For the system of | ||
| IN | metadata | 0..* | Child parameters can be added under this parameter to pass pre-coordinated data relevant to the submission from the Data Provider to the Data Consumer. Each child parameter name SHALL be an absolute URL. Specific child parameters are defined in implementation guides for particular use cases. | |||
| IN | metadata.parameterUrl | 1..1 | uri | An absolute URL identifying this metadata parameter. | ||
| IN | metadata.parameterValue | 1..1 | string | The value for this metadata parameter. | ||
| IN | import | 0..* | Child parameters MAY be added under this parameter to pass pre-coordinated options relevant to how the data will be processed from the Data Provider to the Data Consumer. For example, a Data Consumer might allow the Data Provider to specify whether or not existing data should be replaced with the data in the submission. Each child parameter name SHALL be an absolute URL. Specific child parameters are defined in implementation guides for particular use cases. | |||
| IN | import.parameterUrl | 1..1 | uri | An absolute URL identifying this import parameter. | ||
| IN | import.parameterValue | 1..1 | string | The value for this import parameter. |