End-to-End Happy Path

This guide walks through the entire rental lifecycle — from initial system setup through contract closure and accounting export. Follow each phase in order to understand how a typical rental flows through Paul Rent a Car.

Overview

The happy path covers 10 sequential phases. Each phase has a clear owner, a specific screen, required permissions, and visible status changes.

flowchart LR
  P0[Phase 0: System Setup] --> P1[Phase 1: Customer Acquisition]
  P1 --> P2[Phase 2: Booking]
  P2 --> P3[Phase 3: Vehicle Assignment]
  P3 --> P4[Phase 4: Checkout]
  P4 --> P5[Phase 5: Active Rental]
  P5 --> P6[Phase 6: Return & Check-in]
  P6 --> P7[Phase 7: Billing & Payment]
  P7 --> P8[Phase 8: Contract Closure]
  P8 --> P9[Phase 9: Accounting Export]

Business Tip: A single rental can span minutes (walk-in) or months (corporate lease). The process is the same — only timing differs.

Phase 0 — System Setup

What happens: The platform is configured with tenants, users, roles, branches, fleet, and pricing before any rental can occur.

Who does it: System Administrator

Screen: Admin > Tenants, Admin > Users, Admin > Roles, Fleet > Vehicles, Pricing > Rates

Permission: admin:manage_users, admin:manage_roles, vehicle:create, pricing:configure

Setup Checklist

Business Tip: Complete all setup steps before processing the first rental. Pricing errors discovered after checkout require credit notes to correct.

Phase 1 — Customer Acquisition

What happens: A new customer is registered, documents are uploaded, and a lead is captured from walk-in, call, or website.

Who does it: Sales Agent, Front Desk Agent

Screen: Customers > Add Customer, Documents > Upload, Leads > New Lead

Permission: customer:create, lead:create, customer_document:upload

Steps

1. Open Customers > Add Customer
2. Enter name, mobile, email, Emirates ID / passport number
3. Upload front and back of ID document
4. System runs OCR verification automatically
5. Save customer profile
6. Create a lead from walk-in call or website inquiry
7. Link lead to the new customer record

Status Change: Customer: Draft → Active | Lead: New → Contacted

Business Tip: Reject customer registration if any document fails OCR verification. Do not proceed to booking until documents are verified.

Phase 2 — Booking

What happens: A quote is created, the customer selects a vehicle class, and a reservation is confirmed.

Who does it: Sales Agent, Front Desk Agent

Screen: Reservations > New Reservation, Quotes > New Quote

Permission: reservation:create, quote:create, reservation:confirm

Steps

1. Open Reservations > New Reservation
2. Select customer from dropdown (or create inline)
3. Select pickup date/time and return date/time
4. Select pickup branch and return branch
5. System suggests available vehicle classes
6. Generate quote with pricing breakdown
7. Send quote to customer via WhatsApp or email
8. Customer accepts quote
9. Confirm reservation

flowchart TD
  A[New Reservation] --> B{Customer Selected?}
  B -->|No| C[Create Customer]
  B -->|Yes| D[Select Dates & Branches]
  D --> E[View Available Vehicles]
  E --> F[Generate Quote]
  F --> G{Customer Accepts?}
  G -->|Yes| H[Confirm Reservation]
  G -->|No| I[Revise or Cancel]
  H --> J[Reservation Confirmed]

Status Change: Reservation: Draft → Quoted → Confirmed

Business Tip: Reservations without a deposit are held for 24 hours only. After that they auto-cancel and the vehicle becomes available again.

Phase 3 — Vehicle Assignment

What happens: A specific vehicle is assigned to the reservation based on availability, class, and branch.

Who does it: Fleet Coordinator, Branch Manager

Screen: Reservations > Assign Vehicle, Fleet > Vehicle Availability

Permission: reservation:update, vehicle:update_status

Steps

1. Open the confirmed reservation
2. Click Assign Vehicle
3. System shows available vehicles matching the class
4. Select a specific vehicle by plate number
5. Confirm assignment
6. Vehicle status changes from Available to Reserved

Status Change: Reservation: Confirmed → Vehicle Assigned | Vehicle: Available → Reserved

Business Tip: Assign vehicles with the lowest odometer reading first to balance fleet utilization and resale value.

Phase 4 — Checkout

What happens: The customer picks up the vehicle. A 4-step wizard captures inspection details, processes the deposit, and creates the rental contract.

Who does it: Front Desk Agent, Branch Staff

Screen: Reservations > Checkout Wizard

Permission: contract:create, contract:checkout, security_deposit:create

4-Step Checkout Wizard

