For a full list of available versions, see the Directory of published versions
The Submit MI Report interaction is based on RESTful asynchronous HTTP interaction using FHIR transaction bundle. Each transaction bundle must include an DiagnosticReport resource and its referenced resources.
The transaction interactions submit a set of actions to perform on a server in a single HTTP request/response. The actions are performed as a single atomic "transaction" where the entire set of changes succeeds or fails as a single entity.
The content of the post submission is a Bundle with Bundle.type = transaction. Each entry SHALL carry request details (Bundle.entry.request) that provides the HTTP details of the action in order to inform the system processing the batch or transaction what to do for the entry. In most casess, this should be a PUT command with business identifiers of the associated resource to support conditional update. The FHIR server will use the business identifier to determine if the resource will be created or updated if it already exists. If multiple matches are found, no action shall be performed and the bundle will be rejected. The resources in the bundle are each processed separately as if they were an individual interaction. The actions are subject to the normal processing for each, including transactional integrity. In a transaction, all interactions or operations either succeed or fail together.
For a transaction, servers will either accept all actions or reject all resources. The outcome of processing the transaction will not depend on the order of the resources in the transaction. A resource can only appear in a transaction once (by identity).
When processing a transaction, the server will assign new ids to all submitted resources, irrespective of any claimed logical id in the resource or fullUrl on entries in the transaction.
As miCDR supports submission asynchrounously, after miCDR receives the submission, it returns "Accepted" (HTTP 202) response. The submission payload is placed in a queue waiting to be validated. If it is valid, the data is stored in miCDR. If validation fails, the errors and warnings are recorded in the DQS solution. The access of DQS solution is out of the scope of this implmentation guide. The applicable information will be provided to HICs at onboarding time.
Actor: miCDR DiagnosticReport Contributor
Role: Submits a DiagnosticReport resource and other referenced resources to the miCDR FHIR server.
Actor: miCDR FHIR server
Role: Performs validation of the submission payload and returns HTTP acknowledgement and applicable FHIR OperationOutcome depending on the validation outcome.
This interaction is based on FHIR R4 transaction bundle.
Submit MI Report Interaction
POST [base]/Bundle
See Response Handling page for additional response handling behavior.
| Legend |
|---|
| code = OperationOutcome.issue.code |
| severity = OperationOutcome.issue.severity |
| details.coding.code=OperationOutcome.issue.details.coding.code |
| details.coding.display=OperationOutcome.issue.details.coding.display |
| details.text = OperationOutcome.issue.details.coding.text |
| HTTP Status | Scenario Description | severity | code | details.coding.code | details.coding.display | details.text |
|---|---|---|---|---|---|---|
| 202 Accepted | The submission payload has passed conformance rules, and put into message queue for further processing. No Operationoutcome is returned. | |||||
| 400 Bad Request | Missing security token | error | required | Missing required security token: PIN | ||
| 401 Unauthorized | Failed authentication | error | security | Authorization is required for the interaction that was attempted | ||
| 500 Internal Server Error | API validates the request but cannot return a valid response due to internal issues. | fatal | exception | Internal Error | ||
| 503 Service Unavailable | Indicates that the services has been temporarily taken down (on purpose) | |||||
| 504 Gateway Timeout | Downstream system(s) did not return timely response error timeout | error | timeout |