文档中心
使用电子云签服务时,电子面单下单接口应该如何传参?

使用电子云签服务时,电子面单下单接口应该如何传参?

使用云签电子回单服务时,下单请求需传入以下额外参数。不同快递公司要求略有差异,请严格按对应规则传递。

额外参数汇总表

参数名适用快递公司是否必填说明
fileUrl全部文件上传接口返回的 fileId,直接传入即可。
orderId德邦文件上传成功响应中返回的 orderId 字段。
needBack德邦、京东固定值 "1",表示需要回单服务。注意:顺丰不要传入此参数。
fileTempCode京东云签模板编码,按实际模板填写。 联系京东销售人员获取编码
addService德邦、京东回单服务配置,值为 JSON 字符串,**注意需要转义。**具体内容因快递公司而异,详见下方 addService 明细表

addService 明细表

适用快递公司参数名值(JSON 字符串)字段说明
德邦addService{"backnum":{"value":"电子云签"}}backnum 表示回单服务;value 指定回单形式为“电子云签”。
京东addService{"backnum":{"reReceiveMode":["链上签"]}}backnum 表示回单服务;reReceiveMode 为签单返还模式编码,固定填写 "链上签"

说明addService 虽参数名相同,但德邦与京东的内部 JSON 结构不同,请务必按对应公司选择正确的值。实际传输时需对双引号进行转义(如请求示例所示)。 注意:上表中未列出的参数(如 kuaidicomrecMan 等)为基础下单字段,不在此赘述。

快递公司详细规则

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"
}