退出
热词搜索：
API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.btborder.create 零售云采购单确认开单接口
￥免费

零售云采购单确认开单接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY666666调用方唯一编码
channelCodeStringN19541渠道编码
storeCodeStringN59021门店编码
remarkStringN备注信息备注
outerOrderNoStringNB2019050518000801外部单号
payWayStringN9支付方式（9:银联支付）
orderItemListStringN
cmmdtyCodeStringY000000000102556513商品编码
distributorCodeStringY0000000000分销商编码
priceStringY2000.00商品采购单价
quantityStringY1数量
installFlagStringN0安装方式，0-不安装 1-苏宁安装 2-商家安装
bookTimeDetailStringN2018-07-01安装时间
serviceCmmdtyCodeStringN000000000102556513服务商品编码
hopeArrivalTimeStringN2018-08-30预计送达时间
outerOrderItemNoStringNB20190505180001021外部订单行号
itemTotalFareStringN24.00商品行运费
orderDeliveryStringN
receiverNameStringY张三收货人姓名
receiverPhoneStringY18632486868收货人电话
provinceCodeStringY100省编码
cityCodeStringY025城市编码
districtCodeStringY01区县编码
townCodeStringY01镇编码
buyerAddressStringY江苏省南京市玄武区玄武大道1号收货详细地址
orderInvoiceStringN
invoiceTypeStringY1发票类型（1 增值税发票, 4电子发票）
invoiceTitleTypeStringY1发票抬头类型（1： 个人，:2：单位）
invoiceTitleStringY个人发票抬头
invoiceReceiverNameStringN张三收票人姓名
invoiceReceiverPhoneStringN135889088765收票人电话
invoiceAddressStringN江苏省南京市玄武区玄武大道1号收票详细地址
taxPayerNoStringN122021154545x纳税人识别号
响应参数
名称 类型 示例值 描述
respListString
orderNoString0066000459021订单号
freightString0订单运费
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <createBtborder>
      <orderInvoice>
        <invoiceTitleType>1</invoiceTitleType>
        <invoiceReceiverPhone>135889088765</invoiceReceiverPhone>
        <invoiceReceiverName>张三</invoiceReceiverName>
        <invoiceType>1</invoiceType>
        <invoiceAddress>江苏省南京市玄武区玄武大道1号</invoiceAddress>
        <taxPayerNo>122021154545x</taxPayerNo>
        <invoiceTitle>个人</invoiceTitle>
      </orderInvoice>
      <appId>666666</appId>
      <channelCode>19541</channelCode>
      <remark>备注信息</remark>
      <outerOrderNo>B2019050518000801</outerOrderNo>
      <orderDelivery>
        <districtCode>01</districtCode>
        <provinceCode>100</provinceCode>
        <cityCode>025</cityCode>
        <receiverName>张三</receiverName>
        <buyerAddress>江苏省南京市玄武区玄武大道1号</buyerAddress>
        <townCode>01</townCode>
        <receiverPhone>18632486868</receiverPhone>
      </orderDelivery>
      <orderItemList>
        <cmmdtyCode>000000000102556513</cmmdtyCode>
        <price>2000.00</price>
        <itemTotalFare>24.00</itemTotalFare>
        <serviceCmmdtyCode>000000000102556513</serviceCmmdtyCode>
        <hopeArrivalTime>2018-08-30</hopeArrivalTime>
        <quantity>1</quantity>
        <bookTimeDetail>2018-07-01</bookTimeDetail>
        <outerOrderItemNo>B20190505180001021</outerOrderItemNo>
        <installFlag>0</installFlag>
        <distributorCode>0000000000</distributorCode>
      </orderItemList>
      <payWay>9</payWay>
      <storeCode>59021</storeCode>
    </createBtborder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createBtborder": {
        "appId": "666666",
        "orderInvoice": {
          "invoiceTitleType": "1",
          "invoiceReceiverPhone": "135889088765",
          "invoiceType": "1",
          "invoiceReceiverName": "张三",
          "invoiceAddress": "江苏省南京市玄武区玄武大道1号",
          "taxPayerNo": "122021154545x",
          "invoiceTitle": "个人"
        },
        "channelCode": "19541",
        "remark": "备注信息",
        "outerOrderNo": "B2019050518000801",
        "orderItemList": [
          {
            "cmmdtyCode": "000000000102556513",
            "price": "2000.00",
            "itemTotalFare": "24.00",
            "serviceCmmdtyCode": "000000000102556513",
            "hopeArrivalTime": "2018-08-30",
            "quantity": "1",
            "bookTimeDetail": "2018-07-01",
            "distributorCode": "0000000000",
            "installFlag": "0",
            "outerOrderItemNo": "B20190505180001021"
          }
        ],
        "orderDelivery": {
          "districtCode": "01",
          "provinceCode": "100",
          "cityCode": "025",
          "receiverName": "张三",
          "buyerAddress": "江苏省南京市玄武区玄武大道1号",
          "receiverPhone": "18632486868",
          "townCode": "01"
        },
        "payWay": "9",
        "storeCode": "59021"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <createBtborder>
      <respList>
        <orderNo>0066000459021</orderNo>
        <freight>0</freight>
      </respList>
    </createBtborder>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createBtborder": {
        "respList": [
          {
            "orderNo": "0066000459021",
            "freight": "0"
          }
        ]
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.retailer.createbtborder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
biz.retailer.createbtborder.invalid-biz:100 请求参数缺失或异常 请检查查询参数
biz.retailer.createbtborder.invalid-biz:101 接口执行返回失败 请检查查询参数
biz.retailer.createbtborder.invalid-biz:102 查询结果为空 请检查查询参数
biz.retailer.createbtborder.invalid-biz:103 系统异常 请联系苏宁技术人员
biz.retailer.createbtborder.invalid-biz:105 无效的AppId请求 请检查查询参数
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