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

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.batchcreateorder.create 批量提交预占订单接口
￥免费

用户侧批量提交一单多商品、多地址订单时使用

公共参数
请求参数
名称 类型 是否必须 示例值 描述
batchIdStringY100000100078批次号（唯一）
orderTypeStringY1订单类型：1-预占型订单
goodsStringY1商品类型 1-普通商品
paymentStringY08支付方式 ：08-账期
submitTypeStringY1提交方式：1-必须整单成功；2-接受部分失败
invoiceStateStringY1是否开发票：1-开；0-不开
invoiceTypeStringN1发票类型：1-增值税专票；4-电子发票
invoiceContentStringN1发票内容：1-明细
invoiceToStringY10-个人，1-企业
specialVatTicketStringN
companyNameStringN苏宁易购股份有限公司增票注册公司名称（发票抬头）
taxNoStringN1234567890ABCDE纳税人识别号：数字或字母，字段长度为15-20位,invoiceTo=1必填
regAddStringN江苏省南京市玄武区苏宁大道113号增票注册地址（invoiceState是否开票=1，invoiceType=1时必传）
regTelStringN18767890345增票注册电话（invoiceState是否开票=1，invoiceType=1时必传）
regBankStringN苏宁银行增票注册银行（invoiceState是否开票=1，invoiceType=1时必传）
regAccountStringN23235254664336增票银行注册账户（invoiceState是否开票=1，invoiceType=1时必传）
consigneeNameStringN张飞增票收票人姓名（invoiceState是否开票=1，invoiceType=1时必传）
consigneeMobileNumStringN15822222200增票收票人电话（invoiceState是否开票=1，invoiceType=1时必传）
consigneeAddressStringN江苏省南京市秦淮区法院增票收票人地址全称（invoiceState是否开票=1，invoiceType=1时必传）
skuPriceListStringN
skuIdStringY121347746商品编码
unitPriceStringY12.1商品单价
receiveInfoListStringN
tradeNoStringN1000001交易单号（客户唯一流水号），≤16个字符
provinceIdStringY100省编码
cityIdStringY025市编码
countryIdStringY01区/县编码
townIdStringY99镇编码
addressStringY江苏省南京市雨花区软件大道舜天集团收货人详细地址（不多于80个汉字）
receiverNameStringY张飞收货人姓名（不多于50个汉字）
telephoneStringN010-84728989收货人座机号
mobileStringY17856789012收货人手机号
emailStringNxxx@xxx.com收货人邮箱
zipStringN210000收货人邮编（6位数字）
skuQuantityListStringN
skuStringY121347657商品编码
numStringY2购买数量
remarkStringN订单备注备注（不多于80个汉字）
响应参数
名称 类型 示例值 描述
campSuccessStringYY-批量提交成功；N-批量提交失败
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <createBatchcreateorder>
      <invoiceContent>1</invoiceContent>
      <orderType>1</orderType>
      <submitType>1</submitType>
      <skuPriceList>
        <unitPrice>12.1</unitPrice>
        <skuId>121347746</skuId>
      </skuPriceList>
      <goods>1</goods>
      <invoiceState>1</invoiceState>
      <invoiceType>1</invoiceType>
      <invoiceTo>1</invoiceTo>
      <payment>08</payment>
      <batchId>100000100078</batchId>
      <specialVatTicket>
        <consigneeName>张飞</consigneeName>
        <regAccount>23235254664336</regAccount>
        <regTel>18767890345</regTel>
        <consigneeMobileNum>15822222200</consigneeMobileNum>
        <companyName>苏宁易购股份有限公司</companyName>
        <regAdd>江苏省南京市玄武区苏宁大道113号</regAdd>
        <regBank>苏宁银行</regBank>
        <taxNo>1234567890ABCDE</taxNo>
        <consigneeAddress>江苏省南京市秦淮区法院</consigneeAddress>
      </specialVatTicket>
      <receiveInfoList>
        <zip>210000</zip>
        <address>江苏省南京市雨花区软件大道舜天集团</address>
        <tradeNo>1000001</tradeNo>
        <receiverName>张飞</receiverName>
        <mobile>17856789012</mobile>
        <remark>订单备注</remark>
        <telephone>010-84728989</telephone>
        <cityId>025</cityId>
        <townId>99</townId>
        <provinceId>100</provinceId>
        <countryId>01</countryId>
        <skuQuantityList>
          <num>2</num>
          <sku>121347657</sku>
        </skuQuantityList>
        <email>xxx@xxx.com</email>
      </receiveInfoList>
    </createBatchcreateorder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createBatchcreateorder": {
        "invoiceContent": "1",
        "orderType": "1",
        "submitType": "1",
        "skuPriceList": [
          {
            "unitPrice": "12.1",
            "skuId": "121347746"
          }
        ],
        "goods": "1",
        "invoiceState": "1",
        "invoiceType": "1",
        "invoiceTo": "1",
        "payment": "08",
        "batchId": "100000100078",
        "specialVatTicket": {
          "consigneeName": "张飞",
          "regAccount": "23235254664336",
          "regTel": "18767890345",
          "consigneeMobileNum": "15822222200",
          "companyName": "苏宁易购股份有限公司",
          "regAdd": "江苏省南京市玄武区苏宁大道113号",
          "regBank": "苏宁银行",
          "taxNo": "1234567890ABCDE",
          "consigneeAddress": "江苏省南京市秦淮区法院"
        },
        "receiveInfoList": [
          {
            "zip": "210000",
            "address": "江苏省南京市雨花区软件大道舜天集团",
            "tradeNo": "1000001",
            "receiverName": "张飞",
            "mobile": "17856789012",
            "remark": "订单备注",
            "telephone": "010-84728989",
            "cityId": "025",
            "townId": "99",
            "provinceId": "100",
            "countryId": "01",
            "skuQuantityList": [
              {
                "num": "2",
                "sku": "121347657"
              }
            ],
            "email": "xxx@xxx.com"
          }
        ]
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <createBatchcreateorder>
      <campSuccess>Y</campSuccess>
    </createBatchcreateorder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createBatchcreateorder": {
        "campSuccess": "Y"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.govbus.createbatchcreateorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.govbus.createbatchcreateorder.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.govbus.createbatchcreateorder.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.gcapi 服务不可用 请联系苏宁技术人员
biz.govbus.createbatchcreateorder.invalid-biz:100 输入报文格式错误 输入报文格式错误
biz.govbus.createbatchcreateorder.invalid-biz:101 入参校验失败 入参校验失败,请检查入参
biz.govbus.createbatchcreateorder.invalid-biz:102 接口调用异常 接口调用异常,请联系苏宁技术人员
biz.govbus.createbatchcreateorder.invalid-biz:103 缺少增票开票实体信息 缺少增票开票实体信息
biz.govbus.createbatchcreateorder.invalid-biz:104 缺少增票开票基本信息 缺少增票开票基本信息
biz.govbus.createbatchcreateorder.invalid-biz:105 缺少增票开票要素信息 缺少增票开票要素信息
biz.govbus.createbatchcreateorder.invalid-biz:106 该批次号已经申请过订单，请更换批次号 该批次号已经申请过订单，请更换批次号
biz.govbus.createbatchcreateorder.invalid-biz:107 暂不支持套餐品创建订单 暂不支持套餐品创建订单
biz.govbus.createbatchcreateorder.invalid-biz:999 停用客户，调用权限受限 请联系苏宁客户经理
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