**生产报工及冲销接口功能说明书**

**广联智通科技公司信息系统**

**开发功能说明书**

<table><tr><td><p><strong>信息系统</strong></p></td><td><p>☑MES ☑SAP </p></td></tr><tr><td><p><strong>功能名称</strong></p></td><td><p>生产报工创建+冲销接口</p></td></tr><tr><td><p><strong>开发类型</strong></p></td><td><p>□报表 □用户出口 ☑接口 □对话程序 □流程  </p><p>□表单</p></td></tr><tr><td><p><strong>开发记录号</strong></p></td><td></td></tr></table>

<a id="mpf3rr675bu5kc5ec6y"></a>
# 1. **创建修改记录（调整）**

<table><tr><td><p>作者</p></td><td><p>陈奕清</p></td></tr><tr><td><p>业务顾问</p></td><td><p>陈奕清</p></td></tr><tr><td><p>创建日期</p></td><td><p>20260605</p></td></tr><tr><td><p>最近修改日期</p></td><td></td></tr><tr><td><p>开发</p></td><td></td></tr><tr><td><p>备注</p></td><td></td></tr></table>

<a id="mpf3rr67h0nw9g19rcc"></a>
# 2. **文档变更（调整）**

<table><thead><tr><th><p><strong>版本号</strong></p></th><th><p><strong>修正日期</strong></p></th><th><p><strong>修改人</strong></p></th><th><p><strong>修正描述</strong></p></th><th><p><strong>备注</strong></p></th></tr></thead><tbody><tr><td><p>V1.0</p></td><td><p>20260605</p></td><td><p>陈奕清</p></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

<a id="mpf3rr68iokg4qaeu0a"></a>
# 3. **业务需求概述（调整）**

<table><tr><td><p>需求概述：</p></td><td colspan="3"><p>MES的实际生产报工数据推送给SAP执行报工</p><p>MES发现数据问题后，冲销已报工的数据并传输SAP</p></td></tr><tr><td><p>开发难度(高/中/低)：</p></td><td><p>低</p></td><td><p>事务代码：</p></td><td></td></tr><tr><td><p>运行类型(在线/批处理):</p></td><td><p>在线</p></td><td></td><td></td></tr><tr><td><p>交易量：</p></td><td colspan="3"><p>低</p></td></tr><tr><td><p>备注：</p></td><td colspan="3"></td></tr></table>

<a id="mpf3rr68q0hwkg1j705"></a>
## 3.1. **现有/样本报表**

<table><tr><td><p>现有报表名称：</p></td><td><p>N/A</p></td></tr><tr><td><p>系统菜单/交易代码：</p></td><td><p>N/A</p></td></tr></table>

<a id="mpf3rr688a9wookda0k"></a>
# 4. **功能规范**

<a id="mpf3rr68d3ixoh0xjyw"></a>
## 4.1. **程序开发优先级**

<table><tr><td><p><input/>高</p></td><td><p><input/>中</p></td><td><p><input/>低</p></td></tr></table>

<a id="mpf3rr693bz54oi4op8"></a>
## 4.2. **权限要求**

全员赋予流程入口权限

<a id="mpf3rr69p261canb4eq"></a>
## 4.3. **程序运行频率**

[请在此选择本程序的运行频率，并按照业务需要，说明具体的频率要求，例如，每日：具体到时；每周：具体到日和时；每月：具体到日和时；每年：具体到日和时]

<table><tr><td><p><input/>随时</p></td><td><p><input/>周</p></td><td><p><input/>月</p></td><td><p><input/>季</p></td><td><p><input/>年</p></td></tr></table>

<a id="mpf3rr69kzg4l07sj96"></a>
## 4.4. **屏幕设计及其布局**

无

<a id="mpf3rr69p5cen0pv6x4"></a>
## 4.5. **参数和选择条件**

<a id="mpf3rr69460312ud92a"></a>
### 4.5.1. **查询生产订单：**

<table><tr><td><p>方法</p></td><td><p>URL</p></td><td><p>认证方式</p></td></tr><tr><td><p>GET</p></td><td><p>https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV</p></td><td><p>Basic Auth</p></td></tr></table>

### 4.5.2. **创建生产报工：**

