POST/tickets/addTicketsCheck管理后台开放/回调

核销员核销接口单票核销表-新增

门票与景区 / 核销· TicketsCheckController#addTicketsCheck

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/tickets/addTicketsCheck
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台、开放/回调　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 景区核销（1 个前端）
需求上下文单票核销表创建、后端基础功能开发
维护人 / 最后改动liuxu　2025-06-24　最近提交：单票核销表创建、后端基础功能开发
读写数据表checker_tickets_relation、tickets_order_tourist、tickets_order、checker、tickets_order_goods、tickets、member、tickets_sku　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.tickets.TicketsCheckController#addTicketsCheck
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsCheckController.java:190
判定依据1 个调用点：writeoff/common/http.api.js

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 TicketsCheckAddRequest

参数名	参数值	是否必填	参数类型	描述说明
userId	…	是	Long
skuId	…	是	String	skuId → checker_tickets_relation.sku_id
checkCode	…	是	String

认证方式

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

响应参数

data 类型 TicketsAddCheckResponse

参数名	参数值	是否必填	参数类型	描述说明
skuName	…	否	String	→ tickets_sku.sku_name
typeId	…	否	String	→ tickets_sku.type_id
useDate	…	否	String	使用日期
enterDemand	…	否	String	→ tickets_sku.enter_demand
name	…	否	String	→ tickets.name
idNo	…	否	String
mobile	…	否	String	→ checker.mobile
contactName	…	否	String
contactMobile	…	否	String
status	…	否	String	→ tickets_sku.status
checkerName	…	否	String	→ tickets_check.checker_name
checkTime	…	否	Date	→ tickets_check.check_time
timeSlot	…	否	String	→ tickets_order_goods.time_slot
checkMsg	…	否	String	核销信息
checkCode	…	否	String	0 成功的 500 失败的

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "skuName": "\"string\"",
    "typeId": "\"string\"",
    "useDate": "\"string\"",
    "enterDemand": "\"string\"",
    "name": "\"string\"",
    "idNo": "\"string\"",
    "mobile": "\"string\"",
    "contactName": "\"string\"",
    "contactMobile": "\"string\"",
    "status": "\"string\"",
    "checkerName": "\"string\"",
    "checkTime": "\"2026-01-01 00:00:00\""
  }
}

失败响应示例

{
  "data": null,
  "可能返回": [
    {
      "errcode": "99999",
      "errmsg": "服务内部错误"
    }
  ]
}

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

附录 · 实现细节

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

涉及数据表：checker_tickets_relation、tickets_order_tourist、tickets_order、checker、tickets_order_goods、tickets、member、tickets_sku　反查全部引用接口 →

TicketsCheckController#addTicketsCheck
CheckerTicketsRelationService#queryList（CheckerTicketsRelationServiceImpl）
CheckerTicketsRelationMapper#queryList
TicketsOrderTouristService#update（TicketsOrderTouristServiceImpl）
TicketsOrderTouristMapper#update
TicketsOrderTouristService#queryList（TicketsOrderTouristServiceImpl）
TicketsOrderTouristMapper#queryList
TicketsOrderService#update（TicketsOrderServiceImpl）
TicketsOrderMapper#update
XghService#syncOrder（XghServiceImpl）

其它依赖：ShopCache.get

逻辑摘要：查询详情（checkerService.get）；查询详情（ticketsOrderTouristService.get）；列表查询（ticketsRelationService.queryList）

操作日志：tickets / 新增门票核销

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

throw ChaosRes.SYS_FAIL.toException("核销码已核销或已退款");
查询商品信息
throw ChaosRes.SYS_FAIL.toException("核销日期错误");
判断订单是否已完成
同步订单信息到湘工惠

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

调用点证据

writeoff/common/http.api.js:9　景区核销 · addTicketsCheckUrl

可能抛出的业务码：99999 服务内部错误　错误码字典 →

核销员核销接口 单票核销表-新增