ttpos-recharge

Original:🇨🇳 Chinese
Translated

Looks up TTPOS member recharge orders (member top-up orders) through the ttpos CLI, listing them by date range or order number, fetching a single order by uuid, and checking its refundable amount without executing a refund. Use when asked "How many recharge orders were there recently," "recharge order details," or "How much can this recharge be refunded for." Not for regular sales orders (ttpos-order) or member orders (ttpos-member-order).

7installs
Added on

NPX Install

npx skill4agent add zoneasetech/ttpos-cli ttpos-recharge

Tags

Translated version includes tags in frontmatter

SKILL.md Content (Chinese)

View Translation Comparison →

ttpos-recharge

First read
ttpos-shared
.

Questions this skill can answer

QuestionCommand
Recent recharge records
ttpos recharge list
Details of a recharge
ttpos recharge get <uuid>
How much can this recharge still be refunded for
ttpos recharge refund-info <uuid>

ttpos recharge list

bash
ttpos recharge list                                     # 最近 7 天
ttpos recharge list --from YYYY-MM-DD --to YYYY-MM-DD --page 2 --size 100
ttpos recharge list --order-no <订单号> --from YYYY-MM-DD --to YYYY-MM-DD
  • Query limits: up to 100 records per page, with a maximum
    --from/--to
    date range of 31 days.
  • If no dates are provided, the default is the most recent 7 days.
    --order-no
    does not extend the time range; older orders require dates as well. If "not found" appears, check
    notice
    first.
  • If only
    --from
    is provided,
    --to
    defaults to the current date; a date that is too early will exceed 31 days. If only
    --to
    is provided,
    --from
    defaults to 7 days earlier.
  • Dates are filtered by creation time and cannot be filtered by payment time. The output
    payment_time
    may differ from the creation time by several days; if the expected order is not found, widen
    --from
    .
  • status
    values are 0 for pending payment, 1 for completed, and 2 for canceled;
    status_text
    contains the Chinese description and should be used directly.
  • Use each item's
    uuid
    (string) with
    get
    and
    refund-info
    . For amounts, use
    recharge_amount
    and
    gift_amount
    ;
    payment_methods
    is an array of strings.

ttpos recharge get <uuid>

data
contains unmodeled raw details, and
--format table
also outputs JSON. Common fields include:
uuid
order_no
member
status
cashier
recharge_amount
amount
charge_due
payment_time
create_time
gift_amount
gift_point
payment_methods
operation_log
extra
.

ttpos recharge refund-info <uuid>

This only queries information and does not process refunds; this CLI has no refund command. It returns
refundable_amount
recharge_amount
gift_amount
gift_point
recharge_member_info
payment_records
.
  • <uuid>
    is the
    uuid
    from
    recharge list
    . An order number or a sales order id cannot be used.
  • This command only covers recharge orders. Refundable amounts for sales orders and member orders are not provided in this version; do not substitute this command for them.
See
ttpos help exit-codes
for exit codes.