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

**开发功能说明书**

<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></td></tr><tr><td><p>业务顾问</p></td><td></td></tr><tr><td><p>创建日期</p></td><td><p>20260605</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>用户在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. **参数和选择条件**

1. 创建项目主数据：

<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_ENTERPRISE_PROJECT_SRV;v=0002/A_EnterpriseProject?sap-language=ZH</p></td><td><p>Basic Auth</p></td></tr></table>

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_ENTERPRISE_PROJECT_SRV;v=0002/A_EnterpriseProject?$filter=Project eq 'TEST-01'&amp;sap-language=ZH</p></td><td><p>Basic Auth</p></td></tr></table>

1. 审批项目（发布）：

<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_ENTERPRISE_PROJECT_SRV;v=0002/ChangeEntProjProcgStatus?ProjectUUID=guid'00163e24-21bd-1fe1-9890-db3d73e608d9'&amp;ProcessingStatus='10'</p></td><td><p>Basic Auth</p></td></tr></table>

1. 在现有项目下创建WBS：

<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_ENTERPRISE_PROJECT_SRV;v=0002/A_EnterpriseProjectElement</p></td><td><p>Basic Auth</p></td></tr></table>

1. 更新项目描述：

<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_ENTERPRISE_PROJECT_SRV;v=0002/A_EnterpriseProject (guid'00163e24-21bd-1fe1-9890-db3d73e608d9')</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. **项目创建**

1. SAP的传出传入参数：

**接口URL**

https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_ENTERPRISE\_PROJECT\_SRV;v=0002/A\_EnterpriseProject?sap-language=ZH

**请求方式**

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>x-csrf-token</p></td><td><p>QPhEehZIrhXWnJ8S0yDUSQ==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写fetch获取的值</p></td></tr><tr><td><p>Content-Type</p></td><td><p>application/json;charset=UTF-8</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr></table>

**请求Body参数**

<a id="_Toc531872905"></a>
{

//项目参数文件：投资项目YP02;间接费用项目YP03；统计型项目YP04；有收入项目YP05；

"ProjectProfileCode" : "YP05",

//项目标识

"Project" : "API-TEST5",

//项目描述

"ProjectDescription" : "接口测试-描述",

"ProjectStartDate" : "2026-01-01T00:00:00",

"ProjectEndDate" : "2027-01-01T00:00:00",

"ProfitCenter" : "GLR003",

"ResponsibleCostCenter" : "1010G08000",

"ProjectCurrency" : "CNY",

"FunctionalArea" : "2000",

"ProcessingStatus" : "00"

}

### 5.3.2. **项目查询-按项目标识**

1. SAP的传出传入参数：

**接口URL**

https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_ENTERPRISE\_PROJECT\_SRV;v=0002/A\_EnterpriseProject?\$filter=Project eq 'TEST-01'&sap-language=ZH

**请求方式**

GET

**请求Query参数**

<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>$filter</p></td><td><p>Project eq 'TEST-01'</p></td><td><p>string</p></td><td><p>是</p></td><td><p>待查询项目标识</p></td></tr><tr><td><p>sap-languaget</p></td><td><p>ZH</p></td><td><p>string</p></td><td><p>否</p></td><td><p>-</p></td></tr></table>

### 5.3.3. **项目审批（发布）**

1. SAP的传出传入参数：

**接口URL**

https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_ENTERPRISE\_PROJECT\_SRV;v=0002/ChangeEntProjProcgStatus?ProjectUUID=guid'00163e24-21bd-1fe1-9890-db3d73e608d9'&ProcessingStatus='10'

**请求方式**

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>x-csrf-token</p></td><td><p>QPhEehZIrhXWnJ8S0yDUSQ==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写fetch获取的值</p></td></tr><tr><td><p>Content-Type</p></td><td><p>application/json;charset=UTF-8</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr></table>

**请求Querv参数**

<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>ProjectUUID</p></td><td><p>guid'00163e24-21bd-1fe1-9890-db3d73e608d9'</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写get查询到的指</p></td></tr><tr><td><p>ProcessingStatus</p></td><td><p>'10'</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr></table>

**请求Body参数**

{

"ProcessingStatus": "10"

}

### 5.3.4. **在现有项目下创建WBS（阶段）**

1. SAP的传出传入参数：

**接口URL**

https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_ENTERPRISE\_PROJECT\_SRV;v=0002/A\_EnterpriseProjectElement

**请求方式**

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>x-csrf-token</p></td><td><p>QPhEehZIrhXWnJ8S0yDUSQ==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写fetch获取的值</p></td></tr><tr><td><p>Content-Type</p></td><td><p>application/json;charset=UTF-8</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></td></tr></table>

**请求Body参数**

{

//项目UUID

"ProjectUUID" : "00163e24-21bd-1fe1-9890-db3d73e608d9",

//WBS编号

"ProjectElement" : "API-PART5",

"ProjectElementDescription" : "研发阶段",

"PlannedStartDate" : "2026-02-01T00:00:00",

"ProfitCenter" : "GLR003",

"ResponsibleCostCenter" : "1010G08000",

"FunctionalArea" : "2000",

"PlannedEndDate" : "2026-08-31T00:00:00"

}

### 5.3.5. **更新项目描述**

1. SAP的传出传入参数：

**接口URL**

https://my201453-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API\_ENTERPRISE\_PROJECT\_SRV;v=0002/A\_EnterpriseProject (guid'00163e24-21bd-1fe1-9890-db3d73e608d9')

**请求方式**

PATCH

**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>QPhEehZIrhXWnJ8S0yDUSQ==</p></td><td><p>string</p></td><td><p>是</p></td><td><p>填写fetch获取的值</p></td></tr><tr><td><p>Content-Type</p></td><td><p>application/json;charset=UTF-8</p></td><td><p>string</p></td><td><p>是</p></td><td><p>-</p></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参数**

{

"ProjectDescription":"修改项目"

}

## 5.4. **数据转换**

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

![](images/3872ba063ef83ef08f3cb02cf6af6fd89edc24ff681eacac01c381a9c1b302d5.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>