新增/更新
- 接口:/org/subsidiary/save
- Method:POST
- 数据格式:JSON
- 接口说明:该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(businessCode)会被放在errorData里面;errorData为结构体, 包含出错记录主键(businessCode), 以及与之对应的出错信息; 类似 {"businessCode": "错误信息"}; 具体参见失败示例;如果有错误信息,则返回的code为NACK,然后错误信息会放在errorData里,只有全部成功返回的code为ACK。
请求参数
参数 | 类型 | 必须 | 主键 | 默认值 | 描述 |
---|---|---|---|---|---|
name | string | Y | 业务实体名称,公司内唯一 | ||
businessCode | string | Y | Y | 业务实体编码,若businessCode已存在,则更新已有数据 | |
baseCurrency | string | N | CNY | 业务实体本币 | |
principal | string | N | 业务实体负责人工号 | ||
active | bool | N | false | 是否启用 | |
parentBizCode | string | N | 上级业务实体编码 |
返回数据
字段 | 类型 | 描述 |
---|---|---|
code | string | 该业务实体系统内唯一主键 |
businessCode | string | 业务实体编码 |
示例
请求数据
{
"timestamp": 123456,
"data": [
{
"name": "业务实体A",
"businessCode": "YWSTA",
"baseCurrency": "CNY",
"principal": "10001",
"active": true,
"parentBizCode": null
}
]
}
返回数据(成功)
{
"responseCode": "ACK",
"errorMessage": "",
"data": [{
"businessCode": "YWSTA",
"code": "ABCDAAFA1234"
}
]
}
返回数据(失败)
{
"responseCode": "NACK",
"errorMessage": "处理错误"
}