SAP S/4HANA Cloud Tool
Read SAP S/4HANA Cloud master data — business partners, sales orders, products — via the OData APIs.
Tool ID
s4hana-master-data
Credential Required
Yes — a server-refreshed oauth credential (auth mode oauth_user). The InTouch server resolves and refreshes the linked OAuth credential and hands the tool a live access token; the tool never refreshes or stores tokens itself. Requests are sent with Authorization: Bearer <access_token> to https://{host}/sap/opu/odata/sap (the S/4HANA Cloud API host comes from the task input, not the credential).
Credential Properties
| Property | Type | Default | Description |
|---|---|---|---|
client_id |
string | — | OAuth app client ID. |
client_secret |
string | — | OAuth app client secret (if required on refresh). |
token_url |
string | — | Provider OAuth token endpoint — used to refresh. |
access_token |
string | — | Required. Current access token — kept fresh by the server; do not edit by hand. |
refresh_token |
string | — | Refresh token; enables automatic server-side refresh. |
token_type |
string | Bearer |
Token type. |
scope |
string | — | Granted OAuth scopes (space-separated). |
expires_at |
string | — | Access-token expiry in epoch seconds (0 = non-expiring). |
Operations
1. list_business_partners — List business partners
Lists business partner master data. Calls GET /API_BUSINESS_PARTNER/A_BusinessPartner.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string | — | Required. list_business_partners |
host |
string | — | Required. S/4HANA Cloud API host, e.g. my300096-api.s4hana.ondemand.com (no scheme). |
query |
string | — | OData query params as a JSON object string. Pass {"$format": "json"} for JSON; also $top, $skip, $filter, $select. |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
2. get_business_partner — Get one business partner
Fetches a single business partner by key. Calls GET /API_BUSINESS_PARTNER/A_BusinessPartner('{bp}').
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string | — | Required. get_business_partner |
host |
string | — | Required. S/4HANA Cloud API host, e.g. my300096-api.s4hana.ondemand.com (no scheme). |
bp |
string | — | Required. BusinessPartner key. |
query |
string | — | OData query params as a JSON object string. Pass {"$format": "json"} for JSON. |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
3. list_sales_orders — List sales orders
Lists sales orders. Calls GET /API_SALES_ORDER_SRV/A_SalesOrder.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string | — | Required. list_sales_orders |
host |
string | — | Required. S/4HANA Cloud API host, e.g. my300096-api.s4hana.ondemand.com (no scheme). |
query |
string | — | OData query params as a JSON object string. Pass {"$format": "json"} for JSON; also $top, $skip, $filter, $select. |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
4. list_products — List products
Lists product master data. Calls GET /API_PRODUCT_SRV/A_Product.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string | — | Required. list_products |
host |
string | — | Required. S/4HANA Cloud API host, e.g. my300096-api.s4hana.ondemand.com (no scheme). |
query |
string | — | OData query params as a JSON object string. Pass {"$format": "json"} for JSON; also $top, $skip, $filter, $select. |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
License
This tool requires a per-tool connector license on Department and Enterprise editions (Personal, Solo, and Team editions are unaffected). Apply the license via the tool's Apply License action.
Self-Contained JAR
The jar bundles all runtime dependencies; only intouch-tool-api is provided by the server.
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
completeoperationresultstatuswarning