Loading [MathJax]/jax/output/CommonHTML/config.js
前往小程序，Get更优阅读体验！
立即前往
文档建议反馈控制台
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
发布
首页
学习
活动
专区
圈层
工具
MCP广场
返回腾讯云官网
社区首页 >专栏 >【快递员上门取件API接口对接-退换货下单预约取件接口】

【快递员上门取件API接口对接-退换货下单预约取件接口】

原创
作者头像
kwan的解忧杂货铺
发布于 2024-12-20 14:12:21
发布于 2024-12-20 14:12:21
17000
代码可运行
举报
运行总次数：0
代码可运行
关联问题
换一批

在开始今天的分享之前，我想先推荐一篇非常精彩的文章。 文章就是《渗透测试文件包含漏洞原理与验证(1)——文件包含概述》🚀🌟🚀🌟🚀🌟 链接是：点击这里。 这篇文章详细解释了文件包含漏洞的原理，以及如何在实际的 Web 应用程序中发现和验证这类漏洞。它提到，文件包含漏洞通常发生在 PHP 等脚本语言中，当开发者在引入文件时没有对文件名进行充分的校验，就可能导致意外的文件泄露或恶意代码注入。 文章还介绍了几种 PHP 中的文件包含函数，包括include()、include_once()、require()和require_once()，以及它们在找不到文件时的不同行为。此外，文章还探讨了利用文件包含漏洞的条件，比如函数通过动态变量引入文件，以及用户能够控制这个动态变量。 通过一些实际的示例，文章展示了如何通过修改文件扩展名来绕过某些安全限制，以及如何通过修改 URL 参数来实现文件包含攻击。 这篇文章不仅提供了丰富的技术细节，还强调了合法合规的重要性。它提醒我们，所有的渗透测试活动都应该在获得明确授权的情况下进行，并且要遵守相关法律法规。 如果你对 Web 安全感兴趣，或者想要提高你的 Web 应用程序的安全性，我强烈推荐你阅读这篇文章。它不仅能够提供实用的技术知识，还能帮助你更好地理解安全领域的法律和道德规范。让我们一起在合法合规的前提下，探索和提升 Web 安全吧！

一、接口介绍

发现一个非常好用的上门取件 API 接口——快递 100 商家寄件 API。通过这个接口提交寄件请求，可以直接下单至各快递公司，实现快递员上门取件，下单还可以享运费折扣

这个接口支持国内主流快递公司如 EMS、德邦、京东、极兔、圆通、申通、中通、韵达下单，也就不需要逐家接口对接了。

适用场景：电商退换货用户可以在 APP 上一键退货并自选上门取件的时间；二手回收；发货量较小，无月结账号的微商发货；品牌商家门店发货或门店调拨。

image-20241219020736886
image-20241219020736886

二、 接口测试与对接指南

登录地址： https://api.kuaidi100.com/login/

在对接快递 100 预约上门取件接口前，我们需要完成以下步骤：

注册与获取 API Key

前往快递 100API 开放平台注册账号。 联系客户经理充值运费，获取 API Key 和 Secret。

1、商家寄件（下单价格）

注意：下单价格就是可以查看到下单的预估价格，然后还有折扣的价格

1.1 请求地址

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

https://poll.kuaidi100.com/order/borderapi.do

1.2 请求参数：

参数名

是否必填

类型

说明

method

是

string

业务类型（默认：price）

key

是

string

授权码，请到快递 100 页面申请企业版接口获取

sign

是

string

32 位大写，签名，用于验证身份，按 MD5 (param +t+key+ secret)的顺序进行 MD5 加密，不需要加上“+”号 secret 在授权邮件里面有

t

是

string

时间戳如：1576123932000

param

是

param

由其他字段拼接

param 数据结构：

参数名

是否必填

类型

说明

kuaidiCom

是

string

快递公司编码

sendManPrintAddr

是

string

出发地地址，最小颗粒到市级，例如：广东省深圳市

recManPrintAddr

是

string

目的地地址，最小颗粒到市级，例如：广东省深圳市

weight

否

string

重量，单位：kg，默认：1KG

serviceType

否

string

业务类型

channelSw

否

string

渠道 ID，如有多个同品牌运力，请联系商务提供后传入

1.3 返回结果

字段

类型

说明

备注

result

boolean

提交结果

true 提交成功，false 失败

returnCode

string

返回编码

message

string

返回报文描述

data

data

运力对象

data 数据结构：

参数名

类型

说明

defFirstPrice

string

标准首重价格，单位：元

defOverPrice

string

标准续重价格，单位：元

defPrice

string

标准总价，单位：元

firstPrice

string

折后首重价格，单位：元

overPrice

string

折后续重价格，单位：元

price

string

折后总价，单位：元

serviceType

string

业务类型

1.4 提供数据内容

请求参数示例

