Skip to main content

SAP Integration Suite

Category: EHR & Practice Mgmt
Node id: sap-integration-suite

Standards: SOC2

Integrates with SAP Integration Suite (CPI/BTP) for message routing, iFlow execution, and message log retrieval

What it does​

  • SAP CPI/BTP iFlow message sending
  • Message processing log retrieval
  • iFlow deployment status monitoring
  • OAuth2 client credentials authentication
  • Custom header and content type support

Use cases​

  • Send messages to SAP Integration Suite iFlows
  • Monitor integration flow execution status and logs
  • Orchestrate SAP middleware in healthcare data pipelines

Runtime​

  • Performance tier: variable

Input ports​

NameTypeRequiredDescription
payloadjsonNoJSON payload for send_message operation
raw_payloadtextNoRaw text payload for send_message operation (e.g. XML, HL7)

Output ports​

NameTypeRequiredDescription
responsejsonNoResponse from iFlow execution
http_statusnumberNoHTTP status code
message_idtextNoSAP message processing log ID
content_typetextNoResponse content type
logsjsonNoMessage processing logs (get_message_logs)
iflow_statusjsonNoiFlow runtime artifact status (get_iflow_status)

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
iFlow URLiflow_urlstringYesURL of the SAP CPI iFlow endpoint
OperationoperationenumNosend_messagesend_message, get_message_logs, get_iflow_statusIntegration Suite operation to perform

Auth​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Auth Tokenauth_tokensecretNoBearer token for authentication (alternative to OAuth2)
Client IDclient_idstringNoOAuth2 client ID for token fetch
Client Secretclient_secretsecretNoOAuth2 client secret for token fetch
Token URLtoken_urlstringNoOAuth2 token endpoint URL

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Content Typecontent_typestringNoapplication/jsonContent-Type header for send_message
Custom Headerscustom_headersjsonNoAdditional HTTP headers as key-value pairs
Log LimittopnumberNo50min 1; max 1000Maximum number of message logs to retrieve

Errors​

CodeDescription
IFLOW_URL_REQUIREDiFlow endpoint URL must be configured
AUTH_FAILEDAuthentication to SAP CPI failed
SEND_FAILEDFailed to send message to iFlow
UNSUPPORTED_OPERATIONOperation not recognized

Runtime notes​

  • send_message outputs response, http_status, message_id, and content_type; logs and iflow_status are nil
  • OAuth2 token is auto-fetched when client_id, client_secret, and token_url are all set
  • If the iFlow returns non-JSON, the raw text is placed in response.raw_response
  • message_id is extracted from the SAP_MessageProcessingLogID response header

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Something unclear? Send documentation feedback by email.