1. v1
Tourwell Open APIs
  • Tổng quan
  • Hướng dẫn xác thực
  • API Zalo Mini App (Beta)
  • API Changelog
  • Error Response
  • Khách hàng
    • v1
      • Get by id
      • Get all customer
      • Create customer
      • Update customer
      • Get order history
      • Get destinations
      • Get guests
      • Get by id care history
      • Create company
      • Get all care history
      • Get all company
  • Đơn hàng
    • v1
      • Get by id
      • Get all order
      • Get Passengers Order
      • Create order tour
      • Create order product
      • Create order hotel
      • Create order flight
      • Confirm payment order
      • Cancel order
      • Import Order Flight
      • Create cost order
      • Update cost order
      • Delete cost order
      • Transfer operator
      • Create order multiple services
      • Add services to order.
      • Change order status
      • Add Passengers Order
      • Update Passenger Order
      • Delete Passenger Order
  • Điều hành
    • v1
      • Overview
      • Create row cost
      • Update row cost
      • Delete row cost
  • Sản phẩm
    • v1
      • Create product
      • Get by id
      • Calendar pricing
      • Get all product
      • Get schedule by id
      • Update product
  • Chiết tinh giá
    • v1
  • Nhà cung cấp
    • v1
      • Get all suppliers
      • Get suppliers products
      • Get all tour guides
      • Create Supplier & Hotel
      • Create Prices Suppliers products
      • Append Prices Hotel
  • Lịch khởi hành
    • v1
      • Get all tour
        GET
      • Create tour
        POST
      • Get tour detail
        GET
      • Get tour orders
        GET
  • Lead (Cơ hội)
    • Overview
    • Update History
    • v1
      • Get all lead
      • Get by id
      • Create lead
      • Update lead
  • Báo giá
    • v1
      • Get all
      • Update schedules
      • Update policy
  • Khách sạn
    • v1
      • Get all hotel
      • Get by id
  • Kế toán
    • Phiếu thu
      • v1
        • Get all receipt
        • Create receipt
        • Update receipt
        • Confirm Receipt Success
    • Phiếu chi
      • v1
        • Get all payment
        • Confirm Payment
    • Hóa đơn bán ra
      • Update invoice
      • Issue Invoice
      • Get by id
      • Cancel invoice
    • Hóa đơn mua vào
      • Import
    • Thu hộ/Chi hộ
  • Phê duyệt
    • v1
      • Overview
      • Summary
      • Approvals
  • Cấu hình
    • Zalo ZNS
      • Danh sách Tag
      • Get token
    • Địa điểm
      • Search
    • Nhân sự nội bộ
      • Search
    • Webhook
      • Hướng dẫn cài đặt
    • Trạng thái khách hàng
      • Get All
    • Hạng thành viên
      • Get All
    • Loại dịch vụ
    • Mã sân bay
      • Get All Airport
    • Phương thức thanh toán
      • Get All
    • Nguồn bán hàng
      • Get All
    • Phễu chuyển đổi lead
      • Trạng thái lead
      • Trạng thái báo giá
  • Hướng dẫn tích hợp
    • Hướng dẫn tích hợp thanh toán trực tuyến qua Website và Tourwell
    • Hướng dẫn tích hợp thanh toán trực tuyến qua Website, Cổng thanh toán và Tourwell
  • MCP
    • Hướng dẫn kết nối
  • Schemas
    • ErrorResponse
  1. v1

Get tour orders

