一、电子回单接口介绍

电子回单是在企业数字化转型背景下，快递公司推出的在物流履约交付环节协助客户与收件人进行合同签署的新型增值服务，助力企业实现信息流和物流合二为一。快递100电子回单接口可实现一次对接多家物流公司，减少客户开发成本。不同快递公司对电子回单称呼不同，详见文档第四部分。

二、电子回单接口对接流程

2.1 顺丰德邦对接流程

1.对接调用云签回单上传接口，获取合同ID等参数，详见第三部分对接说明。

2.调用电子面单下单接口，传入相关参数

3.物流签收后，调用图片注册接口传入回调地址给快递100

4.快递100调用客户提供的回调地址，将签署后的文件传回给客户

2.2 跨越对接流程

跨越对接流程见：https://api.kuaidi100.com/document/kuayuedianzihuidan

三、电子回单接口对接

3.1、回单文件上传接口

调用方向：客户>>快递100

3.1.1 请求地址

https://api.kuaidi100.com/thirdApi/file/upload

3.1.2 请求方式

post

Content-Type ：multipart/form-data;

3.1.3 请求参数

param参数结构

请求参数示例

curl --location 'https://api.kuaidi100.com/thirdApi/file/upload' \
--form 'file=@"/C:/Users/kuaidi100/Desktop/测试.png"' \
--form 'key="********"' \
--form 't="1732875767003"' \
--form 'sign="8044BB3D1A7B36829D0A6740688AB241"' \
--form 'param="{\"kuaidicom\":\"debangkuaidi\",\"fileName\":\"测试.png\"}"'

3.1.4 接口返回结果

data字段内容：

返回结果示例

{
    "code": 200,
    "data": {
        "orderId": "01732870368200FDzAJD",
        "fileId": "3725563646228405255"
    },
    "message": "success",
    "time": 0,
    "success": true
}

3.2、电子面单下单接口

调用方向：客户>>快递100

电子面单下单接口对接文档见电子面单下单

下单传参参考：电子面单下单使用电子回单服务如何下单？

3.3、回单文件注册接口

调用方向：客户>>快递100

3.3.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

3.3.2 请求地址

https://api.kuaidi100.com/label/order

3.3.3请求参数（header）

请求参数（body）

param数据结构：

请求参数示例

curl --location 'https://api.kuaidi100.com/label/order' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'method=register' \
--data-urlencode 'key=********' \
--data-urlencode 'sign=8044BB3D1A7B36829D0A6740688AB241' \
--data-urlencode 'param={
    "kuaidinum": "DPK123456",
    "phone": "13088888888",
    "kuaidicom": "debangkuaidi",
    "callbackUrl": "http://api.kuaidi100/test/callBack",
    "partnerId": "123456",
    "fileId":"3725553074795551748"
}' \
--data-urlencode 't=1732875767003'

3.3.4 接口返回结果

返回结果示例

{
    "code": 200,
    "data": {
        "taskId": "123456789012345678901234567890AB",
    },,
    "message": "success",
    "time": 0,
    "success": true
}

3.3.5 返回信息代码含义

3.4、文件回调

调用方向：快递100>>客户

文件注册后，当快递妥投后，会通过该方式推送到图片注册时传的callbackUrl接口，只回调1次。

3.4.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

3.4.2 请求地址

文件注册时传的callbackUrl接口

3.4.3请求参数（header）

请求参数（body）

param数据结构：

请求参数示例

curl --location --request POST 'http://www.baidu.com/test/callback' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'param={
  "kuaidinum": "SF13****168490",
  "kuaidicom": "shunfeng",
  "base64": "/9122se....."
}' \
--data-urlencode 'taskId=EA2B8757ECE45B9326873A639C91D91F' \
--data-urlencode 'pushType=register' 

3.4.4 返回结果

客户按以下格式返回结果给快递100

返回结果示例

{
    "returnCode": "200",
    "message": "success",
    "result": true
}

四、目前接口支持的快递公司

更多快递公司持续接入中。