<table><tr><td><p>方法</p></td><td><p>URL</p></td><td><p>认证方式</p></td></tr><tr><td><p>Post</p></td><td><p>https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_PROD_ORDER_CONFIRMATION_2_SRV/ProdnOrdConf2?sap-language=zh </p></td><td><p>Basic Auth</p></td></tr></table>

<a id="mpf3rr69ary6x098b5k"></a>
### 4.5.3. **冲销生产报工：**

<table><tr><td><p>方法</p></td><td><p>URL</p></td><td><p>认证方式</p></td></tr><tr><td><p>POST</p></td><td><p>https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_PROD_ORDER_CONFIRMATION_2_SRV/CancelProdnOrdConf?sap-language=zh&amp;ConfirmationGroup='26'&amp;ConfirmationCount='5'&amp;PostingDate=datetime'2026-06-05T08:00:00' </p></td><td><p>Basic Auth</p></td></tr></table>

<a id="mpf3rr69kojq4ro85l9"></a>
## 4.6. **字段的定义**

[请在此处说明所涉及字段所对数据表及其字段名或结构及其字段名]

apipost导出接口数据，复制粘贴过来，或者引用aipost分享的地址

<a id="mpf3rr69qeb0sui0tx6"></a>
# 5. **程序输出格式**

<a id="mpf3rr69ofgj2od8r6n"></a>
## 5.1. **业务大概逻辑**

<a id="mpf3rr692xtajz3569e"></a>
## 5.2. **前台业务截图**

[请在此处附上前台业务的截图，并将所要取出的字段标记出来]

<a id="mpf3rr692rna8byv4ze"></a>
## 5.3. **传入传出的参数**

**［仅接口类型程序需要］**

**接口用户：EXT\_USER\_TEST**

**用户密码：#xJ[zK3>VL)wDaT2m-xGx\$)[c2xXQ@QL/ZvCb<lV**

**获取token的方式**

**请求方式**

GET

URL: [https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PRODUCTION\_ORDER\_2\_SRV](https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_PRODUCTION_ORDER_2_SRV)

**Content-Type**

Json

**请求Header参数**

<table><tr><td><p>参数名</p></td><td><p>示例值</p></td><td><p>参数类型</p></td><td><p>是否必填</p></td><td><p>参数描述</p></td></tr><tr><td><p>Accept</p></td><td><p>application/json</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr><tr><td><p>x-csrf-token</p></td><td><p>fetch</p></td><td><p>string</p></td><td><p>是</p></td><td></td></tr></table>

![](images/a441df6bd3004621ef0a37aadb43162f6123925439fb5665978a2c234f26eda5.jpg)

**传参的方式：**

- 创建SAP生产报工

![](images/42ae28d04b808ccb08c7998c1ff558b19a8b3967a47c1943eb548827c0bddf1a.jpg)

{

"OrderID": "2000003", // 生产订单号

"Sequence": "0", // 生产订单工序序列

"OrderOperation": "0010", // 生产订单工序号

"PostingDate": "2026-06-05T00:00:00", // 过账日期

"ConfirmationYieldQuantity": "700", // 确认合格数量

"FinalConfirmationType": "1", // 最终确认类型（1=最终确认）

"OpConfirmedWorkQuantity1": "20", // 工序确认工作量1

"OpWorkQuantityUnit1": "S", // 工序工作量单位1（H=小时）

"OpConfirmedWorkQuantity2": "30", // 工序确认工作量2

"OpWorkQuantityUnit2": "S", // 工序工作量单位2

"OpConfirmedWorkQuantity3": "40", // 工序确认工作量3

"OpWorkQuantityUnit3": "S" // 工序工作量单位3

}

- 冲销生产报工

![](images/9a9e2c3573144f4cde4adda65680c922e3bf9a63f78d22493800b272bf664fed.jpg)

