运费查询

1、功能名称：运费查询

2、功能描述：运费查询

3、请求地址：https://ssl.glitzcloud.com/agent/v1/api/express/query

      测试地址：http://gztest.glitzcloud.com/agent/v1/api/express/query

4、请求方式：POST

5、请求参数

名称 类型 必填 示例值 描述
store_name String 是 The Warehouse USA 仓库名称
carrier String 否 UPS 快递公司
delivery String 否 UPS Ground 派送方式
package String 否 Your Packaging 包裹类型
postcode String 是 78781 邮编
weight Float 是 20 重量（kg）
length Float 是 30 长（cm）
width Float 是 20 宽（cm）
height Float 是 30 高（cm）
country_code String 否 US 国家二字码
state_code Float 否 AL 州二字码

6、请求示例

{
    "apikey": "d661bb3e817111e693f100163e06045",
    "secretkey": "d661bb75817111e693f100163e06045",
    "store_name": "TWUSA-Dallas",
    "sign": "5500fad4f9cbef52768d2e80f8c6a68b",
    "postcode": "78781",
    "weight": 1,
    "length": 1,
    "width": 1,
    "height": 1,
    "carrier": "UPS",
    "delivery": "UPS Ground"
}

7、返回格式：JSON

8、返回示例：

正确时的返回JSON数据包如下：

{
    "status": 200,
    "reqMsg": "ok",
    "result": [
        {
            "carrier": "UPS",
            "delivery": "UPS Ground",
            "package": "Your Packaging",
            "time_limit": "1-5天",
            "price": "22.71",
            "basic_price": "12.95",
            "user_shipping_discount_rate": "1",
            "additional_price": "9.76",
            "additional_price_items": {
                "additional_fee": "0.00",
                "additional_fee_extra": "0.00",
                "additional_value": "1.00",
                "busy_season_fee": "0.00",
                "fuel_fee": "4.76",
                "fuel_rate": "26.50%",
                "insurance_fee": "0.00",
                "private_residence_fee": "5.00",
                "remote_fee": "0.00",
                "signature_fee": "0.00"
            },
            "fuel_price": "4.76",
            "calculation_volume": "250",
            "billing_weight": 1,
            "remark": "",
            "post_zone": "3",
            "version": "8.3.2",
            "reference_date": "1 ~ 5 day"
        }
    ]
}

错误时的返回JSON数据包如下：

{"status":"2533","reqMsg":"Postcode is compulsory.","result":[]}

9、返回参数说明：

参数 类型 示例值 描述
carrier String UPS 快递公司
delivery String UPS Ground 派送方式
package String Your Packaging 包裹类型
time_limit String 1-5天 时效天数
price Float 11.73 总价格
basic_price Float 11.12 基础价格
user_shipping_discount_rate Float 1 费率表基础运费折扣
additional_price Float 9.76 additional_price
additional_price_items Object { "additional_fee": "0.00", // 操作附加费 "additional_fee_extra": "0.00", // 超尺寸旺季费 "additional_value": "1.00", // 附加费折扣 "busy_season_fee": "0.00", // 旺季附加费 "fuel_fee": "4.76", // 燃油附加费 "fuel_rate": "26.50%", // 燃油附加费率 "insurance_fee": "0.00", // 保险费 "private_residence_fee": "5.00", // 私宅派送费 "remote_fee": "0.00", // 偏远地区附加费 "signature_fee": "0.00" // 签名费 } 附加费明细
fuel_price Float 4.76 燃油附加费
calculation_volume Float 250 体积重计算因子
billing_weight Float 1 计费重
remark String 备注
post_zone String 3 邮编分区
version String 8.3.2 费率表版本

全局返回码说明