Process Message Operation

OPERATION: POST [base]/$process-message

The Process Message operation enables the submission of FHIR messages to various Netsmart solutions.

The Messaging using FHIR Resources article to learn more about FHIR Messaging.

Workflow

This API uses the synchronous message exchange pattern for each message.

Authorization

This operation will require the application obtain authorization using one of the following custom scopes based on SMART.

v1: [patient|user|system]/Messaging.[write|*]
v2: To be determined. (future)

Parameters

Use	Name	Cardinality	Type	Documentation
IN	content	1..1	Bundle	The request message to process.
IN	async	0..1	boolean	If `true` the message is process using asynchronous messaging pattern. None of our supported message types currently support the asynchronous message pattern.
IN	content	0..1	url	A URL to submit response messages to, if asynchronous messaging is being used, and if the MessageHeader.source.endpoint is not the appropriate place to submit responses. This is not currently supported by any of our existing message types.
OUT	return	0..1	Bundle	The response message returned directly as a resource.

Supported Message Events

Netsmart-defined Message Events

All Netsmart-defined messaging events use the following system: http://ntst.com/fhir/message-events.

Name	Type	Description	Supported CareRecord(s) and/or other Solutions
Submit Service Request	`submit-service-request`	Enables the submission of referrals ("Service Requests") to Referral Manager.	Referral Manager
Update Service Request	`update-service-request`	Enables the update of previously referrals ("Service Requests") to Referral Manager.	Referral Manager

Examples

Production
Preview

curl -X POST 'https://fhir.netsmartcloud.com/v4/$process-message' \
    -H "Authorization: {Bearer Token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d @payload.json

curl -X POST 'https://fhirtest.netsmartcloud.com/v4/$process-message' \
    -H "Authorization: {Bearer Token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d @payload.json

Workflow​

Authorization​

Parameters​

Supported Message Events​

Netsmart-defined Message Events​

Examples​