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

**开发功能说明书**

<table><tr><td><p><strong>信息系统</strong></p></td><td><p>☑OA ☑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>20260604</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>20260604</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>OA流程完成的新增工艺路线数据推送SAP创建工艺路线；</p><p>OA流程完成的变更工艺路线数据调用SAP接口创建ECN编号，拿到ECN编号后调更改工艺路线接口关联变更工艺路线信息；</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. **创建 SAP 工艺路线：**

<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_PRODUCTION_ROUTING/ProductionRoutingHeader?sap-language=zh</p></td><td><p>Basic Auth</p></td></tr></table>

<a id="mpf3rr69ary6x098b5k"></a>
### 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_PRODUCTION_ROUTING/ProductionRoutingHeader(ProductionRoutingGroup='50000013',ProductionRouting='1',ProductionRoutingInternalVers='1')?sap-language=zh</p></td><td><p>Basic Auth</p></td></tr></table>

<a id="mpqk63ix1radr822nja"></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_PRODUCTION_ROUTING/ProductionRoutingOperation(ProductionRoutingGroup='50000013',ProductionRouting='1',ProductionRoutingSequence='0',ProductionRoutingOpIntID='2',ProductionRoutingOpIntVersion='1')?sap-language=zh</p></td><td><ol><li><a></a></li></ol><p>Basic Auth</p></td></tr></table>

<a id="mpz1bbvqdxzmvgr5qz7"></a>
### 4.5.4. **新增工艺路线工序**

<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_PRODUCTION_ROUTING/ProductionRoutingSequence(ProductionRoutingGroup='50000013',ProductionRouting='1',ProductionRoutingSequence='0',ProductionRoutingSqncIntVers='1')/to_Operation </p></td><td><p><a></a></p><p>Basic Auth</p></td></tr></table>

<a id="mpz1cdvzisrdsq34r5k"></a>
### 4.5.5. **创建ECN**

<table><tr><td><p>方法</p></td><td><p>URL</p></td><td><p>认证方式</p></td></tr><tr><td><p>POST</p></td><td></td><td><p><a></a></p><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. **传入传出的参数**

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

**获取token的方式**

**请求方式**

GET

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PRODUCTION\_ROUTING

**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/61da94e678eb63548d29ca280e80364ce87c37140c0e93bcab15d79a09fa4872.jpg)

- **SAP的传出传入参数：**
- 创建SAP工艺路线
- **请求方式**

POST

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PRODUCTION\_ROUTING/ProductionRoutingHeader?sap-language=zh

**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>Gy2TljN1_tq20FQYySzKzA==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写获取的token</p></td></tr></table>

- **请求BODY参数**

![](images/bb9725eceeeb5d99f336617bbeaf329aa0c3b496dc9e2fffd7539b3e8dc5ff15.jpg)

