Skip to main content

批量码延期

接口用途

  • 多码批量延期时，调用此接口
  • 批量延期有两种方式：1.所有的码同一个有效期；2.每个码单独对应一个有效期。

接口说明

  • 一次可以多码延期,一次最多1000个码。

action

  • BatchCodeUpdate

请求参数，CHANNEL===>WHALE

字段 类型 是否必填 字段意义 备注
requestId String 是 请求流水号 32个字符，用于标识唯一一笔交易
codeArray List 否 码号数组 所有的码同一个有效期，与codeObjArray选择一个上传。该值上传时codeValidEnd必填
codeValidEnd String 否 码有效期结束时间 codeArray上传时，该值必填
codeObjArray List<CodeDelayInfo> 是 码更新集 每个码单独对应一个有效期。与codeArray选择一个上传
saleChannelId Long 否 取码方id  
saleChannelOrderId String 否 取码方制码订单号 当codeArray和codeObjArray均无值时取该订单号下所有串码进行延期。当订单号有值时取码方id必填
callBackUrl String 是 更新成功后的回调地址  
updateShopNo String(10) 否 更新门店号  
updateOrg String(10) 否 更行机构  
optTag String(2) 是 操作分类 B5：批量延期

请求报文举例

{
    "requestId":"20181019112535100000000000000001",
    "codeArray": ["10215523190570712621"],
    "callBackUrl": "http://test.com/api/codeVoid",
    "codeValidEnd": "20200224235959",
    "optTag": "B5",
}

同步返回参数，WHALE===>CHANNEL

字段 类型 是否必填 字段意义 备注
returnCode String 是 请求返回码  
returnMsg String 是 请求返回信息  
data Object<statusUpdateData> 是 批量码作废初步校验返回

同步返回报文举例

{
    "returnCode": "00",
    "returnMsg": "操作成功",
    "data": {
        "requestId": "10000000000000000000002",
        "tradeNo": "10000000000000000000002",
        "codeNum": 1
    }
}

回调返回参数，WHALE===>CHANNEL

字段 类型 是否必填 字段意义 备注
returnCode String 是 请求返回码  
returnMsg String 是 请求返回信息  
data Object<statusUpdateCallbackData> 否 码状态更新返回数据

回调返回报文举例

{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "tradeNo": "9e22d9a9e532435db77bccdfd8a74ee5",
        "requestId": "20181019112535100000000000000008",
        "totalCodeNum": 1,
        "successCodeNum": 1,
        "codeArray": [{
            "code": "100213321414112234",
            ...
            }],
    }
}
No Comments
Back to top
Entity Select