代码语言：apl
AI代码解释
复制
method = price
key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "kuaidicom": "yuantong",
    "sendManPrintAddr": "杭州市西湖区东三十马路",
    "recManPrintAddr": "黑龙江哈尔滨南岗区一匡小区",
    "weight": "1",
    "serviceType": "标准快递"
}

返回结果示例

代码语言：json
AI代码解释
复制
{
  "data": {
    "firstPrice": "8.0",
    "defPrice": "8.0",
    "defFirstPrice": "8.0",
    "price": "8.0",
    "serviceType": "标准快递",
    "overPrice": "0",
    "defOverPrice": "0",
    "kuaidiCom": "zhongtong"
  },
  "message": "成功",
  "result": true,
  "returnCode": "200"
}

说明：

信息代码

信息内容描述

原因及建议处理方式

200

提交成功

提交成功

400

参数错误等

请根据技术文档请求，注意参数类型及是否必填

500

服务器错误

快递 100 的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误

503

验证签名失败

请检查加密方式，param + t + key + secret 的顺序进行 MD5 加密，加密后字符串转大写,不用加上“+”号

600

您不是合法的用户（即授权 Key 出错）

账号无可用余额，需要充值

601

KEY 已过期

账号无可用余额，需要充值

1.5 Python 测试代码和测试结果

测试代码
代码语言：python
代码运行次数：0
运行
AI代码解释
复制
# coding = utf-8
import hashlib
import json
import time
import requests


def do_request(url, key, secret, method, t, param):
    md = hashlib.md5()
    md.update((param + t + key + secret).encode())
    sign = md.hexdigest().upper()
    payload = {
        'key': key,
        'method': method,
        't': t,
        'param': param,
        'sign': sign
    }
    return requests.post(url, payload).text


if __name__ == '__main__':
    key = ''  # TODO 客户授权key
    secret = ''  # TODO 秘钥
    url = 'https://poll.kuaidi100.com/order/borderapi.do'  # 请求地址
    method = 'price'


    param = {
        "kuaidiCom": "yuantong",
        "sendManPrintAddr": "杭州市西湖区东三十马路",
        "recManPrintAddr": "黑龙江哈尔滨南岗区一匡小区",
        "weight": "",
        "serviceType": ""
    }
    t = str(int(round(time.time() * 1000)))
    result = do_request(url, key, secret, method, t, json.dumps(param))
    print(result)
测试数据
image-20241218132142538
image-20241218132142538
测试结果
image-20241218183403650
image-20241218183403650

测试结果概述：returnCode=200 表示接口请求成功。具体返回信息如下表：

参数名

内容

说明

defFirstPrice

15.00

标准首重价格，单位：元

defOverPrice

0.0

标准续重价格，单位：元

defPrice

15.00

标准总价，单位：元

firstPrice

6.50

折后首重价格，单位：元

overPrice

0.0

折后续重价格，单位：元

price

6.50

折后总价，单位：元

serviceType

标准快递

业务类型

注意：具体返回数据以接口实时返回数据为主。

2、商家寄件（下单）

选择快递公司进行下单,可以预约上门取件时间。

2.1 接口格式

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

2.2 请求地址

正式请求地址：https://poll.kuaidi100.com/order/borderapi.do（订单将推至快递公司）

沙箱请求地址：https://api.kuaidi100.com/apiMock/border（订单将不推至快递公司：沙箱下单后，可通过：调试工具-商家寄件-下单回调，调试订单各阶段状态。）

请求参数：

参数名

是否必填

类型

说明

method

是

string

业务类型（默认：bOrder）

key

是

string

授权码，请到快递 100 页面申请企业版接口获取

sign

是

string

32 位大写签名，用于验证身份，按 MD5 (param +t+key+ secret)的顺序进行 MD5 加密，不需要加上“+”号。secret 在企业管理后台获取

t

是

string

时间戳如：1576123932000

param

是

param

由其他字段拼接

param 数据结构：

参数名

是否必填

类型

说明

kuaidicom

是

string

快递公司的编码，一律用小写字母，见《快递公司编码》

recManName

是

string

收件人姓名

recManMobile

是

string

收件人的手机号，手机号和电话号二者其一必填

recManPrintAddr

是

string

收件人所在完整地址，如广东深圳市深圳市南山区科技南十二路 2 号金蝶软件园

sendManName

是

string

寄件人姓名

sendManMobile

是

string

寄件人的手机号，手机号和电话号二者其一必填

sendManPrintAddr

是

string

寄件人所在的完整地址，如广东深圳市深圳市南山区科技南十二路 2 号金蝶软件园 B10

callBackUrl

是

string

callBackUrl 订单信息回调地址

cargo

否

string

物品名称,例：文件。当 kuaidicom=jd，yuantong 时，必填

payment

否

string

