费用试算

接口地址:/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