SAP ECC Agent

15 min

With SAP ECC Agent modules in Make, you can manage the materials, purchase orders, purchase order items, purchase requisitions, purchase requisition items, sales orders, sales order items, deliveries, and outline agreements in your SAP Agent account.

The SAP ECC Agent app is available on the Make Enterprise plan.

To use the SAP ECC Agent modules, you must have SAP credentials and sufficient permissions for the SAP action you want to perform. For more information, see Required SAP permissions.

Additionally, you must do the following before you can connect the SAP ECC Agent app to Make.

Set up On-prem Agent (OPA) on Make.

Set up On-prem Agent (OPA) on your machine.

Set up On-prem Agent on Make

Your Make subscription needs to include On-prem Agent (OPA) to use this app.

Click Organization in the left sidenav and choose the On-prem Agents tab.

Click + Create a new on-prem agent

Enter a name for your On-prem agent and click Create Agent.

Store the Client ID, Client secret , and Base URL in a safe place. They will be used in a later step.

Check next to I saved my credentials and click Download Installer.

You will be redirected to the download page. Download the On-prem Agent client for your operating system. Choose Linux for macOS.

Set up On-prem Agent on your machine and then return to Make.

Click Detail on your newly created OPA in Make.

Click + Connected System. Input the connection information regarding your SAP instance.

For example:

Application Server Host	{host}.compute.amazonaws.com
System Number	00
Client	800

For more information about the On-prem Agent, please refer to Installing the On-prem AgentInstalling the On-prem Agent.

Set up On-prem Agent on your machine

To complete this setup, you need to be an SAP Service user (S User) that is authorized to download software from SAP portals. Usually the SAP BASIS has this access. Also, your machine must be able to connect to your SAP ECC instance.

For Mac and Linux

Unarchive the Installer that you downloaded when setting up OPA on Make.

Open application-local.yml, replace the CHANGE_THIS with your credentials and ignore all other options.

Download the JCO connector suitable for your operating system.

Unarchive it and copy only libsapjco3.dylib / libsapjco3.so and sapjco3.jar to the jco folder under the installation path.

Use your preferred package manager or any other way to have the Java Runtime (at least version 11) installed. On macOS you can use Homebrew.

In the installation folder, run java -jar agent.jar. Do not close the terminal.

For Windows

Install Java, if you haven't installed.

Unarchive the Installer that you downloaded when setting up OPA on Make.

Run the unarchived “Make_Agent_Installer.exe”.

Provide your client credentials (the Client ID, Client secret, and BASE URL) during installation.

Download the SAP Java Connector and choose your operating system. You need at least version 3.1.

Unarchive it and copy only sapjco3.dll and sapjco3.jar to the jco folder under the installation path C:\Program Files\Make Agent. Stop the service in the task manager (Ctrl + Alt + Del) if you cannot overwrite existing files. The service name is make-agent.

Restart the machine. On-prem Agent should run as a service in the background on system startup. If not, check the make-agent service in task manager to see if its status is Running.

Connect SAP ECC Agent to Make

To establish the connection in Make:

Optional: In the Connection name field, enter a name for the connection.

In the Connected System field, choose a connected system.

In the Username field, enter your SAP ECC username.

In the Password field, enter your SAP ECC password.

Click Save.

If prompted, authenticate your account and confirm access.

You have successfully established the connection. You can now edit your scenario and add more SAP ECC Agent modules. If your connection requires reauthorization at any point, follow the connection renewal steps herehere.

Required SAP permissions

Each SAP ECC Agent module calls a specific function module in your SAP system. Your SAP user account needs RFC authorization for that function module, in addition to valid SAP credentials.

SAP controls this access through the S_RFC authorization object, which checks the function group (RFC_TYPE: FUGR), the function module name (RFC_NAME), and the execute activity (ACTVT: 16). Ask your SAP Basis administrator to grant authorization for the function modules used by the SAP ECC Agent modules in your scenario.

For example, SAP ECC Agent > Get sales order details requires authorization for the following function modules:

Function module	Purpose
BAPISDORDER_GETDETAILEDLIST	Retrieves the sales order details.
SYSTEM_RESET_RFC_SERVER	Resets the RFC server session after the call completes.

Required function modules vary by SAP ECC Agent module. If a module run fails with a permission error, ask your SAP Basis administrator to run an SU53 authorization check in SAP and grant the missing authorization object.

Modules

Each SAP ECC Agent module below lists its configuration fields. Field names and behavior may vary slightly depending on your SAP ECC Agent connection and the data in your SAP system.

Get Material Availability

Retrieves material availability.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you want to enable the custom error handling for the material.
Action	Select (map) the action to retrieve the details.
Plant	Enter (map) the plant or unit name to which the material belongs to.
Material Number	Enter (map) the material number whose details you want to retrieve.
Unit of Measure for Display	Enter (map) the units to measure the materials. You can enter a three-character unit.

