积分服务

积分对账单

服务ID	zjrcuoip.cpm.bill.downloadurl.query
VERSION	1.0.0

服务详细描述

获取对账单下载地址。

示例代码

CpmBillGetDemoOp.java

/**
 * 积分对账单
 * 
 * @author
 */
@Service
public class CpmBillGetDemoOp {

	@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.cpm.bill.downloadurl.query");
		// 设置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("输入项必输字段", "字段值");
		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	billDate	对账单日期	String	8	M	下载对账单的日期，格式：yyyyMMdd
2	billType	账单类型	String	8	M	积分消耗：ALL、积分产生：JFCS
3	tarType	压缩账单	String	4	M	固定值：GZIP，返回格式为.gz的压缩包账单

业务输出项

序号	key	数据项名称	类型	长度	是否非空	数据项说明
1	billDownloadUrl	账单下载地址链接	String	2048	M	账单下载地址链接，获取连接后30秒后未下载，链接地址失效。 https://60.190.244.43:8800/downloadBillFile.resource?bizType=X&fileType=X&downloadFileName=X&fileId=X&dlpId=X

所有文件内容中各字段均以|||分隔。

如2022年4月4日生成的文件夹名称为20220403，对账单中包含的是交易日期tradeDate为4月3日的交易数据。

积分消耗流水字段说明：

序号	数据项名称	是否必输	类型	长度	说明
1	交易流水号	M	String	50
2	行社号	M	String	6
3	交易渠道	M	String	10
4	积分科目	M	String	50
5	二级类目	O	String	50	当积分科目为common_point，则该字段可能为空
6	交易状态	M	String	5	00-成功 20-失败
7	消耗积分	M	String	11
8	交易日期	M	String	10	格式：yyyy-MM-dd
9	应用id	M	String	50
10	开发者id	M	String	50
11	清算日期	O	String	20	格式：yyyy-MM-dd HH:mm:ss
12	冲正标识	O	String	2	1.已冲正

积分产生流水字段说明:

序号	数据项名称	是否必输	类型	长度	说明
1	机构号	M	String	6
2	客户内码	M	String	50
3	积分值	M	String	10	对应安吉农商行绿币值
4	证件号码	M	String	50
5	积分科目	M	String	50
6	二级类目	M	String	50
7	交易流水号	M	String	50	订单流水编号
8	产生渠道	M	String	50
9	创建时间	M	String	50	格式：yyyy-MM-dd hh:MM:ss
10	失效时间	M	String	50	格式：yyyy-MM-dd hh:MM:ss