XORB HOTELS User Guide

Welcome to your complete guide for the XORB HOTELS management system. This document will walk you through every feature, from initial setup to advanced reporting, ensuring you can leverage the full power of the platform.

1. Property & Room Setup

This is the foundation of your setup. Before you can take reservations, you must define your properties and the rooms within them.

Step 1: Create a Property

  1. Navigate to
    Properties
    from the main menu.
  2. Click the
    + Add Property
    button.
  3. Fill in the Details: Complete all sections, including basic info, contact details, branding (logo, theme), and the crucial guest consent forms.
  4. Consent Forms: The text you enter into `Property Guidelines` and `Third-Party Services Consent` will be presented to guests for digital signature during check-in. Ensure this text is complete and accurate.
  5. Save the property.

Step 2: Add Rooms to Your Property

  1. From the property list, click
    Manage
    on your newly created property.
  2. On the property detail page, find the "Rooms" section and click
    + Add Room
    .
  3. Complete the Room Form: Provide the room number, type, pricing (for both standard and local rates), and upload high-quality images. The first image uploaded will be the primary one.
  4. Facilities & Features: Use comma-separated lists to detail all facilities (e.g., `Air conditioning, TV`) and bathroom features. This information is key for marketing.
  5. Save the room. Repeat for all rooms in the property.

Step 3: Generate an API Key (Optional)

If you plan to use the public API for a custom website, you need to generate an API key.

  1. Go to the
    Properties
    list and click
    Manage
    on your property, then click the
    Edit
    button.
  2. Scroll down to the "API Access" card.
  3. Click
    Generate Key
    . A unique key will be created for this property.
  4. Copy this key and store it securely. You will need it to make requests to the public API. For full details, see the API Documentation.
2. The Reservation Lifecycle

The reservation workflow is designed to be seamless, guiding you from initial booking to final checkout.

Step 1: Creating a New Reservation

  1. Click on
    Reservations > Reservation List
    and then
    + Add Reservation
    .
  2. Select Property & Dates: Choose the property and the check-in/check-out dates. The system will automatically show you which rooms are available for that period.
  3. Enter Guest Details: Fill in the main contact's information. This guest will be the primary contact for the booking.
  4. Select a Room & Set Charges: Choose one of the available rooms. The standard rate will populate automatically, but you can override it. Transfer charges can also be added here.
  5. Click
    Submit Reservation
    . The booking is now created with a
    PENDING
    status.

Step 2: The Check-in Process

Once a booking is created, click on it from the reservation list to go to the check-in page. This is a multi-step process.

  1. Add Guests: Click
    Add Guest
    . Fill in the details for *every* guest staying in the room, including their ID/passport photo. This is crucial for MIRA reporting. The first guest added becomes the "Main Guest".
  2. Sign Consents: The Main Guest must sign the consent forms. Click
    Add Main Consent
    to open a dialog where the guest can review the property guidelines and sign digitally.
  3. Confirm Payment: Review the bill breakdown. You can choose to take a 50% advance or full payment. After selecting a payment method and uploading a payment slip (if required), click
    Take Payment
    . The status changes to
    CONFIRMED
    .
    • Alternatively, you can click
      Confirm & Pay Later
      to move the status to
      CONFIRMED
      without recording a payment.
  4. Final Check-in: Once payment is confirmed and all required steps are done, the main
    Confirm Check-in
    button will be enabled. Clicking this officially checks the guest in and changes the status to
    CHECKED_IN
    .

Step 3: Checkout & Final Billing

For any
CHECKED_IN
reservation, you can proceed to checkout from the reservation list.
  1. Add Final Charges: On the checkout page, you can add any final charges, such as from the minibar or other services not captured by the POS.
  2. Apply Discounts: If needed, click
    Apply Discount
    to reduce the final bill.
  3. Settle Bill: The system displays the final amount due. Click
    Finalize & Checkout Guest
    to record the final payment.
  4. Generate Invoice: Upon successful checkout, the reservation status becomes
    CHECKED_OUT
    , and a final, official invoice is generated and linked to the reservation.
3. Point of Sale & Listings

The POS and Listing sections work together to manage chargeable items and services during a guest's stay.

Step 1: Configure Your Listings

Before using the POS, you must define what you're selling. Navigate to the
Listing
section in the menu:
  • Food: Create your full à la carte menu, including items, prices, and categories.
  • Minibar: Define all items available in the room minibars.
  • Transport & Excursions: Set up charges for services like airport transfers or snorkeling trips.
  • Pro Tip: Use the
    Upload
    button on each page to bulk-add items via a CSV file. A sample file is available for download to ensure correct formatting.

Step 2: Using the Point of Sale (POS)

The POS is designed for quickly adding charges to a checked-in guest's room bill.

  1. Go to
    Point of Sale > New Order
    .
  2. Select the property, then search for and select the currently checked-in guest.
  3. The menu on the left will become active. Use the tabs and search bar to find items.
  4. Click items to add them to the order cart on the right. Adjust quantities as needed.
  5. When finished, click
    Post to Room Bill
    . These charges will now appear automatically on the guest's final checkout screen.
4. Housekeeping Module

Efficiently manage room cleanliness and track minibar consumption.

Step 1: Configure Cleaning Checklists

Under

Configuration > Housekeeping
, you can create a detailed cleaning checklist for each property. This ensures quality and consistency. Tasks are grouped by category (e.g., "Bathroom", "Bedroom").

Step 2: The Housekeeping Workflow

  1. The main housekeeping dashboard is under
    Housekeeping > Room Status
    . It shows all rooms requiring attention.
  2. Assignment: Owners/Admins can assign a specific cleaner to a room by clicking
    Assign
    .
  3. Servicing a Room: A cleaner clicks
    Service Room
    . A dialog appears with two tabs:
    • Minibar: The cleaner enters the quantity of any consumed minibar items and clicks
      Post Minibar Charges
      . This immediately adds the cost to the guest's bill.
    • Cleaning Checklist: The cleaner goes through the pre-configured checklist. Once all items are checked, they can click
      Mark as Clean
      .
  4. The room status is updated across the system, making it available for the next check-in.
5. Reporting & Analytics

Gain insights into your operations and generate necessary compliance documents from the

Reports
section.

  • MIRA Report: This is your most critical tax report. Select a property and a month to generate the official Green Tax Information Sheet required by MIRA. A summary for the MIRA 501 form is also provided.
  • Daily Summary: A detailed financial report breaking down all revenue sources (room, transport, F&B, etc.) for a selected date range.
  • Document Report: A powerful search tool to quickly find and download any document associated with a reservation, such as payment slips or signed consent forms.
  • Excursion & Transport Reports: Get a quick summary of revenue generated from these specific services.
6. Administration & Settings

This section is for system-wide configuration and is typically reserved for Super Admins.

  • User Management: Add or edit users, assign roles, and set property/room limits.
  • Access Control: Define precisely which user roles can access which pages of the application.
  • System Settings: Configure global tax rates (TGST, Green Tax), service charges, and activate on-premise license keys.
  • Subscription Management: For cloud users, this is where you can create subscription packages and approve user subscription requests.
7. Public API

Integrate your own website or third-party services with our Public API. Full technical details, including request/response examples and authentication methods, are available in our dedicated API documentation.

View API Documentation