使用电子云签服务时,电子面单下单接口应该如何传参?
使用云签电子回单服务时,下单请求需传入以下额外参数。不同快递公司要求略有差异,请严格按对应规则传递。
额外参数汇总表
| 参数名 | 适用快递公司 | 是否必填 | 说明 |
|---|---|---|---|
fileUrl | 全部 | 是 | 文件上传接口返回的 fileId,直接传入即可。 |
orderId | 德邦 | 是 | 文件上传成功响应中返回的 orderId 字段。 |
needBack | 德邦、京东 | 是 | 固定值 "1",表示需要回单服务。注意:顺丰不要传入此参数。 |
fileTempCode | 京东 | 是 | 云签模板编码,按实际模板填写。 联系京东销售人员获取编码 |
addService | 德邦、京东 | 是 | 回单服务配置,值为 JSON 字符串,**注意需要转义。**具体内容因快递公司而异,详见下方 addService 明细表。 |
addService 明细表
| 适用快递公司 | 参数名 | 值(JSON 字符串) | 字段说明 |
|---|---|---|---|
| 德邦 | addService | {"backnum":{"value":"电子云签"}} | backnum 表示回单服务;value 指定回单形式为“电子云签”。 |
| 京东 | addService | {"backnum":{"reReceiveMode":["链上签"]}} | backnum 表示回单服务;reReceiveMode 为签单返还模式编码,固定填写 "链上签"。 |
说明:
addService虽参数名相同,但德邦与京东的内部 JSON 结构不同,请务必按对应公司选择正确的值。实际传输时需对双引号进行转义(如请求示例所示)。 注意:上表中未列出的参数(如kuaidicom、recMan等)为基础下单字段,不在此赘述。
快递公司详细规则
1. 德邦快递(debangkuaidi)
needBack必须设置为"1"。addService:传入{"backnum":{"value":"电子云签"}}。orderId:传入云签文件上传成功后的orderId。fileUrl:必传。
2. 京东快递(jd)
needBack必须设置为"1"。addService:传入{"backnum":{"reReceiveMode":["链上签"]}}。fileTempCode:传入云签模板编码。fileUrl:必传。
3. 顺丰快递(shunfeng)
fileUrl:正常必传。
请求参数示例
{
"type": "",
"partnerId": "*****",
"partnerKey": "",
"code": "",
"kuaidicom": "debangkuaidi",
"recMan": {
"name": "张三",
"mobile": "159****912",
"printAddr": "深圳南山区金蝶软件园b栋",
"company": ""
},
"sendMan": {
"name": "李四",
"mobile": "159*****912",
"printAddr": "深圳南山区金蝶软件园b栋"
},
"cargo": "test",
"weight": "",
"payType": "CONSIGNEE",
"expType": "标准快递",
"remark": "测试下单,请勿发货",
"needBack": "1",
"addService": "{\"backnum\":{\"value\":\"电子云签\"}}",
"orderId": "01732870368200FDzAJD",
"fileUrl": "3725563646228405255",
"fileTempCode": "XXXLLL"
}