新增/更新

  • 接口:/org/department/save
  • Method:POST
  • 数据格式:JSON
  • 接口说明:该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(businessCode)会被放在errorData里面;errorData为结构体, 包含出错记录主键(businessCode), 以及与之对应的出错信息; 类似 {"businessCode": "错误信息"}; 具体参见失败示例;如果有错误信息,则返回的code为NACK,然后错误信息会放在errorData里,只有全部成功返回的code为ACK。如果传了externalCode,会默认以externalCode为主键,不传则以businessCode为主键。
请求参数
参数 类型 必须 默认值 主键 描述
name string Y 部门名称
nameEn string Y 部门英文名称(name和nameEn至少其中一个要有值)
businessCode string Y Y 部门编码
externalCode string N 部门外部编码
costCenterCode string N 成本中心编码
subsidiaryBizCodes array N 共享部门的业务实体编码
directSubsidiaryBizCode string N 部门直属的业务实体编码
active bool N false 是否启用
principal string N 部门负责人工号
parentBizCode string N 上级部门编码
childrenSubsidiaryOperation string N OVERRIDE 如何处理子部门共享业务实体,可选值OVERRIDE, NO_OVERRIDE
asCoverDepartment bool N true 是否允许作为承担部门
返回数据
字段 类型 描述
code string 系统内唯一主键
businessCode string 部门编码
示例:

请求数据

{   
  "timestamp": 123456,  
  "data": [{
      "name": "部门A",  
      "businessCode": "BMA",  
      "costCenterCode": "BMA",  
      "principal": "10001",  
      "subsidiaryBizCodes": ["A", "B"],
      "active": true  
    }  
  ]  
}

返回数据(成功)

{  
  "code": "ACK",   
  "message": "",  
  "data": [{  
      "businessCode": "BMA",  
      "code": "ABCDAAFA1234"  
    }  
  ]  
}

返回数据(失败)

{  
  "code": "NACK",   
  "message": "处理错误" 
}

results matching ""

    No results matching ""