**生产订单技术性关闭接口功能说明书**

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

**开发功能说明书**

<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>20260608</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></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><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></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_PRODUCTION_ORDER_2_SRV/TechlyCmpltOrder?ManufacturingOrder='2000032'</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)

**获取ETag的方式：**

**请求方式**

GET

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

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

**传参的方式：**

- 生产订单技术性关闭
- **请求方式**

POST

- **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><tr><td><p>If-Match</p></td><td><p>W/"'20260525070328'"</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写获取的ETag</p></td></tr><tr><td><p>Content-Type</p></td><td><p>application/json</p></td><td><p>string</p></td><td><p>是</p></td><td></td></tr></table>

![](images/5f13980b4f42e83774115ab004158d32701c933d9d6dbdfd5cbb606aa31a89c8.jpg)

**返回结果**

**响应示例**

**•成功(200 OK)**

{

"d": {

"TechlyCmpltOrder": {

"\_\_metadata": {

"type": "API\_PRODUCTION\_ORDER\_2\_SRV.FunctionMessage"

},

"SystemMessageType": "I",

"SystemMessageIdentification": "PP\_ODATA\_API\_PRODORD",

"SystemMessageNumber": "121",

"SystemMessageLongText": "Order 2000033: Status \"TECO Technically completed\" is activated",

"SystemMessageVariable1": "2000033",

"SystemMessageVariable2": "TECO Technically completed",

"SystemMessageVariable3": "",

"SystemMessageVariable4": ""

}

}

}

**•失败(412 Precondition Failed)**

{

"error": {

"code": "/IWBEP/CM\_MGW\_RT/194",

"message": {

"lang": "en",

"value": "Order 2000032: Precondition required"

},

"innererror": {

"application": {

"component\_id": "PP-ES",

"service\_namespace": "/SAP/",

"service\_id": "API\_PRODUCTION\_ORDER\_2\_SRV",

"service\_version": "0001"

},

"transactionid": "6DFFBDC8ADC50220E006A27952856E8E",

"timestamp": "20260609042308.3668350",

"Error\_Resolution": {

"SAP\_Transaction": "For backend administrators: use ADT feed reader \"SAP Gateway Error Log\" or run transaction /IWFND/ERROR\_LOG on SAP Gateway hub system and search for entries with the timestamp above for more details",

"SAP\_Note": "See SAP Note 1797736 for error analysis (https://service.sap.com/sap/support/notes/1797736)"

},

"errordetails": [

{

"ContentID": "",

"code": "/IWBEP/CM\_MGW\_RT/194",

"message": "Order 2000032: Precondition required",

"longtext\_url": "/sap/opu/odata/iwbep/message\_text;o=LOCAL/T100\_longtexts(MSGID='%2FIWBEP%2FCM\_MGW\_RT',MSGNO='194',MESSAGE\_V1='',MESSAGE\_V2='',MESSAGE\_V3='',MESSAGE\_V4='')/\$value",

"propertyref": "",

"severity": "error",

"transition": **false**,

"target": ""

},

{

"ContentID": "",

"code": "/IWBEP/CX\_MGW\_BUSI\_EXCEPTION",

"message": "Precondition required",

"longtext\_url": "/sap/opu/odata/iwbep/message\_text;o=LOCAL/T100\_longtexts(MSGID='%2FIWBEP%2FCM\_MGW\_RT',MSGNO='194',MESSAGE\_V1='',MESSAGE\_V2='',MESSAGE\_V3='',MESSAGE\_V4='')/\$value",

"propertyref": "",

"severity": "error",

"transition": **false**,

"target": ""

}

]

}

}

}

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

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

<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>