openydt-monthticket

CRITICAL — 开始前 MUST 先用 Read 工具读取
../openydt-shared/SKILL.md
(认证 / profile / 签名 / 状态码 / 限速 / 安全规则)。未读取共享基座不要执行任何
openydt
命令。

何时用本技能

当用户的诉求落在 月票 / VIP / 会员包月 / 特殊车辆(访客、黑名单)/ 车辆身份 业务时使用本技能,典型如:

"给某车牌开通月票 / 续费 / 退费 / 取消月票"
"新建一个月票类型 / 改月票类型 / 查月票类型详情"
"查某车牌的月票记录 / 月票将过期 / 月票已售数量"
"查车辆是不是 VIP / 查车主"、"月票冻结 / 解冻"
"新增访客 VIP 组 / 黑名单 VIP 组的特殊车辆类型"

意图路由:

仅做查询(读) → 直接用对应
```
get-*
```
命令,无需
```
--yes
```
。
涉及创建 / 修改 / 开通 / 续费 / 退费 / 取消 / 冻结(写) → 命令必须加
```
--yes
```
(见下文每条标注)。
访客/黑名单的「名单成员」管理不在本域:访客用
```
openydt visitor
```
,黑名单用
```
openydt blacklist
```
,红名单用
```
openydt redlist
```
;但他们引用的「特殊车辆类型ID」由本域
```
add-special-car-type
```
创建并通过
```
get-special-car-type-list
```
查询。

可用命令

命令格式:

openydt ticket <use>

。下表仅列 catalog 中 included 的命令(共 29 条)。

中文名	命令	读/写	关键参数
新增线上月票类型	`openydt ticket add-online-month-ticket-type`	写( `--yes` )	parkCodes, ticketName, price*, timePeriod(startTime/endTime), channelList
修改线上月票类型	`openydt ticket month-ticket-config-edit`	写( `--yes` )	monthTicketConfigId, ticketName, parkCodeList*
查询线上月票类型详情	`openydt ticket get-month-ticket-config-detail`	读	monthTicketConfigId*
查询线上月票类型详情列表	`openydt ticket get-month-ticket-config-detail-list`	读	parkCodeList*, monthTicketConfigId, ticketStatus
查看月票已购买数量	`openydt ticket get-month-ticket-sell-num`	读	monthId*
月票类型名额扣减	`openydt ticket deduct-month-ticket-config`	写( `--yes` )	monthTicketConfigId, thirdpartyBillCode, thirdpartyIdentify, parkCodes, carNo, num, startTime, endTime
开通线上月票	`openydt ticket add-online-month-ticket`	写( `--yes` )	monthTicketConfigId, parkCodes, carNo, billCode, userName, userPhone, originPrice, favorPrice, payOrigin, payMode, timePeriodList*
续费线上月票	`openydt ticket renew-online-vip-ticket`	写( `--yes` )	billCode, monthTicketId, originPrice, favorPrice, payOrigin, payMode, timePeriodList
取消线上月票	`openydt ticket cancel-online-vip-ticket`	写( `--yes` )	parkCode, billCode, refundPrice, payOrigin, payMode*
根据月票类型取消线上月票	`openydt ticket cancel-online-month-ticket-by-month-ticket-type`	写( `--yes` )	monthTicketConfigId, parkCode
修改线上月票订单信息	`openydt ticket edit-online-vip-ticket`	写( `--yes` )	monthTicketId, carNo, userName, userPhone, remark1~remark3, editBy, editTime
查询线上月票	`openydt ticket get-online-vip-ticket`	读	monthTicketId*
查询线上月票记录	`openydt ticket get-online-month-ticket-list`	读	parkCodeList, pageNum, pageSize*
查询车牌线上月票	`openydt ticket get-online-month-ticket-by-car-card`	读	carCode*
查询线上月票支付信息	`openydt ticket get-online-month-ticket-payment`	读	parkCode, operateTimeFrom, operateTimeTo, pageNum, pageSize*
通过车牌查看月票预约信息详情	`openydt ticket get-month-ticket-bill-detail`	读	thirdBillCode*
查询将要过期的月票	`openydt ticket get-will-expire-month-ticket-bill`	读	validFrom, validTo, pageNum, pageSize
查询月票账号交易记录	`openydt ticket get-month-ticket-account-transation-record`	读	monthTicketBillId, transationTimeStart, transationTimeEnd, pageNum, pageSize*
查询月票账号扣费记录	`openydt ticket get-month-ticket-account-use-record`	读	monthTicketBillId, pageNum, pageSize*
申请月票冻结	`openydt ticket apply-month-ticket-freeze`	写( `--yes` )	monthTicketBillId, frozenStartTime, frozenEndTime, reason
月票冻结	`openydt ticket freeze-month-ticket`	写( `--yes` )	monthTicketBillId, frozenStartTime, frozenEndTime*
月票解冻	`openydt ticket un-freeze-month-ticket`	写( `--yes` )	monthTicketBillId*
添加特殊车辆类型	`openydt ticket add-special-car-type`	写( `--yes` )	parkCode, specialCarTypeName, vipGroupType*(1访客/2黑名单)
获取特殊车辆类型列表	`openydt ticket get-special-car-type-list`	读	(空 body `{}` 即可)
查询车辆的车主及VIP	`openydt ticket get-car-owner-and-vip-type`	读	parkCode, carNo
获取车辆身份	`openydt ticket get-vip-by-car-no`	读	carCode, enterTime, leaveTime, parkCode, parkingCode*
通过车牌和时间获取VIP信息	`openydt ticket get-vip-by-car-no-and-time`	读	carCode, enterTime, parkCode*
获取车场协议	`openydt ticket get-park-agreement`	读	parkCodeList*
同步电子券二维码扫码(车场协议)	`openydt ticket park-agreement-save`	写( `--yes` )	parkCode, agreementTitle, agreementContent*

