获取成本中心信息
接口说明: 获取公司的成本中心信息,包含成本中心id,父成本中心id,成本中心名称以及成本中心编码 共两种情况:
costId为空时,获取公司所有成本中心信息
costId不为空时,获取公司单个指定成本中心信息
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/department/costcenter/list
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
costId | String | N | 成本中心id,不传时,默认返回公司所有成本中心信息 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | List<CostCenterModel> | Y | 成本中心信息列表 |
CostCenterModel
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
costId | String | Y | 成本中心id |
parentId | String | Y | 父成本中心id,顶级父节点id为0 |
costCenterName | String | Y | 成本中心名称 |
costCenterCode | String | Y | 成本中心编码 |
expenseType | String | Y | 费用类型 |
expenseCode | String | Y | 费用编码 |
customFields | Map<String,String> | N | 自定义字段 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/department/costcenter/list?sign=cwyzXRxvXDiGetbidkMvHYJ7TVI%3D
请求Body示例:
{
"timestamp": 1606214752569
}
SDK请求示例(java):
CostCenterModelRequest request = new CostCenterModelRequest(access_token);
OpenapiResponse<List<CostCenterModel>> listOpenapiResponse = XrxsDepartmentService.costCenterList(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": [
{
"costId": "c03b7ef4fced4e64a256327a740b39fc",
"parentId": "0",
"costCenterName": "成本中心",
"costCenterCode": "cost_center_code",
"expenseType":"1",
"expenseCode":"1",
"customFields":{
"测试自定义字段2":"23",
"测试自定义字段1":"测试",
"测试城市":"北京市"
}
}
]
}