支付方式，SHIPPER: 寄付（默认）。不支持到付

serviceType

否

string

业务类型，默认为标准快递，各快递公司业务类型对照参考：七、业务类型参数表

weight

否

string

物品总重量 KG，不需带单位，例：1.5

remark

否

string

备注

dayType

否

string

预约日期，例如：今天/明天/后天

pickupStartTime

否

string

预约起始时间（HH:mm），例如：09:00，顺丰必填

pickupEndTime

否

string

预约截止时间（HH:mm），例如：10:00，顺丰必填，预约起始时间和预约截止时间间隔需 ≥1 小时；中通有严格要求：需要严格按照五个时间段 9:00-11:00、11:00-13:00、13:00-15:00、15:00-17:00、17:00-19:00 进行预约时间的传参，超过 19 点，自动预约第二天的时间；

channelSw

否

string

渠道 ID，如有多个同品牌运力，请联系商务提供后传入

下单扩展属性

valinsPay

否

string

保价额度，单位：元 （当前仅京东、德邦、圆通、极兔和申通支持线上保价，其他快递传值无效，具体费率可咨询商务）

realName

否

string

寄件人实名信息（圆通、极兔支持 ）

sendIdCardType

否

string

寄件人证件类型，1：居民身份证 ；2：港澳居民来往内地通行证 ；3：台湾居民来往大陆通行证 ；4：中国公民护照（圆通、极兔支持 ）

sendIdCard

否

寄件人证件号码 （圆通、极兔支持 ）

passwordSigning

否

string

是否口令签收，Y：需要 N: 不需要，默认值为 N（德邦快递专属参数）

op

否

string

是否开启订阅功能 0：不开启(默认) 1：开启 说明开启订阅功能时：pollCallBackUrl 必须填入 此功能只针对有快递单号的单

pollCallBackUrl

否

string

如果 op 设置为 1 时，pollCallBackUrl 必须填入，用于跟踪回调，回调内容通过五、快递信息推送接口返回（免费服务）

resultv2

否

string

添加此字段表示开通行政区域解析功能 。 0：关闭（默认） 1：开通行政区域解析功能以及物流轨迹增加物流状态名称 (详见：快递信息推送接口文档) 3：开通行政区域解析功能以及物流轨迹增加物流状态名称，同时返回地图内容(详见：地图轨迹推送接口文档)

returnType

否

string

面单返回类型，默认为空，不返回面单内容。10：设备打印，20：生成图片短链回调。

siid

否

string

设备码，returnType 为 10 时必填

tempid

否

string

模板编码，通过管理后台的电子面单模板信息获取 ，returnType 不为空时必填

printCallBackUrl

否

string

打印状态回调地址，returnType 为 10 时必填

salt

否

string

签名用随机字符串，用于验证签名 sign。salt 值不为 null 时，推送数据将包含该加密签名，加密方式：md5(param+salt)。注意： salt 值为空串时，推送的数据也会包含 sign，此时可忽略 sign 的校验。

thirdOrderId

否

string

平台订单号，最大 32 位。若此参数与之前的重复，48 小时内返回第一次下单内容，否则会重新下单。

2.3 返回结果

字段

类型

说明

备注

result

boolean

提交结果

true 提交成功，false 失败

returnCode

string

返回编码

message

string

返回报文描述

data

data

data 数据结构

字段

类型

说明

备注

taskId

string

任务 ID

orderId

string

订单 ID

kuaidinum

string

快递单号

pollToken

string

查询密钥，调用实时快递查询接口时入参此字段可免费查询该快递单号，一个快递单号对应一个密钥

eOrder

string

快递面单附属属性，根据各个快递公司返回属性

eOrder 数据结构

字段

类型

说明

备注

bulkpen

string

大头笔

用于显示于电子面单上规定位置，非必需，是否有值取决于快递公司

orgCode

string

始发地区域编码

orgName

string

始发地/始发网点名称

destCode

string

目的地区域编码

destName

string

目的地/到达网点

orgSortingCode

string

始发分拣编码

orgSortingName

string

始发分拣名称

destSortingCode

string

目的分栋编码

destSortingName

string

目的分栋中心名称

orgExtra

string

始发其他信息

destExtra

string

目的其他信息

pkgCode

string

集包编码

pkgName

string

集包地名称

road

string

路区

qrCode

string

二维码

kdComOrderNum

string

快递公司订单号

expressCode

string

快递业务类型编码

expressName

string

快递业务类型名称

waterMark

string

水印

agingName

string

时效

abFlag

string

电子产品类型图标

proCode

string

时效产品图标

codingMapping

string

进港映射码

codingMappingOut

string

出港信息

printIcon

string

图标名称

destRouteLabel

string

目的地（路由信息）

twoDimensionCode

string

二维码信息

xbFlag

string

顺丰面单标识，快运必填，xbFlag=1，打印 SX 标；xbFlag=2，打印融通标

