签收状态同步接口

  • 接口:/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未到达终级签收人环节,无法变更签收状态"}
}

results matching ""

    No results matching ""