SAP S/4 HANA 云连接器

SAP S/4 HANA 云连接器

与 SAP S/4 HANA Cloud 的多个 API 集成

简介

SAP S/4HANA 是一个内置智能技术（包括人工智能、机器学习和高级分析）的企业资源规划（ERP）系统。该连接器的目标是使用 HTTP连接器将 SAP S/4 HANA Cloud Api 与 Tulip 结合使用，并为客户提供一个开箱即用的连接器，客户可将其导入其实例，以充分利用 SAP S/4 HANA Cloud 提供的功能。

目的

1. 我们将重点介绍不同的 HTTP 连接器功能，这些功能可通过 HTTP 调用 SAP S/4 HANA API 端点来构建，以便与 SAP S/4 Hana 提供的各种服务（如材料库存、计划订单、生产订单、材料计划和库存批次）进行交互。

API 文档

下面的链接将作为连接器中使用的 API 的指南。返回参数定义及其在模式中的部分信息也可在链接中找到

1. SAP S/4 Hana 演示应用程序
2. 材料库存 API
3. 物料计划数据 API
4. 计划订单 API
5. 生产订单 API
6. 检验批 API

前提条件

1. 创建 SAP 通用 ID。
2. 生成访问 SAP S/4 HANA API 的 API 密钥

Tulip 连接详细信息

需要在 Tulip 连接器上配置以下信息。

1. 运行于：云连接器主机
2. 主机：sandbox.api.sap.com
3. 端口:443
4. TLS:Yes
5. 基本身份验证：API 密钥将用于验证来自连接器的 API 调用

连接器功能

材料库存 API

材料库存 API

目的

该连接器的目的是获取系统中可用的所有材料及其 UOM。响应将是一个对象数组，每个对象存储材料 ID 和 UOM。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_MATERIAL_STOCK_SRV/A_MaterialStock

所需输入

以下是作为请求体发送的参数

1. $top - 连接器设置的查询参数，默认设置为 25

输出提取器

材料详细信息数组

1. 材料 - ID
2. MaterialBaseUnit - 材料的 UOM

Material_Stock_API_Material_Stock_in_Account_Model

目的

该连接器的目的是获取账户模型中已发布特定库存的物料库存。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_MATERIAL_STOCK_SRV/A_MatlStkInAcctMod

所需输入

以下是作为查询参数发送的参数

1. $top - 连接器设置的查询参数，默认设置为 50

输出提取器

材料详细信息数组，包含库存

1. __metadata.id
2. __metadata.uri
3. 材料
4. 工厂
5. 存储位置
6. 批次
7. 供应商
8. 客户
9. WBSElementInternalID

Material_Stock_API_Material_Stock_in_Account_Model

目的

