API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.boorder.create 提交订单(买断业务)
¥免费

提交订单(买断业务)

公共参数
请求参数
名称 类型 是否必须 示例值 描述
platFormTradeStringN
orderIdStringY4567890平台订单号
memberNoStringN13888888888会员号
totalNoStringY2订单总行数
orderTypeStringYA001普通订单
businessTypeStringN0101:良品;02:不良品
paymentStringN100顾客实付金额
receiverNationalityStringN中国收货人国籍
receiverProvinceStringY100收货人所在省编码
receiverCityStringY025收货人所在市编码
receiverCountyStringY02510收货人所在区
receiverStreetStringN0251001receiverStreet
receiverAddressStringY门牌号93号收货人详细地址
receiverZipStringN8876868收货人邮编
receiverMobileStringY13888888888收货人手机
receiverPhoneStringN1531-8295345收货人座机
receiverNameStringY苏宁收货人姓名
platFormOrderStringN
orderItemIdStringY56789001平台订单行号
skuIdStringY3456789876平台商品编码
snSkuIdStringY4567899876苏宁商品编码
serialNumberStringN0023564565123商品序列号
preplantCodeStringND024库存地点
priceStringN12商品单价
saleNumStringY3购买数量
postageStringN34邮费
orderPaymentStringN123顾客实付金额
totalFeeStringN523顾客应付金额
businessSignStringY0默认传【0】, 0:普通商品; 1:海外购;
响应参数
名称 类型 示例值 描述
orderIdString4567899876平台订单编号
isSuccessStringY成功失败标识
orderItemsString
orderItemIdString4567876501平台订单行号
skuIdString00000456765商品编码
arriveTimeString2019-10-10预计送达时间
installTimeString1029-10-10预计安装时间
errorListString
orderItemIdString3456765402平台订单行号
errMessageStringN失败
errCodeStringN001错误码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <createBoorder>
      <platFormTrade>
        <orderType>A001</orderType>
        <orderId>4567890</orderId>
        <receiverName>苏宁</receiverName>
        <receiverMobile>13888888888</receiverMobile>
        <totalNo>2</totalNo>
        <receiverNationality>中国</receiverNationality>
        <receiverProvince>100</receiverProvince>
        <receiverCounty>02510</receiverCounty>
        <receiverCity>025</receiverCity>
        <receiverAddress>门牌号93号</receiverAddress>
        <memberNo>13888888888</memberNo>
        <receiverPhone>1531-8295345</receiverPhone>
        <receiverStreet>0251001</receiverStreet>
        <payment>100</payment>
        <platFormOrder>
          <orderPayment>123</orderPayment>
          <postage>34</postage>
          <serialNumber>0023564565123</serialNumber>
          <totalFee>523</totalFee>
          <orderItemId>56789001</orderItemId>
          <price>12</price>
          <snSkuId>4567899876</snSkuId>
          <preplantCode>D024</preplantCode>
          <businessSign>0</businessSign>
          <saleNum>3</saleNum>
          <skuId>3456789876</skuId>
        </platFormOrder>
        <businessType>01</businessType>
        <receiverZip>8876868</receiverZip>
      </platFormTrade>
    </createBoorder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createBoorder": {
        "platFormTrade": {
          "orderType": "A001",
          "orderId": "4567890",
          "receiverName": "苏宁",
          "receiverMobile": "13888888888",
          "totalNo": "2",
          "receiverNationality": "中国",
          "receiverProvince": "100",
          "receiverCounty": "02510",
          "receiverCity": "025",
          "receiverAddress": "门牌号93号",
          "memberNo": "13888888888",
          "receiverPhone": "1531-8295345",
          "receiverStreet": "0251001",
          "payment": "100",
          "platFormOrder": [
            {
              "orderPayment": "123",
              "postage": "34",
              "serialNumber": "0023564565123",
              "totalFee": "523",
              "orderItemId": "56789001",
              "price": "12",
              "snSkuId": "4567899876",
              "preplantCode": "D024",
              "businessSign": "0",
              "saleNum": "3",
              "skuId": "3456789876"
            }
          ],
          "businessType": "01",
          "receiverZip": "8876868"
        }
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <createBoorder>
      <orderId>4567899876</orderId>
      <errorList>
        <errCode>N001</errCode>
        <orderItemId>3456765402</orderItemId>
        <errMessage>N</errMessage>
      </errorList>
      <orderItems>
        <arriveTime>2019-10-10</arriveTime>
        <orderItemId>4567876501</orderItemId>
        <installTime>1029-10-10</installTime>
        <skuId>00000456765</skuId>
      </orderItems>
      <isSuccess>Y</isSuccess>
    </createBoorder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createBoorder": {
        "orderId": "4567899876",
        "errorList": [
          {
            "errCode": "N001",
            "orderItemId": "3456765402",
            "errMessage": "N"
          }
        ],
        "orderItems": [
          {
            "arriveTime": "2019-10-10",
            "orderItemId": "4567876501",
            "installTime": "1029-10-10",
            "skuId": "00000456765"
          }
        ],
        "isSuccess": "Y"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.createboorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.createboorder.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