feat:正元对接类型定义

2025-02-27 19:14:40 +08:00
1 parent 62b00d593e
commit 5ab3150f64
@@ -0,0 +1,10 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.foreign;
+
+import lombok.Data;
+
+/**
+ * 获取区域编码
+ */
+@Data
+public class ZyForeignGetRegionIdByTokenDto {
+}
@@ -0,0 +1,57 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.foreign;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * 本地一卡通交易数据同步
+ */
+@Data
+public class ZyForeignSyncNativeCardTradeInfoDto {
+
+    /**
+     * 区域编码，取【获取区域编码】接口返回值参regionCode
+     */
+    private String regionCode;
+
+    /**
+     * 就餐总人数，从推广公务餐之日起，即总人数
+     */
+    private Long totalNum;
+
+    /**
+     * 	就餐总金额，从推广公务餐之日起，即总金额
+     */
+    private BigDecimal totalMoney;
+
+    /**
+     * 当年就餐总人数，从当年1月1日开始
+     */
+    private Long totalNumYear;
+
+    /**
+     * 当年就餐总金额，从当年1月1日开始
+     */
+    private BigDecimal totalMoneyYear;
+
+    /**
+     * 当月就餐总人数，从当月1日开始
+     */
+    private Long totalNumMonth;
+
+    /**
+     * 当月就餐总金额，从当月1日开始
+     */
+    private BigDecimal totalMoneyMonth;
+
+    /**
+     * 当日就餐总人数
+     */
+    private Long totalNumDay;
+
+    /**
+     * 当日就餐总金额
+     */
+    private BigDecimal totalMoneyDay;
+}
@@ -0,0 +1,15 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.mer;
+
+import lombok.Data;
+
+/**
+ * 获取token
+ */
+@Data
+public class ZyMerGetTokenDto {
+
+    private String appid;
+
+    private String appsecret;
+
+}
@@ -0,0 +1,30 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.mer;
+
+import lombok.Data;
+
+/**
+ * 身份信息同步
+ */
+@Data
+public class ZyMerSyncAccClassInfoDto {
+
+    /**
+     * 身份编号
+     */
+    private String AccClassID;
+
+    /**
+     * 身份名称
+     */
+    private String AccClassName;
+
+    /**
+     * 所属记账单位编号
+     */
+    private String EPID;
+
+    /**
+     * 每次推送版本号，格式化为14位字符串，如果是数字不足14位的，前面补0。
+     */
+    private String FixId;
+}
@@ -0,0 +1,61 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.mer;
+
+import lombok.Data;
+
+/**
+ * 账户信息同步
+ */
+@Data
+public class ZyMerSyncAccountInfoDto {
+
+    /**
+     * 账户姓名
+     */
+    private String AccName;
+
+    /**
+     * 账号，人员的唯一属性
+     */
+    private String AccNum;
+
+    /**
+     * 卡账号，卡片的唯一属性
+     */
+    private Long CardAccNum;
+
+    /**
+     * 物理卡号，行业标准
+     */
+    private String CardSID;
+
+    /**
+     * 卡片状态，0销卡；1有效；2挂失；3冻结；4预销卡；5锁卡，默认1
+     */
+    private String CardStatus;
+
+    /**
+     * 该卡在所属接入系统中的所属单位编号
+     */
+    private String EPID;
+
+    /**
+     * 人员编号
+     */
+    private String PerCode;
+
+    /**
+     * 身份编号，必须是【身份信息】中的值
+     */
+    private String AccClassID;
+
+    /**
+     * 手机号码，建议同步，否则将无法使用移动端应用
+     */
+    private String PhoneNo;
+
+    /**
+     * 版本号，规则同记账单位同步
+     */
+    private String FixId;
+
+}
@@ -0,0 +1,40 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.mer;
+
+
+import lombok.Data;
+
+/**
+ * 商户信息同步
+ */
+@Data
+public class ZyMerSyncDealerInfoDto {
+    /**
+     * 商户所在系统的键值
+     */
+    private String DealerKeyObj;
+
+    /**
+     * 商户名称
+     */
+    private String DealerName;
+
+    /**
+     * 商户是否有效0：禁用 1：有效
+     */
+    private String IsValid;
+
+    /**
+     * 所属记账单位编号
+     */
+    private String EPID;
+
+    /**
+     * 每次推送版本号，格式化为14位字符串，如果是数字不足14位的，前面补0。
+     */
+    private String FixId;
+
+    /**
+     * 商户类型，0食堂餐厅，1超市，2普通商家，3其他；不传默认是食堂餐厅类型
+     */
+    private String DealerType;
+}
@@ -0,0 +1,31 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.mer;
+
+import lombok.Data;
+
+/**
+ * 记账单位同步
+ */
+@Data
+public class ZyMerSyncEnterpriseInfoDto {
+
+    /**
+     * 记账单位在自己系统中的编号，必须使用数字，禁止字母、汉字、特殊字符等其他字符串
+     */
+    private String EPID;
+
+    /**
+     * 记账单位名称，即不同接入单位的名称，本地一卡通可根据实际情况自行判断属性范围
+     */
+    private String EPName;
+
+    /**
+     * 记账单位是否有效0：禁用 1：有效
+     */
+    private String IsValid;
+
+    /**
+     * 每次推送版本号，格式化为14位字符串，如果是数字不足14位的，前面补0。
+     */
+    private String FixId;
+
+}
@@ -0,0 +1,11 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.self;
+
+import lombok.Data;
+
+/**
+ * 第三方url健康探测
+ */
+@Data
+public class ZySelfCheckSystemStatusDto {
+
+}
@@ -0,0 +1,35 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.self;
+
+import lombok.Data;
+
+/**
+ * 第三方一卡通系统提供冲正接口
+ */
+@Data
+public class ZySelfCorrectDto {
+
+    /**
+     * 智慧园区通刷服务平台冲正所产生的平台记录流水号
+     */
+    private String serialNum;
+
+    /**
+     * 待冲正流水号,该流水号是调用第三方扣费接口返回的流水号，即第三方的订单号
+     */
+    private String correctSerialNum;
+
+    /**
+     * 冲正金额，不传表示全额冲正，且仅支持全额冲正退款
+     */
+    private String amount;
+
+    /**
+     * 访问对接系统中配置的opId值，即该退款账户所在的记账单位编号
+     */
+    private String opId;
+
+    /**
+     * 签名值，明文不加密
+     */
+    private String sign;
+}
@@ -0,0 +1,20 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.self;
+
+import lombok.Data;
+
+/**
+ * 第三方提供获取token
+ */
+@Data
+public class ZySelfGetTokenDto {
+
+    /**
+     * 第三方app用户id
+     */
+    private String appid;
+
+    /**
+     * 第三方app用户密钥
+     */
+    private String appsecret;
+}
@@ -0,0 +1,46 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.self;
+
+import lombok.Data;
+
+/**
+ * 第三方一卡通系统提供扣费接口
+ */
+@Data
+public class ZySelfPayDto {
+
+    /**
+     * 一卡通帐号，可以通过【获取账户信息接口】获得
+     */
+    private String accNum;
+
+    /**
+     * 卡账号，用户多卡情况下选择对应卡账号来扣费，不填的是默认用户主卡扣费。
+     */
+    private String cardAccNum;
+
+    /**
+     * 消费金额,格式是XX.XX元
+     */
+    private String amount;
+
+    /**
+     * 智慧园区通刷服务平台扣费流水号
+     */
+    private String serialNum;
+
+    /**
+     * 交易时间，格式：yyyy-MM-dd HH:mm:ss
+     */
+    private String dealTime;
+
+    /**
+     * 在访问对接配置里面配置的opId值，第三方一卡通系统根据需要获取
+     */
+    private String opId;
+
+    /**
+     * 签名
+     */
+    private String sign;
+
+}
@@ -0,0 +1,45 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.stride;
+
+import lombok.Data;
+
+/**
+ * 统一身份验证功能
+ */
+@Data
+public class ZyStrideAuthenticationDto {
+
+    /**
+     * 物理卡号，当Type不传（默认为0）时，该值必填；当Type为1时，该值可为空
+     */
+    private String CardSID;
+
+    /**
+     * 商户号（商户所在单位主键）
+     */
+    private String DealerKeyObj;
+
+    /**
+     * 消费机设备序列号（唯一）,用于终端查流水使用
+     */
+    private String TerminalNum;
+
+    /**
+     * 商户所在系统的单位编号
+     */
+    private String EPID;
+
+    /**
+     * 消费认证方式（0-刷卡；1-扫码），默认为0
+     */
+    private String Type;
+
+    /**
+     * 设备读取到的完整的二维码字符串，当Type为1时，该值必填
+     */
+    private String Qrcode;
+
+    /**
+     * 签名，明文传输
+     */
+    private String sign;
+}
@@ -0,0 +1,35 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.stride;
+
+import lombok.Data;
+
+/**
+ * 智慧园区通刷平台提供消费接口
+ */
+@Data
+public class ZyStrideConsumptionDto {
+
+    /**
+     * 商户在所在系统的编号（主键值）
+     */
+    private String DealerKeyObj;
+
+    /**
+     * 消费金额（元）
+     */
+    private String money;
+
+    /**
+     * 订单号（统一身份验证通过后返回的订单号）
+     */
+    private String recNum;
+
+    /**
+     * POS机发起交易的时间，yyyy-MM-dd HH:mm:ss
+     */
+    private String dealTime;
+
+    /**
+     * 签名值，明文不加密
+     */
+    private String sign;
+}
@@ -0,0 +1,31 @@
+package com.bsd.pjcloud.thirdparty.dto.zy.stride;
+
+import lombok.Data;
+
+/**
+ * 智慧园区通刷平台提供冲正接口
+ */
+@Data
+public class ZyStrideCorrectDto {
+
+    /**
+     * 消费金额（元），末笔全额冲正，现在只支持全额冲正，传过来也无效
+     */
+    private String money;
+
+    /**
+     * POS机收到的末笔订单号（统一身份验证通过后智慧园区通刷服务平台返回的订单号）
+     */
+    private String recNum;
+
+    /**
+     * POS机发起冲正的时间，yyyy-MM-dd HH:mm:ss
+     */
+    private String dealTime;
+
+    /**
+     * 签名值，明文不加密
+     */
+    private String sign;
+
+}
@@ -0,0 +1,12 @@
+package com.bsd.pjcloud.thirdparty.vo.zy;
+
+import lombok.Data;
+
+@Data
+public class ZyBaseVo {
+
+    private Integer code;
+
+    private String msg;
+
+}
@@ -0,0 +1,30 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.foreign;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 获取区域编码
+ */
+@Data
+public class ZyForeignGetRegionIdByTokenVo extends ZyBaseVo {
+
+    private VoData data;
+
+    @Data
+    static class VoData {
+        /**
+         * 区域编码
+         */
+        private String regionCode;
+        /**
+         * 地市全名称
+         */
+        private String regionAllName;
+        /**
+         * 	地市简称
+         */
+        private String regionName;
+    }
+
+}
@@ -0,0 +1,12 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.foreign;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 本地一卡通交易数据同步
+ */
+@Data
+public class ZyForeignSyncNativeCardTradeInfoVo extends ZyBaseVo {
+
+}
@@ -0,0 +1,16 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.mer;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 获取token
+ */
+@Data
+public class ZyMerGetTokenVo extends ZyBaseVo {
+
+    private String access_token;
+
+    private String expires_in;
+
+}
@@ -0,0 +1,11 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.mer;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 身份信息同步
+ */
+@Data
+public class ZyMerSyncAccClassInfoVo extends ZyBaseVo {
+}
@@ -0,0 +1,25 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.mer;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 账户信息同步
+ */
+@Data
+public class ZyMerSyncAccountInfoVo extends ZyBaseVo {
+
+    @Data
+    static  class DataVo{
+        /**
+         * 当前智慧园区通刷服务平台保存的最新同步版本号，返回该版本号，要求第三方一卡通系统同步这个大于这个版本号的数据
+         */
+        private String currentFixId;
+
+        /**
+         * 签名
+         */
+        private String sign;
+    }
+
+}
@@ -0,0 +1,13 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.mer;
+
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 商户信息同步
+ */
+@Data
+public class ZyMerSyncDealerInfoVo extends ZyBaseVo {
+
+}
@@ -0,0 +1,12 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.mer;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 记账单位同步
+ */
+@Data
+public class ZyMerSyncEnterpriseInfoVo extends ZyBaseVo {
+
+}
@@ -0,0 +1,19 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.self;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+import javax.xml.stream.events.StartDocument;
+
+/**
+ * 第三方url健康探测
+ */
+@Data
+public class ZySelfCheckSystemStatusVo extends ZyBaseVo {
+
+    /**
+     * 当前系统时间 格式yyyy-MM-dd HH:mm:ss
+     */
+    private String systemTime;
+
+}
@@ -0,0 +1,13 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.self;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 第三方一卡通系统提供冲正接口
+ */
+@Data
+public class ZySelfCorrectVo extends ZyBaseVo {
+
+
+}
@@ -0,0 +1,15 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.self;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 第三方提供获取token
+ */
+@Data
+public class ZySelfGetTokenVo extends ZyBaseVo {
+
+    private String access_token;
+
+    private String expires_in;
+}
@@ -0,0 +1,11 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.self;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 第三方一卡通系统提供扣费接口
+ */
+@Data
+public class ZySelfPayVo extends ZyBaseVo {
+}
@@ -0,0 +1,56 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.stride;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 统一身份验证功能
+ */
+@Data
+public class ZyStrideAuthenticationVo extends ZyBaseVo {
+
+    /**
+     * 物理卡号
+     */
+    private String CardSID;
+
+    /**
+     * 如果返回成功，则返回订单号
+     */
+    private String recNum;
+
+    /**
+     * 卡户所属单位名称
+     */
+    private String deptName;
+
+    /**
+     * 姓名
+     */
+    private String AccName;
+
+    /**
+     * 个人编号
+     */
+    private String PerCode;
+
+    /**
+     * 是否是本地一卡通人员，true-是，false-不是
+     */
+    private String IsOwner;
+
+    /**
+     * 个人账号
+     */
+    private String AccNum;
+
+    /**
+     * 易通为记账单位编号，4.0为园区号
+     */
+    private String ChargeId;
+
+    /**
+     * 签名
+     */
+    private String sign;
+}
@@ -0,0 +1,36 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.stride;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 智慧园区通刷平台提供消费接口
+ */
+@Data
+public class ZyStrideConsumptionVo extends ZyBaseVo {
+
+    /**
+     * 商户在所在系统的编号（主键值）
+     */
+    private String DealerKeyObj;
+
+    /**
+     * 消费金额（元）
+     */
+    private String money;
+
+    /**
+     * 订单号（统一身份验证通过后返回的订单号）
+     */
+    private String recNum;
+
+    /**
+     * POS机发起交易的时间，yyyy-MM-dd HH:mm:ss
+     */
+    private String dealTime;
+
+    /**
+     * 签名值，明文不加密
+     */
+    private String sign;
+}
@@ -0,0 +1,41 @@
+package com.bsd.pjcloud.thirdparty.vo.zy.stride;
+
+import com.bsd.pjcloud.thirdparty.vo.zy.ZyBaseVo;
+import lombok.Data;
+
+/**
+ * 智慧园区通刷平台提供冲正接口
+ */
+@Data
+public class ZyStrideCorrectVo extends ZyBaseVo {
+
+    /**
+     * 订单号
+     */
+    private String recNum;
+
+    /**
+     * 入流水时间（服务器）
+     */
+    private String dealTime;
+
+    /**
+     * 冲正金额
+     */
+    private String money;
+
+    /**
+     * 姓名
+     */
+    private String accName;
+
+    /**
+     * 个人编号
+     */
+    private String perCode;
+
+    /**
+     * 签名
+     */
+    private String sign;
+}