成本中心同步接口
- 接口:第三方提供
- Method:POST
- 数据格式:JSON
- 接口说明:该接口用于同步成本中心主数据
- 本接口的请求不携带 sign,鉴权仅使用
account + sessionId
- 成本中心所属部门代码
parentDepartmentCode 用于建立成本中心与部门的归属关系;成本中心负责人 ownerBindId 传递对应人员的绑定 id
- 文档末尾有文档版本记录
参数:
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
| account |
String |
对接的公司编号,用于唯一确认对接公司 |
Y |
| sessionId |
String |
身份验证信息 |
Y |
| data |
List<CostCenterInfo> |
同步的成本中心信息,单次最多 200 条 |
Y |
CostCenterInfo
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
| costCenterName |
String |
成本中心名称 |
是 |
| costCenterCode |
String |
成本中心编码 |
是 |
| ownerBindId |
String |
成本中心负责人绑定 id |
否 |
| enabledFlag |
String |
是否启用("Y":启用;"N":禁用) |
是 |
| parentDepartmentCode |
String |
成本中心所属部门代码 |
否 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
| resCode |
Integer |
错误码,同步成功填10000 |
Y |
| resMsg |
String |
错误描述,正确写success |
Y |
| data |
List<CostCenterResult> |
同步失败的成本中心信息 |
Y |
CostCenterResult
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
| costCenterCode |
String |
成本中心编码 |
Y |
| errorMsg |
String |
错误信息 |
Y |
| status |
Integer |
0是失败,1是成功 |
Y |
说明:
data 单次最多传递 200 条成本中心信息,超过上限时应拆分为多次请求。
- 云简按返回项中的
costCenterCode 与请求中的成本中心匹配:status=1 视为成功,其余取 errorMsg 记录失败原因;未出现在 data 中的成本中心按成功处理。
- 第三方未返回结果、或云简侧无法生成身份验证信息(sessionId 获取失败)时,本批成本中心会被标记为同步失败。
示例:
请求数据
{
"sessionId": "123321",
"account": "avcsd123",
"data": [
{
"costCenterName": "研发成本中心",
"costCenterCode": "CC1000",
"ownerBindId": "123",
"enabledFlag": "Y",
"parentDepartmentCode": "3000"
}
]
}
返回数据
{
"resCode": 10000,
"resMsg": "部分同步失败",
"data": [
{
"costCenterCode": "CC1000",
"errorMsg": "成本中心已存在",
"status": 0
}
]
}
{
"resCode": 10000,
"resMsg": "同步成功",
"data": []
}
文档版本记录
| 版本号 |
编写日期 |
更改内容 |
| V1.0 |
2026.09.14 |
初稿,补充成本中心同步字段及请求、返回示例 |