POST/pft/updateOpenapiPftRecord管理后台

票付通记录-更新

开放与对接 / 支付机构 PFT（代号待业务确认）· OpenapiPftRecordController#updateOpenapiPftRecord

基本信息

接口状态开放/回调用（服务端）置信度中
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/pft/updateOpenapiPftRecord
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方本次扫描未发现调用　不等于可以下线
需求上下文预约核销关联票付通
维护人 / 最后改动liuxu　2026-04-09　最近提交：预约核销关联票付通
读写数据表openapi_pft_record　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#updateOpenapiPftRecord
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/openapi/OpenapiPftRecordController.java:114
判定依据渠道为开放/回调且有实现链路，由第三方或支付回调触发

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 OpenapiPftRecordUpdateRequest

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	id → openapi_pft_record.id
appointId	…	否	Long	→ openapi_pft_record.appoint_id
tid	…	否	String	门票id → openapi_pft_record.tid
tnum	…	否	String	购买数量 → openapi_pft_record.tnum
playtime	…	否	String	游玩日期格式：Y-m-d → openapi_pft_record.playtime
ordertel	…	否	String	取票人手机号 → openapi_pft_record.ordertel
contacttel	…	否	String	游玩人手机号 → openapi_pft_record.contacttel
ordername	…	否	String	游客姓名 → openapi_pft_record.ordername
m	…	否	String	供应商 id → openapi_pft_record.m
personid	…	否	String	游客身份证-证件号 + : + 类型 → openapi_pft_record.personid
paymode	…	否	String	支付方式 → openapi_pft_record.paymode
tprice	…	否	String	结算价 → openapi_pft_record.tprice
series	…	否	String	演出信息 → openapi_pft_record.series
remotenum	…	否	String	贵方订单号 → openapi_pft_record.remotenum
ordernum	…	否	String	票付通订单号 → openapi_pft_record.ordernum
code	…	否	String	凭证码/消费码 → openapi_pft_record.code
qrcodeurl	…	否	String	订单详情链接 → openapi_pft_record.qrcodeurl
qrcodeimg	…	否	String	二维码图片 → openapi_pft_record.qrcodeimg
ustatus	…	否	String	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票 → openapi_pft_record.ustatus
orderTime	…	否	Date	创建日期 → openapi_pft_record.order_time
updateTime	…	否	Date	更新时间 → openapi_pft_record.update_time
remark	…	否	String	→ openapi_pft_record.remark
checkerId	…	否	Long	核销员id → openapi_pft_record.checker_id
checkerName	…	否	String	核销员名称 → openapi_pft_record.checker_name

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

参数名	参数值	是否必填	参数类型	描述说明
void —— 不返回业务数据（外层包装见全局公共参数）

响应示例

成功响应示例 code=0

{"errcode":0,"errmsg":""}

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

附录 · 实现细节

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

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

OpenapiPftRecordController#updateOpenapiPftRecord
OpenapiPftRecordService#update（OpenapiPftRecordServiceImpl）
OpenapiPftRecordMapper#update
BeanUtils.map → OpenapiPftRecord ⇒ 表 openapi_pft_record

逻辑摘要：更新（openapiPftRecordService.update）；入参与返回值经 BeanUtils 做对象/分页映射