NFC Universe · Projects · 2025

MÓDULO JEFE

Custom Odoo 16 module for complete hotel management — daily guest logs, monthly summaries, tax reports, and document control, all in one integrated backend.

ODOO 16 Python / XML Hotel Management PDF Reports CSV Import / Export E Custom Module

A complete operational backend for hotels.

Módulo Jefe is a fully custom Odoo module designed to handle the daily operational reality of a hotel — from guest check-in and exit tracking to monthly earnings breakdowns and automated tax reports for the Finanzamt. Built from scratch in Python with Odoo’s ORM and QWeb reporting engine.

📋

DAILY GUEST LOG

Every guest entry is recorded with timestamp, locker number, entry type (standard, early, custom price), overnight stay, DÜV health certificate status, and automatic fee calculation. The Tagesliste tracks the full day shift in real time.

🗂️

CENTRAL GUEST DATABASE

The Datenpflege model stores each registered guest with ID documents, tax numbers, Hauspass ID, health certificate expiry, and automatic status indicators — valid or expired. Alerts trigger when documents approach their expiry date.

📊

MONTHLY SUMMARIES

The Monatsliste generates a per-worker monthly breakdown: total entries, overnight fees, DÜV taxes, and grand totals. One-click PDF export for archiving or handover to management.

📄

TAX REPORTS

The Steuerlisten module generates structured monthly tax lists segmented by DÜV status — ready for submission. Automatically counts women with and without DÜV registration, with dedicated PDF export for the Finanzamt.

Everything a hotel operator needs — nothing they don't.

01 / ENTRY CONTROL

SMART CHECK-IN

Guests are looked up by Hauspass number. Entry type, DÜV status, and overnight stay are selected in seconds. Prices are computed automatically. Booking date follows the "Quittungssoftware" rule — entries before 6 AM count as the previous day.

02 / DOCUMENTS

EXPIRY ALERTS

Every guest has a Hauspass and Gesundheitsamt expiry date. The module auto-computes status: valid, expiring in 30 days, or expired. The main console shows a live count of expired documents.

03 / REPORTS

PDF GENERATION

Seven QWeb PDF report templates: daily guest list (single & multi), monthly summary per worker, Steuerliste for the Finanzamt, Carnet report, and Finanzamt declaration — all with the hotel's branding and logo.

04 / DATA IO

CSV IMPORT / EXPORT

Dedicated controllers for importing and exporting both Tagesliste and Datenpflege via CSV. Handles validation, duplicate prevention, and error reporting during import — enabling seamless data migration and backups.

05 / FINANCIALS

AUTOMATIC TOTALS

Every entry line computes its own entry fee, DÜV surcharge, overnight cost, and tax automatically. Monthly summaries aggregate these per worker. The Steuerlisten model groups everything for fiscal reporting.

06 / SECURITY

PIN PROTECTION

Sensitive operations (Datenpflege editing, console access) are protected by a PIN wizard layer — a custom Odoo TransientModel flow that validates the PIN before granting access to restricted views.

OPERATIONAL FLOW

HOW A TYPICAL DAY
RUNS IN THE SYSTEM.

01

GUEST ARRIVES

Manager enters Hauspass number. System looks up the guest and validates document status.

02

ENTRY LOGGED

Entry type and extras selected. Fees computed. Booking added to today’s Tagesliste.

03

SHIFT CLOSES

Manager prints today’s PDF report directly from the console with one click.

04

MONTH CLOSES

Monatsliste generated per worker. Monthly totals computed. PDFs archived.

05

TAX FILING

Steuerlisten exports structured tax data for the Finanzamt. DÜV counts separated automatically.

MODULE ARCHITECTURE

EIGHT MODELS.
ONE UNIFIED SYSTEM.

🏠

JEFE CONSOLE

TransientModel serving as the operational hub. Houses all import/export actions, print buttons, and live indicator fields like Fällige HP count and server timestamp.

📋

TAGESLISTE

The core daily log. Tracks every guest visit with auto-computed prices, booking date (with midnight rule), sequence numbering, status, and overnight tracking.

👥

DATENPFLEGE

Central guest registry. Stores identification, contact, and document data. Auto-computes document health status and displays visual indicators.

📅

MONATSLISTE

Monthly summary per worker. Aggregates Tagesliste entries for a given month and year into line-by-line totals with grand sum computation.

📊

STEUERLISTEN

Tax list generator for the Finanzamt. Groups monthly Tagesliste data by DÜV status, counts eligible women, and generates structured fiscal reports.

📝

HOME WIZARD

TransientModel for rapid guest registration from the home screen. Pre-fills date and time, handles entry type selection, DÜV, and overnight options in one form.

🔐

PIN WIZARDS

Two security wizards gating sensitive areas with PIN validation before access is granted.

📄

REPORT ENGINE

Seven QWeb PDF report controllers: Tagesliste, Monatsliste, Steuerliste, Carnet, and Finanzamt declaration — all branded with hotel logo.

INTERESTED IN A CUSTOM ODOO MODULE?

Start Your custom odoo Project

1 + 12 =

ANY MORE QUESTION?

We solve any typycal question abaout nfc solutions question in our faqs page

FAQS