API接口目录

电商能力输出业务

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

订单信息提交

公共参数
请求参数
名称 类型 是否必须 示例值 描述
platFormTradeStringN
memberNoStringY23456543会员号
orderStatusStringY0101-订单提交
orderTypeStringYA001普通订单
cartTwoNoStringNDLJA2018114812000000购物车2号,是否促销为1时必填
orderIdStringY123342312订单号
totalNoStringY2订单行总数
receiverProvinceStringY江苏省收货人所在省
paymentStringY100.00买家实付金额
receiverNationalityStringN中国收货人所在国家
receiverCityStringY南京市收货人所在城市
receiverCountyStringY江宁区
receiverStreetStringN淳化街道收货人所在街道
receiverAddressStringY修文路9号收货人的详细地址
receiverZipStringN210000收货人所在地邮编
receiverMobileStringY12345678900收货人手机号码
receiverPhoneStringN025-22222222收货人固定电话号码
receiverNameStringY张三收货人姓名
invoiceTitleTypeStringY01发票抬头类型 如:01 企业 02个人
invoiceTypeStringY01发票类型,如:01增值税专用发票 、02 普通发票、04电子发票
invoiceTitleStringY个人消费发票抬头
invoiceContentStringN餐饮发票内容
taxPayerNoStringN21111税号,当发票类型为增值税专用发票时,要求此字段必传!
regPhoneStringN02584418888注册电话,当发票类型为增值税专用发票时,要求此字段必传!
regAddrStringN举例:南京市白下区淮海路68号苏18F注册地址,当发票类型为增值税专用发票时,要求此字段必传!
accntBankStringN南京银行开户银行,当发票类型为增值税专用发票时,要求此字段必传!
bankAccntNumStringN6YUIOP3456789009876开户账号,当发票类型为增值税专用发票时,要求此字段必传!
taxPayerAddrStringN南京市白下区淮宁电器大厦18F发票收件人地址,当发票类型为增值税专用发票时,要求此字段必传!
taxPayerNameStringN张三发票收件人姓名,当发票类型为增值税专用发票时,要求此字段必传!
taxPayerPhoneStringN02584418888发票收件人电话,当发票类型为增值税专用发票时,要求此字段必传!
taxMobilePhoneStringN02584418888发票收件人手机,当发票类型为增值税专用发票时,要求此字段必传!
isSupportPromotionStringN0是否支持促销(0:否;1:是)
platFormOrderStringN
orderItemIdStringY22222222222222订单行号
orderItemStatusStringN01订单提交
skuIdStringY1234平台商品编码
outerSkuIdStringY123456789外部商品编码(苏宁商品编码)
priceStringY100.00单价
saleNumStringY3销售数量
pointAmountStringN1.00积分抵扣金额
postageStringY5.00邮费
orderPaymentStringY10.00行实付金额
totalFeeStringY12.00行应付金额
promotionNumStringN201419801004**活动编码。当商品为参加大聚惠活动商品时,此字段为必填!
businessSignStringN0业务标识,默认传【0】,【是否支持促销】字段为【1:是】时,必填; 0:普通商品; 1:海外购;
fullReductionInfoStringN
fullReductionTypeStringN1满减类型
bonusIdStringN2079097奖励编码,有苏宁的满减时【必填】
fullReductionAmountStringN2.00满减金额
activityIdStringN1233434活动ID
providerStringN01优惠承担方 ,01:苏宁 02:平台.有满减活动时必填
couponInfoStringN
couponTypeStringN01券类型,01:苏宁券 02:平台券.有券时必填
couponAmountStringN1.00券金额
couponCodeStringN21212券编码
selectedArrivalTimeStringN2018-08-01-2预约时效标识为Y时必填
selectedInstallDateStringN123预约时效标识为Y,且商品需要安装时必填 格式[{"2018-08-19":["3","2","1"]}]
giftCardListStringN
giftCardTypeStringN01礼品卡类型:01-平台承担
giftCardAmountStringN10.00礼品卡金额
giftCardCodeStringN1232332342礼品卡编码
chanIdStringY01下单渠道(01:PC 02:APP 03:WAP)
bespokeStringNY传Y表示外平台接了预约时效功能,采用新下单流程; 传N或传空或没有本字段入参表示外平台未接预约时效功能,用旧下单流程
响应参数
名称 类型 示例值 描述
orderIdString122222222平台订单号
orderItemsString
orderItemIdString251225550008280499订单行号
settlementValueString12.00结算数值
settlementTypeString1结算类型(1:结算价 2:平台使用费比例 3:推广服务费比例)
arriveTimeString2018-04-11 15:00:00送达时间
installTimeString2018-04-11 15:00:00安装时间
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createOrder>
      <platFormTrade>
        <taxPayerAddr>南京市白下区淮宁电器大厦18F</taxPayerAddr>
        <invoiceTitleType>01</invoiceTitleType>
        <bankAccntNum>6YUIOP3456789009876</bankAccntNum>
        <chanId>01</chanId>
        <cartTwoNo>DLJA2018114812000000</cartTwoNo>
        <taxPayerNo>21111</taxPayerNo>
        <receiverAddress>修文路9号</receiverAddress>
        <receiverStreet>淳化街道</receiverStreet>
        <invoiceTitle>个人消费</invoiceTitle>
        <totalNo>2</totalNo>
        <receiverName>张三</receiverName>
        <taxPayerName>张三</taxPayerName>
        <orderId>123342312</orderId>
        <memberNo>23456543</memberNo>
        <bespoke>Y</bespoke>
        <receiverPhone>025-22222222</receiverPhone>
        <platFormOrder>
          <orderItemId>22222222222222</orderItemId>
          <fullReductionInfo>
            <fullReductionAmount>2.00</fullReductionAmount>
            <activityId>1233434</activityId>
            <fullReductionType>1</fullReductionType>
            <bonusId>2079097</bonusId>
            <provider>01</provider>
          </fullReductionInfo>
          <businessSign>0</businessSign>
          <saleNum>3</saleNum>
          <selectedInstallDate>123</selectedInstallDate>
          <postage>5.00</postage>
          <orderPayment>10.00</orderPayment>
          <totalFee>12.00</totalFee>
          <price>100.00</price>
          <pointAmount>1.00</pointAmount>
          <giftCardList>
            <giftCardAmount>10.00</giftCardAmount>
            <giftCardCode>1232332342</giftCardCode>
            <giftCardType>01</giftCardType>
          </giftCardList>
          <orderItemStatus>01</orderItemStatus>
          <outerSkuId>123456789</outerSkuId>
          <skuId>1234</skuId>
          <promotionNum>201419801004**</promotionNum>
          <couponInfo>
            <couponAmount>1.00</couponAmount>
            <couponType>01</couponType>
            <couponCode>21212</couponCode>
          </couponInfo>
          <selectedArrivalTime>2018-08-01-2</selectedArrivalTime>
        </platFormOrder>
        <payment>100.00</payment>
        <orderType>A001</orderType>
        <regPhone>02584418888</regPhone>
        <isSupportPromotion>0</isSupportPromotion>
        <receiverCounty>江宁区</receiverCounty>
        <invoiceType>01</invoiceType>
        <receiverMobile>12345678900</receiverMobile>
        <accntBank>南京银行</accntBank>
        <receiverProvince>江苏省</receiverProvince>
        <regAddr>举例:南京市白下区淮海路68号苏18F</regAddr>
        <receiverNationality>中国</receiverNationality>
        <orderStatus>01</orderStatus>
        <taxMobilePhone>02584418888</taxMobilePhone>
        <receiverCity>南京市</receiverCity>
        <taxPayerPhone>02584418888</taxPayerPhone>
        <receiverZip>210000</receiverZip>
        <invoiceContent>餐饮</invoiceContent>
      </platFormTrade>
    </createOrder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createOrder": {
        "platFormTrade": {
          "invoiceTitleType": "01",
          "taxPayerAddr": "南京市白下区淮宁电器大厦18F",
          "bankAccntNum": "6YUIOP3456789009876",
          "chanId": "01",
          "cartTwoNo": "DLJA2018114812000000",
          "taxPayerNo": "21111",
          "receiverStreet": "淳化街道",
          "receiverAddress": "修文路9号",
          "invoiceTitle": "个人消费",
          "totalNo": "2",
          "receiverName": "张三",
          "taxPayerName": "张三",
          "orderId": "123342312",
          "memberNo": "23456543",
          "bespoke": "Y",
          "receiverPhone": "025-22222222",
          "platFormOrder": [
            {
              "orderItemId": "22222222222222",
              "fullReductionInfo": [
                {
                  "activityId": "1233434",
                  "fullReductionAmount": "2.00",
                  "bonusId": "2079097",
                  "fullReductionType": "1",
                  "provider": "01"
                }
              ],
              "businessSign": "0",
              "saleNum": "3",
              "selectedInstallDate": "123",
              "postage": "5.00",
              "orderPayment": "10.00",
              "totalFee": "12.00",
              "price": "100.00",
              "pointAmount": "1.00",
              "giftCardList": [
                {
                  "giftCardAmount": "10.00",
                  "giftCardCode": "1232332342",
                  "giftCardType": "01"
                }
              ],
              "outerSkuId": "123456789",
              "orderItemStatus": "01",
              "promotionNum": "201419801004**",
              "skuId": "1234",
              "selectedArrivalTime": "2018-08-01-2",
              "couponInfo": [
                {
                  "couponAmount": "1.00",
                  "couponType": "01",
                  "couponCode": "21212"
                }
              ]
            }
          ],
          "payment": "100.00",
          "orderType": "A001",
          "regPhone": "02584418888",
          "isSupportPromotion": "0",
          "receiverCounty": "江宁区",
          "invoiceType": "01",
          "receiverMobile": "12345678900",
          "receiverProvince": "江苏省",
          "accntBank": "南京银行",
          "receiverNationality": "中国",
          "regAddr": "举例:南京市白下区淮海路68号苏18F",
          "orderStatus": "01",
          "receiverCity": "南京市",
          "taxMobilePhone": "02584418888",
          "taxPayerPhone": "02584418888",
          "receiverZip": "210000",
          "invoiceContent": "餐饮"
        }
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createOrder>
      <orderItems>
        <settlementType>1</settlementType>
        <settlementValue>12.00</settlementValue>
        <orderItemId>251225550008280499</orderItemId>
        <arriveTime>2018-04-11 15:00:00</arriveTime>
        <installTime>2018-04-11 15:00:00</installTime>
      </orderItems>
      <orderId>122222222</orderId>
    </createOrder>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createOrder": {
        "orderItems": [
          {
            "settlementType": "1",
            "arriveTime": "2018-04-11 15:00:00",
            "orderItemId": "251225550008280499",
            "settlementValue": "12.00",
            "installTime": "2018-04-11 15:00:00"
          }
        ],
        "orderId": "122222222"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.createorder.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.online.createorder.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.online.createorder.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.createorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.createorder.invalid-biz:100 SO_E0001:订单正在处理,不允许重复提交 请不要重复提交订单
