openydt-coupon

CRITICAL: MUST use the Read tool to read

../openydt-shared/SKILL.md

before starting (Authentication / Profile / Signature / Status Code / Rate Limiting / Security Rules). Do not execute any commands without reading the shared base document.

When to Use This Skill

• "Create a merchant / Add a merchant / Enter merchant account" →

  openydt coupon create-trader

  (Write operation, requires

  --yes

  ).
• "Edit merchant info / Freeze merchant / Unfreeze / Delete merchant" →

  openydt coupon edit-trader

  /

  frozen-trader

  /

  delete-trader

  (Write operation, requires

  --yes

  ).
• "Query merchant list / View a merchant's info / Verify merchant account password" →

  openydt coupon get-trader-list

  /

  get-trader-info-by-trader-code

  /

  validate-trader-account-and-password

  .
• "Create a voucher template / Create coupon / Create fixed voucher" →

  openydt coupon create-coupon-template

  /

  create-coupon

  /

  create-fixed-coupon

  (Write operation, requires

  --yes

  ).
• "Sell vouchers to merchant / Sell e-vouchers" →

  openydt coupon sell-coupon

  (Write operation, requires

  --yes

  ).
• "Issue voucher to this vehicle / Distribute coupon / Issue by voucher code / Scan to issue voucher" →

  openydt coupon send-coupon

  /

  send-coupon-by-coupon-code

  /

  sync-scan-coupon-qr-code

  (Write operation, requires

  --yes

  ).
• "Query vouchers for this vehicle / Issued vouchers / Available vouchers / Voucher info" →

  openydt coupon query-car-code-valid-coupon

  /

  query-usable-coupon

  /

  query-coupon

  .
• "Reclaim this voucher / Refund voucher / Lock voucher / Print voucher" →

  openydt coupon cancel-coupon

  /

  lock-coupon

  /

  print-coupon

  (Write operation, requires

  --yes

  ).

Querying actual fee after voucher deduction / Payment is in the trade domain (

openydt trade --help

); Parking vehicle confirmation is in the parking domain (

openydt parking --help

).

Available Commands

openydt coupon get-trader-info-by-trader-code

--trader-code

openydt coupon validate-trader-account-and-password

--trader-user-account

--trader-password

openydt coupon create-trader

--trader-name

--contact

--phone

--park-code

--login-account

--password

--trader-type

openydt coupon edit-trader

--trader-code

--trader-id

--trader-name

--contact

--phone

--park-code

--login-account

--password

--trader-type

openydt coupon frozen-trader

--trader-code

--trader-id

--park-code

--status

openydt coupon delete-trader

--park-code

--trader-code

--trader-id

openydt coupon get-trader-list

--park-code

--create-time-from

--create-time-to

--page-num

--page-size

openydt coupon create-coupon-template

--name

--sell-from

--sell-to

--grant-from

--grant-to

--valid-minute

--balance-type

--coupon-type

--face-value

--original-price

--real-price

--use-rule-from

--use-rule-to

openydt coupon create-coupon

--trader-code

--total-count

--body

openydt coupon create-fixed-coupon

--trader-code

--group-name

--valid-from

--valid-to

--max-num

--sell-bill-id

--uniq-no

openydt coupon sell-coupon

--trader-coupon-template-code

--trader-code

--sell-num

--sell-money

--sell-time

--sell-remark

--transation-num

openydt coupon send-coupon

--trader-code

--sell-bill-id

--car-code

--car-code-color

--parking-code

openydt coupon send-coupon-by-coupon-code

--coupon-code

--car-no

--card-no

--park-code

--grant-user-id

--car-code-color

--parking-code

--is-fixed-qr-code

--origin

openydt coupon sync-scan-coupon-qr-code

--coupon-code

--grant-user-id

openydt coupon check-coupon-whether-send-available

--coupon-code

--fixed-status

openydt coupon check-coupon-qr-code-valid-status

--coupon-code

--origin

openydt coupon print-coupon

--trader-code

--coupon-sn

openydt coupon query-coupon-print-record

--coupon-code

openydt coupon lock-coupon

--url

openydt coupon cancel-coupon

--trader-code

--coupon-sn

openydt coupon query-car-code-valid-coupon

--park-code

--car-code

--card-code

--coupon-sn

openydt coupon query-coupon

--trader-code

--query-type

--page

--page-size

--coupon-code-list

openydt coupon query-usable-coupon

--trader-code

--sell-bill-id

openydt coupon query-coupon-available-park-by-coupon-code

--coupon-code

--fixed-status

openydt coupon query-coupon-template-by-coupon-code

--code

openydt coupon query-coupon-template-by-coupon-sn

--coupon-sn

openydt coupon query-trader-info-by-coupon-code

--coupon-sn

