一、智能时效预估接口

通过收寄件地址、下单时间和业务/产品类型来预估快递可送达的时间，以及过程需要花费的时间，分为全程模式和在途模式。

1.1 接口格式

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

1.2 请求地址

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

1.3 请求参数

请求参数（header）

请求参数（body）

param数据结构：

logistics内部object数据结构：

1.4 请求参数示例

全程智能时效预估入参示例：

method = time
key = kytRsteof
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
	 "from": "深圳南山区金蝶软件园",
	 "to": "北京海淀区",
	 "orderTime": "2023-09-14 08:08:08",
	 "kuaidicom": "shunfeng",
	 "expType": "标准快递"
        }

在途智能时效预估入参示例：

method = time
key = kytRsteof
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
    "from": "深圳南山区金蝶软件园",
    "to": "北京海淀区",
    "orderTime": "2023-09-14 08:08:08",
    "kuaidicom": "shunfeng",
    "logistics": [
        {
            "time": "2025-05-09 13:15:26",
            "context": "您的快件离开【吉林省吉林市桦甸市】，已发往【长春转运中心】"
        },
        {
            "time": "2025-05-09 12:09:38",
            "context": "您的快件在【吉林省吉林市桦甸市】已揽收"
        }
    ]
}

1.5 返回结果

data数据结构：

predictedRoute中object数据结构：

1.6 返回结果示例

全程智能时效预估成功返回示例：

{
    "code": 200,
    "data": {
        "fromName": "广东,深圳市,南山区,金蝶软件园",
        "fromNum": "440305000000",
        "toName": "北京,北京,海淀区,",
        "toNum": "110108000000",
        "arrivalTime": "2023-09-15 18:00:00",
        "deliveryExpendTime": "2",
        "taskId": "D9F5EBF5EA114794B681C812304E5CDD",
    	"totalTime": "67",
    	"remainTime": "67"
    },
    "message": "success",
    "time": 0,
    "success": true
}

在途智能时效预估成功返回示例：

{
    "code": 200,
    "data": {
        "arrivalTime": "2025-05-18 07:18:03",
        "deliveryExpendTime": "3",
        "fromName": "陕西,商洛市,洛南县,皇城广场",
        "fromNum": "611021000000",
        "predictedRoutes": [
            {
                "arriveTime": "2025-05-15 22:14:52",
                "city": "商洛市",
                "district": "洛南县",
                "leaveTime": "2025-05-16 08:51:03",
                "name": "陕西省商洛市洛南县",
                "province": "陕西",
                "state": "已经过节点",
                "type": "网点"
            },
            {
                "arriveTime": "2025-05-16 12:09:03",
                "city": "咸阳市",
                "district": "渭城区",
                "leaveTime": "2025-05-16 18:18:03",
                "name": "西安转运中心",
                "province": "陕西",
                "state": "预估途径节点",
                "type": "转运中心"
            },
            {
                "arriveTime": "2025-05-18 03:42:03",
                "city": "绍兴市",
                "district": "上虞区",
                "leaveTime": "2025-05-18 04:26:03",
                "name": "上虞转运中心",
                "province": "浙江",
                "state": "预估途径节点",
                "type": "转运中心"
            },
            {
                "arriveTime": "2025-05-18 07:40:03",
                "city": "绍兴市",
                "district": "越城区",
                "leaveTime": "2025-05-18 08:22:03",
                "name": "浙江省绍兴市城南",
                "province": "浙江",
                "state": "预估途径节点",
                "type": "网点"
            }
        ],
        "taskId": "68BBD959F99443F2BEA3618D25942F91",
        "toName": "浙江,绍兴市,越城区,灵芝街道境界府4幢1单元1803退货组送门口",
        "toNum": "330602000000"
    },
    "message": "success",
    "success": True,
    "time": 0
}

错误示例：

{
    "code": 30001,
    "message": "不支持该快递公司",
    "time": 0,
    "success": false
}

1.7 信息代码含义

二、支持的快递公司列表及业务/产品类型

2.1 全程时效预估支持的快递公司及业务类型

2.2 在途时效预估支持的快递公司