biz.online.createorder.invalid-biz:104 E9999:其他异常 请联系苏宁技术人员
biz.online.createorder.invalid-biz:105 该单含有非选品商品,商品编码为XX,不可销售 提交失败
biz.online.createorder.invalid-biz:106 地址信息解析报错 请重新检查地址信息后提交订单
biz.online.createorder.invalid-biz:107 该单存在不可售商品,商品编码为XX 提交失败
biz.online.createorder.invalid-biz:108 该单存在不可配送的商品,商品编码为XX 提交失败
biz.online.createorder.invalid-biz:109 库存不足 提交失败
biz.online.createorder.invalid-biz:110 活动过期 提交失败
biz.online.createorder.invalid-biz:111 活动数量不足 提交失败
biz.online.createorder.invalid-biz:112 活动资格校验失败 提交失败
biz.online.createorder.invalid-biz:113 订单行总金额与应付金额不一致 提交失败
biz.online.createorder.invalid-biz:114 未查询到平台配置信息 提交失败
biz.online.createorder.invalid-biz:115 调用接口发生异常或响应结果为空或异常 提交失败
biz.online.createorder.invalid-biz:116 商品价格不一致 提交失败
biz.online.createorder.invalid-biz:117 未知异常 提交失败
biz.online.createorder.invalid-biz:118 增票场景下手机号码和座机不能同时为空 提交失败
biz.online.createorder.invalid-biz:119 未找到原始校验行项目 提交失败
biz.online.createorder.invalid-biz:120 该平台不支持此支付方式 提交失败
biz.online.createorder.invalid-biz:121 订单已下发OMS 提交失败
biz.online.createorder.invalid-biz:122 当前订单状态不允许提交订单 提交失败
biz.online.createorder.invalid-biz:123 活动ID不一致,请重新获取价格 提交失败
biz.online.createorder.invalid-biz:124 未支付运费 提交失败
biz.online.createorder.invalid-biz:125 运费计算错误 提交失败
biz.online.createorder.invalid-biz:126 当前价格类型不支持输出,限制下单 提交失败
biz.online.createorder.invalid-biz:127 超过单人限购数量,无法下单 提交失败
biz.online.createorder.invalid-biz:128 活动名额被占用,无法下单 提交失败
biz.online.createorder.invalid-biz:129 活动未开始或已结束,无法下单 提交失败
biz.online.createorder.invalid-biz:130 订单直降校验金额不一致 提交失败
biz.online.createorder.invalid-biz:131 优惠券数量不一致 提交失败
biz.online.createorder.invalid-biz:132 优惠券编码不一致 提交失败
biz.online.createorder.invalid-biz:133 优惠券金额不一致 提交失败
biz.online.createorder.invalid-biz:134 订单实付金额不一致 提交失败
biz.online.createorder.invalid-biz:135 奖励列表为空 提交失败
biz.online.createorder.invalid-biz:136 分摊明细列表为空 提交失败
biz.online.createorder.invalid-biz:137 该活动不存在 提交失败
biz.online.createorder.invalid-biz:138 查不到用券信息 提交失败
biz.online.createorder.invalid-biz:139 查不到用券详细信息 提交失败
biz.online.createorder.invalid-biz:140 购物车2号不存在 提交失败
biz.online.createorder.invalid-biz:141 活动不满足条件 提交失败
biz.online.createorder.invalid-biz:142 订单直降校验活动id不一致 提交失败
biz.online.createorder.invalid-biz:143 订单直降校验奖励id不一致 提交失败
biz.online.createorder.invalid-biz:144 订单直降校验金额不一致 提交失败
biz.online.createorder.invalid-biz:145 不支持苏宁促销活动 提交失败
biz.online.createorder.invalid-biz:146 BusinessSign字段不能为空 提交失败
biz.online.createorder.invalid-biz:147 XXX商品无对应主数据 提交失败
biz.online.createorder.invalid-biz:148 外平台预约配送时间有误,下单失败 提交失败
biz.online.createorder.invalid-biz:149 外平台预约安装时间有误,下单失败 提交失败
biz.online.createorder.invalid-biz:150 {%s}接口已选送货时间校验失败 提交失败
biz.online.createorder.invalid-biz:151 {%s}接口已选安装时间有误 下单失败
biz.online.createorder.invalid-biz:152 已选安装时间早于送达时间 下单失败
biz.online.createorder.invalid-biz:153 日期格式转换失败 下单失败
biz.online.createorder.invalid-biz:154 PG未找到设备版本号,平台账号为XX 下单失败
biz.online.createorder.invalid-biz:155 %s不能为空 检查请求入参是否有值
公共异常码
API工具
FAQ