POST/tickets/order/getTicketsOrderDetail开放/回调管理后台

获取Tickets订单详情 · getTicketsOrderDetail 推断名·方法名推断

门票与景区 / 订单· TicketsOrderController#getTicketsOrderDetail

基本信息

  • 接口状态前端在用 置信度 高 免鉴权
  • 接口URLPOSThttps://dscp-dev.hn12301.net/open-api/tickets/order/getTicketsOrderDetail
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道开放/回调、管理后台　前缀 /open-api
  • 名称来源方法名推断　补 javadoc 后自动转正
  • 调用方已确认在用 · 管理后台、质惠游 公众号 H5、湘工惠商城（3 个前端）
  • 需求上下文1
  • 维护人 / 最后改动liuxu　2025-06-23　最近提交：1
  • 读写数据表tickets_order_tourist、tickets_order_payment、tickets_check、tickets_order_operatelog、tickets_order、tickets_order_goods、tickets_sku、tickets　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.tickets.TicketsOrderController#getTicketsOrderDetail
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsOrderController.java:571
  • 判定依据3 个调用点：dscp-html-manage/src/api/tickets/index.ts、h5-meike/common/http.api.js

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 IdRequest
参数名参数值是否必填参数类型描述说明
id…是Longid → tickets_sku.id

认证方式

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

响应参数

