POST/cqy/queryCqyCheck开放/回调

对接方 CQY（代号待业务确认）-查询Qyc核销 · queryQycCheck 推断名·方法名推断

开放与对接 / 对接方 CQY（代号待业务确认）· OpenapiCqyRecordController#queryQycCheck

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/open-api/cqy/queryCqyCheck
请求方式POST
Content-Typeapplication/json
暴露渠道开放/回调　前缀 /open-api
名称来源方法名推断　补 javadoc 后自动转正
调用方已确认在用 · 景区核销（1 个前端）
需求上下文春秋游核销相关接口
维护人 / 最后改动liuxu　2026-04-07　最近提交：春秋游核销相关接口
读写数据表openapi_cqy_record　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#queryQycCheck
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/openapi/OpenapiCqyRecordController.java:599
判定依据1 个调用点：writeoff/common/http.api.js

请求参数

分页字段来自 AbstractPageRequest：pageNo（不是 pageNum）· pageSize · orderBy

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 CqyCheckQueryRequest

参数名	参数值	是否必填	参数类型	描述说明
pageNo	…	否	Integer	当前页面
pageSize	…	否	Integer	每页记录数
orderBy	…	否	String	排序语句
checkerId	…	否	Long	→ openapi_cqy_record.checker_id
name	…	否	String	持卡人姓名
checkTimeRange	…	否	Date[]
goodsId	…	否	Long	→ openapi_cqy_record.goods_id

认证方式

免鉴权：@Route(auth = false) —— 该接口不校验登录态，改动前确认调用方与签名校验。

响应参数

data 类型 PageInfo<OpenapiCqyRecordResponse>

参数名	参数值	是否必填	参数类型	描述说明
list	…	否	List<T><OpenapiCqyRecordResponse>	分页数据集合（元素结构见下一行）
id	…	否	Long	id → openapi_cqy_record.id
orgId	…	否	String	→ openapi_cqy_record.org_id
mobile	…	否	String	手机号 → openapi_cqy_record.mobile
userName	…	否	String	姓名 → openapi_cqy_record.user_name
actName	…	否	String	活动名称 → openapi_cqy_record.act_name
couponType	…	否	String	券类型 → openapi_cqy_record.coupon_type
couponNumber	…	否	String	券号 → openapi_cqy_record.coupon_number
couponStatus	…	否	Integer	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功 → openapi_cqy_record.coupon_status
amount	…	否	String	累计发放金额 → openapi_cqy_record.amount
getTime	…	否	Date	领取日期 → openapi_cqy_record.get_time
consumeTime	…	否	Date	核销日期 → openapi_cqy_record.consume_time
orderId	…	否	String	订单号 → openapi_cqy_record.order_id
goodsId	…	否	Long	产品id → openapi_cqy_record.goods_id
goodsName	…	否	String	→ openapi_cqy_record.goods_name
createTime	…	否	Date	创建日期 → openapi_cqy_record.create_time
updateTime	…	否	Date	更新时间 → openapi_cqy_record.update_time
remark	…	否	String	→ openapi_cqy_record.remark
checkerId	…	否	Long	核销人id → openapi_cqy_record.checker_id
checkerName	…	否	String	核销人员姓名 → openapi_cqy_record.checker_name
order	…	否	Order
id	…	否	Long	id → openapi_cqy_record.id
orderId	…	否	Long	订单Id，主键 → openapi_cqy_record.order_id
merchantId	…	否	Long	商户Id，merchant表Id
shopId	…	否	Long	商铺Id，shop表Id
memberId	…	否	Long	会员用户Id
orderType	…	否	OrderType	订单类型，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食 1＝景区套票 2＝酒店民宿 3＝餐饮美食 4＝美食特产 5＝自驾路线 6＝非遗专区 7＝旅游卡 8＝旅游卡
orderSource	…	否	OrderSource	订单来源，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP 1＝H5 2＝微信小程序 3＝支付宝小程序 4＝安卓APP 5＝IOSAPP 6＝YOUZHENG 7＝XIANGGONGHUI 8＝XIANGYUEMA 9＝ZHIHUIYOU 10＝BCM 11＝JIANHANG 24＝MEIKE
buyNum	…	否	Integer	购买份数
orderAmount	…	否	Integer	订单金额(订单原始金额)
receivableAmount	…	否	Integer	应收金额
payableAmount	…	否	Integer	实收金额
reducedPrice	…	否	Integer	优惠金额
expressAmount	…	否	Integer	运费金额
discountAmount	…	否	Integer	折扣金额
isDelivery	…	否	Integer	是否配送(0=否；1=是)
payStatus	…	否	PayStatus	支付状态，1=待支付 2=已支付 3=已退款 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
orderStatus	…	否	OrderStatus	订单状态，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone	…	否	String	下单人手机
orderRemark	…	否	String	订单备注
orderTime	…	否	Date	下单时间
orderExpressTime	…	否	Date	订单失效时间
isSendIntegral	…	否	Integer	订单积分是否已发放(0=否 1=是)
isComment	…	否	Integer	订单是否已经评价(0=否；1=是)
isProfitSharing	…	否	Integer	订单资金是否已冻结(0=已冻结 1=已解冻)
isSendCommission	…	否	SendCommission	订单佣金是否已发放，0=否 1=是 2=无佣金 0＝否 1＝是 2＝无佣金
icode	…	否	String	分销邀请码
shouldReturnCommission	…	否	Integer	应返佣金
reallyReturnCommission	…	否	Integer	实返佣金
createdBy	…	否	String	创建人id
createdTime	…	否	LocalDateTime	创建时间
updatedBy	…	否	String	更新人id
updatedTime	…	否	LocalDateTime	更新时间
total	…	否	Long	数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "orgId": "\"string\"",
    "mobile": "\"string\"",
    "userName": "\"string\"",
    "actName": "\"string\"",
    "couponType": "\"string\"",
    "couponNumber": "\"string\"",
    "couponStatus": "1",
    "amount": "\"string\"",
    "getTime": "\"2026-01-01 00:00:00\"",
    "consumeTime": "\"2026-01-01 00:00:00\""
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：openapi_cqy_record　反查全部引用接口 →

OpenapiCqyRecordController#queryQycCheck
OpenapiCqyRecordService#queryPage（OpenapiCqyRecordServiceImpl）
OpenapiCqyRecordMapper#queryPage
BeanUtils.mapPage → OpenapiCqyRecordResponse

其它依赖：OpenapiCqyRecordService.applyWrapper

逻辑摘要：调用 applyWrapper（openapiCqyRecordService.applyWrapper）；调用 isNotEmpty（StrUtil.isNotEmpty）；分页查询（openapiCqyRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

源码内联注释（旧站解析结果）

wrapper.like("user_name", request.getName());
wrapper.eq("goods_id", request.getGoodsId());
return checkList;

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

writeoff/common/http.api.js:25　景区核销 · queryCqyCheckUrl