Skip to Main Content

Clinical APIs (EHR)

Announcement

For information related to the Oracle Partner Network (OPN) Industry Healthcare Track please visit our OPN Industry Healthcare Program page.

For specific questions related to Oracle Partner Network (OPN), please contact Partner Assistance.

Millennium FHIR and non-FHIR API Specifications and Supporting Documents can be found HERE on docs.oracle.com
Soarian FHIR API Specifications and Supporting Documents can be found HERE on docs.oracle.com.

Send message using new Messaging API returns error: "Unable to convert HTML to RTF"

Anderson SilvaJan 28 2025 — edited Jan 29 2025

Workflow or API calls:

message/20241001/patientMessages/sentItems

Background Information:

I am trying to implement a patient messaging feature using cerner's new messaging api: https://docs.oracle.com/en/industries/health/millennium-platform-apis/mcfap/api-messages.html

I am using system tokens to execute the API calls and the proper permissions have been set in my code console

So far, /20241001/patientMessages/inboxItems, /20241001/patientMessages/sentItems and /20241001/groupInboxes

have worked as expected. My issue lies on the /20241001/patientMessages/sentItems API.

Here is the payload I am trying to send

{

patientId: '<my test patient id>',

content: `

<html xmlns="http://www.w3.org/1999/xhtml" lang="en">

<body>

<div>

<p>Hello,</p>

</div>

</body>

</html>

`,

subject: 'test',

recipients: [{

id: '<my test patient id>',

type: 'PERSONNEL',

}],

messageSender: {

id: '<my test patient id>',

type: 'PERSON',

},

},

The docs mention that the message must be in XHTML format but it does not matter what format I send, even valid XHTML, I always receive back the error message "Unable to convert HTML to RTF" with http code 400.

Can you please show me a valid payload to be sent or what is wrong with mine?

Are you an OPN Member? Yes

Have you signed up to be in the Healthcare Developer Track? Yes
Are you a registered Code Program member? No
Does your App have a presence on the Oracle Healthcare App Marketplace? No

Expected Result: HTTP 200

Actual Result:

{
code: "InvalidParameter",
message: "Unable to convert HTML to RTF",
details: [
],
}

cerner-correlation-id: '/9F992A05E734BCBF801777F3CF02FDE8+7556'

opc-request-id:'/9F992A05E734BCBF801777F3CF02FDE8/6721EDD714C1C2FB0616C040CF900A4B'

This post has been answered by Kennan Keim-Oracle on Mar 21 2025
Jump to Answer
Comments
Post Details
Added on Jan 28 2025
10 comments
474 views