{
    "ProductionRouting": "1", // 计数器
    "BillOfOperationsDesc": "接口测试工艺路线01", // 描述
    "Plant": "1011", // 工厂
    "BillOfOperationsUsage": "1", // 用途
    "BillOfOperationsStatus": "4", // 状态
    "MinimumLotSizeQuantity": "0", // 最小批量
    "MaximumLotSizeQuantity": "99999999", // 最大批量
    "BillOfOperationsUnit": "PCS", // 基本计量单位
    "to\_MatlAssgmt": {
        "results": [
            {
                "Product": "111-006-99001" // 物料号
            }
        ]
    },
    "to\_Sequence": {
        "results": [
            {
                "ProductionRoutingSequence": "0", // 序列号
                "SequenceCategory": "0", // 序列类别
                "to\_Operation": {
                    "results": [
                        {
                            "Operation": "10", // 工序号
                            "OperationText": "测试工序001", // 工序描述
                            "Plant": "1011", // 工厂
                            "OperationControlProfile": "GL01", // 工序控制码
                            "WorkCenterInternalID": "10000000", // 工作中心
                            "OperationCostingRelevancyType": "X", // 成本核算相关
                            "OperationReferenceQuantity": "1", // 基准数量
                            "OperationUnit": "PCS", // 工序计量单位
                            "OpQtyToBaseQtyNmrtr": "1", // 分子（工序数量/基本数量）
                            "OpQtyToBaseQtyDnmntr": "1", // 分母（工序数量/基本数量）
                            "StandardWorkQuantity1": "100", // 标准工作量1
                            "StandardWorkQuantityUnit1": "S", // 标准工作量单位1
                            "CostCtrActivityType1": "", // 成本中心活动类型1
                            "StandardWorkQuantity2": "0.000", // 标准工作量2
                            "StandardWorkQuantityUnit2": "S", // 标准工作量单位2
                            "CostCtrActivityType2": "", // 成本中心活动类型2
                            "StandardWorkQuantity3": "0.000", // 标准工作量3
                            "StandardWorkQuantityUnit3": "S", // 标准工作量单位3
                            "CostCtrActivityType3": "", // 成本中心活动类型3
                            "StandardWorkQuantity4": "0.000", // 标准工作量4
                            "StandardWorkQuantityUnit4": "S", // 标准工作量单位4
                            "CostCtrActivityType4": "", // 成本中心活动类型4
                            "StandardWorkQuantity5": "0.000", // 标准工作量5
                            "StandardWorkQuantityUnit5": "S", // 标准工作量单位5
                            "CostCtrActivityType5": "", // 成本中心活动类型5
                            "StandardWorkQuantity6": "0.000", // 标准工作量6
                            "StandardWorkQuantityUnit6": "S", // 标准工作量单位6
                            "CostCtrActivityType6": "" // 成本中心活动类型6
                        },
                        {
                            "Operation": "20",
                            "OperationText": "测试工序002",
                            "Plant": "1011",
                            "OperationControlProfile": "GL01", // 工序控制码
                            "WorkCenterInternalID": "10000000", // 工作中心
                            "OperationCostingRelevancyType": "X",
                            "OperationReferenceQuantity": "2",
                            "OperationUnit": "PCS",
                            "OpQtyToBaseQtyNmrtr": "1",
                            "OpQtyToBaseQtyDnmntr": "1",
                            "StandardWorkQuantity1": "1.000",
                            "StandardWorkQuantityUnit1": "S",
                            "CostCtrActivityType1": "",
                            "StandardWorkQuantity2": "0.000",
                            "StandardWorkQuantityUnit2": "S",
                            "CostCtrActivityType2": "",
                            "StandardWorkQuantity3": "0.000",
                            "StandardWorkQuantityUnit3": "S",
                            "CostCtrActivityType3": "",
                            "StandardWorkQuantity4": "0.000",
                            "StandardWorkQuantityUnit4": "S",
                            "CostCtrActivityType4": "",
                            "StandardWorkQuantity5": "0.000",
                            "StandardWorkQuantityUnit5": "S",
                            "CostCtrActivityType5": "",
                            "StandardWorkQuantity6": "0.000",
                            "StandardWorkQuantityUnit6": "S",
                            "CostCtrActivityType6": ""
                        },
                        {
                            "Operation": "9999",
                            "OperationText": "调整工序999",
                            "Plant": "1011",
                            "OperationControlProfile": "GL01", // 工序控制码
                            "WorkCenterInternalID": "10000000", // 工作中心
                            "OperationCostingRelevancyType": "X",
                            "OperationReferenceQuantity": "2",
                            "OperationUnit": "PCS",
                            "OpQtyToBaseQtyNmrtr": "1",
                            "OpQtyToBaseQtyDnmntr": "1",
                            "StandardWorkQuantity1": "1.000",
                            "StandardWorkQuantityUnit1": "S",
                            "CostCtrActivityType1": "",
                            "StandardWorkQuantity2": "0.000",
                            "StandardWorkQuantityUnit2": "S",
                            "CostCtrActivityType2": "",
                            "StandardWorkQuantity3": "0.000",
                            "StandardWorkQuantityUnit3": "S",
                            "CostCtrActivityType3": "",
                            "StandardWorkQuantity4": "0.000",
                            "StandardWorkQuantityUnit4": "S",
                            "CostCtrActivityType4": "",
                            "StandardWorkQuantity5": "0.000",
                            "StandardWorkQuantityUnit5": "S",
                            "CostCtrActivityType5": "",
                            "StandardWorkQuantity6": "0.000",
                            "StandardWorkQuantityUnit6": "S",
                            "CostCtrActivityType6": ""
                        }
                    ]
                }
            }
        ]
    }
}

- 更改工艺路线抬头数据
- **请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PRODUCTION\_ROUTING/ProductionRoutingHeader(ProductionRoutingGroup=‘50000013‘,ProductionRouting=‘1‘,ProdutionRoutingInternalVers=‘1‘)?sap-language=zh

**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>Gy2TljN1_tq20FQYySzKzA==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写获取的token</p></td></tr></table>

- **请求BODY参数**

![](images/ba7915d22e628cf9fcc36426e461b2cc2534f223ac8ea0c1c5d56b1630c1f7de.jpg)

{
    "BillOfOperationsDesc": "接口测试工序CYQ", //描述
    "Plant": "1011", //工厂
    "BillOfOperationsUsage": "2", //用途;1生产;2工程/设计;3通用;4工厂维护;5收货;51收货模型检验;52收货源检测;53收货外部流程;6发货;9物料检验
    "BillOfOperationsStatus": "4", //总体状态;1已创建;2对订单下达;3对成本核算下达;4已下达（常规）
    "MinimumLotSizeQuantity": "0", //批量自
    "MaximumLotSizeQuantity": "777777", //批量至
    "BillOfOperationsUnit": "PCS" //单位
}

