V2

SAP S/4HANA

Provides integration with SAP S/4HANA OData APIs to interact with business objects such as business partners, sales orders, and materials. Operations are generated from the bundled OpenAPI metadata for supported SAP services.

Revision History

1.0.0.4 - 2025/12/10 - Initial release.
1.0.0.10 - 2026/01/26 - Changed template key format for AI system.

Setup Notes

  • Ensure the target OData services (for example: API_BUSINESS_PARTNER, API_SALES_ORDER_SRV) are activated and reachable through the SAP Gateway.
  • Coordinate with the SAP BASIS team to whitelist Flowgear IP addresses and issue a technical user with permissions for the selected services.
  • Confirm HTTPS access to the Gateway host and port, and verify that CSRF token requests are allowed for POST/PUT/PATCH/DELETE operations.

Connection

Parameter Type Description
Host String Host name or IP address of the SAP S/4HANA instance (for example: s4hana.example.com).
Port String HTTPS port exposed by the SAP Gateway.
Username String SAP technical or dialog user used for basic authentication.
Password Masked Password associated with the SAP user.
Timeout (seconds) Integer Request timeout for SAP calls.
Exclude Empty Query Parameters Boolean When true, omits query parameters with empty values from requests.

Functions

Query

Executes GET operations for the selected SAP service using the generated OpenAPI templates.

Parameter Type Notes
Connection Connection SAP connection profile containing host, port, and credentials.
Service String SAP service key (for example: API_BUSINESS_PARTNER, API_SALES_ORDER_SRV).
OperationId String Operation identifier from the chosen query template.
Parameters Dictionary<string, object> Route or query parameters applied to the request (keys align to the template).
Body IAsyncEnumerable Optional payload; normally omitted for GET requests.
Return Type Notes
Response IAsyncEnumerable Streamed SAP responses; each item reflects the selected operation’s response schema.

Create

Executes POST operations against the chosen SAP service.

Parameter Type Notes
Connection Connection SAP connection profile containing host, port, and credentials.
Service String SAP service key (for example: API_BUSINESS_PARTNER, API_SALES_ORDER_SRV).
OperationId String Operation identifier from the create template.
Parameters Dictionary<string, object> Route or query parameters applied to the request.
Body IAsyncEnumerable Stream of request payloads to create records; each item is sent as a separate call.
Return Type Notes
Response IAsyncEnumerable Item-wise responses from SAP, including any returned keys or error payloads.

Update

Executes PUT or PATCH operations for existing SAP records.

Parameter Type Notes
Connection Connection SAP connection profile containing host, port, and credentials.
Service String SAP service key (for example: API_BUSINESS_PARTNER, API_SALES_ORDER_SRV).
OperationId String Operation identifier from the update template.
Parameters Dictionary<string, object> Route or query parameters applied to the request (for example: keys in the URL).
Body IAsyncEnumerable Stream of payloads representing updates; each item is sent as a separate call.
Return Type Notes
Response IAsyncEnumerable Item-wise responses from SAP, including any returned keys or error payloads.

Delete

Executes DELETE operations for existing SAP records.

Parameter Type Notes
Connection Connection SAP connection profile containing host, port, and credentials.
Service String SAP service key (for example: API_BUSINESS_PARTNER, API_SALES_ORDER_SRV).
OperationId String Operation identifier from the delete template.
Parameters Dictionary<string, object> Route or query parameters applied to the request (for example: keys in the URL).
Body IAsyncEnumerable Optional payload for delete operations that require a body; usually left empty.
Return Type Notes
Response IAsyncEnumerable Item-wise responses from SAP, including status and any returned identifiers.

Usage Notes

  • Use the template picker to select the correct service and operation; templates are organized by HTTP method to avoid method mismatches.
  • CSRF tokens are requested automatically for create, update, and delete operations; ensure the SAP Gateway permits token retrieval for the service.
  • Set Exclude Empty Query Parameters to true when your service rejects blank query values; set it to false when the service expects explicit empty strings.

Known Issues

  • CSRF token handling is automatic for mutating operations; ensure the target service supports standard SAP Gateway token retrieval.
  • Only basic authentication is supported; SAML or OAuth-based front ends are not handled by this node.