退出
热词搜索：
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.shoppingcoupon.get 购物返券活动详情查询
￥免费

通过此接口可对购物返券活动详情查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
id String Y 1001434507 购物返券活动ID
响应参数
名称 类型 示例值 描述
name String null 购物返券活动名称
getChannel String null 购物返券活动获取渠道（移动端、PC和移动端）
totalType String null 返券总量类型（0表示返券数量；1标识返券金额）
totalNumber String null 返券总数量
totalAmount String null 返券金额总量
useChannel String null 返券使用渠道（移动端、PC和移动端）
isBindGoods String null 是否指定返券商品（0否；1是）
returnedVoucherNumber String null 已返券数量
returnedVoucherAmount String null 已返券金额
usedNumber String null 已用券数量
usedAmount String null 已用券金额
updateTime String null 更新时间，格式：yyyy-MM-dd HH:mm:ss
level String null 返券层级
fulledAmount String null 订单满多少钱用券
parAmount String null 返券的面值
condition String null 返券的券使用条件（0不限，1订单满一定金额使用）
orderAmount String null 订单满多少钱
productCode String null 苏宁商品编码（如果是通码商品，则通码下面所有的子码分别展示）
productName String null 商品名称
level String null 返券层级
fulledAmount String null 订单满多少钱用券
parAmount String null 返券的面值
condition String null 返券的券使用条件（0不限，1订单满一定金额使用）
orderAmount String null 订单满多少钱
productCode String null 苏宁商品编码（如果是通码商品，则通码下面所有的子码分别展示）
productName String null 商品名称
level String null 返券层级
fulledAmount String null 订单满多少钱用券
parAmount String null 返券的面值
condition String null 返券的券使用条件（0不限，1订单满一定金额使用）
orderAmount String null 订单满多少钱
productCode String null 苏宁商品编码（如果是通码商品，则通码下面所有的子码分别展示）
productName String null 商品名称
level String null 返券层级
fulledAmount String null 订单满多少钱用券
parAmount String null 返券的面值
condition String null 返券的券使用条件（0不限，1订单满一定金额使用）
orderAmount String null 订单满多少钱
productCode String null 苏宁商品编码（如果是通码商品，则通码下面所有的子码分别展示）
productName String null 商品名称
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
	<sn_body>
		<getShoppingCoupon>
			<id>1001434507</id>
		</getShoppingCoupon>
	</sn_body>
</sn_request>
                                
                                {
	"sn_request": {
		"sn_body": {
			"getShoppingCoupon": {
				"id": "1001434507" 
			}
		}
	}
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
	<sn_body>
		<getShoppingCoupon>
			<name>我爱我家啊</name>
			<getChannel>移动端</getChannel>
			<totalType>0</totalType>
			<totalNumber> 1000 </totalNumber>
			<totalAmount>20000</totalAmount>
			<useChannel>移动端</useChannel>
			<isBindGoods>1</isBindGoods>
			<returnedVoucherNumber>100</returnedVoucherNumber>
			<returnedVoucherAmount>5000</returnedVoucherAmount>
			<usedNumber>50</usedNumber>
			<usedAmount>500</usedAmount>
			<updateTime>2014-07-19 21:12:22</updateTime>
			<shoppingDetail>
				<level>1</level>
				<fulledAmount>500</fulledAmount>
				<parAmount>100</parAmount>
				<condition>0</condition>
				<orderAmount>200</orderAmount>
			</shoppingDetail>
			<shoppingDetail>
				<level>1</level>
				<fulledAmount>500</fulledAmount>
				<parAmount>100</parAmount>
				<condition>0</condition>
				<orderAmount>200</orderAmount>
			</shoppingDetail>
			<productDetail>
				<productCode>100421144</productCode>
				<productName>拖把</productName>
			</productDetail>
			<productDetail>
				<productCode>100421144</productCode>
				<productName>拖把</productName>
			</productDetail>
		</getShoppingCoupon>
	</sn_body>
</sn_responseContent>
                              
                              {
	"sn_responseContent": {
		"sn_body": {
			"getShoppingCoupon": {
				"name": "我爱我家啊",
				"getChannel": "移动端",
				"totalType": "0",
				"totalNumber": " 1000 ",
				"totalAmount": "20000",
				"useChannel": "移动端",
				"isBindGoods": "1",
				"returnedVoucherNumber": "100",
				"returnedVoucherAmount": "5000",
				"usedNumber": "50",
				"usedAmount": "500",
				"updateTime": "2014-07-19 21:12:22",
				"shoppingDetail": [
				{
					"level": "1",
					"fulledAmount": "500",
					"parAmount": "100",
					"condition": "0",
					"orderAmount": "200"
				},
				{
					"level": "1",
					"fulledAmount": "500",
					"parAmount": "100",
					"condition": "0",
					"orderAmount": "200"
				}],
				"productDetail": [
				{
					"productCode": "100421144",
					"productName": "拖把"
				},
				{
					"productCode": "100421144",
					"productName": "拖把"
				}]
			}
		}
	}
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.getshoppingcoupon.missing-parameter:id 购物返券活动ID不能为空。必填项 请输入正确参数。
isp.sys.service.unavailable.sel 服务不可用（系统异常） 请联系苏宁技术人员。
biz.handler.data-get:no-result 查询没结果 请输入正确参数。
sys.check.pageno-format:error pageNo格式错误，只允许1到99999之间的整数 请输入正确参数。
sys.check.pagesize-format:error pageSize格式错误，只允许1到50之间的整数(订单相关是1到100) 请输入正确参数。
sys.check.page-param:error pageNo或者pageSize不在要求范围内，pageNo只允许1到99999之间的整数，pageSize只允许1到50之间的整数(订单相关是1到100) 请输入正确参数。
sys.check.starttime:format-error 查询开始时间格式错误。格式：yyyy-MM-dd HH:mm:ss 请输入正确参数。
sys.check.endtime:format-error 查询结束时间格式错误。格式：yyyy-MM-dd HH:mm:ss 请输入正确参数。
sys.check.invalid-time:100 开始日期和结束时间必须成对出现 请输入正确参数。
sys.check.query-time:error 开始时间不能小于等于结束时间 请输入正确参数。
sys.check.query-time:outofrange 查询时间区间超出指定范围 请输入正确参数。
sys.check.api-permission:inexistence API方法不存在 请输入正确参数。
sys.check.app-sign:null 签名信息为空 请输入正确参数。
sys.check.app-sign:error 签名信息错误 请输入正确参数。
sys.check.missing-parameter:apiversion API版本号未指定 请输入正确参数。
sys.check.missing-parameter:appRequestTime 请求时间丢失 请输入正确参数。
sys.check.app-time:error api请求时间误差大 请输入正确参数。
sys.check.missing-nestElement:sn_body 缺少sn_body节点 请输入正确参数。
sys.check.user-permission:inexistence 用户key不存在 请输入正确参数。
sys.check.api-permission:authority 无权限访问API方法 请输入正确参数。
biz.handler.batch-handler:no-support 非查询类API不支持批量操作 请输入正确参数。
biz.handler.request-message:error 查询类API输入多个业务节点 请输入正确参数。
sys.check.request-params:error 请求报文结构错误 请输入正确参数。
sys.error.network:failure 统一异常封装，运行时异常造成的 请输入正确参数。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：购物返券活动详情查询接口如何使用？

A：通过此接口可对购物返券活动详情查询