注意：eOrder 实际返回的字段各家快递公司不同，以实际返回为准

2.4 提供数据内容

请求参数示例

代码语言：apl
AI代码解释
复制
method = bOrder
key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "kuaidicom": "yuantong",
    "recManName": "王超",
    "recManMobile": "13800138000",
    "recManPrintAddr": "西藏日喀则市定日县珠穆朗玛峰",
    "sendManName": "王大",
    "sendManMobile": "13800138000",
    "sendManPrintAddr": "西藏日喀则市定日县珠穆朗玛峰",
    "cargo": "文件",
    "callBackUrl": "http: //www.baidu.com",
    "payment": "SHIPPER",
    "serviceType": "标准快递",
    "weight": "1",
    "remark": "",
    "salt": "",
    "dayType": "",
    "pickupStartTime": "",
    "pickupEndTime": "",
    "passwordSigning": "Y",
    "valinsPay": "",
    "op": "0",
    "pollCallBackUrl": "",
    "resultv2": "0",
    "returnType": "",
    "siid": "",
    "tempid": "",
    "printCallBackUrl": ""
}

返回结果示例

代码语言：json
AI代码解释
复制
{
    "result": true,
    "returnCode": "200",
    "message": "提交成功",
    "data": {
        "taskId": "", // 任务ID
        "orderId": "" // 订单ID
        "kuaidinum": "" // 快递单号
        "eOrder": "[\"destName\":null,\"orgName\":null,\"pkgCode\":null,\"pkgName\":null,\"bulkpen\":\"上海-S33-K27-P\",\"orgExtra\":null}]"
    }
}

说明：

信息代码

信息内容描述

原因及建议处理方式

200

提交成功

提交成功

400

参数错误等

请根据技术文档请求，注意参数类型及是否必填

500

服务器错误

快递 100 的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误

501

重复提交

重复提交了请求

503

验证签名失败

请检查加密方式，param + t + key + secret 的顺序进行 MD5 加密，加密后字符串转大写,不用加上“+”号

600

您不是合法的用户（即授权 Key 出错）

账号无可用余额，需要充值

601

KEY 已过期

账号无可用余额，需要充值

700

错误的回调地址

检查回调地址，或者联系快递 100 工作人员

2.5 python 测试代码和测试结果

测试代码
代码语言：python
代码运行次数：0
运行
AI代码解释
复制
# coding = utf-8
import hashlib
import json
import time
import requests


def do_request(url, key, secret, method, t, param):
    md = hashlib.md5()
    md.update((param + t + key + secret).encode())
    sign = md.hexdigest().upper()
    payload = {
        'key': key,
        'method': method,
        't': t,
        'param': param,
        'sign': sign
    }
    return requests.post(url, payload).text


if __name__ == '__main__':
    key = '********'  # TODO 客户授权key
    secret = '********'  # TODO 秘钥
    url = 'https://poll.kuaidi100.com/order/borderapi.do'  # 请求地址
    method = 'bOrder'


    param = {
        "kuaidicom": "shentong",
        "recManName": "李四",
        "recManMobile": "15045666312",
        "recManPrintAddr": "黑龙江哈尔滨南岗区一匡小区",
        "sendManName": "张三",
        "sendManMobile": "15045666311",
        "sendManPrintAddr": "杭州市西湖区东三十马路",
        "cargo": "书籍",
        "callBackUrl": "http://meihua150.cn/reback",
        "payment": "",
        "serviceType": "",
        "weight": "",
        "remark": "",
        "salt": "",
        "dayType": "",
        "pickupStartTime": "",
        "pickupEndTime": "",
        "passwordSigning": "N",
        "valinsPay": "",
        "op": "0",
        "pollCallBackUrl": "",
        "resultv2": "0"
    }
    t = str(int(round(time.time() * 1000)))
    result = do_request(url, key, secret, method, t, json.dumps(param))
    print(result)
    # {"data":{"kuaidinum":"YT2213099035201","orderId":"20066771","attach":null,"taskId":"9FC293CA417E431F33046E64F4C4EC20"},"message":"提交成功","result":true,"returnCode":"200"}
测试数据
image-20241218132229381
image-20241218132229381
测试结果
image-20241217213450004
image-20241217213450004

测试结果概述：returnCode=200 表示接口请求成功。具体返回信息如下表：

字段

内容

说明

taskId

EFCC9B7835C226766E2BC9AE1E420593

任务 ID

orderId

229206462

订单 ID

kuaidinum

772035537682325

快递单号

pollToken

KsofHmxy3xoaqYjoV1zb+49aRtW/04Z9rEMtlTg2pqU="

查询密钥，调用实时快递查询接口时入参此字段可免费查询该快递单号，一个快递单号对应一个密钥

attach

null

额外信息标签

