票券

用户名下票券信息查询

服务 ID	zjrcuoip.tcs.qry.usercoupon
VERSION	1.0.0

服务详细描述

通过调用该接口，查询用户名下的票券信息。

业务规则：根据传入的用户 id 和投放渠道，查询用户在该渠道下的票券信息。

示例代码

QuanYiUserCouponDemo.java

/**
 * 用户名下票券信息查询
 *
 * @author
 */
@Service
public class QuanYiUserCouponDemo {

	@SuppressWarnings({ "rawtypes", "unchecked" })
	public static void execute() {
		// 1.获取通讯连接对象
		INetTools netTools = NetToolsHttpFactory.getHttpInstance();
		// 2.生成公共请求报文对象
		OipReqBean oipReqBean = new OipReqBean();
		// 设置应用id
		oipReqBean.setAppId("应用id");
		// 设置开发者id
		oipReqBean.setDlpId("开发者id");
		// 设置产品id
		oipReqBean.setProdId("产品id");
		// 设置api方法名
		oipReqBean.setMethod("zjrcuoip.tcs.qry.usercoupon");
		// 设置api版本
		oipReqBean.setVersion("1.0.0");
		// 设置时间戳
		SimpleDateFormat sfs = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
		oipReqBean.setTimestamp(sfs.format(new Date()));
		// 3.生成请求配置对象,配置请求地址/url等信息
		NetReqConfBean netReqConfBean = new NetReqConfBean();
		// 应用私钥
		netReqConfBean.setAppPrivateKey("应用私钥");
		// 请求地址
		netReqConfBean.setNetUrl("请求地址");
		// 开发者公钥
		netReqConfBean.setPublicKey("开发者公钥");
		// 设置业务报文
		Date d=new Date();
		SimpleDateFormat sf=new SimpleDateFormat("yyyyMMddHHmmss");
		//以map接收所有参数生成业务报文，主要是必输项，具体参考接口文档
		Map map =new HashMap();
		map.put("openId", "9999999999");
		map.put("channelId", "9A");
		map.put("status", "CAN_CONSUME");
		map.put("index", "1");
		map.put("size", "10");
		String bizContent = JSON.toJSONString(map);
		// 生成业务报文json对象
		oipReqBean.setBizContent(bizContent);
		// 通讯获取报文对象
		OipRspBean oipRspBean = netTools.execute(oipReqBean, netReqConfBean);
		// 响应成功
		if (oipRspBean.isSuccess()) {
		    String bizJson = oipRspBean.getBizContent();
		    if (StringUtils.isNotBlank(bizJson)) {
				Map bizData = JSON.parseObject(bizJson, Map.class);
				System.out.println(bizData);
		    }
		}
	}
}

公共报文

[点击查看公共报文]

业务输入项

序号	key	数据项名称	类型	长度	是否必输	数据项说明
1	openId	用户唯一标识	String	32	是
2	channelId	投放渠道	String	2	是	9A-丰收互联，DB-移动展业 APP，9I-数字营销系统， 3D-数字银行管理平台，LB-行社融合 ZH
3	status	券码状态	String	12	否	INEFFECTIVE:未生效，CAN_CONSUME:可使用，INVALID:已作废，CONSUMED:已核销，EXPIRE:已过期
4	index	第几页	String	10	是	第 1 页对应的 pageIndex=1
5	size	每页条数	String	10	是

业务输出项

票券信息列表开始 couponList

序号	key	数据项名称	类型	长度	是否非空	数据项说明
1	codeNo	流水号	String	18		发券流水号
2	couponName	券名称	String	64
3	validStartDate	有效期开始日期	String	12		yyyy-MM-dd
4	validEndDate	有效期结束日期	String	12		yyyy-MM-dd
5	status	券码状态	String	12		INEFFECTIVE:未生效，CAN_CONSUME:可使用，INVALID:已作废，CONSUMED:已核销，EXPIRE:已过期
6	couponLogo	券图片	String	128		应用券 logo

响应码

服务响应码	响应信息
00000000	交易成功