data 类型 TicketsOrderDetailResponse
参数名参数值是否必填参数类型描述说明
order…否TicketsOrder
id…否Long主键 → tickets_sku.id
orderNo…否String订单号 → tickets_order.order_no
merchantId…否Long商户Id，merchant表Id → tickets_sku.merchant_id
shopId…否Long商铺Id，shop表Id → tickets_sku.shop_id
memberId…否Long会员用户Id → tickets_order.member_id
orderType…否OrderType订单类型，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡 → tickets_order.order_type 1＝景区套票 2＝酒店民宿 3＝餐饮美食 4＝美食特产 5＝自驾路线 6＝非遗专区 7＝旅游卡 8＝旅游卡
orderSource…否OrderSource订单来源，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP → tickets_order.order_source 1＝H5 2＝微信小程序 3＝支付宝小程序 4＝安卓APP 5＝IOSAPP 6＝YOUZHENG 7＝XIANGGONGHUI 8＝XIANGYUEMA 9＝ZHIHUIYOU 10＝BCM 11＝JIANHANG 24＝MEIKE
buyNum…否Integer购买份数 → tickets_order.buy_num
orderAmount…否Integer订单金额，订单原始金额 → tickets_order.order_amount
receivableAmount…否Integer应收金额 → tickets_order.receivable_amount
payableAmount…否Integer实收金额 → tickets_order.payable_amount
reducedPrice…否Integer优惠金额 → tickets_order.reduced_price
discountAmount…否Integer折扣金额 → tickets_order.discount_amount
payStatus…否PayStatus支付状态，1=待支付 2=已支付 3=已退款 → tickets_order.pay_status 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
orderStatus…否OrderStatus订单状态，1=待确认 2=待发货 3=已发货 4=已完成 5=已取消 → tickets_order.order_status 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone…否String下单人手机 → tickets_order.order_phone
orderContactMobile…否String → tickets_order.order_contact_mobile
orderContactName…否String → tickets_order.order_contact_name
orderRemark…否String订单备注 → tickets_order.order_remark
orderTime…否Date下单时间 → tickets_order.order_time
orderExpressTime…否Date订单失效时间 → tickets_order.order_express_time
createdBy…否String创建人 → tickets_sku.created_by
createdTime…否Date创建时间 → tickets_sku.created_time
updatedBy…否String修改人 → tickets_sku.updated_by
updatedTime…否Date修改时间 → tickets_sku.updated_time
orderGoods…否TicketsOrderGoods
id…否Long → tickets_sku.id
orderId…否Long订单号，order表id → tickets_order_payment.order_id
ticketsId…否Long产品id，goods表id → tickets_sku.tickets_id
ticketsName…否String产品名称 → tickets_order_goods.tickets_name
ticketsSkuId…否Long产品SKU id，sku表id → tickets_order_goods.tickets_sku_id
ticketsSkuName…否String产品SKU → tickets_order_goods.tickets_sku_name
skuPrice…否Integer产品SKU销售价 → tickets_order_goods.sku_price
calendarId…否Long → tickets_order_goods.calendar_id
bookDate…否String日期 → tickets_order_goods.book_date
timeSlotId…否Long → tickets_order_goods.time_slot_id
timeSlot…否String场次 → tickets_order_goods.time_slot
updatedBy…否String → tickets_sku.updated_by
updatedTime…否Date → tickets_sku.updated_time
createdBy…否String → tickets_sku.created_by
createdTime…否Date → tickets_sku.created_time
sku…否TicketsSku
id…否Long商品id，主键 → tickets_sku.id
merchantId…否Long所属商户id → tickets_sku.merchant_id
shopId…否Long所属商铺id → tickets_sku.shop_id
ticketsId…否Long单票ID，关联单票表id → tickets_sku.tickets_id
skuName…否Stringsku名称 → tickets_sku.sku_name
typeId…否Stringsku类型 → tickets_sku.type_id
typeInfo…否String适用人群说明 → tickets_sku.type_info
stockNumType…否Boolean是否无限库存 → tickets_sku.stock_num_type
stockDateType…否Boolean库存形式:日历库存、时间段库存 → tickets_sku.stock_date_type
bookType…否Integer预定时间:1=可订当天,0=可订明日 → tickets_sku.book_type
bookTimeLimit…否LocalTime预订限制时间：订当天时，表示xx时间之前可订当天；订明日时，表示xx时间之前可订明日 → tickets_sku.book_time_limit
idLimitFlag…否Boolean身份证是否限购 → tickets_sku.id_limit_flag
idLimitDays…否Integer身份证限制天数 → tickets_sku.id_limit_days
idLimitNum…否Integer身份证限制张数 → tickets_sku.id_limit_num
speedInfo…否String出票速度 → tickets_sku.speed_info
basePrice…否Integer默认价(分) → tickets_sku.base_price
contentWith…否String费用包含 → tickets_sku.content_with
contentWithout…否String费用不包含 → tickets_sku.content_without
enterDemand…否String入园要求 → tickets_sku.enter_demand
enterType…否String入园方式 → tickets_sku.enter_type
enterChangeFlag…否Boolean → tickets_sku.enter_change_flag
changePostion…否String换票地点 → tickets_sku.change_postion
changeStart…否LocalTime换票起始 → tickets_sku.change_start
changeEnd…否LocalTime换票截止 → tickets_sku.change_end
enterPostion…否String入园地点 → tickets_sku.enter_postion
enterStart…否LocalTime入园起始 → tickets_sku.enter_start
enterEnd…否LocalTime入园截止 → tickets_sku.enter_end
refundType…否Integer退款规则 → tickets_sku.refund_type
refundDays…否Integer可退款时间：选择天数和时间，在这之前的可退款。之后的不能退款。0天为使用当天 → tickets_sku.refund_days
refundTime…否LocalTime可退款时间 → tickets_sku.refund_time
refundPolicy…否String退款政策 → tickets_sku.refund_policy
remark…否String补充说明 → tickets_sku.remark
receiptPolicy…否String发票说明 → tickets_sku.receipt_policy
isDeleted…否Boolean是否删除 → tickets_sku.is_deleted
status…否TicketsStatus → tickets_sku.status 1＝已上架 2＝编辑中 3＝已下架
createdBy…否String创建人 → tickets_sku.created_by
createdTime…否Date创建时间 → tickets_sku.created_time
updatedBy…否String修改人 → tickets_sku.updated_by
updatedTime…否Date修改时间 → tickets_sku.updated_time
tickets…否Tickets
id…否Long商品id，主键 → tickets_sku.id
merchantId…否Long所属商户id → tickets_sku.merchant_id
shopId…否Long所属商铺id → tickets_sku.shop_id
name…否String单票名称 → tickets.name
mainPic…否String单票主图 → tickets.main_pic
typeId…否String单票大类 → tickets_sku.type_id
subTypeId…否String单票小类 → tickets.sub_type_id
tags…否String商品标签 → tickets.tags
introduction…否String简介 → tickets.introduction
propagatePic…否String宣传图片url地址 → tickets.propagate_pic
status…否TicketsStatus单票状态，1正常，2编辑中，3已下架 → tickets_sku.status 1＝已上架 2＝编辑中 3＝已下架
isDeleted…否Boolean是否删除 → tickets_sku.is_deleted
createdBy…否Long创建人 → tickets_sku.created_by
createdTime…否Date创建时间 → tickets_sku.created_time
updatedBy…否Long修改人 → tickets_sku.updated_by
updatedTime…否Date修改时间 → tickets_sku.updated_time
provinceId…否String省id → tickets.province_id
cityId…否String市id → tickets.city_id
districtId…否String县id → tickets.district_id
address…否String地址 → tickets.address
price…否Integer → tickets.price
unitPrice…否Integer → tickets.unit_price
openDate…否String → tickets.open_date
remark1…否String → tickets.remark1
remark2…否String → tickets.remark2
touristList…否List<TicketsOrderTouristResponse>
id…否Longid → tickets_sku.id
orderId…否Long订单号，order表id → tickets_order_payment.order_id
name…否String持卡人姓名 → tickets.name
phone…否String手机号码 → tickets_order_tourist.phone
idType…否IdType证件类型，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证 → tickets_order_tourist.id_type 1＝身份证 2＝护照 3＝港澳居民来往内地通行证 5＝驾驶证 6＝居住证 7＝士官证 8＝学生证
identityNo…否String身份证号码 → tickets_order_tourist.identity_no
isDeleted…否Boolean是否删除 → tickets_sku.is_deleted
updatedBy…否String → tickets_sku.updated_by
updatedTime…否Date → tickets_sku.updated_time
createdBy…否String → tickets_sku.created_by
createdTime…否Date → tickets_sku.created_time
qrCode…否String核销码 → tickets_order_tourist.qr_code
qrCodeBase64…否String
status…否Integer状态: 1正常 2 已核销 3 已退款 → tickets_sku.status
payment…否TicketsOrderPayment
id…否Long → tickets_sku.id
orderId…否Long订单号(order表id) → tickets_order_payment.order_id
paymentType…否PaymentType交易类型，1=收款 2=退款 3=红冲 4=返佣 5=抵扣 6=手续费 → tickets_order_payment.payment_type 1＝收款 2＝退款 3＝红冲 4＝返佣 5＝抵扣 6＝手续费
paymentMode…否PaymentMode交易方式，1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他 → tickets_order_payment.payment_mode 1＝积分 2＝优惠券 3＝微信 4＝支付宝 5＝工商银行 6＝其他 7＝湘工惠 8＝建行
paymentAmount…否Integer交易金额 → tickets_order_payment.payment_amount
paymentCurrency…否Integer交易币种（1=人民币） → tickets_order_payment.payment_currency
transactionNo…否String支付中心otg的交易流水 → tickets_order_payment.transaction_no
remark…否String备注(如:积分抵扣，优惠券抵扣) → tickets_sku.remark
status…否Integer状态(1=成功 ) → tickets_sku.status
updatedBy…否String → tickets_sku.updated_by
updatedTime…否Date → tickets_sku.updated_time
createdBy…否String → tickets_sku.created_by
createdTime…否Date交易时间 → tickets_sku.created_time
paymentList…否List<TicketsOrderPayment>
id…否Long → tickets_sku.id
orderId…否Long订单号(order表id) → tickets_order_payment.order_id
paymentType…否PaymentType交易类型，1=收款 2=退款 3=红冲 4=返佣 5=抵扣 6=手续费 → tickets_order_payment.payment_type 1＝收款 2＝退款 3＝红冲 4＝返佣 5＝抵扣 6＝手续费
paymentMode…否PaymentMode交易方式，1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他 → tickets_order_payment.payment_mode 1＝积分 2＝优惠券 3＝微信 4＝支付宝 5＝工商银行 6＝其他 7＝湘工惠 8＝建行
paymentAmount…否Integer交易金额 → tickets_order_payment.payment_amount
paymentCurrency…否Integer交易币种（1=人民币） → tickets_order_payment.payment_currency
transactionNo…否String支付中心otg的交易流水 → tickets_order_payment.transaction_no
remark…否String备注(如:积分抵扣，优惠券抵扣) → tickets_sku.remark
status…否Integer状态(1=成功 ) → tickets_sku.status
updatedBy…否String → tickets_sku.updated_by
updatedTime…否Date → tickets_sku.updated_time
createdBy…否String → tickets_sku.created_by
createdTime…否Date交易时间 → tickets_sku.created_time
checkList…否List<TicketsCheck>
id…否Long → tickets_sku.id
orderId…否Long订单号，order表id → tickets_order_payment.order_id
orderTouristId…否Long订单号，order表id → tickets_check.order_tourist_id
ticketsId…否Long → tickets_sku.tickets_id
ticketsName…否String → tickets_order_goods.tickets_name
ticketsSkuId…否Long产品SKU id，sku表id → tickets_order_goods.tickets_sku_id
ticketsSkuName…否String产品SKU → tickets_order_goods.tickets_sku_name
checkerId…否Long核销人 → tickets_check.checker_id
checkerName…否String核销人姓名 → tickets_check.checker_name
checkTime…否Date核销时间 → tickets_check.check_time
name…否String持卡人姓名 → tickets.name
phone…否String手机号码 → tickets_order_tourist.phone
idType…否IdType证件类型，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证 → tickets_order_tourist.id_type 1＝身份证 2＝护照 3＝港澳居民来往内地通行证 5＝驾驶证 6＝居住证 7＝士官证 8＝学生证
identityNo…否String身份证号码 → tickets_order_tourist.identity_no
isDeleted…否Boolean是否删除 → tickets_sku.is_deleted
status…否Integer状态 → tickets_sku.status
updatedBy…否String → tickets_sku.updated_by
updatedTime…否Date → tickets_sku.updated_time
createdBy…否String → tickets_sku.created_by
createdTime…否Date → tickets_sku.created_time
qrcode…否String → tickets_check.qrcode
shopId…否Long → tickets_sku.shop_id
shopName…否String → tickets_check.shop_name
operatelogList…否List<TicketsOrderOperatelog>
id…否Longid → tickets_sku.id
orderId…否Long订单号，order表id → tickets_order_payment.order_id
ip…否Stringip地址 → tickets_order_operatelog.ip
content…否String操作内容 → tickets_order_operatelog.content
createdBy…否String操作人 → tickets_sku.created_by
authUserType…否AuthUserType用户类型，1管理员，2会员 → tickets_order_operatelog.auth_user_type
createdTime…否Date操作时间 → tickets_sku.created_time

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "order": "…",
    "id": "1",
    "orderNo": "\"string\"",
    "merchantId": "1",
    "shopId": "1",
    "memberId": "1",
    "orderType": "1",
    "orderSource": "1",
    "buyNum": "1",
    "orderAmount": "1",
    "receivableAmount": "1",
    "payableAmount": "1"
  }
}
示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：tickets_order_tourist、tickets_order_payment、tickets_check、tickets_order_operatelog、tickets_order、tickets_order_goods、tickets_sku、tickets　反查全部引用接口 →
  • TicketsOrderController#getTicketsOrderDetail
  • TicketsOrderTouristService#queryList（TicketsOrderTouristServiceImpl）
  • TicketsOrderTouristMapper#queryList
  • TicketsOrderPaymentService#queryList（TicketsOrderPaymentServiceImpl）
  • TicketsOrderPaymentMapper#queryList
  • TicketsCheckService#queryList（TicketsCheckServiceImpl）
  • TicketsCheckMapper#queryList
  • TicketsOrderOperatelogService#queryList（TicketsOrderOperatelogServiceImpl）
  • TicketsOrderOperatelogMapper#queryList
  • BeanUtils.mapList → TicketsOrderTouristResponse
逻辑摘要：查询详情（ticketsOrderService.get）；查询详情（ticketsOrderGoodsService.get）；查询详情（ticketsSkuService.get）；入参与返回值经 BeanUtils 做对象/分页映射
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • dscp-html-manage/src/api/tickets/index.ts:140　管理后台 · request
  • xghmall/common/http.api.js:48　湘工惠商城 · getTicketsOrderDetailUrl
  • h5-meike/common/http.api.js:11　质惠游 公众号 H5 · getTicketsOrderDetailUrl
← 单票订单-详情获取Tickets订单Tourist列表 · get →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据