签收退回接口
接口:/signForTasks/return
Method:POST
数据格式:JSON
请求参数:
字段 | 类型 | 必须 | 默认值 | 描述 |
---|---|---|---|---|
signForTasks | List<SignForTaskForm> | Y | 单据签收参数 | |
reason | String | N | 退回理由 |
SignForTaskForm.class
字段 | 类型 | 必须 | 默认值 | 描述 |
---|---|---|---|---|
formCode | String | Y | 单据号 | |
formType | String | N | 单据类型,可选值REIMBURSE,CORP_REIMBURSE |
该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(formCode)会被放在errorData里面;
errorData为结构体, 包含出错记录主键(formCode), 以及与之对应的出错信息; 类似 {"formCode": "错误信息"}; 具体参见失败示例;
为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;
示例
请求示例
{
"timestamp":123456,
"data":{
"reason":"退回理由",
"signForTasks":[
{
"formCode":"MY117081203",
"formType":"REIMBURSE"
},
{
"formCode":"MY117081204",
"formType":"REIMBURSE"
}
]
}
}
返回数据(成功)
{
"code": "ACK",
"message": ""
}
返回数据(失败)
{
"code": "NACK",
"errorData": {"MY117081203": "签收状态异常"}
}