Hotel and Hospitality Management Overview
Architectural and operational overview of SmartERP Hotel & Hospitality Management, front office PMS, guest folios, and restaurant POS integration.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Hotel and Hospitality Management Overview within SmartERP.
SmartERP Hotel & Hospitality Management delivers a full Property Management System (PMS) designed for luxury hotels, business lodges, safari resorts, and boutique guest houses. It unifies room reservations, front desk registration, housekeeping room boards, restaurant and bar Point of Sale (POS), banquet conference event bookings, and automated night audit financial balancing into a real-time operational engine.
Core Capabilities#
- Front Office PMS & Room Matrix: Visual room calendar displaying real-time occupancy, clean/dirty room statuses, and instant walk-in registration.
- Multi-Folio Guest Billing: Route room accommodation, restaurant checks, minibar items, and laundry expenses across separate personal and corporate master folios.
- F&B and POS Outlets Integration: Direct posting of dining bills from hotel restaurants, bars, and pool terraces directly onto guest room accounts with digital signature confirmation.
- Housekeeping & Engineering Workflows: Real-time room turnaround boards, maid assignments, minibar replenishment, and rapid maintenance defect logging.
- Conference & Event Booking (BEO): Banquet event orders, conference room setups, audio-visual equipment packages, and catering covers.
- Automated Night Audit Engine: Automated nightly posting of room rates, municipality tourism taxes, outlet closing verification, and executive manager ledger balancing.
{screenshot:overview-overview-dashboard}
2. Prerequisites & Security Access Groups#
- Required Modules:
smarterp_hospitality, point_of_sale, account, stock - Security Groups:
Front Desk Receptionist(Technical ID:hotel.group_hotel_reception)Housekeeping Supervisor(Technical ID:hotel.group_hotel_housekeeping)Night Auditor / Financial Controller(Technical ID:hotel.group_hotel_night_auditor)Hotel General Manager(Technical ID:hotel.group_hotel_manager)
- Master Data Dependencies: Established property hotel profile for Company 1 (
Ashewa Technology Solutions S.C.), room inventory, room types, rate plans, and POS dining outlets.
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Module Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Select the Hospitality app icon.
- From the top navigation bar, open Front Desk → Reservations / In-House / Room Board / Night Audit.
{screenshot:overview-app-switcher-navigation}
Step 2: Creating and Parameterizing Records#
- Click the New button in the top-left control panel.
- Complete the mandatory fields in the record form:
- Guest Name (Mandatory): Complete legal name matching national ID or passport (
res.partner). - Stay Dates (Mandatory): Scheduled arrival and departure dates and times.
- Room Category & Rate (Mandatory): Desired room category and contractual rate tier.
- Payment Guarantee (Mandatory): Advance deposit, corporate billing voucher, or credit card pre-authorization.
- Guest Name (Mandatory): Complete legal name matching national ID or passport (
- Configure optional operational parameters and localized tags as required:
- Special Guest Preferences (Optional): High floor, non-smoking, extra pillows.
- Meal Plan (Optional): Bed & Breakfast, Half Board, or Full Board.
- Flight / Airport Transfer Details (Optional): Flight arrival schedule for hotel shuttle pickup.
- Click the Save icon in the control bar to commit the record.
{screenshot:overview-record-creation-form}
Step 3: Validating and Processing Transactions#
- State Transitions: Execute operational state progression (
Reserved→Checked-In / In-House→Folio Charges Accrued→Checked-Out / Settled). - Ledger & System Impact: Night audit posts daily accommodation revenue and municipality tourism taxes; restaurant and minibar charges post to guest folio.
- Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.
{screenshot:overview-transaction-processing-state}
4. Advanced Configuration Points#
- Automated Actions & Scheduled Tasks (Crons):
Hotel: Post nightly room rate charges to folios(hotel.ir_cron_night_audit): Runs nightly at 02:00 to post room accommodation fees.Hotel: Housekeeping room cleanliness inspection reset(hotel.ir_cron_housekeeping_reset): Runs daily at 06:00 to refresh room turnaround boards.Hotel: Check No-Show reservations(hotel.ir_cron_noshow_cleanup): Runs nightly to process unfulfilled reservations.
- Custom Print Templates & Reports:
- Official Guest Registration Card (GRC) with Digital Signature
- Guest Folio Tax Invoice (Model 85 Compliant)
- Daily Manager Report (DMR) & RevPAR Ledger
- Housekeeping Floor Turnaround Board & Attendant Roster
- Multi-Company Rules: Record-level security isolation under Company 1 (
Ashewa Technology Solutions S.C.), preventing cross-hotel guest folio leakage across sister properties.
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Access Rights Error: Cannot execute Night Audit | User lacks assigned Night Auditor security privileges. | Assign user to hotel.group_hotel_night_auditor under Settings → Users. |
Validation Error: Room not in clean inspected status | Attempting to check guest into a dirty or uninspected room. | Housekeeping floor supervisor must inspect and mark room Clean prior to check-in. |
Folio Settlement Block: Open POS checks exist | Guest checkout attempted while restaurant or bar bills remain open. | Close all open restaurant checks to the folio before printing final bill. |
Keycard Encoder Timeout: Communication error | USB/network RFID encoder machine disconnected or daemon offline. | Check physical USB cable connection and restart PMS keycard encoder service. |