{
    "d": {
        "\_\_metadata": {
            "id": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PROD\_ORDER\_CONFIRMATION\_2\_SRV/ProdnOrdConf2(ConfirmationGroup='26',ConfirmationCount='5')",
            "uri": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PROD\_ORDER\_CONFIRMATION\_2\_SRV/ProdnOrdConf2(ConfirmationGroup='26',ConfirmationCount='5')",
            "type": "API\_PROD\_ORDER\_CONFIRMATION\_2\_SRV.ProdnOrdConf2Type"
        },
        "ConfirmationGroup": "26", // 报工组
        "ConfirmationCount": "5", // 报工计数
        "OrderID": "2000003", // 生产订单
        "Sequence": "0", // 序列
        "OrderOperation": "0030", // 工序
        "OrderSuboperation": "", // 子工序
        "OrderType": "GL02", // 订单类型
        "OrderOperationInternalID": "3", // 工序内部ID
        "ConfirmationText": "", // 报工文本
        "Language": "", // 语言
        "Material": "131-001-01001", // 物料
        "OrderPlannedTotalQty": "700.000", // 计划总数量
        "ProductionUnit": "PCS", // 生产单位
        "FinalConfirmationType": "X", // 最终报工类型
        "IsFinalConfirmation": true, // 最终报工标识
        "OpenReservationsIsCleared": false, // 已清除未清预留
        "IsReversed": true, // 已冲销
        "IsReversal": false, // 冲销标识
        "APIConfHasNoGoodsMovements": false, // 无货物移动
        "OrderConfirmationRecordType": "L40", // 记录类型
        "ConfirmationEntryDate": "/Date(1780617600000)/", // 录入日期
        "ConfirmationEntryTime": "PT03H31M55S", // 录入时间
        "EnteredByUser": "CC0000000002", // 录入用户
        "LastChangeDate": "/Date(1780617600000)/", // 最后更改日期
        "LastChangedByUser": "CC0000000002", // 最后更改用户
        "ConfirmationExternalEntryDate": null, // 外部录入日期
        "ConfirmationExternalEntryTime": "PT00H00M00S", // 外部录入时间
        "EnteredByExternalUser": "", // 外部录入用户
        "ExternalSystemConfirmation": "00000000-0000-0000-0000-000000000000", // 外部系统报工
        "Plant": "1011", // 工厂
        "WorkCenterTypeCode": "A", // 工作中心类型
        "WorkCenter": "SMT001", // 工作中心
        "CapacityCategoryCode": "", // 能力类别
        "CapacityRequirementSplit": 0, // 能力需求分割
        "ShiftGrouping": "", // 班次分组
        "ShiftDefinition": "", // 班次定义
        "Personnel": "0", // 人员
        "TimeRecording": "0", // 时间记录
        "EmployeeWageType": "", // 员工工资类型
        "EmployeeWageGroup": "", // 员工工资组
        "BreakDurationUnit": "", // 休息时间单位
        "BreakDurationUnitISOCode": "", // 休息时间ISO代码
        "BreakDurationUnitSAPCode": "", // 休息时间SAP代码
        "ConfirmedBreakDuration": "0.000", // 确认休息时间
        "EmployeeSuitability": "", // 员工适合度
        "NumberOfEmployees": "0.00", // 员工人数
        "PostingDate": "/Date(1780531200000)/", // 过账日期
        "ConfirmedExecutionStartDate": "/Date(1780531200000)/", // 执行开始日期
        "ConfirmedExecutionStartTime": "PT11H25M23S", // 执行开始时间
        "ConfirmedSetupEndDate": null, // 准备结束日期
        "ConfirmedSetupEndTime": "PT00H00M00S", // 准备结束时间
        "ConfirmedProcessingStartDate": null, // 加工开始日期
        "ConfirmedProcessingStartTime": "PT00H00M00S", // 加工开始时间
        "ConfirmedProcessingEndDate": null, // 加工结束日期
        "ConfirmedProcessingEndTime": "PT00H00M00S", // 加工结束时间
        "ConfirmedTeardownStartDate": null, // 拆卸开始日期
        "ConfirmedTeardownStartTime": "PT00H00M00S", // 拆卸开始时间
        "ConfirmedExecutionEndDate": "/Date(1780617600000)/", // 执行结束日期
        "ConfirmedExecutionEndTime": "PT03H31M55S", // 执行结束时间
        "ConfirmationUnit": "PCS", // 报工单位
        "ConfirmationUnitISOCode": "\_01", // 报工单位ISO代码
        "ConfirmationUnitSAPCode": "PC", // 报工单位SAP代码
        "ConfirmationYieldQuantity": "700.000", // 合格数量
        "ConfirmationScrapQuantity": "0.000", // 废品数量
        "ConfirmationReworkQuantity": "0.000", // 返工数量
        "VarianceReasonCode": "", // 差异原因码
        "OpWorkQuantityUnit1": "S", // 工作量单位1
        "WorkQuantityUnit1ISOCode": "SEC", // 工作量单位1 ISO代码
        "WorkQuantityUnit1SAPCode": "S", // 工作量单位1 SAP代码
        "OpConfirmedWorkQuantity1": "20", // 确认工作量1
        "NoFurtherOpWorkQuantity1IsExpd": false, // 无需进一步工作量1
        "OpWorkQuantityUnit2": "S", // 工作量单位2
        "WorkQuantityUnit2ISOCode": "SEC", // 工作量单位2 ISO代码
        "WorkQuantityUnit2SAPCode": "S", // 工作量单位2 SAP代码
        "OpConfirmedWorkQuantity2": "30", // 确认工作量2
        "NoFurtherOpWorkQuantity2IsExpd": false, // 无需进一步工作量2
        "OpWorkQuantityUnit3": "S", // 工作量单位3
        "WorkQuantityUnit3ISOCode": "SEC", // 工作量单位3 ISO代码
        "WorkQuantityUnit3SAPCode": "S", // 工作量单位3 SAP代码
        "OpConfirmedWorkQuantity3": "40", // 确认工作量3
        "NoFurtherOpWorkQuantity3IsExpd": false, // 无需进一步工作量3
        "OpWorkQuantityUnit4": "", // 工作量单位4
        "WorkQuantityUnit4ISOCode": "", // 工作量单位4 ISO代码
        "WorkQuantityUnit4SAPCode": "", // 工作量单位4 SAP代码
        "OpConfirmedWorkQuantity4": "0.000", // 确认工作量4
        "NoFurtherOpWorkQuantity4IsExpd": false, // 无需进一步工作量4
        "OpWorkQuantityUnit5": "", // 工作量单位5
        "WorkQuantityUnit5ISOCode": "", // 工作量单位5 ISO代码
        "WorkQuantityUnit5SAPCode": "", // 工作量单位5 SAP代码
        "OpConfirmedWorkQuantity5": "0.000", // 确认工作量5
        "NoFurtherOpWorkQuantity5IsExpd": false, // 无需进一步工作量5
        "OpWorkQuantityUnit6": "", // 工作量单位6
        "WorkQuantityUnit6ISOCode": "", // 工作量单位6 ISO代码
        "WorkQuantityUnit6SAPCode": "", // 工作量单位6 SAP代码
        "OpConfirmedWorkQuantity6": "0.000", // 确认工作量6
        "NoFurtherOpWorkQuantity6IsExpd": false, // 无需进一步工作量6
        "BusinessProcessEntryUnit": "", // 业务流程输入单位
        "BusProcessEntrUnitISOCode": "", // 业务流程输入单位ISO代码
        "BusProcessEntryUnitSAPCode": "", // 业务流程输入单位SAP代码
        "BusinessProcessConfirmedQty": "0.000", // 业务流程确认数量
        "NoFurtherBusinessProcQtyIsExpd": false, // 无需进一步业务处理数量
        "to\_ProdnOrdConfMatlDocItm": {
            "\_\_deferred": {
                "uri": "https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PROD\_ORDER\_CONFIRMATION\_2\_SRV/ProdnOrdConf2(ConfirmationGroup='26',ConfirmationCount='5')/to\_ProdnOrdConfMatlDocItm"
            }
        }
    }
}

<a id="mpf3rr6916gxqaw6j52"></a>
## 5.4. **数据转换**

[仅接口程序类型需要，请在此处描述SAP系统和对方系统之间的数据匹配]

![](images/a9f6cbb08b46516a4558434261cc9e4a82445cb517747654607789b70c3a5d25.png)

<a id="mpf3rr69d7m5067ypny"></a>
# 6. **测试数据**

[请在此处说明已经在开发环境准备好的可供程序员测试的数据]

<a id="mpf3rr69o3rgrhlaxym"></a>
# 7.  **附件或样本**

<a id="mpf3rr69hiuyvhd7k1e"></a>
# 8. **测试记录**

<table><tr><td><p>序号</p></td><td><p>CLIENT</p></td><td><p>测试人</p></td><td><p>测试日期</p></td><td><p>测试条件</p></td><td><p>预期测试结果</p></td><td><p>实际测试结果</p></td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr></table>