GET
/api/v1/tours/{id}/orders
Danh sách đơn hàng của 1 lịch khởi hành, giống bảng Danh sách đơn hàng trong chi tiết điều hành tour.
Tra lịch theo ID hoặc mã tour (VD: TD18809). Chỉ áp dụng cho tour ghép khách và đoàn riêng; dịch vụ lẻ trả 404.
Mỗi phần tử trong items là 1 dịch vụ (order item) của đơn trên lịch này, sắp theo giờ đón tăng dần. Đơn có nhiều dịch vụ trên cùng lịch sẽ có nhiều dòng cùng order_id.
Trả cả đơn Đã hủy (is_cancelled = true); dòng dịch vụ đã hủy riêng lẻ không trả về.
Nhóm payment là số tiền của cả đơn hàng (tiền tệ gốc của hệ thống), giống các cột Tổng tiền / Đã thu / Còn thiếu / Thu hộ trên CRM.
summary tương ứng dòng Tổng (active, đơn chưa hủy) và Tổng hủy (cancelled) ở chân bảng. Tiền cộng theo đơn: đơn có nhiều dòng chỉ cộng 1 lần.
order_statusTrạng thái đơn
0Đang xử lý
1Thành công
2Đã hủy
3Giữ chỗ

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://demo.tourwell.net/api/v1/tours/TD272/orders' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Thành công
application/json
Bodyapplication/json

Example
{
    "success": true,
    "message": "OK",
    "data": {
        "tour": {
            "id": 272,
            "code": "TD272",
            "name": "Tour Mộc Châu 2N1Đ ghép 12/05",
            "type": "join",
            "departure_date": "2024-05-12",
            "return_date": "2024-05-13",
            "status_code": 1,
            "status": "Mở bán",
            "total_seat": 30,
            "deleted_at": null
        },
        "summary": {
            "active": {
                "order_count": 13,
                "total_seat": 14,
                "total_pax": 27,
                "adult": 27,
                "children": 0,
                "infant": 0,
                "total_payment": 59000000,
                "total_paid": 0,
                "total_refunded": 0,
                "total_missing": 59000000,
                "total_cod": 0
            },
            "cancelled": {
                "order_count": 0,
                "total_seat": 0,
                "total_pax": 0,
                "adult": 0,
                "children": 0,
                "infant": 0,
                "total_payment": 0,
                "total_paid": 0,
                "total_refunded": 0,
                "total_missing": 0,
                "total_cod": 0
            }
        },
        "items": [
            {
                "order_item_id": 855,
                "order_id": 645,
                "order_code": "UP645",
                "order_status": 1,
                "order_status_name": "Thành công",
                "is_cancelled": false,
                "hold_until": null,
                "created_at": "2024-05-05T16:49:11+07:00",
                "order_at": "2024-05-05T21:35:25+07:00",
                "customer": {
                    "id": 92,
                    "name": "(Anh) Nguyễn Văn A",
                    "phone": "0912345678",
                    "email": "nguyenvana@example.com",
                    "sub_group": "personal",
                    "sub_group_name": "Cá nhân"
                },
                "company": null,
                "follower": {
                    "id": 1,
                    "name": "Admin",
                    "email": "admin@example.com"
                },
                "product_code": null,
                "product_name": "Tour Mộc Châu 2N1D",
                "depart_date": "2024-05-12",
                "return_date": "2024-05-13",
                "pickup_time": "06:30",
                "pickup_location": "Nhà hát Lớn Hà Nội",
                "drop_location": null,
                "room_number": "",
                "seat_number": null,
                "selected_seats": [],
                "pax": {
                    "total_seat": 2,
                    "total_pax": 2,
                    "adult": 2,
                    "children": 0,
                    "infant": 0,
                    "passengers_with_info": 2
                },
                "price_lines": [
                    {
                        "object": "Người lớn",
                        "unit_human": "adult",
                        "quantity": 2,
                        "price": 2000000,
                        "grand_total": 4000000
                    }
                ],
                "payment": {
                    "total_payment": 4000000,
                    "total_paid": 0,
                    "total_refunded": 0,
                    "total_missing": 4000000,
                    "total_cod": 0
                },
                "service_note": "Khách tự túc xe",
                "operator_note": null
            }
        ]
    }
}
🟠401Chưa xác thực
🟠404Không tìm thấy
🟠422Sai dữ liệu
🟠429Quá giới hạn
Modified at 2026-11-11 03:08:17
Previous
Get tour detail
Next
Overview
Built with