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

**开发功能说明书**

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

**2026年5月**

**目录**

- [**1** **创建修改记录** **3**](#_Toc531872890)
- **2** **开发类型** **4**
- [**3** **业务需求概述** **4**](#_Toc531872892)
    - [现有/样本报表](#_Toc531872893)
- [**4** **功能规范** **5**](#_Toc531872894)
    - [4.1 程序开发优先级](#_Toc531872895)
    - [4.2 权限要求](#_Toc531872896)
    - [4.3 程序运行频率](#_Toc531872897)
    - [4.4 屏幕设计及其布局](#_Toc531872898)
    - [4.5 参数和选择条件](#_Toc531872899)
    - [4.6 字段的定义](#_Toc531872900)
- [**5** **程序输出格式** **7**](#_Toc531872901)
    - [5.1 业务大概逻辑](#_Toc531872902)
    - [5.2 前台业务截图](#_Toc531872903)
    - [5.3 SAP方需要传入传出的参数](#_Toc531872904)
    - [5.4 数据转换](#_Toc531872905)
- [**6测试数据 9**](#_Toc531872906)
- [**7 附件或样本 9**](#_Toc531872907)
- [**8 测试记录 10**](#_Toc531872908)

<a id="_Toc531872890"></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>2026-06-01</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="_Toc135387408"></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="_Toc531872892"></a>
# 3. **业务需求概述**

<table><tr><td><p><a></a><a></a><a></a>需求概述：</p></td><td colspan="3"><p>用户在OA系统更改供应商信息，审批通过后同步到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="_Toc531872893"></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="_Toc531872894"></a>
# 4. **功能规范**

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

**优先级别	:**	□ 高		 中		☑ 低

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

全员赋予流程入口权限

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

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

随时	□ 周	 	□ 月 		□ 季		□ 年

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

无

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

创建供应商：

<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_BUSINESS_PARTNER/</p><p>A_BusinessPartner (‘100030‘)</p></td><td><p>Basic Auth</p></td></tr></table>

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

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

字段清单见数据转换

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

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

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

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

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

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

### 5.3.1. **更改供应商基本信息**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER/A\_BusinessPartner (‘100030’)

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

**请求Body参数**

{

"OrganizationBPName1": "更改测试", //必填，公司名称

"OrganizationBPName2": "test023", //选填，公司名称OrganizationBPName1超出的填这里

"SearchTerm1": "API" //选填，搜索标记

}

**实时响应 204**

空

### 5.3.2. **更改供应商地址**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER/A\_BusinessPartner (‘100030’,AddressID=‘323’)

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

**请求Body参数**

{

"Region": "GD", //必填，省份，枚举值

"CityName": "深圳市", //必填，城市

"StreetName": "创维大厦", ///必填，街道

"PostalCode": "100000", //选填，邮政编码

"CareOfName": "联系人姓名" //必填

}

**实时响应 204**

空

### 5.3.3. **更改供应商邮箱**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER /A\_AddressEmailAddress(AddressID=‘353’,Person=’‘,OrdinalNumber=’1’)

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

**请求Body参数**

{

"EmailAddress": "sap@123.com" //邮箱

}

**实时响应 204**

空

### 5.3.4. **更改供应商传真**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER /A\_AddressFaxNumber(AddressID=‘323’,Person=’’,OrdinalNumber=’1’)

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

**请求Body参数**

{

"FaxNumber": "56666666" //传真

}

**实时响应 204**

空

### 5.3.5. **更改供应商电话**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER /A\_AddressPhoneNumber(AddressID=‘353’,Person=’‘,OrdinalNumber=’1’)

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

**请求Body参数**

{

"PhoneNumber": "602202026" //电话

}

**实时响应 204**

空

### 5.3.6. **更改供应商税号**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER /A\_BusinessPartnerTaxNumber(BusinessPartner=‘100030’,BPTaxType=‘CN5’)

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

**请求Body参数**

{

"BPTaxLongNumber": "666666699999" //必填，税号

}

**实时响应 204**

空

### 5.3.7. **更改供应商银行信息**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER /A\_BusinessPartnerBank(BusinessPartner=‘100030’,BankIdentification=‘0001’)

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

**请求Body参数**

{

"BankControlKey":"", // 必填， X表示有效，空表示无效

"BankNumber": " 103584001374", //必填，银行编码

"BankAccountName": "帐户名称", //必填，账户名称

"BankAccount": "1100454811671", //必填，银行账号

"BankAccountReferenceText": "11" //选填，银行账号超出18剩余的填这里

}

**实时响应 204**

空

### 5.3.8. **新增供应商银行**

**请求方式**

Post

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER/A\_BusinessPartnerBank

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

**请求Body参数**

{

"BusinessPartner": "100209",

"BankIdentification": "0005",//如0005 在SAP已存在，更新现有数据；如没有，SAP会新增一条银行数据

"BankCountryKey": "CN",

"BankControlKey":"", // 必填， X表示有效，空表示无效

"BankNumber": "104304383143", //必填，银行编码

"BankAccountName": "帐户名称5", //必填，账户名称

"BankAccount": "104199904", //必填，银行账号

"BankAccountReferenceText": "12" //选填，银行账号超出18剩余的填这里

}

**响应示例**

- 成功(201)

### 5.3.9. **更改供应商采购组织信息**

**请求方式**

Patch

URL: https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER /A\_SupplierPurchasingOrg(Supplier=‘100030’,PurchasingOrganization=‘1000’)

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

**请求Body参数**

{

"PaymentTerms": "0001"//选填，付款条件

**响应示例**

- 成功(204)

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

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

![](images/c4534f9ddbed9bb86311bd960bf98363cf7c150cb1505512ca2d399e0afdebc7.png)

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

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

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

<a id="_Toc531872908"></a>
# 8. **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>