API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.orders.query C店订单支付及优惠信息查询
¥免费

C店订单支付及优惠信息查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderCodeStringY4511680451B2C订单号
响应参数
名称 类型 示例值 描述
orderCodeString1000831522订单号
orderTimeString2019-01-01 11:00:00订单提交时间
orderSaleTimeString2018-01-01 01:01:01订单销售时间
countMoneyString111.00订单行支付总额
orderDetailString
orderLineNumberString1000231255订单行项目号
productCodeString102609881苏宁商品编码
itemCodeStringB1001商家商品编码
productNameString销售组汤锅02商品中文名称
unitPriceString188.00商品单价
payAmountString299.00商品行应付金额
saleNumString1.00商品销售数量
orderLineStatusString0:订单取消;5:等待支付;10=待发货;15:发货中;20=已发货;30=交易成功订单行状态
transportFeeString0.00订单行运费
returnOrderFlagString0表示正常订单, 1表示退货订单退货订单标识
coupontotalMoneyString0.00优惠券金额
vouchertotalMoneyString0.00优惠单金额
payorderidStringP00000000100001785834支付单号
reservedepositamountString100.00预定订金金额
reservebalanceamountString100.00预定尾款金额
reservestatusString预定状态(M:定金已支付,P:定金已罚没,R:定金已退还)预定状态
orderPayCodeString23-花呗支付;24-花呗分期支付子支付方式
declareItemPriceString20.00申报单价
declareGoodsAmountString30.00申报订单行贷款
itemTaxFareString10.00税费
declareItemTaxfareString2.00申报税费
paymentListString
paycodeString4148-易付宝支付、5002-礼品卡支付、9003-门店付款、6901-券或云钻支付、6903-易付宝优惠券支付、2037-光大MIS银行卡(新)、1001-现金 (CASH)、2044-建行MIS银行卡(新)、6906-赠品支付、4237-支付宝支付、4245-微信支付、6915-铜板支付付款方式
banktypecodeString998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券、10001-云券、10002-限品类云券、10003-店铺云券、10004-易券、10005-限品类易券、10006-店铺易券、10009-无敌券。支付方式编码,表示对订单使用的券用积分类型
payamountString299.00支付方式分摊金额。订单使用劵和积分总金额需每个行项目的支付方式分摊金额累计。
offLinePayFlagString1;非线下支付:空值线下支付
alipayPayNoString2019010722001416950514272890支付流水号
merchantPercentString商家: 50.00%商家承担比例
platformPercentString平台: 50.00%平台承担比例
couponListString
coupontypeString券类型表示返券返积分的类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券券类型
sharelimitString1.00销售单据分摊金额。订单返券返积分总金额需每个行项目的销售单据分摊额度累计
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryOrders>
      <orderCode>4511680451</orderCode>
    </queryOrders>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryOrders": {
        "orderCode": "4511680451"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryOrders>
      <orderTime>2019-01-01 11:00:00</orderTime>
      <orderSaleTime>2018-01-01 01:01:01</orderSaleTime>
      <orderCode>1000831522</orderCode>
      <orderDetail>
        <unitPrice>188.00</unitPrice>
        <reservestatus>预定状态(M:定金已支付,P:定金已罚没,R:定金已退还)</reservestatus>
        <declareGoodsAmount>30.00</declareGoodsAmount>
        <transportFee>0.00</transportFee>
        <itemTaxFare>10.00</itemTaxFare>
        <itemCode>B1001</itemCode>
        <returnOrderFlag>0表示正常订单, 1表示退货订单</returnOrderFlag>
        <payorderid>P00000000100001785834</payorderid>
        <saleNum>1.00</saleNum>
        <productName>销售组汤锅02</productName>
        <paymentList>
          <paycode>4148-易付宝支付、5002-礼品卡支付、9003-门店付款、6901-券或云钻支付、6903-易付宝优惠券支付、2037-光大MIS银行卡(新)、1001-现金 (CASH)、2044-建行MIS银行卡(新)、6906-赠品支付、4237-支付宝支付、4245-微信支付、6915-铜板支付</paycode>
          <platformPercent>平台: 50.00%</platformPercent>
          <banktypecode>998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券、10001-云券、10002-限品类云券、10003-店铺云券、10004-易券、10005-限品类易券、10006-店铺易券、10009-无敌券。</banktypecode>
          <alipayPayNo>2019010722001416950514272890</alipayPayNo>
          <merchantPercent>商家: 50.00%</merchantPercent>
          <offLinePayFlag>1;非线下支付:空值</offLinePayFlag>
          <payamount>299.00</payamount>
        </paymentList>
        <orderPayCode>23-花呗支付;24-花呗分期支付</orderPayCode>
        <declareItemTaxfare>2.00</declareItemTaxfare>
        <productCode>102609881</productCode>
        <payAmount>299.00</payAmount>
        <couponList>
          <coupontype>券类型表示返券返积分的类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券</coupontype>
          <sharelimit>1.00</sharelimit>
        </couponList>
        <reservedepositamount>100.00</reservedepositamount>
        <reservebalanceamount>100.00</reservebalanceamount>
        <declareItemPrice>20.00</declareItemPrice>
        <orderLineNumber>1000231255</orderLineNumber>
        <coupontotalMoney>0.00</coupontotalMoney>
        <orderLineStatus>0:订单取消;5:等待支付;10=待发货;15:发货中;20=已发货;30=交易成功</orderLineStatus>
        <vouchertotalMoney>0.00</vouchertotalMoney>
      </orderDetail>
      <countMoney>111.00</countMoney>
    </queryOrders>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryOrders": {
        "orderTime": "2019-01-01 11:00:00",
        "orderSaleTime": "2018-01-01 01:01:01",
        "orderCode": "1000831522",
        "orderDetail": [
          {
            "unitPrice": "188.00",
            "reservestatus": "预定状态(M:定金已支付,P:定金已罚没,R:定金已退还)",
            "declareGoodsAmount": "30.00",
            "transportFee": "0.00",
            "itemTaxFare": "10.00",
            "itemCode": "B1001",
            "returnOrderFlag": "0表示正常订单, 1表示退货订单",
            "payorderid": "P00000000100001785834",
            "saleNum": "1.00",
            "productName": "销售组汤锅02",
            "paymentList": [
              {
                "paycode": "4148-易付宝支付、5002-礼品卡支付、9003-门店付款、6901-券或云钻支付、6903-易付宝优惠券支付、2037-光大MIS银行卡(新)、1001-现金 (CASH)、2044-建行MIS银行卡(新)、6906-赠品支付、4237-支付宝支付、4245-微信支付、6915-铜板支付",
                "platformPercent": "平台: 50.00%",
                "banktypecode": "998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券、10001-云券、10002-限品类云券、10003-店铺云券、10004-易券、10005-限品类易券、10006-店铺易券、10009-无敌券。",
                "alipayPayNo": "2019010722001416950514272890",
                "merchantPercent": "商家: 50.00%",
                "offLinePayFlag": "1;非线下支付:空值",
                "payamount": "299.00"
              }
            ],
            "orderPayCode": "23-花呗支付;24-花呗分期支付",
            "declareItemTaxfare": "2.00",
            "productCode": "102609881",
            "payAmount": "299.00",
            "couponList": [
              {
                "coupontype": "券类型表示返券返积分的类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券",
                "sharelimit": "1.00"
              }
            ],
            "reservedepositamount": "100.00",
            "reservebalanceamount": "100.00",
            "declareItemPrice": "20.00",
            "orderLineNumber": "1000231255",
            "coupontotalMoney": "0.00",
            "orderLineStatus": "0:订单取消;5:等待支付;10=待发货;15:发货中;20=已发货;30=交易成功",
            "vouchertotalMoney": "0.00"
          }
        ],
        "countMoney": "111.00"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
isp.sys.service.unavailable.momq 服务不可用 请联系苏宁技术人员
biz.custom.queryorders.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
biz.custom.queryorders.invalid-biz:100 B2C订单号格式非法 B2C订单号为空或长度超过30位
公共异常码
API工具
FAQ