该连接器的目的是获取由所提供的 ID 标识的材料的所有库存详细信息，该连接器还返回材料的基本信息。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_MATERIAL_STOCK_SRV/A_MaterialStock('$Material$)

所需输入

以下是作为查询参数发送的参数

1. 材料：材料 ID

输出提取器

1. 材料
2. 材料基础单位

材料库存详细信息数组

1. __metadata.uriMaterial
2. 工厂
3. 存储位置
4. 批次
5. 供应商
6. 客户
7. WBSElementInternalID
8. SDDocument
9. SDDocumetnItem
10. 特殊库存类型
11. 库存类型
12. MatlWrhsStkQTYInMatBaseUnit - 以材料基本单位表示的材料仓库库存数量

材料规划数据 API

Material_Planning_Data_API_MRP_Material

目的

该连接器的目的是获取材料需求计划中使用的材料的所有详细信息，连接器会返回许多响应参数，我们在文档中强调了其中几个。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_MRP_MATERIALS_SRV_01/A_MRPMaterial

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25

输出提取器

材料工厂详细信息数组--下面突出显示了其中几个参数，连接器返回的许多参数可根据特定用例使用。其中一些参数是

1. 材料
2. MRPPlant
3. MRPA 区域
4. 材料名称
5. MRPAreaText
6. MRPAreaCategory
7. MRPAreaCategoryName
8. 材料组
9. 交叉植物状态
10. 交叉植物状态名称
11. 基本单位
12. 测量单位名称
13. 低级代码
14. 采购组
15. 采购组名称

材料规划_数据_API_供需

目的

该连接器的目的是获取一定时间段内物料需求计划（MRP）中物料供需信息的所有详细信息。连接器会返回许多响应参数，我们在文档中重点介绍了其中几个。

端点

对端点的 HTTP GET 调用https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_MRP_MATERIALS_SRV_01/SupplyDemandItems

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25
2. filterField ：要搜索的过滤器名称
3. FilterCondition（过滤条件）：允许值为 eq（相等）和 ne（不相等）
4. filterValue：匹配值：匹配值 - 您可以根据指定列中的值进行筛选

输出提取器

材料供求信息数组 - 响应参数突出显示如下。

1. 材料
2. MRPPlant
3. MRPA 区域
4. 测量单位名称
5. MRPC 控制器
6. MRPPlanningSegmentType
7. 材料短缺概况
8. 收货类别组
9. 材料基本单位
10. 测量单位文本
11. 材料外部 ID
12. MRPA 可用性
13. 材料安全库存数量
14. MRPE 元素打开数量
15. 可用数量
16. MRPE 元件类别
17. MRPE 元件类别短名
18. MRPE 元件类别名称
19. 生产版本

计划订单 API

Planned_Order_API_Planned_Order

目的

该连接器的目的是获取现有计划订单标题数据的可用信息。该连接器会返回许多响应参数，我们已突出显示了可用作 PlannedOrder 等其他连接器输入的参数。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25

输出提取器

计划订单信息数组 - 响应参数突出显示如下。

1. 计划订单
2. 计划订单类型
3. 计划订单配置文件
4. 材料
5. 材料名称
6. 生产工厂
7. MRPPlant
8. MRPA 区域
9. 生产版本
10. 材料采购类别
11. 材料采购类型
12. PlndOrderPlannedStartDate 计划开始日期
13. PlndOrderPlannedStartTime 计划开始时间
14. PlndOrderPlannedEndDate 计划结束日期
15. 计划结束时间
16. 计划订单开启日期
17. 最后更改日期时间
18. 生产开始日期
19. 生产结束日期

Planned_Order_API_Planned_Order_by_Id

目的

该连接器的目的是获取由 PlannedOrder 标识的现有计划订单的标题数据信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据特定用例使用所需的参数

端点

对端点的 HTTP GET 调用https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder('$PlannedOrder$')

所需输入

以下参数将作为查询参数（URL 参数）发送

1. $top 默认值设置为 25
2. 计划订单

输出提取器

计划订单信息对象 - 响应参数如下所示。

1. 计划订单
2. 计划订单类型
3. 计划订单配置文件
4. 材料
5. 材料名称
6. 生产工厂
7. MRPPlant
8. MRPA 区域
9. 生产版本
10. 材料采购类别
11. 材料采购类型
12. PlndOrderPlannedStartDate 计划开始日期
13. PlndOrderPlannedStartTime 计划开始时间
14. PlndOrderPlannedEndDate 计划结束日期
15. 计划结束时间
16. 计划订单开启日期
17. 最后更改日期时间
18. 生产开始日期
19. 生产结束日期

Planned_Order_API_Planned_Order_Capacity_By_Id

目的

该连接器的目的是获取使用计划订单号指定的属于订单的容量数据信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder('$PlannedOrder$')/to_PlannedOrderCapacity

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设为 25
2. 计划订单

输出提取器

计划订单的容量信息数组 - 响应参数突出显示如下。

1. 容量要求
2. 容量要求项目
3. 容量要求项目容量
4. 计划订单
5. 计划订单类型
6. 序列
7. 操作
8. 子操作
9. 工作中心
10. 能力类别代码
11. 容量
12. MRPController
13. MRPPlant

Planned_Order_API_Planned_Order_Capacity_by_PlannedOrder_And_Filters

目的

该连接器的目的是获取单个容量项目的容量信息，您可以使用容量需求 ID、容量需求项目和项目容量来指定单个容量项目。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点[https://sandbox.api.sap.com/s4hanacloud/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder('$PlannedOrder$')/A_PlannedOrderCapacity(CapacityRequirement='{CapacityRequirement}',CapacityRequirementItem='{CapacityRequirementItem}',CapacityRqmtItemCapacity='{CapacityRqmtItemCapacity}](https://sandbox.api.sap.com/s4hanacloud/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder( "%24PlannedOrder%24%E2%80%99)/A_PlannedOrderCapacity(CapacityRequirement='%7BCapacityRequirement%7D',CapacityRequirementItem='%7BCapacityRequirementItem%7D',CapacityRqmtItemCapacity='%7BCapacityRqmtItemCapacity%7D")'))

所需输入

以下是发送的查询参数

1. $top 默认值设置为 25
2. 计划订单
3. 容量要求
4. 容量要求项目
5. 容量查询项容量

输出提取器

计划订单的容量信息数组 - 响应参数突出显示在下面。

1. 容量要求
2. 产能要求项
3. CapacityRqmtItemCapacity
4. 计划订单
5. 计划订单类型
6. 序列
7. 操作
8. 子操作
9. 工作中心
10. 能力类别代码
11. 容量
12. MRPController
13. MRPPlant

Planned_Order_API_Planned_Order_Components_by_PlannedOrder_Id

目的

该连接器的目的是获取使用计划订单号指定的订单所属组件的信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder('{PlannedOrder}')/too_PlannedOrderComponent/too_PlannedOrderComponent](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder( "%7BPlannedOrder%7D"))

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25
2. 计划订单

输出提取器

属于订单的组件数组 - 响应参数突出显示如下。

1. 预订
2. 预订项目
3. 计划订单
4. BOMItem
5. 物料清单项目描述
6. 物料清单类别
7. 排序字段
8. 物料清单类别
9. 材料
10. 材料要求日期
11. 货物移动条目数量
12. 输入单位
13. 要求数量
14. 基本单位
15. 撤回数量
16. 材料组件是幻影项目
17. 工厂
18. 储存地点
19. 供应区域

计划订单_API_Planned_Order_Components_by_PlannedOrder_and_Filters（按计划订单和过滤器分类的计划订单组件

目的

该连接器的目的是获取使用预订编号和预订项目编号指定的单个计划订单组件的数据。连接器中有许多可用的响应参数，我们已在文档中强调了所有这些参数。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder('{PlannedOrder}')/to_PlannedOrderComponent(Reservation='{Reservation}',ReservationItem='{ReservationItem}')](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PLANNED_ORDERS/A_PlannedOrder( "%7BPlannedOrder%7D")/to_PlannedOrderComponent(Reservation='%7BReservation%7D',ReservationItem='%7BReservationItem%7D'))

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25
2. 计划订单
3. 预订
4. 预订项目

