SAP actions let an agent work with SAP S/4HANA data directly in a flow. An agent can create, update, read, list, and delete business partners, read materials, and manage purchase orders and sales orders, then pass the results to later steps.Documentation Index
Fetch the complete documentation index at: https://explore.airia.com/llms.txt
Use this file to discover all available pages before exploring further.
Supported actions
| Group | Actions |
|---|---|
| Business partner | Create, Update, Get, Get All, Delete |
| Material | Get, Get All |
| Purchase order | Create, Update, Get, Get All |
| Sales order | Create, Update, Get, Get All |
Prerequisites
Create an SAP credential
Create an SAP credential
Store your SAP API key as an SAP credential in Credential Management. Select that credential on every SAP action.
How to use these actions
- Every action needs your tenant Base URL. Supply the Base URL of your S/4HANA tenant, such as
https://tenant.s4hana.cloud.sap, on every action. - Map text inputs from earlier steps. Inputs such as identifiers and names accept a value mapped from a previous step.
- Paging numbers take fixed values. The Top and Skip numbers are entered as fixed values.
- Get All actions accept OData query options. Use Filter to narrow results, Top to limit the number returned, and Skip to page through results.
- Materials are read only. You can read materials with Get and Get All.
- Choose names by partner type. For a person business partner, provide a first and last name. For an organization, provide the organization name.
Actions
Business partner
SAP Business Partner Create
Creates a new business partner.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Business Partner Category | Yes | The partner category: 1 for an organization, 2 for a person. |
| First Name | No | The first name. Used for a person. |
| Last Name | No | The last name. Used for a person. |
| Organization Name | No | The organization name. Used for an organization. |
| Business Partner Grouping | No | The grouping code for number range assignment. |
SAP Business Partner Update
Updates an existing business partner.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Business Partner ID | Yes | The unique identifier of the business partner to update. |
| Search Term 1 | No | A search term for the business partner. |
| Business Partner Grouping | No | The grouping code for number range assignment. |
SAP Business Partner Get
Retrieves a business partner by ID.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Business Partner ID | Yes | The unique identifier of the business partner to retrieve. |
SAP Business Partner Get All
Lists business partners.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Top | No | Maximum number of records to return. A fixed number. |
| Skip | No | Number of records to skip for paging. A fixed number. |
| Filter | No | An OData filter expression to narrow results. |
SAP Business Partner Delete
Deletes a business partner.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Business Partner ID | Yes | The unique identifier of the business partner to delete. |
Material
SAP Material Get
Retrieves a material by ID.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Material ID | Yes | The product or material number. |
SAP Material Get All
Lists materials.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Top | No | Maximum number of records to return. A fixed number. |
| Skip | No | Number of records to skip for paging. A fixed number. |
| Filter | No | An OData filter expression to narrow results. |
Purchase order
SAP Purchase Order Create
Creates a new purchase order.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Purchase Order Type | Yes | The order type, such as NB for a standard order. |
| Purchasing Organization | Yes | The purchasing organization. |
| Purchasing Group | Yes | The purchasing group. |
| Company Code | Yes | The company code. |
| Supplier | Yes | The supplier or vendor number. |
SAP Purchase Order Update
Updates an existing purchase order.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Purchase Order ID | Yes | The unique identifier of the purchase order to update. |
| Payment Terms | No | The payment terms for the order. |
SAP Purchase Order Get
Retrieves a purchase order by ID.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Purchase Order ID | Yes | The unique identifier of the purchase order to retrieve. |
SAP Purchase Order Get All
Lists purchase orders.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Top | No | Maximum number of records to return. A fixed number. |
| Skip | No | Number of records to skip for paging. A fixed number. |
| Filter | No | An OData filter expression to narrow results. |
Sales order
SAP Sales Order Create
Creates a new sales order.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Sales Order Type | Yes | The order type, such as OR for a standard order. |
| Sales Organization | Yes | The sales organization. |
| Distribution Channel | Yes | The distribution channel. |
| Organization Division | Yes | The organization division. |
| Sold To Party | Yes | The sold to party number. |
| Purchase Order By Customer | No | The customer purchase order reference. |
SAP Sales Order Update
Updates an existing sales order.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Sales Order ID | Yes | The unique identifier of the sales order to update. |
| Purchase Order By Customer | No | The customer purchase order reference. |
SAP Sales Order Get
Retrieves a sales order by ID.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Sales Order ID | Yes | The unique identifier of the sales order to retrieve. |
SAP Sales Order Get All
Lists sales orders.| Input | Required | Description |
|---|---|---|
| Base URL | Yes | The base URL of your S/4HANA tenant, such as https://tenant.s4hana.cloud.sap. |
| Top | No | Maximum number of records to return. A fixed number. |
| Skip | No | Number of records to skip for paging. A fixed number. |
| Filter | No | An OData filter expression to narrow results. |
Example
An agent that creates a sales order for a known customer:Find the customer
A SAP Business Partner Get All action with a Filter locates the customer so a model step can confirm the Sold To Party number.
Create the sales order
A SAP Sales Order Create action sets the Base URL, Sales Order Type, Sales Organization, Distribution Channel, Organization Division, and the matched Sold To Party.
Troubleshooting
Authentication failed
Authentication failed
Confirm the stored API key is valid and has not been rolled, and that the Base URL points to the same tenant the key belongs to.
Invalid or missing Base URL
Invalid or missing Base URL
Every SAP action needs the Base URL of your S/4HANA tenant, such as
https://tenant.s4hana.cloud.sap. Confirm the value has no trailing path and is reachable.Entity not found
Entity not found
The Business Partner ID, Material ID, Purchase Order ID, or Sales Order ID does not exist in this tenant. Use a Get All action with a Filter to discover valid IDs.
Missing required fields on create
Missing required fields on create
Create actions require their organizational fields. For a business partner, set Business Partner Category and the matching name fields. For orders, set the order type and organization fields.