费用试算
接口地址:/openapi/v1/order/caculate
请求方式:POST
请求数据类型:application/json
响应数据类型:*/*
接口描述: 可以调用此接口进行费用试算,时间不传默认是当天
请求示例:
{
"channelCode": "联系渠道获取",
"countryCode": "BD",
"zipCode": "5230",
"packageDetails": [
{
"length": 66,
"width": 37.5,
"height": 45.5,
"actualWeight": 25
}
]
}
请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| apiToken | apiToken | header | true | string | |
| customerTrialParam | customerTrialParam | body | true | CustomerTrialParam | CustomerTrialParam |
| channelCode | 渠道编码 | true | string | ||
| countryCode | 国家代码 | true | string | ||
| packageDetails | 包裹详情 | false | array | OrderPackageDetail | |
| actualWeight | 实重 | true | number | ||
| height | 高 | true | number | ||
| length | 长 | true | number | ||
| width | 宽 | true | number | ||
| recvTime | 计费时间 | false | string(date-time) | ||
| zipCode | 邮编 | false | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | R«List«CustomerTrialRes»» |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | integer(int64) | integer(int64) | |
| data | array | CustomerTrialRes | |
| channelCode | 渠道编码 | string | |
| channelName | 渠道名称 | string | |
| chargeWeight | 计费重 | number | |
| countryCode | 国家代码 | string | |
| countryName | 国家中文 | string | |
| customerId | 客户ID | string | |
| funds | 计费信息 | array | ReceivingFundValue |
| amount | 金额 | number | |
| billingFormula | 计费公式 | string | |
| chargeWeight | 计费重 | number | |
| currency | 币种 | string | |
| fundType | 计费项目编码 | string | |
| fundTypeName | 计费名称 | string | |
| remark | 备注 | string | |
| message | 消息 | string | |
| provinceCode | 省州 | string | |
| recvTime | 计费时间 | string(date-time) | |
| referenceTimeliness | 参考时效 | string | |
| remark | 渠道备注 | string | |
| totalAmounts | 总费用 | number | |
| zipCode | 邮编 | string | |
| message | string | ||
| success | boolean |
响应示例:
{
"code": 200,
"data": [
{
"channelCode": "渠道编码",
"channelName": "渠道名称",
"chargeWeight": 10,
"countryCode": "BR",
"countryName": "巴西",
"customerId": "",
"funds": [
{
"fundType": "FREIGHT",
"fundTypeName": "邮费",
"currency": "CNY",
"amount": 688.23,
"chargeWeight": 10.000,
"billingFormula": "688.23",
"remark": null
},
{
"fundType": "FUEL_SURCHARGE",
"fundTypeName": "燃油附加费",
"currency": "CNY",
"amount": 254.645100,
"chargeWeight": 10.000,
"billingFormula": "",
"remark": null
}
],
"message": "",
"provinceCode": "",
"recvTime": "",
"referenceTimeliness": "",
"remark": "",
"totalAmounts": 942.8751,
"zipCode": ""
}
],
"message": "",
"success": true
}作者:admin 创建时间:2025-11-27 10:51
最后编辑:admin 更新时间:2026-10-16 10:03
最后编辑:admin 更新时间:2026-10-16 10:03