Access business partners, sales orders, purchase orders, materials, invoices, and financial data from SAP S/4HANA via OData APIs
The SAP S/4HANA integration connects your agents to SAP's OData APIs for managing business partners, sales orders, purchase orders, materials, stock, invoices, and financial data. Supports both on-premise and cloud editions.
You need:
- SAP S/4HANA System Base URL — The URL of your SAP S/4HANA system (e.g.,
https://my-s4hana.example.com).
- SAP Technical User Credentials — A technical user created via transaction SU01 with authorizations for the required OData services.
- Activated OData Services — The relevant OData services must be activated via
/IWFND/MAINT_SERVICE in your SAP system.
- Open Integrations from the sidebar
- Select SAP S/4HANA from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "SAP S/4HANA - Production")
- Enter the Base URL of your SAP S/4HANA system
- For authentication, enter your SAP technical username and password (Basic Auth)
- Save the config
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach SAP S/4HANA tools from the tools panel
- Tools are referenced as
sap_s4hana.get_sales_orders, sap_s4hana.create_business_partner, etc.
| Tool | Description | Action Type |
|---|
get_business_partners | List business partners (customers, suppliers) with OData filtering | ReadOnly |
get_business_partner | Get a specific business partner by ID | ReadOnly |
create_business_partner | Create a new business partner | Irreversible |
update_business_partner | Update an existing business partner | Reversible |
| Tool | Description | Action Type |
|---|
get_products | List products (materials) with OData filtering | ReadOnly |
get_product | Get a specific product by ID | ReadOnly |
get_material_stock | Get stock levels across plants and storage locations | ReadOnly |
| Tool | Description | Action Type |
|---|
get_sales_orders | List sales orders with OData filtering | ReadOnly |
get_sales_order | Get a specific sales order with item details | ReadOnly |
create_sales_order | Create a new sales order | Irreversible |
| Tool | Description | Action Type |
|---|
get_purchase_orders | List purchase orders with OData filtering | ReadOnly |
get_purchase_order | Get a specific purchase order with item details | ReadOnly |
create_purchase_order | Create a new purchase order | Irreversible |
| Tool | Description | Action Type |
|---|
get_billing_documents | List billing documents (customer invoices) | ReadOnly |
get_billing_document | Get a specific billing document with item details | ReadOnly |
get_supplier_invoices | List supplier invoices | ReadOnly |
create_supplier_invoice | Create a new supplier invoice | Irreversible |
| Tool | Description | Action Type |
|---|
get_journal_entries | List journal entry line items | ReadOnly |
get_cost_centers | List cost centers | ReadOnly |
get_profit_centers | List profit centers | ReadOnly |
