ComponentsActions
SAP
Manage SAP S/4HANA business partners, materials, purchase orders, and sales orders from inside an agent workflow.
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.
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
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:
A SAP Business Partner Get All action with a Filter locates the customer so a model step can confirm the Sold To Party number.
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.
A model step summarizes the created sales order, including its returned identifier, for the activity log.
Troubleshooting
For issues common to every vendor, see the Actions overview.
Was this page helpful?