Create Supplier & Hotel - Tourwell Open APIs

API: Tạo Mới Nhà Cung Cấp (Hỗ trợ tạo Khách Sạn + Hạng Phòng + Bảng Giá)
API dùng để tạo mới nhà cung cấp. Đặc biệt hỗ trợ "Nest-Creation" cho phép khởi tạo luôn danh sách hạng phòng và bảng giá nếu nhà cung cấp là Khách sạn/Resort/Du thuyền.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "name": "JW Marriott Phu Quoc Emerald Bay Resort & Spa (Test API)",
    "short_name": "JW Marriott PQ",
    "type_of_service_id": 2,
    "email": "mhrs.pqcjw.reservations@marriotthotels.test",
    "phone": "02973779999",
    "location": "1_city",
    "address": "Bãi Khem, An Thới, Phú Quốc, Kiên Giang",
    "star": 5,
    "tax_code": "1701122556-JW-MARRIOTT",
    "seasons": [
        {
            "name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
            "description": "Giá ưu đãi lưu trú mùa mưa tại Phú Quốc.",
            "booking_start_at": "01/05/2026",
            "booking_end_at": "30/09/2026",
            "use_start_at": "01/06/2026",
            "use_end_at": "30/09/2026",
            "use_date_except": "02/09/2026"
        },
        {
            "name": "Mùa Cao Điểm (Khách Quốc Tế 2026 - 2027)",
            "description": "Giai đoạn siêu cao điểm dành cho khách trú đông.",
            "booking_start_at": "01/08/2026",
            "booking_end_at": "31/03/2027",
            "use_start_at": "01/10/2026",
            "use_end_at": "31/03/2027",
            "use_date_except": ""
        }
    ],
    "rooms": [
        {
            "name": "Phòng Emerald Bay View",
            "total_room": 40,
            "max_adult": 2,
            "max_children": 1,
            "metre_square": 53,
            "is_breakfast": 1,
            "season_prices": [
                {
                    "season_name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
                    "service_name": "Giá Emerald (Ngày thường)",
                    "price_in": 5500000,
                    "price_out": 6500000,
                    "allotment": 20,
                    "policy": "Miễn phí xe đưa đón sân bay",
                    "day_off_week": "1,2,3,4,5"
                },
                {
                    "season_name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
                    "service_name": "Giá Emerald (Cuối tuần)",
                    "price_in": 6500000,
                    "price_out": 7500000,
                    "allotment": 10,
                    "policy": "Bao gồm bữa tối nhẹ (Set Menu)",
                    "day_off_week": "6,0"
                },
                {
                    "season_name": "Mùa Cao Điểm (Khách Quốc Tế 2026 - 2027)",
                    "service_name": "Giá Emerald (Cao điểm)",
                    "price_in": 8500000,
                    "price_out": 10500000,
                    "allotment": 10,
                    "policy": "Không áp dụng hoàn/hủy",
                    "day_off_week": "1,2,3,4,5,6,0"
                }
            ]
        },
        {
            "name": "Lamarck House (Biệt thự 7 phòng ngủ)",
            "total_room": 1,
            "max_adult": 14,
            "max_children": 7,
            "metre_square": 1300,
            "is_breakfast": 1,
            "season_prices": [
                {
                    "season_name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
                    "service_name": "Giá Lamarck House",
                    "price_in": 120000000,
                    "price_out": 150000000,
                    "allotment": 1,
                    "policy": "Gồm 1 Chef riêng phục vụ BBQ tại Villa"
                },
                {
                    "season_name": "Mùa Cao Điểm (Khách Quốc Tế 2026 - 2027)",
                    "service_name": "Giá Lamarck House (Cao điểm)",
                    "price_in": 180000000,
                    "price_out": 220000000,
                    "allotment": 1,
                    "policy": "Yêu cầu thanh toán trước 100%"
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://demo.tourwell.net/api/v1/suppliers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "JW Marriott Phu Quoc Emerald Bay Resort & Spa (Test API)",
    "short_name": "JW Marriott PQ",
    "type_of_service_id": 2,
    "email": "mhrs.pqcjw.reservations@marriotthotels.test",
    "phone": "02973779999",
    "location": "1_city",
    "address": "Bãi Khem, An Thới, Phú Quốc, Kiên Giang",
    "star": 5,
    "tax_code": "1701122556-JW-MARRIOTT",
    "seasons": [
        {
            "name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
            "description": "Giá ưu đãi lưu trú mùa mưa tại Phú Quốc.",
            "booking_start_at": "01/05/2026",
            "booking_end_at": "30/09/2026",
            "use_start_at": "01/06/2026",
            "use_end_at": "30/09/2026",
            "use_date_except": "02/09/2026"
        },
        {
            "name": "Mùa Cao Điểm (Khách Quốc Tế 2026 - 2027)",
            "description": "Giai đoạn siêu cao điểm dành cho khách trú đông.",
            "booking_start_at": "01/08/2026",
            "booking_end_at": "31/03/2027",
            "use_start_at": "01/10/2026",
            "use_end_at": "31/03/2027",
            "use_date_except": ""
        }
    ],
    "rooms": [
        {
            "name": "Phòng Emerald Bay View",
            "total_room": 40,
            "max_adult": 2,
            "max_children": 1,
            "metre_square": 53,
            "is_breakfast": 1,
            "season_prices": [
                {
                    "season_name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
                    "service_name": "Giá Emerald (Ngày thường)",
                    "price_in": 5500000,
                    "price_out": 6500000,
                    "allotment": 20,
                    "policy": "Miễn phí xe đưa đón sân bay",
                    "day_off_week": "1,2,3,4,5"
                },
                {
                    "season_name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
                    "service_name": "Giá Emerald (Cuối tuần)",
                    "price_in": 6500000,
                    "price_out": 7500000,
                    "allotment": 10,
                    "policy": "Bao gồm bữa tối nhẹ (Set Menu)",
                    "day_off_week": "6,0"
                },
                {
                    "season_name": "Mùa Cao Điểm (Khách Quốc Tế 2026 - 2027)",
                    "service_name": "Giá Emerald (Cao điểm)",
                    "price_in": 8500000,
                    "price_out": 10500000,
                    "allotment": 10,
                    "policy": "Không áp dụng hoàn/hủy",
                    "day_off_week": "1,2,3,4,5,6,0"
                }
            ]
        },
        {
            "name": "Lamarck House (Biệt thự 7 phòng ngủ)",
            "total_room": 1,
            "max_adult": 14,
            "max_children": 7,
            "metre_square": 1300,
            "is_breakfast": 1,
            "season_prices": [
                {
                    "season_name": "Mùa Thấp Điểm (Mùa Mưa PQ 2026)",
                    "service_name": "Giá Lamarck House",
                    "price_in": 120000000,
                    "price_out": 150000000,
                    "allotment": 1,
                    "policy": "Gồm 1 Chef riêng phục vụ BBQ tại Villa"
                },
                {
                    "season_name": "Mùa Cao Điểm (Khách Quốc Tế 2026 - 2027)",
                    "service_name": "Giá Lamarck House (Cao điểm)",
                    "price_in": 180000000,
                    "price_out": 220000000,
                    "allotment": 1,
                    "policy": "Yêu cầu thanh toán trước 100%"
                }
            ]
        }
    ]
}'

Responses

🟢201

application/json

Bodyapplication/json

Example

{
    "success": true,
    "message": "Tạo Nhà Cung Cấp thành công",
    "data": {
        "id": 256,
        "code": "KSS00256",
        "name": "JW Marriott Phu Quoc Emerald Bay Resort & Spa (Test API) (JW Marriott PQ)",
        "short_name": "JW Marriott PQ",
        "email": "mhrs.pqcjw.reservations@marriotthotels.test",
        "phone": "02973779999",
        "address": "Bãi Khem, An Thới, Phú Quốc, Kiên Giang",
        "star": 5,
        "tax_code": "1701122556-JW-MARRIOTT",
        "location": "An Giang",
        "type_of_service": "Khách sạn",
        "created_at": "2026-06-06 12:49:57"
    }
}