API接口目录

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.mixpayorder.add 创建订单接口(新)
¥免费

新增服务项:
1、新增支付方式:第三方支付;
2、新增发票类型:增税普票、电子发票;
3、支持按用户方下传增票信息开具增值税专票。


注意事项:

1、交易单号(客户唯一流水号)只能对应一个订单;
2、交易单号多次提交时,订单信息不能发生变化(即订单接口不支持订单修改);
3、交易单号多次提交只能生成一个对应的苏宁订单。

4、入参“备注remark”字段如需传给供应商系统,需先联系管理员进行配置(不配置不传)

5、开票时商品标题最大支持70字符


公共参数
请求参数
名称 类型 是否必须 示例值 描述
tradeNoStringY1000001交易单号(客户唯一流水号),≤16个字符,交易单号多次提交只能生成一个对应的苏宁订单,且多次提交时,订单信息不能发生变化
companyCustNoStringN15114631094@suning.com采购企业账号(母公司下单:不传; 子公司下单:传子公司账号)
skuStringN
skuIdStringY140272356商品编码
numStringY1购买数量
unitPriceStringY88.00商品单价
receiverNameStringY张三收货人(不多于50个汉字)
telephoneStringN010-84728989收货人座机号
mobileStringY15311351111收货人手机号
emailStringNxxx@xxx.com收货人邮箱
provinceIdStringY100省编码
cityIdStringY025市编码
countyIdStringY05区/县编码
townIdStringN01镇编码
addressStringY江苏省南京市雨花区软件大道舜天集团详细地址(不多于80个汉字)
zipStringN210000邮编(6位数字)
remarkStringNxxxxx备注(不多于80个汉字)
hopeArrivalTimeStringN2019-11-06-3期望送达时间,日期格式:yyyy-MM-dd-X X的取值: 1-白天;2-上午;3-下午;4-晚上 X=1,送货时间为18:00:00; X=2,送货时间为09:00:00; X=3,送货时间为15:00:00;为保证期望送达时间有效,请先调用suning.govbus.shiptime.get 物流时效接口获取可选送达时间.此为物流配送参考时间,如遇特殊情况可能导致无法按此时间送达.
invoiceStateStringY1是否开发票:1=开;0=不开
invoiceTypeStringN1发票类型:1-增值税专票;3-增值税普票(即平推式普票,票货分离);4-电子发票 ,(invoiceState是否开票=1时必填)
invoiceTitleStringN江苏舜天有限公司发票抬头(invoiceState是否开票=1时必填)
invoiceContentStringN1发票内容:1-明细(invoiceState是否开票=1时必填)
paymentStringY08支付方式:01-在线支付-易付宝;03-货到付款现金;04-货到付款POS;05-支付宝支付;08-账期;09-预付款;11-第三方支付;12-企业汇款支付;020-在线支付-网银;20-账期+在线支付;13-在线支付-快E付
subPaymentModesStringN
payCodeStringN7207子支付方式:7207-平台个人支付;7208-平台积分;7209-平台券(支付方式=11时必填,可三种方式混合支付);9005-账期(小豆);2931-农行快e付;4237-支付宝支付
payAmountStringN50子支付金额
amountStringY88.00订单总金额=商品单价*数量
orderTypeStringY1订单类型:0-实时型订单; 1-预占型订单(默认:预占型)
servFeeStringY5.00运费
specialVatTicketStringN
taxNoStringN1234567890ABCDE纳税人识别号:数字或字母,字段长度为15、18、20位 (企业开票必填)
regTelStringN18767890345增票注册电话(发票类型为1时必传)
regAccountStringN23235254664336增票银行注册账户(发票类型为1时必传)
regAddStringN江苏省南京市雨花区软件大道舜天集团增票注册地址(发票类型为1时必传)
companyNameStringN江苏舜天有限公司增票注册公司名称(发票类型为1时必传)
regBankStringN453453434534354增票注册银行(发票类型为1时必传)
consigneeNameStringN张三收票件人姓名
consigneeAddressStringN江苏省南京市秦淮区法院收票件人地址
consigneeMobileNumStringN15822222200收票件人电话
specRemarkStringNbuyer:张三灵活备注
响应参数
名称 类型 示例值 描述
orderIdString100000000001苏宁订单号(唯一)
skusString
skuIdString121345091商品编码
orderItemIdString10000000000101苏宁订单行号(唯一)
arriveDataString2017-11-30 18:00:00预计送达时间(yyyy-MM-dd HH:mm:ss)
numString1商品数量
packageNumberString900000121套餐商品编码
amountString88.00商品总金额
freightString5.00运费
errorListString
skuIdString121347601商品编码
errorInfoString商品不在该用户下错误原因
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <addMixpayorder>
      <orderType>1</orderType>
      <invoiceState>1</invoiceState>
      <remark>xxxxx</remark>
      <cityId>025</cityId>
      <townId>01</townId>
      <servFee>5.00</servFee>
      <countyId>05</countyId>
      <invoiceType>1</invoiceType>
      <hopeArrivalTime>2019-11-06-3</hopeArrivalTime>
      <payment>08</payment>
      <sku>
        <unitPrice>88.00</unitPrice>
        <num>1</num>
        <skuId>140272356</skuId>
      </sku>
      <invoiceTitle>江苏舜天有限公司</invoiceTitle>
      <email>xxx@xxx.com</email>
      <zip>210000</zip>
      <companyCustNo>15114631094@suning.com</companyCustNo>
      <invoiceContent>1</invoiceContent>
      <amount>88.00</amount>
      <address>江苏省南京市雨花区软件大道舜天集团</address>
      <tradeNo>1000001</tradeNo>
      <receiverName>张三</receiverName>
      <specRemark>buyer:张三</specRemark>
      <mobile>15311351111</mobile>
      <subPaymentModes>
        <payAmount>50</payAmount>
        <payCode>7207</payCode>
      </subPaymentModes>
      <telephone>010-84728989</telephone>
      <provinceId>100</provinceId>
      <specialVatTicket>
        <consigneeName>张三</consigneeName>
        <regAccount>23235254664336</regAccount>
        <regTel>18767890345</regTel>
        <consigneeMobileNum>15822222200</consigneeMobileNum>
        <companyName>江苏舜天有限公司</companyName>
        <regAdd>江苏省南京市雨花区软件大道舜天集团</regAdd>
        <regBank>453453434534354</regBank>
        <taxNo>1234567890ABCDE</taxNo>
        <consigneeAddress>江苏省南京市秦淮区法院</consigneeAddress>
      </specialVatTicket>
    </addMixpayorder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addMixpayorder": {
        "orderType": "1",
        "invoiceState": "1",
        "remark": "xxxxx",
        "cityId": "025",
        "townId": "01",
        "servFee": "5.00",
        "countyId": "05",
        "invoiceType": "1",
        "hopeArrivalTime": "2019-11-06-3",
        "payment": "08",
        "sku": [
          {
            "unitPrice": "88.00",
            "num": "1",
            "skuId": "140272356"
          }
        ],
        "invoiceTitle": "江苏舜天有限公司",
        "email": "xxx@xxx.com",
        "zip": "210000",
        "companyCustNo": "15114631094@suning.com",
        "invoiceContent": "1",
        "amount": "88.00",
        "address": "江苏省南京市雨花区软件大道舜天集团",
        "tradeNo": "1000001",
        "receiverName": "张三",
        "specRemark": "buyer:张三",
        "mobile": "15311351111",
        "subPaymentModes": [
          {
            "payAmount": "50",
            "payCode": "7207"
          }
        ],
        "telephone": "010-84728989",
        "provinceId": "100",
        "specialVatTicket": {
          "consigneeName": "张三",
          "regAccount": "23235254664336",
          "regTel": "18767890345",
          "consigneeMobileNum": "15822222200",
          "companyName": "江苏舜天有限公司",
          "regAdd": "江苏省南京市雨花区软件大道舜天集团",
          "regBank": "453453434534354",
          "taxNo": "1234567890ABCDE",
          "consigneeAddress": "江苏省南京市秦淮区法院"
        }
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <addMixpayorder>
      <amount>88.00</amount>
      <skus>
        <orderItemId>10000000000101</orderItemId>
        <num>1</num>
        <arriveData>2017-11-30 18:00:00</arriveData>
        <skuId>121345091</skuId>
        <packageNumber>900000121</packageNumber>
      </skus>
      <orderId>100000000001</orderId>
      <errorList>
        <errorInfo>商品不在该用户下</errorInfo>
        <skuId>121347601</skuId>
      </errorList>
      <freight>5.00</freight>
    </addMixpayorder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addMixpayorder": {
        "amount": "88.00",
        "skus": [
          {
            "orderItemId": "10000000000101",
            "num": "1",
            "arriveData": "2017-11-30 18:00:00",
            "skuId": "121345091",
            "packageNumber": "900000121"
          }
        ],
        "orderId": "100000000001",
        "errorList": [
          {
            "errorInfo": "商品不在该用户下",
            "skuId": "121347601"
          }
        ],
        "freight": "5.00"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.govbus.addmixpayorder.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.govbus.addmixpayorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.govbus.addmixpayorder.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.govbus.addmixpayorder.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.gcapi 服务不可用 请联系苏宁技术人员
