API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.freightcart.query 购物车页运费查询
¥免费

购物车页运费查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
supplierCodeStringY0000000000供应商编码
serviceTypeStringY01业务模式
provinceStringY江苏
cityStringY南京市
countyStringY玄武区
villageStringN玄武大道街道
memberNumStringY263712637623会员编号
receivingTypeStringY01收货方式
cmmdtysStringN
itemNumStringY000000001行项目号
cmmdtyCodeStringY000000000123456789商品编码
numberStringY10商品件数
itemsPriceStringY10.00行项目金额
chanIdStringY01下单渠道
响应参数
名称 类型 示例值 描述
resultCodeStringN结果编码
errorDescriptionString商品编码必填错误描述
supplierCodeString0000000000供应商编码
freightFareString10.00运费金额
basicFareString0基础运费
continuedFareString0续重运费
serviceTypeString
gatherAmountString0凑单金额
gatherWeightString0凑单重量
businessTypeStringZ0业务类型
cmmdtysString
itemNumString00000000001行项目号
cmmdtyCodeString000000000761109195商品编码
deliveryAttrString0配送属性
calculatedWeightString0是否计算重量
grossWeightString10KG商品毛重
isOrderMakeString1是否需凑单商品
itemFareString1分摊运费
freightRuleString
lowerLimitString10.00金额下限
upperLimitString10.00金额上限
basicFareString10.00基础运费
weightLimitString10.00基础重量上限
weightPriceString01续重单价
isCurrentStallString1是否当前档
isMaxString1是否最高档位
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryFreightcart>
      <serviceType/>
      <province>江苏</province>
      <city>南京市</city>
      <cmmdtys>
        <itemsPrice>10.00</itemsPrice>
        <itemNum>000000001</itemNum>
        <number>10</number>
        <cmmdtyCode>000000000123456789</cmmdtyCode>
      </cmmdtys>
      <receivingType>01</receivingType>
      <county>玄武区</county>
      <chanId>01</chanId>
      <supplierCode>0000000000</supplierCode>
      <memberNum>263712637623</memberNum>
      <village>玄武大道</village>
    </queryFreightcart>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryFreightcart": {
        "serviceType": {},
        "province": "江苏",
        "city": "南京市",
        "cmmdtys": [
          {
            "itemsPrice": "10.00",
            "itemNum": "000000001",
            "number": "10",
            "cmmdtyCode": "000000000123456789"
          }
        ],
        "receivingType": "01",
        "county": "玄武区",
        "chanId": "01",
        "supplierCode": "0000000000",
        "memberNum": "263712637623",
        "village": "玄武大道"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryFreightcart>
      <serviceType>
        <serviceType>
          <serviceType>Z1</serviceType>
          <gatherAmount>0</gatherAmount>
          <gatherWeight>0</gatherWeight>
          <businessType>Z0</businessType>
        </serviceType>
        <gatherAmount>0</gatherAmount>
        <cmmdtys>
          <calculatedWeight>0</calculatedWeight>
          <isOrderMake>1</isOrderMake>
          <itemNum>00000000001</itemNum>
          <grossWeight>10KG</grossWeight>
          <cmmdtyCode>000000000761109195</cmmdtyCode>
          <deliveryAttr>0</deliveryAttr>
          <itemFare>1</itemFare>
        </cmmdtys>
        <gatherWeight>0</gatherWeight>
        <businessType>Z0</businessType>
        <freightRule>
          <isCurrentStall>1</isCurrentStall>
          <isMax>1</isMax>
          <upperLimit>10.00</upperLimit>
          <lowerLimit>10.00</lowerLimit>
          <weightPrice>01</weightPrice>
          <basicFare>10.00</basicFare>
          <weightLimit>10.00</weightLimit>
        </freightRule>
      </serviceType>
      <errorDescription>商品编码必填</errorDescription>
      <resultCode>N</resultCode>
      <supplierCode>0000000000</supplierCode>
      <continuedFare>0</continuedFare>
      <freightFare>10.00</freightFare>
      <basicFare>0</basicFare>
    </queryFreightcart>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryFreightcart": {
        "serviceType": [
          {
            "serviceType": [
              {
                "serviceType": "Z1",
                "gatherAmount": "0",
                "gatherWeight": "0",
                "businessType": "Z0"
              }
            ],
            "gatherAmount": "0",
            "cmmdtys": [
              {
                "calculatedWeight": "0",
                "isOrderMake": "1",
                "itemNum": "00000000001",
                "grossWeight": "10KG",
                "cmmdtyCode": "000000000761109195",
                "deliveryAttr": "0",
                "itemFare": "1"
              }
            ],
            "gatherWeight": "0",
            "businessType": "Z0",
            "freightRule": [
              {
                "isCurrentStall": "1",
                "isMax": "1",
                "upperLimit": "10.00",
                "lowerLimit": "10.00",
                "weightPrice": "01",
                "basicFare": "10.00",
                "weightLimit": "10.00"
              }
            ]
          }
        ],
        "errorDescription": "商品编码必填",
        "resultCode": "N",
        "supplierCode": "0000000000",
        "continuedFare": "0",
        "freightFare": "10.00",
        "basicFare": "0"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.queryfreightcart.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.queryfreightcart.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