财务管理
运费查询
查询预估运费。
生产环境
https://ssl.glitzcloud.com/agent/v1/api/express/query测试环境
http://gztest.glitzcloud.com/agent/v1/api/express/query说明
1、功能名称：运费查询
2、功能描述：运费查询
请参阅鉴权签名说明。
请求参数
| 名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| 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 | 州二字码 |
返回字段
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| 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 | Array | { "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 | 费率表版本 |
示例
请求示例
{
"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"
}返回示例
{
"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"
}
]
}示例 3
{
"status": "2533",
"reqMsg": "Postcode is compulsory.",
"result": []
}