注意：具体返回数据以接口实时返回数据为主。

3、商家寄件（下单取消）

对下完单且取件前的订单进行取消操作。对于不需邮寄的订单请及时进行取消，当月订单最晚需在次月 8 日前取消，否则将无法取消。

3.1 接口格式

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

3.2 请求地址

https://poll.kuaidi100.com/order/borderapi.do

请求参数：

参数名

是否必填

类型

说明

method

是

string

业务类型（默认：cancel）

key

是

string

授权码，请到快递 100 页面申请企业版接口获取

sign

是

string

32 位大写，签名，用于验证身份，按 MD5 (param +t+key+ secret)的顺序进行 MD5 加密，不需要加上“+”号 secret 在授权邮件里面有

t

是

string

时间戳如：1576123932000

param

是

param

由其他字段拼接

param 数据结构：

参数名

是否必填

类型

说明

taskId

是

string

任务 ID

orderId

是

string

订单 ID

cancelMsg

是

string

取消原因，例：暂时不寄件了，最大长度不超过 30 字符

3.3 返回结果

字段

类型

说明

备注

result

boolean

提交结果

true 提交成功，false 失败

returnCode

string

返回编码

message

string

返回报文描述

data

data

这里默认为空

3.4 提供数据内容

请求参数示例

代码语言：apl
AI代码解释
复制
method = cancel
key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "taskId": "*****",
    "orderId": "*****",
    "cancelMsg": "暂时不寄件了"
}

返回结果示例

代码语言：json
AI代码解释
复制
{
  "result": true,
  "returnCode": "200",
  "message": "取消成功",
  "data": {}
}

说明：

信息代码

信息内容描述

原因及建议处理方式

200

提交成功

提交成功

400

参数错误等

请根据技术文档请求，注意参数类型及是否必填

500

服务器错误

快递 100 的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，或者对已取消的订单重复操作取消，也会报此错误

501

重复提交

重复提交了请求

503

验证签名失败

请检查加密方式，param + t + key + secret 的顺序进行 MD5 加密，加密后字符串转大写,不用加上“+”号

600

您不是合法的用户（即授权 Key 出错）

账号无可用余额，需要充值

601

KEY 已过期

账号无可用余额，需要充值

700

错误的回调地址

检查回调地址，或者联系快递 100 工作人员

3.5 Python 测试代码和测试结果

测试代码
代码语言：python
代码运行次数：0
运行
AI代码解释
复制
# coding = utf-8
import hashlib
import json
import time
import requests


def do_request(url, key, secret, method, t, param):
    md = hashlib.md5()
    md.update((param + t + key + secret).encode())
    sign = md.hexdigest().upper()
    payload = {
        'key': key,
        'method': method,
        't': t,
        'param': param,
        'sign': sign
    }
    return requests.post(url, payload).text


if __name__ == '__main__':
    key = ''  # TODO 客户授权key
    secret = ''  # TODO 秘钥
    url = 'https://poll.kuaidi100.com/order/borderapi.do'  # 请求地址
    method = 'cancel'


    param = {
        "taskId": "EFCC9B7835C226766E2BC9AE1E420593",
        "orderId": "229206462",
        "cancelMsg": "暂时不寄件了"
    }
    t = str(int(round(time.time() * 1000)))
    result = do_request(url, key, secret, method, t, json.dumps(param))
    print(result)
测试数据
image-20241218132307870
image-20241218132307870
测试结果
image-20241217215001995
image-20241217215001995

测试结果概述：returnCode=200 表示接口请求成功，返回结果为取消成功。

注意：具体返回数据以接口实时返回数据为主。

4、商家寄件（下单回调）

订单有状态变更是会触发回调，回调后如果没有得到合作方正确返回，会重复回调多 2 次，即最多回调 3 次。间隔 30 分钟。

上门取件下单成功以后，快递员收到订单，会反馈接单状态，快递 100 会把状态实时推送到我们自己的服务器。

4.1 接口格式

提供统一格式的 HTTP POST,并返回统一格式 JSON 数据。

请求报头：Content-Type=application/x-www-form-urlencoded;charset=UTF-8

4.2 请求地址

请求参数：

字段

类型

说明

备注

taskId

string

任务 ID

sign

string

签名

32 位大写签名，MD5 (param +salt)

param

param

参数主体

param 数据结构：

参数名

是否必填

类型

说明

kuaidicom

是

string

快递公司的编码，一律用小写字母，见《快递公司编码》,选填。

kuaidinum

是

string

快递单号，单号的最大长度是 32 个字符。

status

是

string

状态码

message

是

string

状态描述

data

是

data

订单内容

data 数据结构：

参数名

是否必填

类型

说明

orderId

是

string

平台订单 ID

status

是

int