openydt coupon query-trader-coupon-sell-record

--sell-begin-time

--sell-end-time

--page-num

--page-size

--body

openydt coupon get-trader-coupon-grant-record-list

--trader-id

--begin-time

--end-time

--page-num

--page-size

--body

--need-coupon-park

--need-coupon-status

openydt coupon get-trader-coupon-list

--page-size

--page-num

--body

All write commands (

create-trader

/

edit-trader

/

frozen-trader

/

delete-trader

/

create-coupon-template

/

create-coupon

/

create-fixed-coupon

/

sell-coupon

/

send-coupon

/

send-coupon-by-coupon-code

/

sync-scan-coupon-qr-code

/

print-coupon

/

lock-coupon

/

cancel-coupon

) must include

--yes

for confirmation, otherwise they will be blocked.

Business Process

E-Voucher Closed Loop (Create Merchant + Create Template → Sell → Issue → Query → Reclaim)

1. Create Merchant + Create Voucher Template (Write operations, both require

   --yes

   ):

   openydt coupon create-trader --yes \
     --trader-name <Merchant Name> --contact <Contact Person> --phone <Phone Number> \
     --park-code <Parking Lot Code> --login-account <Account> --password <Password>
   
   openydt coupon create-coupon-template --yes \
     --name <Voucher Name> --sell-from ... --sell-to ... --grant-from ... --grant-to ... \
     --valid-minute 60 --balance-type 0 --coupon-type 1 \
     --face-value 500 --original-price 600 --real-price 500 \
     --use-rule-from 0 --use-rule-to 1000

   • Extract merchant code

     traderCode

     from the

     create-trader

     response (can also be retrieved via

     get-trader-list

     ) → use as

     --trader-code

     for all subsequent commands;
   • Extract voucher template code (merchant voucher template code) from the

     create-coupon-template

     response → use as

     --trader-coupon-template-code

     for

     sell-coupon

     in Step 2 (can also verify via

     query-coupon-template-by-coupon-code --code <Template Code>

     ).
2. Sell to Merchant (Write operation, requires

   --yes

   ) — use the merchant code + template code obtained in Step 1:

   openydt coupon sell-coupon --yes \
     --trader-coupon-template-code <From create-coupon-template> \
     --trader-code <From create-trader> \
     --sell-num 100 --sell-money 0.01 --sell-time "2018-04-16 09:00:00"

   • Extract sales bill

     sellBillId

     from the

     sell-coupon

     response → use as

     --sell-bill-id

     for

     send-coupon

     in Step 3 (can also check the available issuance quantity of this batch via

     query-usable-coupon --trader-code <traderCode> --sell-bill-id <id>

     ).
3. Issue to Vehicle (Write operation, requires

   --yes

   ) — use the

   sellBillId

   + merchant code obtained in Step 2:

   openydt coupon send-coupon --yes \
     --trader-code <From create-trader> \
     --sell-bill-id <From sell-coupon> \
     --car-code <License Plate> --car-code-color 1

   You can also issue by voucher code:

   send-coupon-by-coupon-code --yes --coupon-code <Voucher Code> --car-no <License Plate>

   (Cannot leave both

   --car-no

   and

   --card-no

   empty). Before issuing, you can confirm if it's issuable via

   check-coupon-whether-send-available --coupon-code <Voucher Code>

   .

4. Query Vouchers (Read operation) — confirm vouchers have been assigned to the vehicle / merchant:

   openydt coupon query-car-code-valid-coupon --park-code <Parking Lot> --car-code <License Plate>
   openydt coupon query-coupon --trader-code <traderCode> --query-type 1 --page 1 --page-size 10

   • Extract unique voucher number

     couponSn

     from the query response → use as

     --coupon-sn

     for

     cancel-coupon

     in Step 5 (To query merchant info via voucher code, use

     query-trader-info-by-coupon-code --coupon-sn <couponSn>

     ).
5. Reclaim (Write operation, requires

   --yes

   ) — use the

   couponSn

   + merchant code obtained in Step 4:

   openydt coupon cancel-coupon --yes --trader-code <traderCode> --coupon-sn <From query>

Examples

--yes

openydt coupon create-trader --yes \
  --trader-name Test Merchant --trader-type 5 \
  --contact Contact Person --phone 13800000000 \
  --park-code 2KNTYVWC --login-account trader001 --password 123456

--yes

openydt coupon sell-coupon --yes \
  --trader-coupon-template-code GCSH3FI1YNDN \
  --trader-code NWTSZY49BH67 \
  --sell-num 100 --sell-money 0.01 --sell-remark Test \
  --sell-time "2018-04-16 09:00:00"

openydt coupon query-car-code-valid-coupon --park-code 2KKN6111 --car-code 粤B88888