Futa Tracker

Overview

This skill enables tracking of FUTA Express (Phương Trang) package delivery status via their public API.

API Endpoint

https://api.futaexpress.vn/bo-operation/f1/full-bill-by-code-public/\x3Ctracking_code>

Tracking Workflow

1. Extract tracking code from user input
2. Use web_fetch to call the API
3. Parse the JSON response
4. Present detailed tracking information
5. CRITICAL: Keep all values in original Vietnamese - DO NOT translate

Response Structure

Key fields in the response:

• data.barcode - Mã vận đơn
• data.from_fullname / data.from_phone - Người gửi
• data.to_fullname / data.to_phone - Người nhận
• data.from_department_name - Điểm gửi
• data.to_department_name - Điểm đến
• data.service_type_name - Loại dịch vụ
• data.pay_type - Hình thức thanh toán
• data.package_total - Số kiện
• data.totalcost - Tổng chi phí
• data.addcost - Phụ phí
• data.status_bill - Trạng thái đơn hàng
• data.note - Ghi chú
• data.packages[] - Chi tiết từng kiện hàng
  • package_description - Mô tả hàng
  • receive_fullname / receive_phone / receive_identity - Người nhận thực tế
  • receive_time - Thời gian nhận hàng
  • arrival_time - Thời gian đến nơi
  • go_time - Thời gian xuất phát
  • arrival_note - Ghi chú đến nơi
• data.services[] - Dịch vụ thêm
  • add_service_name - Tên dịch vụ
  • value - Giá dịch vụ
• data.trackings[] - Lịch sử (thường trùng với packages data)

Output Format

Present information in this order:

📦 FUTA Express - Tra cứu vận đơn: \x3Cbarcode>

👤 Người gửi: \x3Cfrom_fullname>
   📞 \x3Cfrom_phone>
   🏢 Điểm gửi: \x3Cfrom_department_name>

👤 Người nhận: \x3Cto_fullname>
   📞 \x3Cto_phone>
   🏢 Điểm đến: \x3Cto_department_name>

📋 Thông tin đơn hàng:
   • Loại dịch vụ: \x3Cservice_type_name>
   • Hình thức thanh toán: \x3Cpay_type>
   • Số kiện: \x3Cpackage_total>
   • Tổng chi phí: \x3Ctotalcost>đ (cước chính: \x3Ccost_main>đ + phụ: \x3Caddcost>đ)
   • Trạng thái: \x3Cstatus_bill>

📦 Chi tiết hàng hóa:
   • \x3Cpackages[*].package_description>
   Ghi chú vận chuyển: \x3Cpackages[*].arrival_note>

🔐 Người nhận thực tế (nếu đã giao):
   • Tên: \x3Cpackages[*].receive_fullname>
   • SĐT: \x3Cpackages[*].receive_phone>
   • CMND/CCCD: \x3Cpackages[*].receive_identity>
   • Thời gian nhận: \x3Cpackages[*].receive_time>

📝 Ghi chú đơn hàng: \x3Cnote>

📍 Lịch sử vận chuyển:
| Thời gian | Trạng thái | Chi tiết |
|-----------|------------|----------|
| \x3Ctime> | \x3Cstatus> | \x3Cdetails> |

🛎️ Dịch vụ thêm:
   • \x3Cadd_service_name>: \x3Cvalue>đ

Important Rules

• NEVER translate Vietnamese values - status names, department names, everything stays in Vietnamese
• Format currency with periods (e.g., 350.000đ)
• Hide partial phone/ID info if present (masked with X or shown as is from API)
• Show timestamps in readable format (YYYY-MM-DD HH:MM)
• Display all meaningful data from the response

Error Handling

• If data.bill_id is 0: Tracking code not found
• If data.packages is empty: No package details available
• Always show the full response data even if some fields are empty