- 更改工艺路线工序数据
- **请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud,.cn/sap/opu/odata/sap/API\_PRODUCTION\_ROUTING/ProductionRoutingOperation(ProductionRoutingGroup='50000013',ProductionRouting='1',ProductionRoutingSequence='O',ProductionRoutingOplntID='2',ProductionRoutingOplntVersion='1)?sap-language=zh

**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>Gy2TljN1_tq20FQYySzKzA==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写获取的token</p></td></tr></table>

![](images/afec9bbfc960570b389fddd4453ca601978b4c4ac1f581c5a8800efbe87e2771.jpg)

{
    
    "OperationText": "更新工序0020", // 工序描述
    "Plant": "1011", // 工厂
    "OperationControlProfile": "GL01", // 工序控制码
    "WorkCenterInternalID": "10000000", // 工作中心
    "OperationCostingRelevancyType": "X", // 成本核算相关
    "OperationReferenceQuantity": "1.000", // 基准数量
    "OperationUnit": "PCS", // 工序计量单位
    "OpQtyToBaseQtyNmrtr": "100", // 分子（工序数量/基本数量）
    "OpQtyToBaseQtyDnmntr": "100", // 分母（工序数量/基本数量）
    "StandardWorkQuantity1": "123", // 直接人工工时
    "StandardWorkQuantityUnit1": "S", // 人工工时单位，固定值S
    "CostCtrActivityType1": "", // 成本中心活动类型1
    "StandardWorkQuantity2": "456", // 间接人工工时
    "StandardWorkQuantityUnit2": "S", // 人工工时单位，固定值S
    "CostCtrActivityType2": "", // 成本中心活动类型2
    "StandardWorkQuantity3": "789", // 机器设备工时
    "StandardWorkQuantityUnit3": "S", // 人工工时单位，固定值S
    "CostCtrActivityType3": "", // 成本中心活动类型3
    "StandardWorkQuantity4": "999", // 能源消耗工时
    "StandardWorkQuantityUnit4": "S", // 人工工时单位，固定值S
    "CostCtrActivityType4": "", // 成本中心活动类型4
    "StandardWorkQuantity5": "098", // 物料消耗工时
    "StandardWorkQuantityUnit5": "S", // 人工工时单位，固定值S
    "CostCtrActivityType5": "", // 成本中心活动类型5
    "StandardWorkQuantity6": "678", // 其他工时
    "StandardWorkQuantityUnit6": "S", // 人工工时单位，固定值S
    "CostCtrActivityType6": "" // 成本中心活动类型6
}

- 新增工艺路线工序
- **请求方式**

POST

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_PRODUCTION\_ROUTING/ProductionRoutingSequence(ProductionRoutingGroup='50000013',ProductionRouting='1',ProductionRoutingSequence='0',ProductionRoutingSqnclntVers='1')/to\_Operation

**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>Gy2TljN1_tq20FQYySzKzA==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写获取的token</p></td></tr></table>

- **请求BODY参数**

![](images/378de88c6351c960a250e59a167dfa4e902f52b25dc252b38f054ac286f41ed1.jpg)

{
    "Operation": "40",//工序号
    "OperationText": "更新工序40",
    "Plant": "1011",
    "OperationControlProfile": "GL01",
    "WorkCenterInternalID": "10000000",
    "OperationCostingRelevancyType": "X",
    "OperationReferenceQuantity": "1",
    "OperationUnit": "EA",
    "OpQtyToBaseQtyNmrtr": "1",
    "OpQtyToBaseQtyDnmntr": "1",
    "StandardWorkQuantity1": "100",
    "StandardWorkQuantityUnit1": "S",
    "StandardWorkQuantity2": "0.000",
    "StandardWorkQuantityUnit2": "S",
    "StandardWorkQuantity3": "789", // 机器设备工时
    "StandardWorkQuantityUnit3": "S", // 人工工时单位，固定值S
    "CostCtrActivityType3": "", // 成本中心活动类型3
    "StandardWorkQuantity4": "999", // 能源消耗工时
    "StandardWorkQuantityUnit4": "S", // 人工工时单位，固定值S
    "CostCtrActivityType4": "", // 成本中心活动类型4
    "StandardWorkQuantity5": "098", // 物料消耗工时
    "StandardWorkQuantityUnit5": "S", // 人工工时单位，固定值S
    "CostCtrActivityType5": "", // 成本中心活动类型5
    "StandardWorkQuantity6": "678", // 其他工时
    "StandardWorkQuantityUnit6": "S", // 人工工时单位，固定值S
    "CostCtrActivityType6": "" // 成本中心活动类型6
}

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

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

![](images/923aa9f59c678205a66d136f6c443081d92610582e4e55fbdc4d7bf6b061b0c5.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>