API接口目录
suning.onlinestore.ordersubmit.create 小店订单提交
¥免费

小店订单提交

公共参数
请求参数
名称 类型 是否必须 示例值 描述
platFormTradeStringN
orderIdStringY123342312平台订单号
cartTwoNoStringNDLJA2018114812000000购物车2号
memberNoStringY23456543会员号
businessSignStringY1业务标识(1:菜场)
paymentStringY100.00顾客实付金额
chanIdStringY02下单渠道(02:APP 03:WAP)
mapTypeStringY01地图类型(01-高德)
poiIdStringN234243兴趣点(地图类型为01时必填)
cityNameStringN北京市地图对应城市名称
shopCodeStringY001门店编码
shopNameStringY小店门店名称
deliveryTypeStringY02配送方式(02-自提)
orderTimeStringY2020-02-14 00:00:00订单提交时间
receiverAddressStringY南京市收货人详细地址
receiverMobileStringY15008987656收货人手机
receiverNameStringY张三收货人姓名
invoiceTitleTypeStringN02发票抬头类型(01 企业 02个人)
invoiceTypeStringY05发票类型(05-暂不开票)
invoiceTitleStringN个人消费发票抬头
invoiceContentStringN餐饮发票内容
taxPayerNoStringNSDFDFD458976增值税纳税人识别号
regAddrStringN南京市白下区淮海路68号苏18F注册地址
regPhoneStringN02584418888注册电话
accntBankStringN南京银行开户行
bankAccntNumStringN6YUIOP3456789009876开户账号
taxPayerAddrStringN南京市白下区淮宁电器大厦18F发票收件人地址
taxPayerNameStringN张三发票收件人姓名
taxPayerPhoneStringN02584418888发票收件人电话
taxMobilePhoneStringN15509876789发票收件人手机
platFormOrderStringN
orderItemIdStringY242342423平台订单行号
cartTwoItemNoStringN4324242343购物车2行号
cmmdtyPropertyStringY01商品属性(01-实体)
skuIdStringY4244242平台商品编码
snSkuIdStringY3244234234苏宁商品编码
priceStringY10.00商品单价
saleNumStringY10购买数量
pointAmountStringN3.00积分抵扣金额
postageStringY0.00运费
orderPaymentStringY32.00顾客实付金额
totalFeeStringY23.00顾客应付金额
hopeArrivalTimeStringY2020-02-14 00:00:00期望服务时间
activityIdStringN67678678787营销活动编码
fullReductionInfoStringN
bonusIdStringN324425345奖励编码
fullReductionAmountStringN20.00满减金额
promotionNumStringN43242满减活动编码
providerStringN02满减承担方(02:平台)
couponInfoStringN
couponTypeStringN02优惠券承担方(02:平台券)
couponAmountStringN2.00优惠券金额
couponCodeStringN3221233优惠券编码
响应参数
名称 类型 示例值 描述
orderIdString122222222平台订单号
resultFlagStringY成功失败标识
orderItemsString
orderItemIdString4234242342平台订单行号
hopeArrivalTimeString2020-02-14 00:00:00期望服务时间
actionEndTimeString2020-02-13 22:00:00截单时间
errorListString
orderItemIdString3424242平台订单行号
resultCodeStringPANGU-DD-001错误编码
resultMsgString错误描述错误描述
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <createOrdersubmit>
      <platFormTrade>
        <orderId>123342312</orderId>
        <shopName>小店</shopName>
        <taxPayerName>张三</taxPayerName>
        <regPhone>02584418888</regPhone>
        <taxPayerPhone>02584418888</taxPayerPhone>
        <regAddr>南京市白下区淮海路68号苏18F</regAddr>
        <orderTime>2020-02-14 00:00:00</orderTime>
        <cityName>北京市</cityName>
        <invoiceTitleType>02</invoiceTitleType>
        <taxPayerNo>SDFDFD458976</taxPayerNo>
        <invoiceType>05</invoiceType>
        <chanId>02</chanId>
        <payment>100.00</payment>
        <platFormOrder>
          <pointAmount>3.00</pointAmount>
          <couponInfo>
            <couponAmount>2.00</couponAmount>
            <couponType>02</couponType>
            <couponCode>3221233</couponCode>
          </couponInfo>
          <orderItemId>242342423</orderItemId>
          <fullReductionInfo>
            <provider>02</provider>
            <bonusId>324425345</bonusId>
            <fullReductionAmount>20.00</fullReductionAmount>
            <promotionNum>43242</promotionNum>
          </fullReductionInfo>
          <saleNum>10</saleNum>
          <activityId>67678678787</activityId>
          <cartTwoItemNo>4324242343</cartTwoItemNo>
          <orderPayment>32.00</orderPayment>
          <postage>0.00</postage>
          <cmmdtyProperty>01</cmmdtyProperty>
          <totalFee>23.00</totalFee>
          <price>10.00</price>
          <snSkuId>3244234234</snSkuId>
          <hopeArrivalTime>2020-02-14 00:00:00</hopeArrivalTime>
          <skuId>4244242</skuId>
        </platFormOrder>
        <poiId>234243</poiId>
        <invoiceTitle>个人消费</invoiceTitle>
        <bankAccntNum>6YUIOP3456789009876</bankAccntNum>
        <shopCode>001</shopCode>
        <accntBank>南京银行</accntBank>
        <invoiceContent>餐饮</invoiceContent>
        <taxPayerAddr>南京市白下区淮宁电器大厦18F</taxPayerAddr>
        <receiverName>张三</receiverName>
        <deliveryType>02</deliveryType>
        <receiverMobile>15008987656</receiverMobile>
        <mapType>01</mapType>
        <taxMobilePhone>15509876789</taxMobilePhone>
        <receiverAddress>南京市</receiverAddress>
        <memberNo>23456543</memberNo>
        <cartTwoNo>DLJA2018114812000000</cartTwoNo>
        <businessSign>1</businessSign>
      </platFormTrade>
    </createOrdersubmit>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createOrdersubmit": {
        "platFormTrade": {
          "orderId": "123342312",
          "shopName": "小店",
          "taxPayerName": "张三",
          "regPhone": "02584418888",
          "taxPayerPhone": "02584418888",
          "regAddr": "南京市白下区淮海路68号苏18F",
          "orderTime": "2020-02-14 00:00:00",
          "cityName": "北京市",
          "invoiceTitleType": "02",
          "taxPayerNo": "SDFDFD458976",
          "invoiceType": "05",
          "chanId": "02",
          "payment": "100.00",
          "platFormOrder": [
            {
              "pointAmount": "3.00",
              "couponInfo": [
                {
                  "couponAmount": "2.00",
                  "couponType": "02",
                  "couponCode": "3221233"
                }
              ],
              "orderItemId": "242342423",
              "fullReductionInfo": [
                {
                  "provider": "02",
                  "bonusId": "324425345",
                  "fullReductionAmount": "20.00",
                  "promotionNum": "43242"
                }
              ],
              "saleNum": "10",
              "activityId": "67678678787",
              "cartTwoItemNo": "4324242343",
              "orderPayment": "32.00",
              "postage": "0.00",
              "cmmdtyProperty": "01",
              "totalFee": "23.00",
              "price": "10.00",
              "snSkuId": "3244234234",
              "hopeArrivalTime": "2020-02-14 00:00:00",
              "skuId": "4244242"
            }
          ],
          "poiId": "234243",
          "invoiceTitle": "个人消费",
          "bankAccntNum": "6YUIOP3456789009876",
          "shopCode": "001",
          "accntBank": "南京银行",
          "invoiceContent": "餐饮",
          "taxPayerAddr": "南京市白下区淮宁电器大厦18F",
          "receiverName": "张三",
          "deliveryType": "02",
          "receiverMobile": "15008987656",
          "mapType": "01",
          "taxMobilePhone": "15509876789",
          "receiverAddress": "南京市",
          "memberNo": "23456543",
          "cartTwoNo": "DLJA2018114812000000",
          "businessSign": "1"
        }
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <createOrdersubmi>
      <orderId>122222222</orderId>
      <errorList>
        <orderItemId>3424242</orderItemId>
        <resultCode>PANGU-DD-001</resultCode>
        <resultMsg>错误描述</resultMsg>
      </errorList>
      <resultFlag>Y</resultFlag>
      <orderItems>
        <actionEndTime>2020-02-13 22:00:00</actionEndTime>
        <orderItemId>4234242342</orderItemId>
        <hopeArrivalTime>2020-02-14 00:00:00</hopeArrivalTime>
      </orderItems>
    </createOrdersubmi>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createOrdersubmi": {
        "orderId": "122222222",
        "errorList": [
          {
            "orderItemId": "3424242",
            "resultCode": "PANGU-DD-001",
            "resultMsg": "错误描述"
          }
        ],
        "resultFlag": "Y",
        "orderItems": [
          {
            "actionEndTime": "2020-02-13 22:00:00",
            "orderItemId": "4234242342",
            "hopeArrivalTime": "2020-02-14 00:00:00"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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