FUTA Express package tracking skill (VN)

---

name: futa-tracker description: Track FUTA Express (Phương Trang) package delivery status using their public API. Use when the user wants to track/tra cứu đơn hàng, kiện hàng from FUTA Express, FUTA Express, or Phương Trang Express. Requires a tracking code (mã vận đơn) to query.

---

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/

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: 
👤 Người gửi: 
   📞 
   🏢 Điểm gửi: 
👤 Người nhận: 
   📞 
   🏢 Điểm đến: 
📋 Thông tin đơn hàng:
   • Loại dịch vụ: 
   • Hình thức thanh toán: 
   • Số kiện: 
   • Tổng chi phí: đ (cước chính: đ + phụ: đ)
   • Trạng thái: 
📦 Chi tiết hàng hóa:
   • 
   Ghi chú vận chuyển: 
🔐 Người nhận thực tế (nếu đã giao):
   • Tên: 
   • SĐT: 
   • CMND/CCCD: 
   • Thời gian nhận: 
📝 Ghi chú đơn hàng: 
📍 Lịch sử vận chuyển:
| Thời gian | Trạng thái | Chi tiết |
|-----------|------------|----------|
|  |  | 
 |
🛎️ Dịch vụ thêm:
   • : đ

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