flowchart LR
  S1[Step 1: Inspection] --> S2[Step 2: Verification]
  S2 --> S3[Step 3: Deposit]
  S3 --> S4[Step 4: Contract & Keys]

Status Changes:

• Reservation: Vehicle Assigned → Converted to Contract
• Contract: Draft → Checkout Pending → Active
• Vehicle: Reserved → Rented

Business Tip: Never skip the pre-existing damage inspection. Missing photos at checkout make damage disputes nearly impossible to resolve fairly.

Phase 5 — Active Rental

What happens: The rental is active. The system monitors the rental period, handles extension requests, and logs any incidents.

Who does it: Customer (self-service extension), Operations Team (monitoring)

Screen: Contracts > Active Contracts, Contract Detail

Permission: contract:read, extension:create

During the Rental

• Customer may request an extension
• Customer may report an accident or breakdown
• System tracks daily rental cost accrual
• SLA monitors contract return date

Status Change: Contract: Active → Extension Requested (if extended)

Business Tip: Contact customers 2 days before the return date. Early reminders reduce late returns by 40%.

Phase 6 — Return & Check-in

What happens: The customer returns the vehicle. Staff perform a return inspection, document any new damage, and initiate the check-in process.

Who does it: Front Desk Agent, Fleet Inspector

Screen: Contracts > Check-in Wizard, Inspections > Return Inspection

Permission: contract:checkin, inspection:create

Steps

1. Customer returns vehicle to branch
2. Open Contracts > Check-in
3. Perform walk-around inspection
4. Compare with checkout photos
5. Record any new damage with photos
6. Record final odometer reading
7. Record fuel level
8. Submit inspection

Status Changes:

• Contract: Active → Return Pending → Damage Review (if damage) or Billing Review
• Vehicle: Rented → Inspection Pending

Business Tip: Always photograph the odometer and fuel gauge during check-in. These readings drive billing calculations.

Phase 7 — Billing & Payment

What happens: Final invoice is generated, additional charges are applied, payment is processed, and the security deposit is resolved.

Who does it: Billing Agent, Accountant

Screen: Billing > Invoices, Payments > Process Payment, Deposits > Resolve

Permission: billing:create_invoice, payment:process, security_deposit:release

Steps

1. System auto-generates invoice from contract
2. Billing agent reviews charges:
   • Base rental (days × rate)
   • Insurance charges
   • Extra days (if late return)
   • Traffic fines and Salik (if matched)
   • Damage charges (if assessed)
3. Customer pays invoice
4. Process payment (cash, card, bank transfer)
5. Resolve security deposit:
   • Deduct any charges
   • Release remainder to customer

Status Changes:

• Contract: Billing Review → Closed
• Invoice: Draft → Issued → Paid
• Security Deposit: Held → Partially Released or Fully Released

Business Tip: Generate the invoice immediately after check-in. Delayed invoicing leads to payment disputes and cash flow gaps.

Phase 8 — Contract Closure

What happens: The contract is formally closed. All charges are settled, all documents are archived, and the vehicle is returned to the available fleet.

Who does it: Branch Manager, Operations Manager

Screen: Contracts > Close Contract

Permission: contract:update

Steps

1. Verify all charges are settled
2. Verify deposit is resolved
3. Verify no open complaints or disputes
4. Click Close Contract
5. Vehicle returns to Available fleet

Status Changes:

• Contract: Closed → Archived
• Vehicle: Inspection Pending → Available (or Maintenance if repairs needed)

Business Tip: Do not close a contract with an unresolved deposit. Always confirm the deposit resolution status before closing.

Phase 9 — Accounting Export

What happens: Financial entries from the closed contract are grouped into a summary journal batch and exported to the tenant's accounting system.

Who does it: Finance Manager

Screen: Accounting > Posting Batches, Accounting > Export

Permission: accounting:approve_posting_batch, accounting:export_posting_batch

Steps

1. Open Accounting > Posting Batches
2. Review generated batch from closed contract
3. Validate debit and credit totals balance
4. Approve the batch
5. Export in CSV, Excel, JSON, or API format
6. Upload to external accounting/ERP system
7. Mark batch as Exported

flowchart TD
  A[Contract Closed] --> B[Accounting Events Generated]
  B --> C[Journal Entries Created]
  C --> D[Summary Batch Grouped]
  D --> E[Finance Reviews & Approves]
  E --> F[Export to ERP]
  F --> G[Batch Acknowledged]

Status Change: Posting Batch: Generated → Validated → Approved → Exported → Acknowledged

Business Tip: Run accounting exports weekly at minimum. Monthly exports create reconciliation nightmares and delay financial reporting.

Quick Reference — Status Summary

What Can Go Wrong