国际寄件API接口文档

一、国际件查价接口

该接口用于查询国际件运费。

1.1 接口格式

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

1.2 请求地址

https://api.kuaidi100.com/apisentquery/international/queryPrice

请求参数：

param数据结构：

1.3 返回结果

data数据结构

1.4 请求参数示例

key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "kuaidiCom": "yuantongguoji",
    "weight": "2.6",
    "serviceType": "国际标快",
    "cargo": "文件",
    "recCountry": "South Korea"
}

返回结果示例

{
    "result": true,
    "returnCode": 200,
    "message": "SUCCESS",
    "data": {
        "firstPrice": "176.40",
        "overPriceUnit": "{\"0-0\":\"86.40\"}",
        "price": "392.40",
        "defPrice": "392.40",
        "defFirstPrice": "176.40",
        "defOverPrice": "{\"0-0\":\"86.40\"}",
        "overUnitWeight": "0.50",
        "overUnitPrice": "43.20",
        "overWeight": "2.50",
        "firstWeight": "0.50",
        "shippingFee": null,
        "fuelAdditionalFee": null,
        "resourceAdjustmentFee": null
    }
}

二、国际件下单接口

该接口用于创建国际件订单。

2.1 接口格式

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

2.2 请求地址

https://api.kuaidi100.com/international/createOrder

请求参数：

param数据结构：

SenderInfo（寄件人信息）

ReceiverInfo（收件人信息）

OrderInvoiceInfo（申报物品信息）

2.3 返回结果

data数据结构

2.4 请求参数示例

key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "serviceType": "国际标快",
    "thirdId": 80000000103438,
    "receiverInfo": {
        "country": "Singapore",
        "ename": "ruoheng lyua",
        "address": "sydney epping derby 2A",
        "province": "New South Wales",
        "city": "New South Wales",
        "name": "ruoheng lyua",
        "mobile": "+61  0480 392 958",
        "postCode": "546080"
    },
    "length": "50",
    "weight": "1.0",
    "senderInfo": {
        "country": "china",
        "ename": "一枚",
        "address": "高新园金蝶大厦",
        "province": "广东",
        "city": "深圳市",
        "district": "南山区",
        "name": "一枚",
        "mobile": "18000000000"
    },
    "orderInvoices": [
        {
            "unitPrice": "5020",
            "ename": "pc",
            "quantity": "1",
            "cname": "电脑",
            "originCountry": "中国",
            "currencyCode": "RMB"
        }
    ],
    "kuaidiCom": "yuantongguoji",
    "width": "10",
    "comment": "",
    "cargo": "包裹",
    "height": "10",
    "callbackUrl": "http://123:9100/apiOrder/callback",
    "pollCallbackUrl": "http://123:9100/apiOrder/callback",
    "salt": "112233"
}

返回结果示例

{
    "result": true,
    "returnCode": 200,
    "message": "SUCCESS",
    "data": {
        "taskId": "69794C5DF8D04E51BA1F5620AD626842",
        "orderId": "1040",
        "kuaidiNum": "G011123",
        "distributeCode": null,
        "pollToken": "VuKzV8A8PSqc479ZLq58IiX/g7EaizZurZ42gvu4P2Q="
    }
}

三、回调接口

该接口用于国际件订单的状态变化。

3.1 接口格式

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

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

3.2 请求参数

param数据结构：

FeeDetail（费用明细）

3.3 返回结果

3.4 请求参数示例

orderId=694509391680
sign=4BBDE07660E5EFF90873642CFAE9A8DD
param={
    "courierMobile": "13800138000",
    "courierName": "张三",
    "firstPrice": "63.60",
    "firstWeight": "0.50",
    "height": "10.00",
    "kuaidiCom": "yuantongguoji",
    "kuaidiNum": "G0310122",
    "length": "10.00",
    "orderId": "1039",
    "overPrice": "79.20",
    "overWeight": "1.50",
    "payStatus": 1,
    "pollToken": "uKdZVppmpxqFkUj4d7O1ibhl8ezHyMu4tA/miRvR5DI=",
    "price": "142.80",
    "serviceType": "国际标快",
    "status": 14,
    "thirdId": "80000000103438",
    "volume": "0.40",
    "volumeWeight": "0.40",
    "width": "20.00"
}

返回结果示例

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

四、国际件订单取消接口

该接口用于取消国际件订单。

4.1 接口格式

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

4.2 请求地址

https://api.kuaidi100.com/internatioanl/cancelOrder

请求参数：

param数据结构：

4.3 返回结果

4.4 请求参数示例

key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "orderId": "694509391663",
    "cancelMsg": "测试取消"
}

返回结果示例

{
    "result": true,
    "returnCode": 200,
    "message": "SUCCESS",
    "data": "取消成功"
}

五、国际件订单详情接口

该接口用于查询国际件订单详情。

5.1 接口格式

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

5.2 请求地址

https://api.kuaidi100.com/apisentquery/international/orderDetail

请求参数：

param数据结构：

5.3 返回结果

data数据结构

费用明细对象：FeeDetail

5.4 请求参数示例

key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
    "orderId": "694509391663"
}

返回结果示例

{
    "result": true,
    "returnCode": 200,
    "message": "SUCCESS",
    "data": {
        "orderId": 1041,
        "taskId": "803C274B9FBD40C5AE345402BC402367",
        "kuaidiCom": "yuantongguoji",
        "kuaidiNum": "G03100035948",
        "thirdId": "80000000103438",
        "serviceType": "国际标快",
        "preWeight": "1.0",
        "lastWeight": null,
        "senderName": "一枚",
        "senderEname": "一枚",
        "senderMobile": "18000000000",
        "senderCountry": "china",
        "senderProvince": "广东",
        "senderCity": "深圳市",
        "senderDistrict": "南山区",
        "senderAddress": "高新园金蝶大厦",
        "senderCompany": null,
        "senderPostCode": null,
        "senderAreaCode": null,
        "senderEmail": null,
        "receiverName": "ruoheng lyua",
        "receiverEname": "ruoheng lyua",
        "receiverMobile": "+61  0480 392 958",
        "receiverCountry": "Singapore",
        "receiverProvince": "New South Wales",
        "receiverCity": "New South Wales",
        "receiverDistrict": null,
        "receiverAddress": "sydney epping derby 2A",
        "receiverCompany": null,
        "receiverPostCode": "546080",
        "receiverAreaCode": null,
        "receiverEmail": null,
        "capacityId": 92,
        "capacityName": "圆通国际-官方-线上",
        "cargo": "包裹",
        "remark": null,
        "volume": null,
        "volumeWeight": null,
        "length": "50",
        "width": "10",
        "height": "10",
        "goodsDetail": "[{\"cname\":\"电脑\",\"currencyCode\":\"RMB\",\"ename\":\"pc\",\"originCountry\":\"中国\",\"quantity\":1,\"unitPrice\":\"5020\"}]",
        "insuredValue": null,
        "status": 99,
        "payStatus": 0,
        "cancleMsg": "测试取消",
        "cancleMsg99": null,
        "courierName": null,
        "courierMobile": null,
        "price": null,
        "firstPrice": null,
        "firstWeight": null,
        "overPrice": null,
        "overWeight": null,
        "createTime": "2025-08-18 15:27:44",
        "feeDetails": null
    }
}

状态码含义

订单状态码含义

国家编码对照表