签收状态同步接口
接口:/signForTasks/signFor
Method:POST
数据格式:JSON
请求参数:
字段 | 类型 | 必须 | 默认值 | 描述 |
---|---|---|---|---|
formCode | String | Y | 单据号 | |
category | String | Y | 签收状态,可选择值为NEED_SIGN(待签收),SIGNED(已签收) | |
signForEmployeeId | String | 签收人工号 |
该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(formCode)会被放在errorData里面;
errorData为结构体, 包含出错记录主键(formCode), 以及与之对应的出错信息; 类似 {"formCode": "错误信息"}; 具体参见失败示例;
为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;
signForEmployeeId只在category为SIGNED时有效,选填,如果填写以传入员工作为该单据当前任务的签收人,否则随机使用某个任务处理人作为实际签收人
示例
请求示例
{
"timestamp": 123456,
"data": [{
"formCode": "MY117081203",
"category": "SIGNED"
},{
"formCode": "MY117081204",
"category": "SIGNED"
}]
}
返回数据(成功)
{
"code": "ACK",
"message": ""
}
返回数据(失败)
{
"code": "NACK",
"errorData": {"MY117081203": "单据MY117081203未到达终级签收人环节,无法变更签收状态"}
}