成本中心同步接口

  • 接口:第三方提供
  • 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 初稿,补充成本中心同步字段及请求、返回示例

results matching ""

    No results matching ""