输出提取器

属于订单的组件对象 - 响应参数如下所示。

1. 预订
2. 预订项
3. 计划订单
4. BOMItem
5. 物料清单项目描述
6. 物料清单类别
7. 排序字段
8. 物料清单类别
9. 材料
10. 材料要求日期
11. 货物移动条目数量
12. 输入单位
13. 要求数量
14. 基本单位
15. 撤回数量
16. 材料组件是幻影项目
17. 工厂
18. 储存地点
19. 供应区

生产订单 API

生产订单 API

目的

该连接器的目的是获取现有生产订单标题数据的可用信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25

输出提取器

生产订单参数数组 - 响应参数突出显示如下。

1. 生产订单
2. 生产订单类别
3. 生产订单类型
4. 订单重要性
5. 订单创建
6. 订单已发布
7. 订单已打印
8. 订单确认
9. 订单关闭
10. 订单已部分交付
11. 订单已标记为删除
12. 订单创建日期
13. 订单创建时间
14. 最后更改日期时间
15. 工厂
16. MRPA 区域
17. MRPC 控制器
18. 生产主管
19. 生产版本
20. 计划订单
21. 订单计划开始日期
22. 计划开始时间

Production_Order_API_Production_Order_by_Manufacturing_Order

目的

该连接器的目的是获取使用生产订单号指定的特定生产订单的信息。连接器中有许多可用的响应参数，我们在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

对端点的 HTTP GET 调用[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2('{ManufacturingOrder}')](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2( "%7BManufacturingOrder%7D"))

所需输入

以下是作为查询参数发送的参数

1. 制造订单

输出提取器

生产订单参数对象 - 部分响应参数突出显示如下。

1. 生产订单
2. 制造订单类别
3. 订单类型
4. 订单重要性
5. 订单创建
6. 订单已发布
7. 订单已打印
8. 订单确认
9. 订单关闭
10. 订单已部分交付
11. 订单已标记为删除
12. 订单创建日期
13. 订单创建时间
14. 最后更改日期时间
15. 材料
16. 订单计划开始日期
17. 订单计划开始时间
18. 订单计划结束日期
19. 生产订单计划结束时间

Production_Order_API_Production_Order_by_Manufacturing_Order_Component

目的

该连接器的目的是获取使用生产订单号指定的订单所属组件的信息。连接器中有许多可用的响应参数，我们已在文档中强调了所有这些参数。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2('{ManufacturingOrder}')/too_ProductionOrderComponent/too_ProductionOrderComponent](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2( "%7BManufacturingOrder%7D"))

所需输入

以下是作为请求正文发送的参数

1. $top 默认值设置为 25
2. 生产订单

输出提取器

生产订单组件参数数组--部分响应参数突出显示如下。

1. 预订
2. 预订项目
3. 物料组
4. 材料
5. 工厂
6. 制造订单类别
7. 制造订单类型
8. 制造订单
9. 制造订单序列
10. 制造订单操作
11. 生产工厂
12. 订单内部作业清单
13. 材料要求日期
14. 材料需求时间
15. 物料清单类别
16. 物料清单项目
17. 物料清单项目类别
18. 物料清单项目编号
19. 物料清单项目描述
20. 存储位置