订单状态说明： 0：'下单成功'； 1：'已接单'； 2：'收件中'； 9：'用户主动取消'；10：'已取件'； 11：'揽货失败'；12：'已退回'； 13：'已签收'； 14：'异常签收'；15：'已结算' ；99：'订单已取消'；101：'运输中'；200：'已出单'；201：'出单失败'；610：'下单失败'；155：'修改重量'(注意需要在工单系统中发起异常反馈并由快递 100 服务人员确认调重后才会有此状态回调，回调内容包含修改重量后的重量、运费、费用明细、业务类型)；166：订单复活（订单被取消，但是实际包裹已经发出，正常计费）；400：派送中

cancelMsg9

否

string

用户取消原因

cancelMsg99

否

string

系统取消或下单失败原因

courierName

否

string

快递员姓名

courierMobile

否

string

快递员电话

netTel

否

string

网点电话，目前仅圆通会推送

netCode

否

string

网点编码，目前仅圆通会推送

weight

否

string

计费重量，单位：kg

defPrice

否

string

标准运费，单位：元

freight

否

string

折后运费，单位：元

volume

否

string

体积，单位：cm³

actualWeight

否

string

称重重量，单位：kg

ΘfeeDetails

否

list

费用明细，明细项目请展开

└ feeType

否

string

费用类型,参考：八、费用类型(feeType)说明

└ feeDesc

否

string

费用名称

└ amount

否

string

费用明细金额，单位：元

└ payStatus

否

string

支付状态，支付失败：-1；未支付：0；已支付：1 ；无需支付：2；已退款：3

printTaskId

否

string

打印任务 ID

label

否

string

面单短链，下单请求中 returnType 为 20 时返回

pickupCode

否

string

取件码，目前只有中通、申通会返回，在状态 1 时返回

pollToken

是

string

查询密钥，调用实时快递查询接口时入参此字段可免费查询该快递单号，一个快递单号对应一个密钥。

4.3 返回结果

字段

说明

备注

result

提交结果

true 提交成功，false 失败

returnCode

返回编码

message

返回报文描述

4.4 提供数据内容

请求参数示例

代码语言：apl
AI代码解释
复制
taskId = ** ** **
sign = ** ** **
param = {
    "kuaidicom": "yuantong",
    "kuaidinum": "1234567890",
    "status": "200",
    "message": "成功",
    "data": {
        "orderId": "*****",
        "status": "0",
        "courierName": "王大",
        "courierMobile": "13800138000",
        "weight": "1",
        "defPrice": "15.0",
        "freight": "5.1",
        "volume": "120",
        "actualWeight": "1",
        "feeDetails": [{
            "feeType": "PACKAGINGFEE",
            "feeDesc": "包装费",
            "amount": "0.8",
            "payStatus": 1
        }]，
        "printTaskId": "*****",
        "imgBase64": "*****"
    }
}

返回结果示例

代码语言：json
AI代码解释
复制
{
  "result": true,
  "returnCode": "200",
  "message": "成功"
}

4.5 回调响应报文及错误码解释

字段名称

字段含义

result

true 表示成功，false 表示失败。如果提交回调接口的地址失败，30 分钟后重新回调，3 次仍旧失败的，自动放弃

returnCode

200: 提交成功 500: 服务器错误 其他错误请自行定义

message

返回的提示

三、总结

快递 100API 开放平台提供以快递查询、快递在线下单预约上门取件为核心的一系列业务接口，对每个接口的开发文档丰富而全面，并且提供标准的多语言示例代码（Java、Python、PHP、.Net）。上面是对下单价格、下单、下单取消，下单回调接口的应用实例。

