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

质检业务

服务商质检API
异常码自查工具
suning.fws.chargeitemremain.query 批量查询指定收费项目服务剩余可使用数量
￥免费

通过此接口可查询指定收费项目以及商家账号的订购关系及服务剩余可使用数量。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
chargeId String Y S01234567890 收费项目代码。服务的子项目的代码
businessAccounts String Y zz@xx.com 商家账号。商家账号
pageNo String N 1 页码。页码。默认值：1。
pageSize String N 10 每页条数。每页条数。最大值：50。默认值：10。
响应参数
名称 类型 示例值 描述
orderId String null 订单号。服务市场的订单号
failureTime String null 失效时间。购买服务截止时间；格式yyyy-MM-ddhh:mm:ss
orderDetailId String null 订单行号。服务市场的订单详情号
orderQuantity String null 订购数量。未失效行订单下订购该收费项目的数量
remainCount String null 可使用数量。未失效行订单下订购该收费项目可使用的剩余数量
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
     <sn_body>
          <queryChargeItemRemain>
             <chargeId>S01234567890</chargeId>
             <businessAccounts>zz@xx.com</businessAccounts>
             <pageNo>1</pageNo>
             <pageSize>10</pageSize>
             </queryChargeItemRemain>
     </sn_body>
</sn_request>
                                
                                {
  "sn_request": {
    "sn_body": {
      "queryChargeItemRemain": {
        "chargeId": "S01234567890",
        "businessAccounts": "zz@xx.com",
        "pageNo": "1",
        "pageSize": "10"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
     <sn_head>
          <pageTotal>1</pageTotal>
          <pageNo>1</pageNo>
          <totalSize>20</totalSize>
          <returnMessage>biz.handler.data-get:success</returnMessage>
     </sn_head>
     <sn_body>
          <queryChargeItemRemain>
           		<orderId>1001434507</orderId>
            	<failureTime>2015-4-11  00:00:00</failureTime>
            	<orderDetail>
            			<orderDetailId>S01234567890</orderDetailId>
            			<orderQuantity>20</orderQuantity>
            			<remainCount>15< remainCount>
            	</orderDetail>
            	<orderDetail>
            			<orderDetailId>S01234567891</orderDetailId>
            			<orderQuantity>20</orderQuantity>
            			<remainCount>15< remainCount>
            	</orderDetail>
        	</queryChargeItemRemain>
          <queryChargeItemRemain>
            	<orderId>1001434508</orderId>
            	<failureTime>2015-4-11  00:00:00</failureTime>
            	<orderDetail>
            		  <orderDetailId>S01234567892</orderDetailId>
            		  <orderQuantity>20</orderQuantity>
            		  <remainCount>15< remainCount>
            	</orderDetail>
            	<orderDetail>
            		  <orderDetailId>S01234567893</orderDetailId>
            		  <orderQuantity>20</orderQuantity>
            		  <remainCount>15< remainCount>
            	</orderDetail>
          </queryChargeItemRemain>
		</sn_body>
</sn_responseContent>
                              
                              {
	"sn_responseContent": {
      	"sn_head": {
			"pageTotal": "1",
			"pageNo": "1",
			"returnMessage": "biz.handler.data-get:success"
		},
        "sn_body": {
            "queryChargeItemRemain": [{
				"orderId": "1001434507",
				"failureTime": "2015-4-11  00:00:00",
				"orderDetail": [{
					"orderDetailId": "S01234567890",
					"orderQuantity": "20",
					"remainCount": "15"
				},
				{
					"orderDetailId": "S01234567891",
					"orderQuantity": "20",
					"remainCount": "15"}]
				},
				{
					"orderId": "1001434508",
					"failureTime": "2015-4-11  00:00:00",
				"orderDetail": [{
						"orderDetailId": "S01234567892",
						"orderQuantity": "20",
						"remainCount": "15"
				},
				{
						"orderDetailId": "S01234567893",
						"orderQuantity": "20",
						"remainCount": "15"
				}]
				}
           	]
		}
	}
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.fws.queryChargeItemRemain.missing-parameter:chargeId 收费项目代码为空 请输入正确参数。
biz.fws.queryChargeItemRemain.missing-parameter:businessAccounts 商家账号为空 请输入正确参数。
biz.handler.data-get:no-result 查询无结果 请输入正确参数。
isp.sys.service.unavailable.fws 服务不可用（系统异常） 请联系苏宁技术人员。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：批量查询指定收费项目服务剩余可使用数量接口如何使用？

A：通过此接口可查询指定收费项目以及商家账号的订购关系及服务剩余可使用数量。