查询价格

接口URL #

/label/rates

请求方式 #

POST

请求Body参数 #

参数名 示例值 参数类型 是否必填 参数描述
apiUserCode ACUSER String 是 系统账号用户编码
orderUserReferenceCode TESTUSER String 否 可选，可自行填写订单客户识别参考码
sellerOrderNumber TESTORDER-001 String 否 销售订单号
serviceCodes - Array 否 可选，不传默认为账号开放的所有渠道
shipFrom - Object 是 发件地址信息
shipFrom.code - String 否 发件地址代码
shipFrom.company TEST String 是 公司名或发件人
shipFrom.attentionName TEST String 否 发件人名称
shipFrom.countryCode US String 是 国家2位简写代码
shipFrom.stateCode CA String 是 州2位简写代码
shipFrom.city rowland height String 是 城市
shipFrom.addressLine1 test String 是 地址1
shipFrom.addressLine2 - Object 否 地址2
shipFrom.postalCode 91748 String 是 邮编
shipFrom.phone 0000000000 String 是 电话号码
shipFrom.phoneExtension 0000 String 否 电话号码分机号
shipFrom.isResidential - - 是 是否住宅地址，true或者false
shipTo - Object 是 -
shipTo.company TEST String 是 公司名或收件人
shipTo.attentionName TEST String 否 收件人名称
shipTo.countryCode US String 是 国家2位简写代码
shipTo.stateCode CA String 是 州2位简写代码
shipTo.city rowland height String 是 城市
shipTo.addressLine1 test String 是 地址1
shipTo.addressLine2 - Object 是 地址2
shipTo.postalCode 91748 String 是 邮编
shipTo.phone 0000000000 String 是 电话号码
shipTo.phoneExtension 0000000000 String 否 电话号码分机号
shipTo.isResidential true Boolean 是 是否住宅地址，true或者false
packages - Object 是 包裹列表
packages.length 10 Number 是 包裹长
packages.width 10 Number 是 包裹宽
packages.height 10 Number 是 包裹高
packages.weight 14 Number 是 包裹重量(单个包裹)
packages.quantity 1 Number 是 包裹数量
packages.declaredValue 100 Number 否 包裹保险价值USD(单个包裹）
packages.reference1 REF01 String 否 包裹参考号1
packages.reference2 - Object 否 包裹参考号2
options - Object 是 订单服务选项
options.dimensionUnitCode IN String 是 包裹尺寸单位, 可选值为IN （英寸）,CM (厘米)
options.weightUnitCode LBS String 是 包裹重量单位，可选值为LBS （磅）,KG (公斤)
options.shipDate 2022-05-14 String 否 格式：2022-01-01
options.deliveryConfirmation signature String 否 签名服务方式，无签收：none，普通签收：signature ,成人签收：adultSignature

请求示例 # 

{
    "apiUserCode": "ACUSER",
    "sellerOrderNumber": "TESTORDER-001",
    "shipFrom": {
        "code": "",
        "company": "TEST",
        "attentionName": "TEST",
        "countryCode": "US",
        "stateCode": "CA",
        "city": "rowland height",
        "addressLine1": "test",
        "addressLine2": "",
        "postalCode": "91748",
        "phone": "0000000000",
        "phoneExtension": "0000",
        "isResidential": false
    },
    "shipTo": {
        "company": "TEST",
        "attentionName": "TEST",
        "countryCode": "US",
        "stateCode": "CA",
        "city": "rowland height",
        "addressLine1": "test",
        "addressLine2": "",
        "postalCode": "91748",
        "phone": "0000000000",
        "phoneExtension": "0000000000",
        "isResidential": true
    },
    "packages": [
        {
            "length": 10,
            "width": 10,
            "height": 10,
            "weight": 14,
            "quantity": 1,
            "declaredValue": 100,
            "reference1": "REF01",
            "reference2": ""
        }
    ],
    "options": {
        "dimensionUnitCode": "IN",
        "weightUnitCode": "LBS",
        "shipDate": "2025-05-14",
        "deliveryConfirmation": "signature"
    }
}

返回示例 # 

{
    "code": 200,
    "data": {
        "rates": [   //渠道价格列表，同时返回多个支持的渠道价格
            {
                "rateId": "rate_clrt0d0o2hotek12v7u0",
                "rate": 13.06,   //渠道价格
                "chargeItems": null,
                "currencyCode": "USD",
                "carrierCode": "FedEx",
                "carrierName": "FedEx",
                "serviceCode": "FedExGround"  //渠道服务代码，下单时使用
            }
        ],
        "messages": null  //如一些渠道有查询错误提示则显示在此
    },
    "message": "success"
}