通过本文的指南，相信您可以快速完成相关接口对接，并利用这项技术提升用户体验和业务效率。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯技术创作特训营S11#重启人生

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯技术创作特训营S11#重启人生
评论
登录后参与评论
暂无评论
登录 后参与评论
推荐阅读
编辑精选文章
换一批
一文掌握 MCP 上下文协议：从理论到实践
3221
LLM 效果不好？可能是 Prompt 写错了！Prompt Engineering 技术的最全综述
1137
鹅厂写码13年，我总结的程序员高效阅读方法论
7433
进程，线程，协程 - 你了解多少？
3820
微服务与分布式系统设计看这篇就够了！
3150
腾讯文档表格卡顿指标探索之路
2668
快递100商家寄件运力接口-查询全国快递公司运力覆盖情况的案例代码
官方文档javapythonapi网站
https://order.kuaidi100.com/order/borderbestapi.do
快递100API
2021/05/24
1.3K0
快递100商家寄件运力接口-查询全国快递公司运力覆盖情况的案例代码
集成全国多家快递公司同城配送下单API接口代码-快递100
官方文档javapythonapiphp
https://order.kuaidi100.com/sameCity/order
快递100API
2021/05/25
1.2K0
集成全国多家快递公司同城配送下单API接口代码-快递100
快递100电商快递物流电子面单图片接口API案例代码
官方文档javapythonapiphp
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号，提交生成电子面单；通过管理后台模板配置，选择面单模板并可进行编辑，生成图片输出，可自选方式打印。
快递100API
2021/05/19
1.4K0
快递100电商快递物流电子面单图片接口API案例代码
快递100电商快递物流电子面单图片接口API案例代码
javapythonhtmljavascriptapi
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号，提交生成电子面单；通过管理后台模板配置，选择面单模板并可进行编辑，生成图片输出，可自选方式打印。
快递100API
2021/05/19
1.1K0
快递100电商快递物流电子面单图片接口API案例代码
快递100-电商/快递电子面单复打API接口案例
javapythonhtmlapiphp
https://poll.kuaidi100.com/printapi/printtask.do
快递100API
2021/05/19
8930
快递100-电商/快递电子面单复打API接口案例
快递100快递物流发货单API接口代码及功能说明
网站费用中心官方文档javapython
https://poll.kuaidi100.com/print/billparcels.do
快递100API
2021/05/24
1.7K0
快递100快递物流发货单API接口代码及功能说明
快递100快递信息订阅推送API接口案例代码
javapythonhtmlapiphp
当我方调用贵方的回调接口（callbackurl）时，贵方需要先将我方提交的数据保存至贵方的数据库，接着向我方返回是否成功接收的响应报文及代码，即贵公司直接在回调接口的地址的response中填写如下内容：
快递100API
2021/05/19
1.6K0
快递100快递信息订阅推送API接口案例代码
快递100轨迹查询-电商快递地图轨迹推送服务API接口案例代码
智慧物流apiopenapi云 APIjava
1.使用http协议表单提交的方式进行信息交互，字符编码默认统一采用UTF-8，数据格式：application/x-www-form-urlencoded；
快递100API
2021/05/18
1.8K0
快递100轨迹查询-电商快递地图轨迹推送服务API接口案例代码
快递100快递查询地图轨迹API接口案例代码
javapythonhtmljavascriptapi
提供统一格式的HTTP POST或GET调用接口,并返回格式支持JSON，xml，text，html数据。
快递100API
2021/05/17
1.5K0
快递100快递查询地图轨迹API接口案例代码
集成全国多家快递公司同城配送账号授权接口代码-快递100
javapythonapiphp官方文档
https://order.kuaidi100.com/sameCity/order
快递100API
2021/05/25
8700
集成全国多家快递公司同城配送账号授权接口代码-快递100
快递100如何获取第三方电商平台账号授权的快递物流接口API案例
官方文档javapythonapihtml
<p>https://poll.kuaidi100.com/printapi/authThird.do</p>
快递100API
2021/05/19
1.7K0
快递100如何获取第三方电商平台账号授权的快递物流接口API案例
快递100电商快递物流电子面单HTML接口API案例代码
官方文档javapythonhtmlapi
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号，提交生成电子面单号，返回固定面单模板，调用本地打印机即可打印出电子面单。
快递100API
2021/05/19
1.7K0
快递100电商快递物流电子面单HTML接口API案例代码
快递100快递实时物流快递查询接口API案例代码
java网站企业电商智慧物流
<a href="https://api.kuaidi100.com/manager/openapi/download/kdbm.do" style="color: #027eff;" target="_blank"><u>下载表格</u></a>
快递100API
2021/05/18
1.9K0
快递100快递实时物流快递查询接口API案例代码
退换货下单接口-快递员上门取件API
编程算法
（1）此功能是为买家在退货时，提供的一种省心，便捷的物流服务，当买家购买的商品在申请换货或者发起维权投诉时需要退货，不需要自己邮寄商品，由物流公司安排快递员上门取件的一项服务。 （2）下单需指定相应的快递公司编码，格式不对或则编码错误都会返回失败的信息。
老杨占线
2020/04/12
1.3K0
退换货下单接口-快递员上门取件API
快递查询、快递单识别、电子面单、家寄件等接口代码-快递100JAVA-DEMO
javapythonapiphp官方文档
快递查询、快递单识别、电子面单、家寄件等接口代码DEMO，由快递100官方提供的java sdk，方便调试使用。
快递100API
2021/05/25
1.4K0
快递查询、快递单识别、电子面单、家寄件等接口代码-快递100JAVA-DEMO
JAVA快递寄件下单api接口一次性接入顺丰,中通,圆通,申通,韵达,京东,德邦,百世,天天
云 APIapiAPI 网关openapi企业
为了让各位更快地接入顺丰,中通,圆通,申通,韵达,京东,德邦,百世,天天等主流快递公司，大家可以把源码复制到你的项目上，将源码里的参数改成自己的账户参数就能直接使用了。
快递100API
2021/08/10
1.2K0
快递100API实测：一键查询快递物流+实时推送，开发者的物流神器！
大数据api文档api
在电商、供应链、仓储管理等行业，物流信息的实时查询与推送已成为刚需。传统手动查询方式效率低下，而自建物流追踪系统成本高昂。因此，第三方快递查询API成为开发者的首选解决方案。小编最近就发现了一款超级好用的快递物流查询API接口软件——快递100旗下「百递云·API开放平台」，今天就让我们一起从实测角度来聊聊。
xcLeigh
2025/04/12
2290
快递100API实测：一键查询快递物流+实时推送，开发者的物流神器！
全国电商快递物流信息短信通知API代码-快递100
官方文档javapythonapiphp
<p>http://apisms.kuaidi100.com:9502/sms/send.do</p>
快递100API
2021/05/25
3.3K0
全国电商快递物流信息短信通知API代码-快递100
调用快递100查询类接口出现错误时的解决方法
云 APIjavaapiphppython
请用正确的x-www-form-urlencoded方式提交参数，也可以参考GitHub上的demo：https://github.com/kuaidi100-api
快递100API
2021/08/16
3.2K0
快递100API接口帮助文档_接入技术问题FAQ
apiopenapi云 API智慧物流企业
快递100API接口常见问题解答。此内容为技术对接FAQ，为您解决对接快递100API接口过程中遇到的问题。如果本篇内容没有覆盖到您的问题，请访问官方网站联系技术人员和运营人员帮您1对1处理。
快递100API
2021/08/10
8330
快递100API接口帮助文档_接入技术问题FAQ
推荐阅读
编辑精选文章
单体架构比微服务架构更落后吗？万级TPS优惠券系统设计与实践我独到的技术见解--大型前端项目的常见问题和解决方案
相关讨论
预约企业考察？辛苦确认下：这个接口，是不是不能统计实时预约会议的数据？直播未预约 怎么一直给发短息提示已经预约？
相关课程
AI代码助手快速上手训练营腾讯云开发玩转小程序实战训练营数字化IT从业者知识体系
快递100商家寄件运力接口-查询全国快递公司运力覆盖情况的案例代码
1.3K0
集成全国多家快递公司同城配送下单API接口代码-快递100
1.2K0
快递100电商快递物流电子面单图片接口API案例代码
1.4K0
快递100电商快递物流电子面单图片接口API案例代码
1.1K0
快递100-电商/快递电子面单复打API接口案例
8930
快递100快递物流发货单API接口代码及功能说明
1.7K0
快递100快递信息订阅推送API接口案例代码
1.6K0
快递100轨迹查询-电商快递地图轨迹推送服务API接口案例代码
1.8K0
快递100快递查询地图轨迹API接口案例代码
1.5K0
集成全国多家快递公司同城配送账号授权接口代码-快递100
8700
快递100如何获取第三方电商平台账号授权的快递物流接口API案例
1.7K0
快递100电商快递物流电子面单HTML接口API案例代码
1.7K0
快递100快递实时物流快递查询接口API案例代码
1.9K0
退换货下单接口-快递员上门取件API
1.3K0
快递查询、快递单识别、电子面单、家寄件等接口代码-快递100JAVA-DEMO
1.4K0
JAVA快递寄件下单api接口一次性接入顺丰,中通,圆通,申通,韵达,京东,德邦,百世,天天
1.2K0
快递100API实测：一键查询快递物流+实时推送，开发者的物流神器！
2290
全国电商快递物流信息短信通知API代码-快递100
3.3K0
调用快递100查询类接口出现错误时的解决方法
3.2K0
快递100API接口帮助文档_接入技术问题FAQ
8330
相关推荐
快递100商家寄件运力接口-查询全国快递公司运力覆盖情况的案例代码
更多 >
kwan的解忧杂货铺0
LV.5
开发
文章
173
获赞
81
专栏
2
作者相关精选
换一批
加入讨论
的问答专区 >
毛剑0
相关课程
一站式学习中心 >
AI代码助手快速上手训练营
1861人在学
腾讯云代码助手
腾讯云开发玩转小程序实战训练营
1563人在学
云开发 CloudBase
数字化IT从业者知识体系
396人在学
CODING DevOps
软件开发
领券

腾讯云开发者

扫码关注腾讯云开发者

扫码关注腾讯云开发者

领取腾讯云代金券

热门产品

热门推荐

更多推荐

Copyright © 2013 - 2025 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有 

深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 深公网安备号 44030502008569

腾讯云计算（北京）有限责任公司 京ICP证150476号 |  京ICP备11018762号 | 京公网安备号11010802020287

问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档

Copyright © 2013 - 2025 Tencent Cloud.

All Rights Reserved. 腾讯云 版权所有

登录 后参与评论
目录
本文部分代码块支持一键运行，欢迎体验
本文部分代码块支持一键运行，欢迎体验