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.
{
"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
{
"resourceType": "Bundle",
"type": "transaction",
"entry": [
{
"request": {
"method": "POST",
"url": "ServiceRequest"
},
"fullUrl": "urn:uuid:ec11f683-8779-4fcf-a9b7-1ce1b0033968",
"resource": {
"resourceType": "ServiceRequest",
"id": "ec11f683-8779-4fcf-a9b7-1ce1b0033968", //PLEASE GENERATE YOUR OWN GUID
"subject": {
"reference": "Patient/a41d9169-0dc9-4645-bc85-fbd3fafc4fee",
"display": "TEST TESTER"
},
"requester": {
"reference": "Organization/288859cf-ed33-4a41-85f1-ceba72f029dc",
"type": "Organization",
"display": "YOUR ORG" //This information will be given when registering to the Hub
},
"code": {
"coding": [
{ // Represents why the service request is being made
"code": "CODE",
"display": "FRIENDLY DISPLAY NAME",
"system": "https://mi-cie.org/fhir/StructureDefinition"
}
]
},
"extension": [ //THESE ARE OPTIONAL
{
"url": "http://hl7.org/fhir/StructureDefinition/referringName",
"valueString": "REFERRERFISTNAME"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/referringEmail",
"valueString": "referrer@referrer.com"
}
],
"status": "active",
"intent": "original-order",
"category": [
{ // REPRESENTS MORE METADATA ABOUT THE REQUEST- THIS IS OPTIONAL
"coding": [
{
"system": "http://hl7.org/fhir/us/sdoh-clinicalcare/CodeSystem/SDOHCC-CodeSystemTemporaryCodes",
"code": "transportation-insecurity",
"display": "Transportation Insecurity"
}
]
}
],
"performer": [
{
"reference": "Organization/39649",
"type": "Organization",
"display": "PERFORMER ORGANIZATION"
}
],
"authoredOn": "2024-07-22T11:26:45-04:00"
}
},
{
"request": {
"method": "POST",
"url": "Observation"
},
"fullUrl": "urn:uuid:e7508fe8-a854-4a4d-a77a-6c89e6242f3f",
"resource": {
"resourceType": "Observation",
"basedOn": [
{
"reference": "ServiceRequest/ec11f683-8779-4fcf-a9b7-1ce1b0033968",
"type": "ServiceRequest"
}
],
"id": "a403eef1-df40-43ce-8d5c-8c10a7ca757b",
"status": "final",
"category": [
{ //Represents more meta data about the observation - This is optional
"coding": [
{
"system": "https://mi-cie.org/fhir/StructureDefinition",
"code": "CODE_v2",
"display": "FRIENDLY CODE NAME"
}
]
}
],
"code": {
"coding": [
{ // THIS REPRESENTS WHAT THE OBSERVATION IS
"system": "https://mi-cie.org/fhir/StructureDefinition/employmentEligibility",
"code": "employmentEligibility_v2",
"display": "Employment Eligibility"
}
]
},
"subject": {
"reference": "Patient/a41d9169-0dc9-4645-bc85-fbd3fafc4fee",
"display": "PUTFIRSTNAME PUTLASTNAME"
},
"valueString": "Job searching",
"effectiveDateTime": "2024-07-22T11:26:45-04:00"
}
},
{
"request": {
"method": "POST",
"url": "Observation"
},
"fullUrl": "urn:uuid:1d6d50dc-8e2e-418a-999f-dc3a9382ae5a",
"resource": {
"resourceType": "Observation",
"basedOn": [
{
"reference": "ServiceRequest/ec11f683-8779-4fcf-a9b7-1ce1b0033968",
"type": "ServiceRequest"
}
],
"id": "78a9b719-7087-4305-9fc6-c2c56c796e85",
"status": "final",
"category": [
{ //Represents more meta data about the observation - This is optional
"coding": [
{
"system": "https://mi-cie.org/fhir/StructureDefinition",
"code": "CODE_v2",
"display": "FRIENDLY CODE NAME"
}
]
}
],
"code": {
"coding": [
{ // THIS REPRESENTS WHAT THE OBSERVATION IS
"system": "https://mi-cie.org/fhir/StructureDefinition/clientSituation",
"code": "clientSituation_v2",
"display": "Client Situation"
}
]
},
"subject": {
"reference": "Patient/a41d9169-0dc9-4645-bc85-fbd3fafc4fee",
"display": "PUTFIRSTNAME PUTLASTNAME"
},
"valueString": "Test",
"effectiveDateTime": "2024-07-22T11:26:45-04:00"
}
}
]
}
The following describes how to make this call POST / .
Add Comment