Skip to main content

Kết nối API PMS Skyhotel

Với việc sử dụng API PMS skyhotel (API PMS), bạn có thể truy vấn phòng trống (Availability) và tạo đặt phòng (Booking) thông qua API

Để sử dụng được API PMS, Trong request API cần User API và Hotel Id, được tạo theo hướng dẫn sau:

1. Tạo tài khoản API​

Tạo tài khoản API để sử dụng trong code API. Bạn đăng nhập tài khoản Admin > Nhân viên > Quản lý Nhân viên > Thêm > Tạo tài khoản với phân quyền API_USER.

Lưu ý: Phần quyền API_USER là phân quyền có sẵn trong hệ thống, vui lòng liên hệ với hỗ trợ Skyhotel để kích hoạt sử dụng API_USER

Kết nối API PMS Skyhotel

2. Lấy mã Hotel ID​

Bạn vào mục Khách sạn > Danh sách khách sạn > Nhấp vào nút Sửa để xem chi tiết. Copy mã Hotel ID để sử dụng trong API

Lưu ý: Vui lòng liên hệ với hỗ trợ Skyhotel để kích hoạt sử dụng sử dụng API Hotel ID

Kết nối API PMS Skyhotel

4. Tải file mẫu API​

Tải file mẫu sử PHP tại: https://skyhotel.vn/files/test_api.zip

Các ngôn ngữ lập trình khác. Vui lòng tham chiếu request từ mã CURL trong file PHP test ở trên

5. Cách triển khai API​

Mỗi request API sẽ kèm theo thông số User API và Hotel ID đã tạo ở hướng dẫn trên

Trong API có 2 function chính:

1. get_availability​

Dùng để truy vấn phòng trống trong khoản thời gian. Kết quả trả về:

{
    "room_types": [{
            "room_type_id": "27707",
            "room_type_name": "STANDARD",
            "availability": 6,
            "rates": [{
                    "date": "2024-06-16",
                    "rate": 1818000
                }, {
                    "date": "2024-06-17",
                    "rate": 1818000
                }, {
                    "date": "2024-06-18",
                    "rate": 1818000
                }
            ]
        }, {
            "room_type_id": "27709",
            "room_type_name": "DOUBLE",
            "availability": 14,
            "rates": [{
                    "date": "2024-06-16",
                    "rate": 2020000
                }, {
                    "date": "2024-06-17",
                    "rate": 2020000
                }, {
                    "date": "2024-06-18",
                    "rate": 2020000
                }
            ]
        }, {
            "room_type_id": "27710",
            "room_type_name": "TWIN",
            "availability": 7,
            "rates": [{
                    "date": "2024-06-16",
                    "rate": 3188000
                }, {
                    "date": "2024-06-17",
                    "rate": 3188000
                }, {
                    "date": "2024-06-18",
                    "rate": 3188000
                }
            ]
        }
    ]
}

2. push_booking​

Dùng để tạo booking trên PMS. Kết quả trả về là mã booking thành công trên PMS

{
    "result": {
        "code_book": 4,
        "id": 501053303
    }
}