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

**开发功能说明书**

<table><tr><td><p><strong>信息系统</strong></p></td><td><p>☑CRM ☑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></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><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>用户在CRM系统创建客户，确定成单的客户主数据需要同步到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. **参数和选择条件（需要CRM提供）**

1. 拉取crm客户主数据（广联提供）：
2. 创建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_BUSINESS_PARTNER</p></td><td><p>Basic Auth</p></td></tr></table>

1. 修改SAP客户主数据（基本视图）：

<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></td><td><p>Basic Auth</p></td></tr></table>

1. 修改SAP客户主数据（销售视图）：

<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></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. **传入传出的参数**

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

1. CRM的传出传入参数：
2. SAP的传出传入参数：

创建

**请求方式**

POST

URL: [https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_BUSINESS\_PARTNER//A\_BusinessPartner](https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_BUSINESS_PARTNER//A_BusinessPartner)

**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参数**

{

"BusinessPartnerCategory": "2",//必填，固定值2

"BusinessPartnerGrouping": "BP01",//必填，客户分组

"OrganizationBPName1": "接口测试客户2",//必填，公司名称

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

"SearchTerm1": "test",//选填，搜索标记

"Language": "ZH",//必填，语言，Zh表示中文

"to\_BusinessPartnerAddress": [

{

"Country": "CN",//必填，国家

"Language": "ZH",//必填，语言，Zh表示中文

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

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

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

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

"to\_EmailAddress": [

{

"EmailAddress": "noreply@sap.com" //必填，邮箱

}

],

"to\_FaxNumber": [

{

"FaxNumber": "0102222555555"//选填，传真

}

],

"to\_MobilePhoneNumber": [

{

"PhoneNumber": "18200000000"//选填，移动电话

}

],

"to\_PhoneNumber": [

{

"PhoneNumber": "0429-7895028"//选填，固定电话

}

]

}

],

"to\_BusinessPartnerBank": [ // 多个银行有多个节点

{

"BankIdentification": "0001",//必填，键值,从0001开始，每个银行节点值加1

"BankCountryKey": "CN",//必填，银行的国家代码

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

"BankControlKey":"", // 必填， X表示有效，空表示无效 12/25新增必填字段

"ValidityStartDate": "2020-01-01T00:00:00",//选填，有效期开始，不填默认开始当天

"ValidityEndDate": "9999-12-31T00:00:00",//选填，有效期开始，不填默认永久有效

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

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

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

}

],

"to\_BusinessPartnerRole": {

"results": [

{

"BusinessPartnerRole": "FLCU00"//必填，固定值

},

{

"BusinessPartnerRole": "FLCU01"//必填，固定值

}

]

},

"to\_BusinessPartnerTax": [

{

"BPTaxType": "CN5",//必填，CN5表示中国税号类型

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

}

],

"to\_Customer": {

"CustomerAccountGroup": "CUST",//必填，固定值CUST

"to\_CustomerCompany": [

{

"CompanyCode": "1010",//必填，公司代码

"ReconciliationAccount": "1122010200",//必填，对账科目

"PaymentTerms": "0001"//选填，默认0001

}

],

"to\_CustomerSalesArea": [

{

"SalesOrganization": "1010",//必填，销售组织

"DistributionChannel": "20",//必填，分销渠道，默认20

"Division": "00",//必填，产品组，默认00

"SalesOffice": "2001",//必填，默认2001

"CustomerPaymentTerms": "0001",//选填，付款条件，默认0001

"Currency": "CNY",//必填，货币

"CustomerAccountAssignmentGroup": "Z1",//必填，客户科目分配组

"IncotermsClassification": "EXW",//选填，国际贸易条款编码

"IncotermsLocation1": "深圳",//选填，目的港

"ShippingCondition": "01",//必填，装运条件，默认01

"OrderCombinationIsAllowed": true,//必填，组合订单，默认ture

"to\_SalesAreaTax":[

{

"DepartureCountry": "CN",//必填，销售公司国家

"CustomerTaxCategory": "TTX1",//必填，税收类别

"CustomerTaxClassification": "1"//必填，税收类别

},

{

"DepartureCountry": "HK",//必填，销售公司国家

"CustomerTaxCategory": "TTX1",//必填，税收类别

"CustomerTaxClassification": "1"//必填，税收类别

},

{

"DepartureCountry": "US",//必填，销售公司国家

"CustomerTaxCategory": "UTXJ",//必填，税收类别

"CustomerTaxClassification": "1"//必填，税收类别

}

]

}

]

}

}

<a id="_Toc531872905"></a>
## 5.4. **数据转换（需要CRM提供）**

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

![](images/48dd23c4ca717959416b3c150259c7961a381c852bccfdfa8c413dc6833dea16.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>