API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.ordersubmit.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平台商品编码
snSkuIdStringY123456789外部商品编码(苏宁商品编码)
priceStringY100.00单价
saleNumStringY3销售数量
pointAmountStringN1.00积分抵扣金额
postageStringY5.00邮费
orderPaymentStringY10.00行实付金额
totalFeeStringY12.00行应付金额
activityIdStringN201419801004**活动编码。当商品为参加大聚惠活动商品时,此字段为必填!
businessSignStringN0业务标识,默认传【0】,【是否支持促销】字段为【1:是】时,必填; 0:普通商品; 1:海外购;
fullReductionInfoStringN
fullReductionTypeStringN1满减类型
bonusIdStringN2079097奖励编码,有苏宁的满减时【必填】
fullReductionAmountStringN2.00满减金额
promotionNumStringN1233434满减活动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礼品卡编码
collectionInfoListStringN
collectionSortStringN1归集分类
collectionTypeStringN1归集类型
collectionCodeStringN1类型编码
chanIdStringY01下单渠道(01:PC 02:APP 03:WAP)
bespokeStringNY传Y表示外平台接了预约时效功能,采用新下单流程; 传N或传空或没有本字段入参表示外平台未接预约时效功能,用旧下单流程
installmentNumStringN6分期期数
activityNumStringN201909090001分期活动编码
siteCodeStringN1LQ站点编码
响应参数
名称 类型 示例值 描述
orderIdString122222222平台订单号
orderItemsString
orderItemIdString251225550008280499订单行号
settlementValueString12.00结算数值
settlementTypeString1结算类型(1:结算价 2:平台使用费比例 3:推广服务费比例)
installTimeString2018-04-11 15:00:00安装时间
arriveTimeString2018-04-11 15:00:00送达时间
settlementListString
settlementValueString12.00结算数值
settlementTypeString结算类型1
isSuccessStringY成功失败标识
errorListString
orderItemIdString商品行号/卡号/券号00001111
errMessageString[PANGU系统异常]描述:{0}错误描述
errCodeStringPANGU-01-002错误码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <createOrdersubmit>
      <platFormTrade>
        <orderType>A001</orderType>
        <installmentNum>6</installmentNum>
        <orderId>123342312</orderId>
        <orderStatus>01</orderStatus>
        <receiverProvince>江苏省</receiverProvince>
        <taxPayerName>张三</taxPayerName>
        <receiverCounty>江宁区</receiverCounty>
        <regPhone>02584418888</regPhone>
        <taxPayerPhone>02584418888</taxPayerPhone>
        <receiverCity>南京市</receiverCity>
        <regAddr>举例:南京市白下区淮海路68号苏18F</regAddr>
        <receiverPhone>025-22222222</receiverPhone>
        <invoiceTitleType>01</invoiceTitleType>
        <isSupportPromotion>0</isSupportPromotion>
        <taxPayerNo>21111</taxPayerNo>
        <invoiceType>01</invoiceType>
        <chanId>01</chanId>
        <payment>100.00</payment>
        <platFormOrder>
          <pointAmount>1.00</pointAmount>
          <couponInfo>
            <couponAmount>1.00</couponAmount>
            <couponType>01</couponType>
            <couponCode>21212</couponCode>
          </couponInfo>
          <orderItemId>22222222222222</orderItemId>
          <fullReductionInfo>
            <fullReductionType>1</fullReductionType>
            <provider>01</provider>
            <bonusId>2079097</bonusId>
            <fullReductionAmount>2.00</fullReductionAmount>
            <promotionNum>1233434</promotionNum>
          </fullReductionInfo>
          <saleNum>3</saleNum>
          <selectedInstallDate>123</selectedInstallDate>
          <activityId>201419801004**</activityId>
          <orderPayment>10.00</orderPayment>
          <postage>5.00</postage>
          <orderItemStatus>01</orderItemStatus>
          <totalFee>12.00</totalFee>
          <price>100.00</price>
          <snSkuId>123456789</snSkuId>
          <businessSign>0</businessSign>
          <giftCardList>
            <giftCardType>01</giftCardType>
            <giftCardAmount>10.00</giftCardAmount>
            <giftCardCode>1232332342</giftCardCode>
          </giftCardList>
          <selectedArrivalTime>2018-08-01-2</selectedArrivalTime>
          <collectionInfoList>
            <collectionType>1</collectionType>
            <collectionSort>1</collectionSort>
            <collectionCode>1</collectionCode>
          </collectionInfoList>
          <skuId>1234</skuId>
        </platFormOrder>
        <invoiceTitle>个人消费</invoiceTitle>
        <receiverZip>210000</receiverZip>
        <bankAccntNum>6YUIOP3456789009876</bankAccntNum>
        <accntBank>南京银行</accntBank>
        <invoiceContent>餐饮</invoiceContent>
        <taxPayerAddr>南京市白下区淮宁电器大厦18F</taxPayerAddr>
        <siteCode>1LQ</siteCode>
        <activityNum>201909090001</activityNum>
        <receiverName>张三</receiverName>
        <receiverMobile>12345678900</receiverMobile>
        <totalNo>2</totalNo>
        <receiverNationality>中国</receiverNationality>
        <bespoke>Y</bespoke>
        <taxMobilePhone>02584418888</taxMobilePhone>
        <receiverAddress>修文路9号</receiverAddress>
        <memberNo>23456543</memberNo>
        <cartTwoNo>DLJA2018114812000000</cartTwoNo>
        <receiverStreet>淳化街道</receiverStreet>
      </platFormTrade>
    </createOrdersubmit>
  </sn_body>
</sn_request>

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

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createOrdersubmit": {
        "orderId": "122222222",
        "errorList": [
          {
            "errCode": "PANGU-01-002",
            "orderItemId": "商品行号/卡号/券号",
            "errMessage": "[PANGU系统异常]描述:{0}"
          }
        ],
        "orderItems": [
          {
            "arriveTime": "2018-04-11 15:00:00",
            "settlementType": "1",
            "orderItemId": "251225550008280499",
            "settlementList": [
              {
                "settlementType": "结算类型",
                "settlementValue": "12.00"
              }
            ],
            "installTime": "2018-04-11 15:00:00",
            "settlementValue": "12.00"
          }
        ],
        "isSuccess": "Y"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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