费用试算

场景说明

提交订单预报参数进行费用试算。

接口名

{域名}/api/svc/rates

请求方式

POST

参数名	是否必填	类型	说明
Authorization	是	string	授权码：访问授权 Token

请求参数

参数名	二级参数名	是否必填	类型	说明
reference_no	-	是	string	参考号(客户单号),长度不得超过35位
has_insurance		否	integer	是否购买保险 0：否 1：是默认：0
insurance_effective_time		否	string	保险生效时间
sm_code	-	是	string	物流产品代码, 可咨询服务商或使用getUserInfo查询
remark		否	string	订单备注信息长度不得超过35位
oa_firstname		是	string	收件人姓名长度不能小于3位，并且长度不能大于35位
oa_company		否	string	收件人公司长度不得超过35位
oa_street_address1		是	string	收件人地址1 长度不得超过35位
oa_street_address2		否	string	收件人地址2 长度不得超过35位
oa_postcode		是	string	收件人邮编 5-4格式邮编,邮编长度最短5位数,最长10位数
oa_state		是	string	收件人州需要填写两位简称,只能为大写二字编码
oa_city		是	string	收件人城市长度最短1位数，最长30位数
oa_country		是	string	收件人国家要求固定值US
oa_telphone		是	string	收件人电话 10-15位之间
is_more_box		是	integer	包裹类型:固定值，请传1
signature_service		否	string	签名服务:是否需要签名服务：ASS为成人签名，SSF为普通签名，不需要可以不传该字段
weight_unit_type		否	integer	包裹单位类型: 1-英制(INCH/LBS) 2-公制(CM/KG) 默认为2
box_list		是	array	包裹信息
-box_list	box_length	是	number	长
-box_list	box_width	是	number	宽
-box_list	box_height	是	number	高
-box_list	box_actual_weight	是	number	重量
shipper_address		是	object	发件人信息, 发件人信息必须与我司备案信息完全一致, 发件人信息与发件人编码同时存在时，以发件人信息为准
-shipper_address	shipper_name	是	string	发件人姓名,长度最短3位数,最长35位数
-shipper_address	shipper_company	否	string	发件人公司，长度最长35位数
-shipper_address	shipper_telphone	是	string	发件人电话， 10-15位之间
-shipper_address	shipper_country	是	string	发件人国家，要求固定值US
-shipper_address	shipper_state_province	是	string	发件人州, 只能为大写二字编码
-shipper_address	shipper_city	是	string	发件人城市, 长度最短1位数，最长30位数
-shipper_address	shipper_address1	是	string	发件人地址1,长度不得超过35位
-shipper_address	shipper_address2	否	string	发件人地址2,长度不得超过35位
-shipper_address	shipper_postal_code	是	string	发件人邮编, 长度最短5位数,最长10位数
shipper_code		是	string	发件人编码, 发件人信息与发件人编码同时存在时，以发件人信息为准

输入示例（body）


{
    "reference_no": "string",
    "sm_code": "string",
    "remark": "string",
    "oa_firstname": "string",
    "oa_company": "string",
    "oa_street_address1": "string",
    "oa_street_address2": "string",
    "oa_postcode": "string",
    "oa_state": "string",
    "oa_city": "string",
    "oa_country": "string",
    "oa_telphone": "string",
    "is_more_box": 1,
    "signature_service": "string",
    "weight_unit_type": 2,
    "box_list": [
        {
            "box_length": 0,
            "box_width": 0,
            "box_height": 0,
            "box_actual_weight": 0
        }
    ],
    "`shipper_address`": {
        "shipper_name": "string",
        "shipper_company": "string",
        "shipper_telphone": "string",
        "shipper_country": "string",
        "shipper_state_province": "string",
        "shipper_city": "string",
        "shipper_address1": "string",
        "shipper_address2": "string",
        "shipper_postal_code": "string"
    },
    "shipper_code": "string"
}

返回参数

参数名	二级参数名	是否必填	类型	说明
code	-	是	string	响应码，200-成功
result	-	是	object	响应结果
msg	-	是	string	响应消息
-result	sm_code	是	string	物流产品
-result	address_type_text	是	string	地址类型描述
-result	address_type	是	integer	地址类型
-result	amount	是	string	金额
-result	currency_code	是	string	币种
-result	total_charge	是	string	总金额
-result	shipping_charge	是	string	基础运费
-result	charge_detail	是	array	费用明细
-result.charge_detail	charge_desc	是	string	费用描述
-result.ft_code	ft_code	是	string	费用英文名称
-result.fee_type_code	fee_type_code	是	string	费用编码
-result.charge_detail	amount	是	string	金额
-result	zc_name	是	string	分区

输出示例

{
  "code": 200,
  "result": {
    "sm_code": "FedEx",
    "address_type_text": "Residential",
    "address_type": 1,
    "currency_code": "USD",
    "total_charge": "4",
    "shipping_charge": "1",
    "zc_name": "Zone8",
    "charge_detail": [
      {
        "charge_desc": "运费",
        "amount": "1"
      },
      {
        "charge_desc": "成人签名签收服务",
        "amount": "1"
      },
      {
        "charge_desc": "住宅地址附加费",
        "amount": "1"
      },
      {
        "charge_desc": "燃油附加费",
        "amount": "1"
      }
    ]
  },
  "msg": "Success"
}