Service type to query slots & EHR Id

325 views
Skip to first unread message
Assigned to Fenil....@cerner.com by me

Abhilash Kokkonda

unread,
Jul 9, 2021, 8:15:54 AM7/9/21
to Cerner FHIR Developers
I'm trying to fetch available slots to create an appointment.
I was going through the documentation, and it's mentioned that we need to provide EHR ID and then it's corresponding service type id
&serviceType=https://fhir.cerner.com/<EHR source id>/codeSet/14250
Is there anyway where I can call an API to fetch the EHR and its service type based on user's query/question?

Thanks,
Abhilash

Fenil Desani (Cerner)

unread,
Jul 12, 2021, 1:09:52 PM7/12/21
to Cerner FHIR Developers
Hello,

EHR Source ID is an unique identifier which varies per domain. For our public Sandbox, please use - ec2458f2-1e24-41c8-b71b-0e701af7583d

To search for slots using service-type, you can use Service-type parameter (http://fhir.cerner.com/millennium/r4/base/workflow/slot/#parameters), 
A single or comma separated list of appointment types that can be booked into the slot. Example: service-type=https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249|4047611

Thank You,
Fenil (Cerner)
Message has been deleted

Abhilash Kokkonda

unread,
Jul 13, 2021, 12:15:36 PM7/13/21
to Cerner FHIR Developers
Thanks for your reply Fenil,

    I have few questions.
1. For service types, if I wanted to search for slots for a specific provider type, like paediatrics or cardiologist, how can I get a service type for a specific provider type
2. I had a sample request for creating an appointment, with status 'proposed', where I have a service type added as below
    {
        "resourceType": "Appointment",
        "status": "proposed",
            "reasonCode": [
            {
                "text": "I have a cramp"
            }
        ],
        "serviceType": [
            {
                "coding": [
                    {
                        "code": "408443003",
                        "system": "http://snomed.info/sct"
                    }
                ]
            }
        ]
        ...
Where can I reference this code - 408443003

Warm regards,
Abhilash

Fenil Desani (Cerner)

unread,
Jul 13, 2021, 2:50:49 PM7/13/21
to Cerner FHIR Developers

Hello Abhilash,

 

You can search slot by the following params only  -  http://fhir.cerner.com/millennium/r4/base/workflow/slot/#parameters

ServiceType.Slot means more of Appointment Type and not Provider Type

 

 

For proposed Appointments, you can create Appointments using Standard codes such as SNOMED or Proprietary codes

SNOMED:

"code": "408443003",

"system": "http://snomed.info/sct"

 

Proprietary Code

"code": "24477838",

"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249"

 

 

Similarly, you can search for Appointments using:

SNOMEDhttps://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Slot?service-type=http://snomed.info/sct|408443003&start=ge2022-01-23T22:05:47Z&start=lt2022-12-12T18:13:55Z&-location=Location/21304876

Proprietary Code:  https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Slot?service-type=https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249|24477838&start=ge2022-01-23T22:05:47Z&start=lt2022-12-12T18:13:55Z&-location=Location/21304876

Abhilash Kokkonda

unread,
Jul 16, 2021, 6:54:17 AM7/16/21
to Cerner FHIR Developers
Hi Fenil,

    Thanks for your reply. I was searching for slots with the below URL


 and I got an array of slots containing nearly 50 slots, which one should we consider?

Attached the response here for your reference

Warm Regards,
Abhilash

Fenil Desani (Cerner)

unread,
Jul 16, 2021, 5:35:11 PM7/16/21
to Cerner FHIR Developers
You can use any of the returned free slot to book an Appointment.

Abhilash Kokkonda

unread,
Jul 21, 2021, 10:35:14 AM7/21/21
to Cerner FHIR Developers
Hi Fenil,
    Thanks for your time looking into my queries.
I have a basic question - Currently we are interacting with the test sandbox server. What are the actual TEST (similar to SIT, UAT) and PROD servers we will be interacting with?

Warm Regards,
Abhilash

Fenil Desani (Cerner)

unread,
Jul 21, 2021, 11:06:21 AM7/21/21
to Cerner FHIR Developers
Our public Sandbox is of the Production capacity and the only available domain to test.
All other testing/integration would need to happen in the health System's domains.

Abhilash Kokkonda

unread,
Jul 26, 2021, 12:16:39 PM7/26/21
to Cerner FHIR Developers
SNOMED Service Types, FHIR Service Types, Relation/Mapping between them & Which One to Use When

Hi Fenil,

   Thanks a lot in taking your time and looking into our queries with patience, very much appreciated. sorry to bother you, we have few items where we need your assistance in clarifying the queries.

1. We have come across this page on FHIR -  http://hl7.org/fhir/DSTU2/valueset-c80-practice-codes.html, where we can see all the codes of the system SNOMED. We are getting proper response for some codes, but some codes returned no results.
Example - 
    Consider the code 394576009 which is "Surgical-Accident & emergency", we are able to see the results.
        {
            "resourceType": "Bundle",
            "id": "072aaa2e-4982-47c1-a7d8-bd681ae6bbfd",
            "type": "searchset",
            "link": [
                {
                    "relation": "self",
                },
                {
                    "relation": "next",
                }
            ],
            "entry": [
                {
                    "resource": {
                        "resourceType": "Slot",
                        "id": "4047611-32216049-63533175-420",
                        "meta": {
                            "versionId": "3423v09vv872283",
                            "lastUpdated": "2020-06-25T07:10:27Z"
                        }
        ................
    and the response is empty - 
        {
            "resourceType": "Bundle",
            "id": "890c09c5-c6d8-493e-ad30-55751ae72940",
            "type": "searchset",
            "link": [
                {
                    "relation": "self",
                }
            ]
        }

2. For the same code, if I were to use with proprietary codes, we get some response, where service type part of the response reads as below

                "serviceType": [
                    {
                        "coding": [
                            {
                                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14249",
                                "code": "4047611",
                                "display": "Surgery Rapid",
                                "userSelected": true
                            },
                            {
                                "system": "http://snomed.info/sct",
                                "code": "394576009",
                                "display": "Accident & emergency (qualifier value)"
                            }
                        ],
                        "text": "Surgery Rapid"
                    }
                ]
**How are the codes 4047611 (from FHIR) and 394576009 (from SNOMED) are related?**

3. in the document which you have shared with us - https://docs.google.com/document/d/10RnVyF1etl_17pyCyK96tyhUWRbrTyEcqpwzW-Z-Ybs/edit#heading=h.j43pecou7im1. Why are different service types mapped to different systems?
        - Established Patient 
        - EVisit 
        - General medical practice (qualifier value) 
        - PT Eval 
        - Rehabilitation - specialty (qualifier value) 
        - Video Visit 
        - Community medicine (qualifier value) 
    Can we use any one from SNOMED or FHIR, or should we need to use both of them based on the slot types?

Warm Regards,
Abhilash

Fenil Desani (Cerner)

unread,
Jul 26, 2021, 4:36:44 PM7/26/21
to Cerner FHIR Developers
Hello,

  • 4047611 is a Proprietary code [1]
  • 394576009 is a standard [SNOMED] code
  • 408467006 SNOMED code is not mapped in our public Sandbox
  • The reason our test document has listed Proprietary and SNOMED codes for different  Slot Types is to provide both the ways of testing. Each SNOMED code would have a corresponding Proprietary code. You can use either of them as per your business seems fit.

Abhilash Kokkonda

unread,
Jul 30, 2021, 5:52:31 AM7/30/21
to Cerner FHIR Developers
Hi Fenil,
    Thanks a lot for your response.
  • For the third point which you have mentioned, how can we know which codes are not mapped to the system? and can we safely assume that all the codes are mapped in PROD at any point of time?
  • Secondly, one related to the location codes - Location/32216049 how can we know which code is mapped to which area - For instance, If I want to create an appointment in California, which location code should we need to pass?
  • I have encountered error while creating an appointment for the below request
{
    "resourceType": "Appointment",
    "status": "proposed",
    "serviceType": [
        {
            "coding": [
                {
                    "code": "4047611",
                    "display": "Surgery Rapid",
                    "userSelected": true
                }
            ]
        }
    ],
    "reasonCode": [
        {
            "text": "I have a cramp"
        }
    ],
    "comment": "I have a cramp",
    "participant": [
        {
            "actor": {
                "reference": "Patient/12742419"
            },
            "status": "needs-action"
        },
        {
            "actor": {
                "reference": "Location/32216049"
            },
            "status": "needs-action"
        }
    ],
    "requestedPeriod": [
        {
            "start": "2021-07-16T00:00:00.000Z",
            "end": "2021-08-16T00:00:00.000Z"
        }
    ]
}

But got success response for the below request

{
    "resourceType": "Appointment",
    "status": "proposed",
    "serviceType": [
        {
            "coding": [
                {
                    "code": "408443003",
                    "system": "http://snomed.info/sct"
                }
            ]
        }
    ],
    "reasonCode": [
        {
            "text": "I have a cramp"
        }
    ],
    "comment": "Appointment request comment",
    "participant": [
        {
            "actor": {
                "reference": "Patient/12724066"
            },
            "status": "needs-action"
        },
        {
            "actor": {
                "reference": "Location/21304876",
                "display": "MX Clinic 1"
            },
            "status": "needs-action"
        }
    ],
    "requestedPeriod": [
        {
            "start": "2020-02-07T13:28:17-05:00",
            "end": "2021-02-07T13:28:17-05:00"
        }
    ]
}

Can you please help with this?

Warm Regards,
Abhilash

Fenil Desani (Cerner)

unread,
Jul 30, 2021, 11:02:28 AM7/30/21
to Cerner FHIR Developers
  • For testing in our Sandbox, please use the codes mentioned here - https://docs.google.com/document/d/10RnVyF1etl_17pyCyK96tyhUWRbrTyEcqpwzW-Z-Ybs/edit#heading=h.j43pecou7im1
  • While integration, codes can be mapped per client as per the requirement of the App and/or hospital.
  • When integrating your application with a client’s production environment you will work with the client to determine the Practitioner and Location ids (Millennium personnel and location codes, respectively) which they want to make available to third-party applications for enabling scheduling functionality. [1]
  • Please provide X-Request-Id of the failure.

Abhilash Kokkonda

unread,
Jul 30, 2021, 1:25:08 PM7/30/21
to Cerner FHIR Developers
Hi Fenil,

    Thanks a lot for your response. We will be connecting with Keck Medicine of USC for their specialties and location codes.
Thanks a lot for your time in looking into our queries, very much appreciated.

For the last point - the x-request id

SUCCESS: ae99b3e0-3be0-41ec-9fc5-91b38fa283a2
FAILURE: c43cd6a1-7eca-4e78-b076-2a608c460139
    - Error: {
    "resourceType": "OperationOutcome",
    "issue": [
        {
            "severity": "error",
            "code": "invalid",
            "details": {
                "text": "Unprocessable entity"
            }
        }
    ]
}

Warm Regards,
Abhilash

Fenil Desani (Cerner)

unread,
Aug 2, 2021, 11:38:02 AM8/2/21
to Cerner FHIR Developers
Rapid Surgery is an Appointment Type which requires an order associated and hence can be booked but not proposed.
Reply all
Reply to author
Forward
0 new messages