*
表示必填。写操作均通过
f.ConfirmWrite
拦截,执行时必须带
--yes
,否则会被拒绝。

业务流程

月票闭环(创建类型 → 开通 → 续费/退费 → 查询)

务必把前序命令响应里的字段作为后续命令的入参,不要凭空编造 ID。

创建月票类型 —
```
openydt ticket add-online-month-ticket-type --yes
```
(body 见下方示例)。从响应取 data.monthTicketConfigId
作为「月票类型ID」。

开通线上月票 —

openydt ticket add-online-month-ticket --yes

,用上一步的

monthTicketConfigId

填入

--month-ticket-config-id

(或 body 的

monthTicketConfigId

)。从响应取 data.monthTicketId
(月票订单id) 用于续费 / 退费 / 修改。

续费 / 退费:

续费 —

openydt ticket renew-online-vip-ticket --yes

,用第 2 步的

monthTicketId

填

--month-ticket-id

,并给新的

timePeriodList

。

退费(取消)—

openydt ticket cancel-online-vip-ticket --yes

,用

monthTicketId

parkCode

refundPrice

;或按类型批量取消

openydt ticket cancel-online-month-ticket-by-month-ticket-type --yes

(用

monthTicketConfigId

)。

查询:

按类型/车场列表查 —

openydt ticket get-online-month-ticket-list

。

按车牌查 —

openydt ticket get-online-month-ticket-by-car-card

(用

carCode

)。

单笔订单查 —

openydt ticket get-online-vip-ticket

(用

monthTicketId

)。

月票冻结 / 解冻

冻结需要月票订单id:先用

get-online-month-ticket-by-car-card

或

get-online-month-ticket-list

查到 monthTicketBillId
(月票订单id)。

冻结 —

openydt ticket apply-month-ticket-freeze --yes

或

openydt ticket freeze-month-ticket --yes

(传

monthTicketBillId

frozenStartTime

frozenEndTime

)。

解冻 —

openydt ticket un-freeze-month-ticket --yes

(传

monthTicketBillId

)。

特殊车辆类型(供访客 / 黑名单复用)

用

openydt ticket add-special-car-type --yes

创建特殊车辆类型,

vipGroupType=1

为访客VIP组、

vipGroupType=2

为黑名单VIP组。

从响应取特殊车辆类型ID(也可用
```
openydt ticket get-special-car-type-list
```
查询列表拿到ID)。
该「特殊车辆类型ID」供
```
openydt visitor
```
(访客)与
```
openydt blacklist
```
(黑名单)在添加名单成员时作为入参复用,实现「类型在 ticket 域创建、名单成员在各自域管理」的闭环。

示例

以下 body 取自 catalog 的 sampleBody;写操作均已带
--yes
。

新增线上月票类型(写,需
```
--yes
```
)— 成功后从响应
```
data.monthTicketConfigId
```
取类型ID:

bash

openydt ticket add-online-month-ticket-type --yes --body '{
  "parkCodes": "2KKN6112",
  "ticketName": "0412WDL测试月票01",
  "price": 10,
  "timePeriod": { "startTime": "2019-04-16 00:11:25", "endTime": "2019-04-17 09:11:25" }
}'

用上一步的
```
monthTicketConfigId
```
开通线上月票(写,需
```
--yes
```
):

bash

openydt ticket add-online-month-ticket --yes --body '{
  "carNo": "粤A12345",
  "billCode": "wdl201904250001",
  "parkCodes": "PR2WCYG4,2KKN6112",
  "originPrice": 10,
  "favorPrice": 5,
  "payMode": 4,
  "payModeRemark": "微信支付",
  "payOrigin": 7,
  "payOriginRemark": "智慧停车",
  "userName": "王五11",
  "userPhone": "18000000000",
  "monthTicketConfigId": 537,
  "timePeriodList": [
    { "startTime": "2019-04-25 01:11:25", "endTime": "2019-04-27 00:11:25" }
  ]
}'

按车牌查询线上月票(读,无需
```
--yes
```
):

bash

openydt ticket get-online-month-ticket-by-car-card --body '{
  "carCode": "粤A12345",
  "userName": "张三",
  "userPhone": "18000000000",
  "buyMethod": 2,
  "ticketType": 1,
  "validStatus": 0,
  "startTime": "20190101000000",
  "endTime": "20190501000000",
  "pageNum": 1,
  "pageSize": 10
}'

openydt-monthticket

NPX Install

Tags

SKILL.md Content

何时用本技能

可用命令

业务流程

月票闭环(创建类型 → 开通 → 续费/退费 → 查询)

月票冻结 / 解冻

特殊车辆类型(供访客 / 黑名单复用)

示例