Introduction
This use case will focus on the calls that need to be made to submit a new service request through the CIE hub. The use case will demonstrate how to create a patient in the system and then submit the Service Request along with observations.
Resources that will be submitted in this use case
Resource | Description | FHIR Reference |
|---|---|---|
ServiceRequest | This represents the Request from a partner system. The performer of this ServiceRequest should be your organization. | |
Patient | Represents information on the person that has be referred by the partner organization. | |
Observation | Represents a piece of information that is associated with a Service Request. This could be answer to a questionnaire or a test result. |
Step 1 - Submit a Patient
Step one is to register a patient within the system. Please note that if you have already submitted a patient you do not need to do this step again. The CIE hub also has the ability for you to share your unique identifiers to the record in this way you will be able to do searches by using your unique identifier. The following describes that process. Sharing your Unique Identifiers
The following is a example payload for a patient. This will return a identifier for the CIE Hub that can be used in the next bundle call.
| Code Block |
|---|
{
"active": true,
"address": [
{
"city": "Detroit",
"district": "Wayne",
"line": [
"1111 Test Street"
],
"postalCode": "48217",
"state": "MI",
"text": " 1111 Test Street, Detroit, MI, United States",
"type": "physical",
"use": "offical"
}
],
"birthDate": "1989-05-31",
"communication": [
{
"language": {
"coding": [
{
"code": "en-US",
"display": "English"
}
]
},
"preferred": true
}
],
"extension": [
{
"url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race",
"valueString": "Black / African American"
},
{
"url": "http://hl7.org/fhir/us/military-service/StructureDefinition/military-service-veteran-status",
"valueBoolean": false
},
{
"url": "http://hl7.org/fhir/StructureDefinition/patient-preferenceType",
"valueString": "Text Message"
}
],
"gender": "female",
"id": "cd521181-661f-480e-8d47-50ad810d712f",
"identifier": [
{
"system": "https://YOUR-URL.org",
"type": {
"text": "patientId"
},
"use": "official",
"value": "3058423"
}
],
"name": [
{
"family": "TESTER",
"given": [
"TEST"
],
"use": "official"
}
],
"resourceType": "Patient",
"telecom": [
{
"rank": 1,
"system": "phone",
"use": "mobile",
"value": "(313) 111-1111"
},
{
"rank": 2,
"system": "email",
"use": "home",
"value": "test@gmail.com"
}
]
} |
...
Here is the documentation on how to call the endpoint. POST Patient
Step 2 - Submit the ServiceRequest and Observations Bundle
Step two is to give information about the service request. There will be two types of FHIR resources the Service Request and the Observation. The following is a example of the Bundle
...