> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # SAP S/4HANA Cloud > **This Connector is in Beta** > > Merge has validated SAP S/4HANA Cloud against the provider's documented API and not yet verified it against the live one, so its behavior can differ from the documentation. It carries the same tool surface it will have at general availability. [Connectors overview](/merge-agent-handler/connectors/overview) covers the tier and how to turn Beta Connectors off. **Authentication:** Communication user (username and password). See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * Find the business partner for `Acme Corp` and list its addresses * List open purchase orders for supplier `100045` with their delivery dates * Create a sales order for customer `1000123` with two material line items ## Available Tools #### create_business_partner Create a business partner. BusinessPartnerCategory is required ('1' person, '2' organization, '3' group). Returns the... #### create_business_partner_address Add an address to a business partner. BusinessPartner is required. Use list_business_partners to find numbers. Return... #### create_product Create a product. Product, ProductType (FERT/HALB/ROH/HAWA) and BaseUnit are required. Returns the created product. #### create_purchase_order Create a purchase order. PurchaseOrderType, CompanyCode, PurchasingOrganization, PurchasingGroup and Supplier are req... #### create_purchase_order_item Add a line item to a purchase order. PurchaseOrder, Material and Plant are required. Use list_purchase_orders for Pur... #### create_sales_order Create a sales order. SalesOrderType, SalesOrganization, DistributionChannel, OrganizationDivision and SoldToParty ar... #### create_sales_order_item Add a line item to a sales order. SalesOrder and Material are required. Use list_sales_orders for SalesOrder and list... #### create_supplier_invoice Create a supplier invoice. CompanyCode, DocumentDate, PostingDate, InvoicingParty, DocumentCurrency and InvoiceGrossA... #### get_business_partner Get a single business partner by its BusinessPartner number. Use list_business_partners to find numbers. #### get_customer Get a single customer by its Customer number. Use list_customers to find numbers. #### get_journal_entry_item Get a single journal entry line item by its five-part composite key (SourceLedger, CompanyCode, FiscalYear, Accountin... #### get_product Get a single product by its Product number. Use list_products to find numbers. #### get_purchase_order Get a single purchase order by its PurchaseOrder number. Use list_purchase_orders to find numbers. #### get_purchase_order_item Get a single purchase order item by its composite key (PurchaseOrder + PurchaseOrderItem). Use list_purchase_order_it... #### get_sales_order Get a single sales order by its SalesOrder number. Use list_sales_orders to find numbers. #### get_sales_order_item Get a single sales order item by its composite key (SalesOrder + SalesOrderItem). Use list_sales_order_items to find... #### get_supplier Get a single supplier by its Supplier number. Use list_suppliers to find numbers. #### get_supplier_invoice Get a single supplier invoice by its composite key (SupplierInvoice + FiscalYear). Use list_supplier_invoices to find... #### list_business_partner_addresses List business partner addresses with pagination. Filter by business_partner to get one partner's addresses, or use OD... #### list_business_partners List business partners (companies and people) with pagination and optional OData $filter, $orderby and \$select. Use t... #### list_customers List customers with pagination and optional OData $filter, $orderby and \$select. Use this to discover Customer number... #### list_journal_entry_items List journal entry (G/L) line items with pagination. Filter by company_code and/or fiscal_year, or use OData \$filter/... #### list_product_descriptions List product descriptions (language-specific texts) with pagination. Filter by product to get one product's descripti... #### list_products List products (materials) with pagination and optional OData $filter, $orderby and \$select. Use this to discover Prod... #### list_purchase_order_items List purchase order line items with pagination. Filter by purchase_order to get one order's items, or use OData \$filt... #### list_purchase_orders List purchase orders with pagination and optional OData $filter, $orderby and \$select. Use this to discover PurchaseO... #### list_sales_order_items List sales order line items with pagination. Filter by sales_order to get one order's items, or use OData $filter/$or... #### list_sales_orders List sales orders with pagination and optional OData $filter, $orderby and \$select. Use this to discover SalesOrder n... #### list_supplier_invoice_items List supplier invoice items (purchase-order reference lines) with pagination. Filter by supplier_invoice to get one i... #### list_supplier_invoices List supplier invoices with pagination and optional OData $filter, $orderby and \$select. Use this to discover Supplie... #### list_suppliers List suppliers (vendors) with pagination and optional OData $filter, $orderby and \$select. Use this to discover Suppl... #### update_business_partner Update fields of an existing business partner by BusinessPartner number. Use list_business_partners to find numbers. #### update_product Update fields of an existing product by Product number. Use list_products to find numbers. #### update_purchase_order Update header fields of an existing purchase order by PurchaseOrder number. Use list_purchase_orders to find numbers. #### update_purchase_order_item Update a purchase order item by its composite key (PurchaseOrder + PurchaseOrderItem). Use list_purchase_order_items... #### update_sales_order Update header fields of an existing sales order by SalesOrder number. Use list_sales_orders to find numbers. #### update_sales_order_item Update a sales order item by its composite key (SalesOrder + SalesOrderItem). Use list_sales_order_items to find item...