更新操作接口
1 接口介绍
更新操作服务是指通过在请求体中按规范输入json格式的参数，并指定要更新的具体业务对象，再调用服务执行更新操作。
2 注意事项
1）API默认只会更新请求体参数中携带的字段，请求体中不携带的字段不会更新；
2 ）更新操作与保存操作服务的调用路由（url）相同，区别在于更新操作API会在请求参数中带上准确的id信息，系统默认根据id去匹配对应的单据，再修改相应字段；
3）在请求体中可以添加参数"KeyFields"，该参数可以指定更新引入时的匹配字段，比如billno等其他候选键，用来查找待更新的数据，若不指定则默认根据主键id匹配；
4）在请求体中可以添加参数“updateFields”，该参数可以指定要更新的字段，当请求体携带这个参数且指定了更新字段时，接口只会更新参数中声明的字段。若不携带该参数，会默认根据请求体传入的字段，覆盖原业务对象的数据；
5）可以在分录中带上内码（内码id需要加上双引号），指定更新某行分录，若不指定内码，会在单据中新增分录行。
3 接口示例
采购订单修改（含分录）
URL：{{host}}/kapi/sys/pm_purorderbill/save 请求方式：POST 请求Header参数： Content-Type=application/json accessToken: xxxxxxxxxxxxx |
请求Body： { "data": { "org": { "number": "000" }, "id": "1205743530614482944", "biztime": "2021-07-21 15:15:22", "billstatus": "A", "bizorg": { "number": "000" }, "supplier": { "number": "Sup-000002" }, "settlecurrency": { "number": "AM040201" }, "exratetable": { "number": "ERT-21" }, "exratedate": "2021-07-21 15:15:22", "paymode": "CREDIT", "exchangerate": 1.0000000000, "istax": "1", "comment":”test” "billentry": [ { "id":"1205753370116122624", "material": { "number": "Item-00000016" }, "qty": "1007", "unit": { "number": "pcs" }, "entrycomment":””tes” } ] }, "option": { "importtype": "override" }, "updateFields": [ "comment", "billentry", "qty", "entrycomment" ] } |
请求结果： { "data": { "success": true, "needSign": false, "needWfAssignPersons": false, "cancelWriteLog": true, "showMessage": true, "billCount": 1, "successPkIds": [ 1205743530614482944 ], "billNos": { "1205743530614482944": "CGDD-210721-067006" }, "validateResult": { "validateErrors": [], "success": true, "message": "", "errorPkIds": [], "errorDataIndexs": [] }, "runSecond": 0, "allErrorOrValidateInfo": [], "allErrorInfo": [] }, "success": true, "errorCode": "success", "message": null } |
4 返回参数说明
序号 | 参数 | 解释 | 返回值实例 |
1 | success | 是否成功 | true/false |
2 | errorCode | 错误编码 | success/false |
3 | message | 提示信息 | 成功时为null，失败时会返回错误信息 |
4 | data | 业务对象数据 | {"successPkIds":[1205743530614482944],"billNos":{"1205743530614482944": "CGDD-210721-067006"}...} |
更新操作接口
本文2024-09-23 00:26:53发表“云苍穹知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-cangqiong-139524.html
