Back to Details

manage-booking

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

manage-booking

manage-booking

Retrieve the current state of an existing booking. Read-only — no changes are made.
查询现有预订的当前状态。仅支持读取操作——不会进行任何修改。

When to use

使用场景

  • "What's the status of booking BK_2026_05_001?"
  • "Show me my reservation"
  • "Did my booking go through?"
  • "When do I check in?"
If the user wants to cancel, use the 
cancel-booking
skill instead.
  • “预订BK_2026_05_001的状态是什么？”
  • “展示我的预订信息”
  • “我的预订成功了吗？”
  • “我什么时候办理入住？”
如果用户想要取消预订，请改用
cancel-booking
Skill。

Prerequisites

前提条件

You need:
  1. A 
    bookingId
    (returned when the booking was created)
  2. The last name on the booking, used as a verification check
  3. The email used at booking time, also used as a verification check
If the user doesn't have the booking ID, ask them to find their confirmation email. Don't guess.
你需要：
  1. bookingId
    （创建预订时返回）
  2. 预订人姓氏，用于验证
  3. 预订时使用的邮箱，同样用于验证
如果用户没有预订ID，请让他们查找确认邮件。请勿猜测。

How to call

调用方式

bash
npx @tvl-justin/travel-cli@latest manage-booking \
  --booking-id "<bookingId>" \
  --last-name "<lastName>" \
  --email "<email>"
bash
npx @tvl-justin/travel-cli@latest manage-booking \
  --booking-id "<bookingId>" \
  --last-name "<lastName>" \
  --email "<email>"

Output

输出结果

json
{
  "bookingId": "BK_2026_05_001",
  "status": "CONFIRMED",
  "hotelName": "Park Hyatt Tokyo",
  "address": "3-7-1-2 Nishi Shinjuku, Tokyo",
  "checkIn": "2026-05-01",
  "checkOut": "2026-05-05",
  "guestName": "Nguyen Van A",
  "totalPriceUSD": 1800,
  "cancellationDeadline": "2026-04-29T23:59:00Z",
  "isCancellable": true
}
json
{
  "bookingId": "BK_2026_05_001",
  "status": "CONFIRMED",
  "hotelName": "Park Hyatt Tokyo",
  "address": "3-7-1-2 Nishi Shinjuku, Tokyo",
  "checkIn": "2026-05-01",
  "checkOut": "2026-05-05",
  "guestName": "Nguyen Van A",
  "totalPriceUSD": 1800,
  "cancellationDeadline": "2026-04-29T23:59:00Z",
  "isCancellable": true
}

Presenting to the user

向用户展示结果

Give a clean overview, not the raw JSON:
Booking BK_2026_05_001 — Confirmed ✅ Park Hyatt Tokyo · 3-7-1-2 Nishi Shinjuku, Tokyo Check-in: May 1, 2026 · Check-out: May 5, 2026 Total: $1,800 (paid) Free cancellation until April 29, 2026.
提供清晰的概述，而非原始JSON：
预订BK_2026_05_001 — 已确认 ✅ 东京柏悦酒店 · 东京都新宿区西新宿3-7-1-2 入住：2026年5月1日 · 退房：2026年5月5日 总价：1800美元（已支付） 可免费取消至2026年4月29日。

Errors

错误处理

  • 404 Not Found
    — Booking ID not found, or last name / email doesn't match. Ask the user to double-check all three.
  • Network error
    — Can't reach the API. Tell the user and offer to retry.
  • 404 Not Found
    — 未找到预订ID，或姓氏/邮箱不匹配。请用户仔细核对这三项信息。
  • Network error
    — 无法连接API。告知用户并提供重试选项。