Corresponding BAPI call: BAPI_MATERIAL_AVAILABILITY

Change Material

Modifies an existing material's data.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for the material.
Action	Select (map) the action you want to perform with the material.
Material Number	Select (map) the Material Number.
Cross-Distribution Chain Status	Enter (map) the new cross-distribution chain status and the date from which the new status should be valid.
Cross-Plant Specific Status	Enter (map) the new cross-plant specific status and the date from which the new status should be valid.
Goods Receipt Processing Time	Enter (map) the plant for which you want to adjust the goods receipt processing time, e.g. 1000, and enter the new GR processing time (in days), e.g. 2.
In-House Production Time	Enter (map) the plant for which you want to adjust the in-house production time, e.g. 1000, and enter the new in-house production time (in days), e.g. 2.
Material Status (plant-specific)	Enter (map) the plant, e.g. 1000, and enter the new plant specific status, e.g. OB.
Minimum Lot Size	Enter (map) the plant, e.g. 1000, the new MRP type, e.g. PD for MRP, and the new minimum lot size value, e.g. 10.
MRP Type	Enter (map) the plant, e.g. 1000, and the new MRP type, e.g. ND for no planning.
Planned Delivery Time	Enter (map) the plant, e.g. 1000, and the new planned delivery time (in days), e.g. 14.
Reorder Point	Enter (map) the plant, e.g. 1000, and the new reorder point, e.g. 29.
Safety Stock	Enter (map) the plant, e.g. 1000, and the new safety stock, e.g. 28.

Corresponding BAPI call: BAPI_MATERIAL_SAVEDATA

Change Purchase Order

Modifies a purchase order.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing order.
Action	Select or map the action you want to perform with the purchase order.
Purchasing Document Number	Select or map the Purchase Document Number.
Currency Key	Enter (map) the currency key you want to apply to the purchase order.
Text Line	Add the text line items for the purchase order.
Terms of Payment Key	Enter (map) the payment key for the purchase order.

Corresponding BAPI call: BAPI_PO_CHANGE

Add Purchase Order Item

Adds a purchase order item to a purchase order.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing order.
Action	Select or map the action you want to perform with the purchase order.
Purchasing Document Number	Select or map the Purchase Document Number.
Purchase Order Item Number	Enter the number of the item you want to add, e.g. 00070.
Material Number	Enter the material number for the new item, e.g. CONTROLLER-2.
Plant	Enter the plant for the new item, e.g. 1100.
Storage Location	Enter the storage location for the new item, e.g. 0001.
Quantity	Enter the quantity for the new item, e.g. 50.
Item Category	Enter the item category for the new item, e.g. 0.

Corresponding BAPI call: BAPI_PO_CHANGE

Change Purchase Order Item(s)

Modifies a purchase order item.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing order item.
Action	Select the action for changing a purchase order item.
Purchasing Document Number	Select or map the Purchase Document Number.
Complete Delivery Indicator	Enter the item number, e.g. 00010, then mark or unmark the item as a Complete Delivery.
Delivery Address	Enter the item number, e.g. 00010, and the new delivery address for the item.
Delivery Date	Enter the item number, e.g. 00010, and the new delivery date for the item.
Material Group	Enter the item number, e.g. 00010, and the material group for the item, e.g. 101.
Material Number	Enter the item number, e.g. 00010, and the material number for the item, e.g. M-777.
OLA Number	Enter the item number, e.g. 00010, the new outline agreement number, e.g. 4600000039, and the new outline agreement item, e.g. 00020.
Price	Enter the item number, e.g. 00010, and the new price for the item, e.g. 150.
Quantity	Enter the item number, e.g. 00010, and the new quantity for the item, e.g. 10000.
Schedule Line (Date)	Enter the item number, e.g. 00010, the schedule line number, e.g. 0002, and the new delivery date for the schedule line.
Schedule Line (Quantity)	Enter the item number, e.g. 00010, the schedule line number, e.g. 0002, and the new quantity for the schedule line, e.g. 15000.
Short Text	Enter the item number, e.g. 00010, and the new short text, e.g. New text.
Supplier Material Number	Enter the item number, e.g. 00010, and the new supplier material number, e.g. CEB-431.
Tax Code	Enter the item number, e.g. 00010, and the new tax code for the item, e.g. I0.

Corresponding BAPI call: BAPI_PO_CHANGE

Delete Purchase Order Item

Deletes a purchase order item.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing order item.
Action	Select or map the action to choose the purchase order item you want to delete.
Purchasing Document Number	Select or map the Purchase Document Number where you want to delete an item.
Purchase Order Item Number	Select or map the Purchase Order Item Number of the item to be deleted.

Corresponding BAPI call: BAPI_PO_CHANGE

Revoke Purchase Order Item Deletion

