快递100电动车托运API接口文档

快递100电动车托运API接口文档，涵盖价格查询、托运下单、订单取消及状态回调等全部接口。支持电瓶车、摩托车、三轮车等车型，开发者可快速集成，实现实时运费查询、在线下单与全流程订单追踪。

调用流程说明：

1、价格查询：用户先调用 价格查询接口 ，传入起止地、物品类型等，获取预估运费。

2、托运下单：确认后调用 托运下单接口 ，提交完整寄收件信息、预约时间及回调地址，获得订单号。

3、状态回调：快递100会按订单状态变化（待取件→配送中→已完成），主动向用户提供的 callbackUrl 推送状态通知；回调失败有重试机制。

4、订单取消：仅在“待取件”状态下可调用 订单取消接口 取消订单，成功后同样会通过回调通知状态更新为“订单取消”。

一、 价格查询接口

1.1 请求地址

POST https://api.kuaidi100.com/consign/price

1.2 请求参数

param 数据结构

extra数据结构:

*到站自提：收货人需去最近营业网点取货；送货上门：送货至收货人楼下不上楼。

请求示例

{
    "sendProvince": "广东省",
    "sendCity": "深圳市",
    "sendDistrict": "南山区",
    "sendAddress": "科技园南区深圳湾科技生态园",
    "recProvince": "广东省",
    "recCity": "深圳市",
    "recDistrict": "龙华区",
    "recAddress": "龙华某某街道11号",
    "goodsNum": 2,
    "extra": {
        "goodsTypeId": 31,
        "appreciateId": 1,
        "deliveryId": 2
    }
}

1.3 响应参数

data数据结构

otherFee 对象结构：

响应示例

{
    "result": true,
    "returnCode": 200,
    "message": "成功",
    "data": {
        "deliverFee": "922.00",
        "otherFee": [
            {
                "feeType": "delivery_service_fee",
                "feeDesc": "配送服务费",
                "amount": "90.00"
            }
        ],
        "taskId": "B1E203B23DA94BB6B6563D22C8294772",
        "totalFee": "1012.00"
    }
}

二、 托运下单接口

2.1 请求地址

POSThttps://api.kuaidi100.com/consign/createOrder

2.2 请求参数

param 数据结构

extra数据结构:

*到站自提：收货人需去最近营业网点取货；送货上门：送货至收货人楼下不上楼。

请求示例：

{
    "sendName": "张三",
    "sendMobile": "13800138000",
    "sendProvince": "广东省",
    "sendCity": "深圳市",
    "sendDistrict": "南山区",
    "sendAddress": "科技园南区深圳湾科技生态园1111",
    "recName": "李四",
    "recMobile": "13900139000",
    "recProvince": "广东省",
    "recCity": "深圳市",
    "recDistrict": "龙华区",
    "recAddress": "龙华某某街道11号",
    "goodsNum": 1,
    "extra": {
        "goodsTypeId": 31,
        "appreciateId": 1,
        "deliveryId": 1
    },
    "remark": "易碎物品，请轻拿轻放",
    "dayType": "明天",
    "pickupStartTime": "09:00",
    "pickupEndTime": "12:00",
    "callbackUrl": "http://106.12.21.101:3001/callback/sentorder",
    "salt": "123"
}

2.3 响应参数

data数据结构

otherFee 对象结构：

响应示例：

{
    "result": true,
    "returnCode": 200,
    "message": "成功",
    "data": {
        "taskId": "3B9A04EA8D8443F18F72670212ACAC01",
        "orderId": 268,
        "outOrderId": "20302423432",
        "deliveryDistance": null,
        "phone": "4006115858",
        "totalFee": "436.00",
        "deliverFee": "436.00",
        "otherFee": [
            {
                "feeType": "delivery_service_fee",
                "feeDesc": "配送服务费",
                "amount": "0.00"
            }
        ],

    }
}

三、 订单取消接口

只有在待取件状态下才允许调用取消接口，快递员已揽收不允许取消

3.1 请求地址

POSThttps://api.kuaidi100.com/consign/cancel

3.2 请求参数

param 数据结构

请求示例：

{
    "orderId": "45",
    "cancelMsg": "张三"
}

3.3 响应参数

响应示例：

{
    "result": true,
    "returnCode": 200,
    "message": "成功",
    "data": {
        "taskId": "32599AA3DEA8423E8F26638988FEDCAB",
        "orderId": 45
    }
}

四、 下单回调接口

4.1 请求地址

POST 下单填写的callbackUrl

4.2 请求参数

param字段：

状态码

{
    "param": {
        "taskId": "B8237E815CFF46CE98AEAA0B6851BD84",
        "orderId": 46,
        "status": 720
    },
    "sign": "c945f835b6fb517c6083123c23bb7cec",
    "taskId": "B8237E815CFF46CE98AEAA0B6851BD84"
}

4.3 响应参数

{
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

失败后每隔20min重试一次，最多（含首次）调用3次。