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

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:

1. 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.

2. 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.

3. Confirm

   A model step summarizes the created sales order, including its returned identifier, for the activity log.

Troubleshooting

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

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

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

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.

For issues common to every vendor, see the Actions overview.