签收退回接口

  • 接口:/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": "签收状态异常"}
}

results matching ""

    No results matching ""