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

**开发功能说明书**

<table><tr><td><p><strong>信息系统</strong></p></td><td><p>☑SAP ☑WMS</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>20260609</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><p>用户在WMS系统销售方发货后，同步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_CUSTOMER_RETURNS_DELIVERY_SRV;v=0002</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>Patch</p></td><td><p>https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_CUSTOMER_RETURNS_DELIVERY_SRV;v=0002/A_ReturnsDeliveryItem(DeliveryDocument=‘84000007’,DeliveryDocumentItem=‘10’)</p></td><td><p>Basic Auth</p></td></tr></table>

### 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_OUTBOUND_DELIVERY_SRV;v=0002/</p><p>PostGoodsIssue?DeliveryDocument='80000055'</p></td><td><p>Basic Auth</p></td></tr></table>

## 4.6. **字段的定义**

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

<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\_OUTBOUND\_DELIVERY\_SRV;v=0002

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

### **5.3.1更改交货单行：**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_OUTBOUND\_DELIVERY\_SRV;v=0002/A\_OutbDeliveryItem(DeliveryDocument=’80000055’,DeliveryDocumentItem=’10’)

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

**请求BODY参数**

{

"ActualDeliveryQuantity": "1.000",

"StorageLocation": "1001"

}

**返回结果**

**响应示例**

**•成功(204 No Content)**

![](images/91bf6c5182de1e897c6a9b174e14e2be8cf307931c0887514acfbfea7f192444.jpg)

**•失败(404 Not Found)**

{

"error": {

"code": "005056A509B11EE1B9A8FEC11C21778E",

"message": {

"lang": "zh",

"value": "The request URI contains an invalid key predicate."

},

"innererror": {

"transactionid": "6DFFBDC8ADC50250E006A27F4D18C46E",

"timestamp": "20260609111118.2122610",

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

}

}

}

}

### **5.3.2收货过账：**

**请求方式**

Post

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_OUTBOUND\_DELIVERY\_SRV;v=0002/A\_OutbDeliveryItem(DeliveryDocument=‘80000055’,DeliveryDocumentItem=‘10’)

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

**返回结果**

**响应示例**

**•成功(200 OK)**

{

"d": {

"\_\_metadata": {

"type": "Collection(API\_CUSTOMER\_RETURNS\_DELIVERY\_SRV.PutawayReport)"

},

"results": []

}

}

**•失败(400 Bad Request)**

{

"error": {

"code": "VL/604",

"message": {

"lang": "zh",

"value": "存储地点不是为交货项目 000010 确定的"

},

"innererror": {

"application": {

"component\_id": "LE-SHP-API",

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

"service\_id": "API\_CUSTOMER\_RETURNS\_DELIVERY\_SRV",

"service\_version": "0002"

},

"transactionid": "6DFFBDC8ADC50090E006A27F9215B567",

"timestamp": "20260609112941.9190900",

"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": "VL/604",

"message": "存储地点不是为交货项目 000010 确定的",

"longtext\_url": "/sap/opu/odata/iwbep/message\_text;o=LOCAL/T100\_longtexts(MSGID='VL',MSGNO='604',MESSAGE\_V1='000010',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>