Revokes the deletion of a purchase order item.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing order item.
Action	Select or map the action to choose the purchase order item you want to revoke the deletion.
Purchasing Document Number	Enter or map the number of the purchase order, e.g. 0000019646.
Purchase Order Item Number	Enter the item number of the item for which you want to revoke the deletion, e.g. 00010.

Corresponding BAPI call: BAPI_PO_CHANGE

Create Purchase Requisition

Creates a purchase requisition.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing requisition.
Material Number	Add the material number for which you want to create the purchasing requisition.
Plant	Add the plant details to which the material belongs to.
Purchase Requisition Quantity	Add the number of items for which you are creating the purchase requisition.

Corresponding BAPI call: BAPI_PR_CREATE

Change Purchase Requisition

Modifies a purchase requisition.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing requisition.
Action	Select the action to modify the purchase requisition.
Purchase Requisition Number	Enter (map) the purchase requisition number you want to modify.
Header Text	Add the new text lines for the purchase requisition. For example, new items to add.

Corresponding BAPI call: BAPI_PR_CHANGE

Add Purchase Requisition Item

Adds a purchase requisition item to a purchase requisition.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing order.
Action	Select or map the action you want to perform with the purchase order.
Purchase Requisition Number	Enter the number of the purchase requisition you want to add an item to, e.g. 0005000100.
Purchase Requisition Item Number	Enter the number of the item you want to add.
Purchasing Group	Enter the requested purchasing group, e.g. 001.
Material Number	Enter the requested material number, e.g. M-777.
Plant	Enter the requested plant, e.g. 1000.
Purchase Requisition Quantity	Enter the requested quantity, e.g. 100.

Corresponding BAPI call: BAPI_PR_CHANGE

Change Purchase Requisition Item (s)

Modifies a purchase requisition item.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing requisition item.
Action	Select or map the actions you want to change in the purchase requisition item.
Purchase Requisition Number	Enter the number of the purchase requisition you want to change, e.g. 0005000100.
Item Number of Purchase Requisition	Enter the number of the item for which you want to make changes, e.g. 00010.
Currency	Enter the new currency key, e.g. EUR.
Delivery Address	Enter the new address number for your delivery, e.g. 44721.
Delivery Date	Enter the new delivery date for the item.
Desired Vendor	Enter the new value for the desired vendor, e.g. 0000003701.
Fixed Vendor	Enter the new fixed vendor for the item, e.g. UT-SUPPLY.
Material Group	Enter the new material group for the item, e.g. 002.
Material Number	Enter the new material number for the item, e.g. M-777.
OLA	Enter the new outline agreement number, e.g. 4600000039, and the new outline agreement item, e.g. 00020.
Price	Enter the new price for the item.
Quantity	Enter the new quantity for the item.
Short Text	Enter the new short text, e.g. New text.
Supplier Material Number	Enter the new supplier material number.

Corresponding BAPI call: BAPI_PR_CHANGE

Delete Purchase Requisition Item

Deletes a purchase requisition item.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing requisition item.
Purchase Requisition Number	Enter the number of the purchase requisition for which you want to delete one or several items, e.g. 0000019082.
Purchase Requisition Item	Enter the item number of the item to be deleted, e.g. 00010.

Corresponding BAPI call: BAPI_PR_CHANGE

Revoke Purchase Requisition Item Deletion

Revokes the deletion of a purchase requisition item.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this purchasing requisition item.
Purchase Requisition Number	Enter the number of the purchase requisition for which you want to revoke the deletion of one or several items, e.g. 0000019082.
Item Number of Purchase Requisition	Enter the item number of the item for which you want to revoke the deletion, e.g. 00010.

Corresponding BAPI call: BAPI_PR_CHANGE

Get Sales Order Details

Retrieves sales order details.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Order Handling	Select whether you disable the custom error handling for this sales order.
Sales Document	Add the sales document numbers whose details you want to retrieve.

Corresponding BAPI call: BAPISDORDER_GETDETAILEDLIST

Create Sales Order

Creates a sales order.

Field	Description
Connection	Establish a connection to your SAP account.
Custom Error Handling	Select whether you disable the custom error handling for this sales order.
Sales Order Type	Enter the sales order type for the order to be created, e.g. OR for a standard order.
Sales Organization	Enter the sales organization for the order to be created, e.g. 1000.
Distribution Channel	Enter the distribution channel for the order to be created, e.g. 01 for general trade.
Division	Enter the division for the order to be created, e.g. 00.
Sold-to-Party	Enter the sold-to-party for the order to be created, e.g. 0000001000.
Sales Order Item	Enter the item number for the item to be created.
Material Number	Enter the requested material number, e.g. M-777.
Quantity	Enter the requested quantity, e.g. 100.

Corresponding BAPI call: BAPI_SALESORDER_CREATEFROMDAT2