biz.govbus.addmixpayorder.invalid-biz:100 输入报文格式错误 请检查输入报文格式
biz.govbus.addmixpayorder.invalid-biz:101 入参校验失败 检查输入参数,必填参数不可为空
biz.govbus.addmixpayorder.invalid-biz:102 会员帐号错误 请检查输入的账号信息
biz.govbus.addmixpayorder.invalid-biz:103 订单中商品输入为空 当前订单商品编码为空,请检查参数
biz.govbus.addmixpayorder.invalid-biz:104 存在不可以购买的商品 请重新调取商品池接口核实购买商品是否存在商品池
biz.govbus.addmixpayorder.invalid-biz:105 未维护合同配置信息 请联系客户经理维护合同配置
biz.govbus.addmixpayorder.invalid-biz:106 未配置该支付方式 请联系客户经理维护当前下单使用的支付方式
biz.govbus.addmixpayorder.invalid-biz:107 未配置该发票类型 请联系客户经理配置所需的发票类型
biz.govbus.addmixpayorder.invalid-biz:108 地址信息错误:省/市编码 请检查省/市编码地址信息是否正确
biz.govbus.addmixpayorder.invalid-biz:109 地址信息错误:市区镇编码 请检查区/镇编码地址信息是否正确
biz.govbus.addmixpayorder.invalid-biz:110 订单流水号已存在 当前订单号已存在,请重新生成
biz.govbus.addmixpayorder.invalid-biz:111 账期大客户编码不存在 联系客户经理维护
biz.govbus.addmixpayorder.invalid-biz:112 大小件信息维护错误 联系客户经理维护
biz.govbus.addmixpayorder.invalid-biz:113 查询商品信息出现错误 检查输入参数
biz.govbus.addmixpayorder.invalid-biz:114 未查询到增票信息 联系客户经理维护
biz.govbus.addmixpayorder.invalid-biz:115 未查询到配送区域信息 该区域暂不支持配送
biz.govbus.addmixpayorder.invalid-biz:116 企业增值税发票未认证 请联系客户经理完成增票认证
biz.govbus.addmixpayorder.invalid-biz:117 城市编码有误 请核实城市编码配置
biz.govbus.addmixpayorder.invalid-biz:118 商品寻源错误 商品寻源失败,请核实商品后重试
biz.govbus.addmixpayorder.invalid-biz:119 金额发生变动 价格变更,请同步更新价格后重新下单
biz.govbus.addmixpayorder.invalid-biz:120 物流配送区域查询失败 该地区暂不支持配送,请联系客户经理线下处理
biz.govbus.addmixpayorder.invalid-biz:121 销售组织信息不存在 请联系客户经理维护当前所需要的销售组织信息
biz.govbus.addmixpayorder.invalid-biz:122 销售组织信息异常 请稍后重试,若还有问题请联系客户经理维护处理
biz.govbus.addmixpayorder.invalid-biz:123 厂送商品不支持货到付款 厂送商品不支持货到付款,请选择其他支付方式
biz.govbus.addmixpayorder.invalid-biz:124 此地区不支持货到付款 联系客户经理
biz.govbus.addmixpayorder.invalid-biz:125 查询此地区不支持货到付款超时 请稍后重试
biz.govbus.addmixpayorder.invalid-biz:126 查询账期信用额度失败 请联系客户经理处理
biz.govbus.addmixpayorder.invalid-biz:127 发OMS前存表异常 请联系苏宁技术人员
biz.govbus.addmixpayorder.invalid-biz:128 OMS订单生成失败 请联系苏宁技术人员
biz.govbus.addmixpayorder.invalid-biz:129 输入的componyCustNo不是子账号 子账号下单请填写子账号,母账号无需填写
biz.govbus.addmixpayorder.invalid-biz:130 运费错误 请核实运费后重新下单
biz.govbus.addmixpayorder.invalid-biz:131 未查询到预存款会员信息 请联系客户经理维护预存款信息
biz.govbus.addmixpayorder.invalid-biz:132 预存款余额不足 预存款余额不足,请进行充值
biz.govbus.addmixpayorder.invalid-biz:133 账期支付额度不够 账期支付余额不足,请进行充值
biz.govbus.addmixpayorder.invalid-biz:134 账期支付本地账号配置为空 请联系客户经理完成账期账号配置
biz.govbus.addmixpayorder.invalid-biz:135 系统异常 请联系苏宁技术人员核实处理
biz.govbus.addmixpayorder.invalid-biz:136 订单总价与订单行总价不匹配 请核实订单行,与订单总价金额
biz.govbus.addmixpayorder.invalid-biz:137 货到付款现金支付目前只支持10000元以下 货到付款现金支付目前只支持10000元以下
biz.govbus.addmixpayorder.invalid-biz:138 账期支付调取财务系统额度校验超时 欠款订单太多,请联系财务及时结款
biz.govbus.addmixpayorder.invalid-biz:139 物流时效查询失败 该地区暂不支持配送,请联系客户经理线下处理
biz.govbus.addmixpayorder.invalid-biz:140 物流时效数据配置有误 请联系苏宁技术人员进行处理
biz.govbus.addmixpayorder.invalid-biz:141 库存锁定失败 请稍后重试
biz.govbus.addmixpayorder.invalid-biz:142 纳税人识别号错误 检查输入参数
biz.govbus.addmixpayorder.invalid-biz:143 已超过单笔商品最大订购数量,请分批下单 请将订单拆分后重新下单
biz.govbus.addmixpayorder.invalid-biz:144 子支付方式编码为空 请填写子支付方式编码后重试
biz.govbus.addmixpayorder.invalid-biz:145 子支付方式对应金额不能为空 请填写子支付方式金额后重试
biz.govbus.addmixpayorder.invalid-biz:146 寻源数据异常 请稍后再试
biz.govbus.addmixpayorder.invalid-biz:147 无可用寻源参数 请联系苏宁技术人员进行处理
biz.govbus.addmixpayorder.invalid-biz:148 您的订单中商品寻源失败 联系客户经理
biz.govbus.addmixpayorder.invalid-biz:149 价格异常 请联系苏宁技术人员进行处理
biz.govbus.addmixpayorder.invalid-biz:150 该商品暂不销售 该商品暂不销售,请联系业务经理处理或选择同类商品下单
biz.govbus.addmixpayorder.invalid-biz:151 下单总数量超过大聚会活动的限量 请修改下单总数
biz.govbus.addmixpayorder.invalid-biz:152 收票人信息缺失 请补全收票人信息
biz.govbus.addmixpayorder.invalid-biz:153 子公司下单暂不支持第三方支付 请修改子公司支付方式
biz.govbus.addmixpayorder.invalid-biz:154 第三方支付本地账号配置为空 请联系业务经理完成第三方支付配置
biz.govbus.addmixpayorder.invalid-biz:155 子支付金额与订单总金额不匹配 请核实订单行,与订单总价金额
biz.govbus.addmixpayorder.invalid-biz:156 此地点不支持配送 请联系客户经理
biz.govbus.addmixpayorder.invalid-biz:157 库存不足 请联系客户经理添加库存
biz.govbus.addmixpayorder.invalid-biz:158 短时间内重复提交订单 请稍等10秒,进行订单提交
biz.govbus.addmixpayorder.invalid-biz:159 第三方支付个人支付金额为0,不支持开纸质发票 请选择不开票或开电子发票
biz.govbus.addmixpayorder.invalid-biz:160 第三方支付暂不支持开卷票 第三方支付无法开普票
biz.govbus.addmixpayorder.invalid-biz:161 发票信息校验失败 请重新输入购买数量
biz.govbus.addmixpayorder.invalid-biz:162 发票字段校验不通过 检查后正确后重新输入
biz.govbus.addmixpayorder.invalid-biz:163 第三方支付未配置销售平台,请联系客户经理 请联系业务经理协助处理
biz.govbus.addmixpayorder.invalid-biz:164 第三方支付未配置店铺信息,请联系客户经理 请联系业务经理协助处理
biz.govbus.addmixpayorder.invalid-biz:165 实体礼品卡、电子礼品卡只支持单独下单购买。 实体礼品卡、电子礼品卡只支持单独下单购买。
biz.govbus.addmixpayorder.invalid-biz:166 实体礼品卡只支持单独下单购买。 实体礼品卡只支持单独下单购买。
biz.govbus.addmixpayorder.invalid-biz:167 电子礼品卡只支持单独下单购买。 电子礼品卡只支持单独下单购买。
biz.govbus.addmixpayorder.invalid-biz:168 电子礼品卡、实体礼品卡需分别单独购买。 电子礼品卡、实体礼品卡需分别单独购买。
biz.govbus.addmixpayorder.invalid-biz:169 礼品卡仅支持开电子发票。 礼品卡仅支持开电子发票。
biz.govbus.addmixpayorder.invalid-biz:170 礼品卡不支持此种支付方式。 礼品卡不支持此种支付方式。
biz.govbus.addmixpayorder.invalid-biz:171 运费错误 运费错误
biz.govbus.addmixpayorder.invalid-biz:172 单个电子礼品卡下单数量不能超过999 单个电子礼品卡下单数量不能超过999
biz.govbus.addmixpayorder.invalid-biz:173 礼品卡商品没有维护易购价 礼品卡商品没有维护易购价
biz.govbus.addmixpayorder.invalid-biz:174 金额不正确 金额不正确
biz.govbus.addmixpayorder.invalid-biz:175 未获取到销售组织编码 请联系客户经理配置合同中销售组织
biz.govbus.addmixpayorder.invalid-biz:176 商品编码:[12321212, 12321212]该地区库存不足,请联系客户经理添加库存! 请联系客户经理完成库存不足的商品库存维护
biz.govbus.addmixpayorder.invalid-biz:177 普通服务商品不可与其他类型商品一起下单 普通服务商品不可与其他类型商品一起下单
biz.govbus.addmixpayorder.invalid-biz:178 服务商品不支持此发票类型 服务商品不支持此发票类型
biz.govbus.addmixpayorder.invalid-biz:179 普通服务商品不支持此支付方式 普通服务商品不支持此支付方式
biz.govbus.addmixpayorder.invalid-biz:180 普通服务商品运费为0 普通服务商品运费为0
biz.govbus.addmixpayorder.invalid-biz:181 普通服务商品下单数量不能超过* 普通服务商品下单数量不能超过*个
biz.govbus.addmixpayorder.invalid-biz:182 该用户未配置相关数量限制 该用户未配置相关数量限制
biz.govbus.addmixpayorder.invalid-biz:183 该用户数量限制的配置为空 该用户数量限制的配置为空
biz.govbus.addmixpayorder.invalid-biz:184 开具卷票请提前与苏宁工作人员联系! 开具卷票请提前与苏宁工作人员联系!
biz.govbus.addmixpayorder.invalid-biz:185 商品xxx最小购买数量为xx 该商品有最少购买数量限制
biz.govbus.addmixpayorder.invalid-biz:186 商品最小购买数量查询异常,请稍后再试 商品最小购买数量查询异常,请稍后再试
biz.govbus.createalipay.invalid-biz:187 20-账期+在线支付订单类型只能为预占型 检查订单类型传值
biz.govbus.createalipay.invalid-biz:190 08-纯账期”订单类型只能为实时型 检查订单类型传值
biz.govbus.addmixpayorder.invalid-biz:191 混合支付子支付方式金额不能为0 请确认传值金额是否有误
biz.govbus.addmixpayorder.invalid-biz:192 混合支付必须含账期支付方式 请重新确认传值
biz.govbus.addmixpayorder.invalid-biz:193 当前子支付方式不支持混合支付 请联系客户经理配置子支付方式
biz.govbus.addmixpayorder.invalid-biz:194 混合支付-运费规则配置未配置 请联系客户经理配置
biz.govbus.addmixpayorder.invalid-biz:195 当前客户运费全部由个人承担,个人在线支付金额应大于运费金额 请重新确认在线支付金额传值
biz.govbus.addmixpayorder.invalid-biz:196 20账期+在线支付,仅支持两种子支付方式 请检查子支付方式传值
biz.govbus.addmixpayorder.invalid-biz:197 创单失败,合同已过期,请联系苏宁客户经理 请联系苏宁客户经理
biz.govbus.addmixpayorder.invalid-biz:999 停用客户,调用权限受限 请联系苏宁客户经理
公共异常码
API工具
FAQ