API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.btborderbysupplymode.create 零售云根据供货模式b2b下单接口
¥免费

零售云根据供货模式b2b下单接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一编码
storeCodeStringY59021零售云门店编码
submitTypeStringY102订单请求类型
supplyModeStringY1供货模式(0:仓配;2:日配)
creatorStringY张三下单人姓名
remarkStringN备注下单备注
orderDeliveryStringN
receiverNameStringY张三收货人姓名
receiverMobileStringY18066118801收货人电话
receiverTelephoneStringN021-66881112收货人固定电话
receiverProvinceStringY100收货地址编码-省
receiverCityStringY025收货地址编码-市
receiverDistrictStringY01收货地址编码-区
receiverTownStringY01收货地址编码-镇
receiverDetailAddressStringY苏宁大道详细地址
orderItemsStringN
cmmdtyCodeStringY000000000102556513商品编码
supplierCodeStringY006644221供应商编码
unitPriceStringY100商品价格
freightStringY15运费
quantityStringY1数量
响应参数
名称 类型 示例值 描述
respBeanString
orderNoStringA2019399301订单号
merchantCustNoString79693441会员编码
omsOrderNoString00663030492oms单号
totalAmountString100总金额
totalFreightString15总运费
invLockTimeString60锁库时长(分钟)
orderItemsString
orderItemNoStringA100100913601订单行号
omsOrderItemNoString00100913601oms订单行号
supplierCodeString0064654供应商编码
supplierNameString苏宁供应商名称
cmmdtyCodeString000000000100004919商品编码
cmmdtyNameString商品名称商品名称
quantityString1数量
unitPriceString100单价
freightString1运费
palletString11箱规
palletUnitNameString11箱规单位名称
unitNameString11 商品单位名称
orderEffectiveTimeString45订单超时取消时间(分钟)
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createBtborderbysupplymode>
      <orderDelivery>
        <receiverName>张三</receiverName>
        <receiverDistrict>01</receiverDistrict>
        <receiverMobile>18066118801</receiverMobile>
        <receiverProvince>100</receiverProvince>
        <receiverDetailAddress>苏宁大道</receiverDetailAddress>
        <receiverCity>025</receiverCity>
        <receiverTelephone>021-66881112</receiverTelephone>
        <receiverTown>01</receiverTown>
      </orderDelivery>
      <creator>张三</creator>
      <submitType>102</submitType>
      <appId>111111</appId>
      <supplyMode>1</supplyMode>
      <remark>备注</remark>
      <orderItems>
        <unitPrice>100</unitPrice>
        <quantity>1</quantity>
        <cmmdtyCode>000000000102556513</cmmdtyCode>
        <freight>15</freight>
        <supplierCode>006644221</supplierCode>
      </orderItems>
      <storeCode>59021</storeCode>
    </createBtborderbysupplymode>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createBtborderbysupplymode": {
        "orderDelivery": {
          "receiverName": "张三",
          "receiverDistrict": "01",
          "receiverMobile": "18066118801",
          "receiverProvince": "100",
          "receiverDetailAddress": "苏宁大道",
          "receiverCity": "025",
          "receiverTelephone": "021-66881112",
          "receiverTown": "01"
        },
        "creator": "张三",
        "submitType": "102",
        "appId": "111111",
        "supplyMode": "1",
        "remark": "备注",
        "orderItems": [
          {
            "unitPrice": "100",
            "quantity": "1",
            "cmmdtyCode": "000000000102556513",
            "freight": "15",
            "supplierCode": "006644221"
          }
        ],
        "storeCode": "59021"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createBtborderbysupplymode>
      <respBean>
        <totalAmount>100</totalAmount>
        <orderEffectiveTime>45</orderEffectiveTime>
        <omsOrderNo>00663030492</omsOrderNo>
        <orderNo>A2019399301</orderNo>
        <totalFreight>15</totalFreight>
        <invLockTime>60</invLockTime>
        <merchantCustNo>79693441</merchantCustNo>
        <orderItems>
          <unitPrice>100</unitPrice>
          <supplierName>苏宁</supplierName>
          <quantity>1</quantity>
          <palletUnitName>11</palletUnitName>
          <unitName>11</unitName>
          <cmmdtyCode>000000000100004919</cmmdtyCode>
          <freight>1</freight>
          <orderItemNo>A100100913601</orderItemNo>
          <omsOrderItemNo>00100913601</omsOrderItemNo>
          <cmmdtyName>商品名称</cmmdtyName>
          <pallet>11</pallet>
          <supplierCode>0064654</supplierCode>
        </orderItems>
      </respBean>
    </createBtborderbysupplymode>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createBtborderbysupplymode": {
        "respBean": {
          "totalAmount": "100",
          "orderEffectiveTime": "45",
          "omsOrderNo": "00663030492",
          "orderNo": "A2019399301",
          "totalFreight": "15",
          "invLockTime": "60",
          "merchantCustNo": "79693441",
          "orderItems": [
            {
              "unitPrice": "100",
              "supplierName": "苏宁",
              "quantity": "1",
              "palletUnitName": "11",
              "unitName": "11",
              "cmmdtyCode": "000000000100004919",
              "freight": "1",
              "orderItemNo": "A100100913601",
              "omsOrderItemNo": "00100913601",
              "cmmdtyName": "商品名称",
              "pallet": "11",
              "supplierCode": "0064654"
            }
          ]
        }
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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