Production_Order_API_Production_Order_by_Manufacturing_Order_Items

目的

该连接器的目的是获取使用生产订单号指定的订单所属项目的信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2('{ManufacturingOrder}')/too_ProductionOrderItem/too_ProductionOrderItem](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2( "%7BManufacturingOrder%7D"))

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25
2. 生产订单

输出提取器

生产订单的项目参数数组 - 部分响应参数突出显示如下。

1. 生产订单
2. 生产订单项目
3. 生产订单类别
4. 生产订单类型
5. 是否完全交付
6. 材料
7. 生产工厂
8. 工厂
9. MRPA 区域
10. 订单项目最后交货日期
11. 订单项目实际交货日期
12. 生产单位
13. 订单项目计划总数量
14. 制造订单项目计划废料数量
15. 制造订单项目货物收据数量
16. 订单项目实际偏差数量

Production_Prder_API_Production_Order_by_Manufacturing_Order_Operation

目的

该连接器的目的是获取属于使用生产订单号指定的订单的操作信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2('{ManufacturingOrder}')/too_ProductionOrderOperation/too_ProductionOrderOperation](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2( "%7BManufacturingOrder%7D"))

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设为 25
2. 生产订单

输出提取器

生产订单的操作参数数组 - 部分响应参数突出显示如下。

1. 订单内部操作清单
2. OrderIntBillOfOperationsItem
3. 生产订单
4. 生产订单序列
5. 制造订单操作
6. 制造订单子操作
7. 制造订单类别
8. 制造订单类型
9. 生产工厂
10. 工作中心内部 ID
11. 工作中心类型代码
12. 工作中心

Production_Order_API_Production_Order_by_Manufacturing_Order_Status

目的

该连接器的目的是获取使用生产订单号指定的订单的状态信息。连接器中有许多可用的响应参数，我们在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点[https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2('{ManufacturingOrder}')/too_ProductionOrderStatus/too_ProductionOrderStatus](https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV/A_ProductionOrder_2( "%7BManufacturingOrder%7D"))

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25
2. 生产订单

输出提取器

生产订单状态数组 - 响应参数突出显示如下。

1. 生产订单
2. 状态代码
3. 是否用户状态
4. 状态短名
5. 状态名称

检测数据 API

Inspection_Lot_API_Inspection_Lot_Data

目的

该连接器的目的是获取检验批信息，并提供检验批标头级别的数据。连接器中有许多可用的响应参数，我们在文档中重点介绍了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_INSPECTIONLOT_SRV/A_InspectionLot

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 50

输出提取器

检验批信息数组 - 响应参数突出显示如下。

1. 检验批
2. 材料
3. 批次
4. 工厂
5. 检验批原产地
6. 订单内部作业清单
7. 制造订单
8. 检验批文本
9. 检验批类型
10. 检验批数量
11. 检验批实际数量
12. 检验批缺陷数量
13. 检验批数量单位
14. InspLotCreatedOnLocalDate（地块在本地日期创建
15. InspSubsetFieldCombination 子集字段组合
16. 检验批NmbrOpenLongTermCharc
17. 状态对象
18. 状态对象类别
19. 检查地块对象文本
20. 状态配置文件

检测地块_API_检测地块_状态

目的

该连接器的目的是获取检验批状态信息，例如，是否确认了结果或记录了缺陷。连接器中有许多可用的响应参数，我们在文档中强调了其中几个。我们可以根据用例使用所需的参数。

端点

HTTP GET 调用端点https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_INSPECTIONLOT_SRV/A_InspectionLotWithStatus

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 50

输出提取器

检验批状态信息数组 - 响应参数突出显示如下。

检测批

1. 检测批状态创建
2. 检验批状态已发布
3. 检验批状态扫描
4. InspLotStatusRsltsConfirmed
5. 记录地块缺陷
6. InspLotStsShrtTrmInspCmpltd
7. 地块状态已完成
8. InspLotStatusCanceled
9. 地块状态维修

检查地段_API_按检查地段划分的检查地段状态

目的

该连接器的目的是获取特定检验批的检验批状态信息。连接器中有许多可用的响应参数，我们已在文档中强调了其中几个。我们可以根据具体用例使用所需的参数。

端点

对端点的 HTTP GET 调用https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_INSPECTIONLOT_SRV/A_InspectionLotWithStatus('{InspectionLot}')

所需输入

以下是作为查询参数发送的参数

1. $top 默认值设置为 25
2. 检测批次

输出提取器

检验批状态信息对象 - 响应参数如下所示。