NapX PMS Docs
Admin Guide

Rate Plans

How rate plans work in the admin dashboard and how pricing is applied to reservation stays.

Rate Plans

Navigate to Property Management → Rate Plans.

Rate plans remain the compatibility layer between the existing admin experience and the reservation engine APIs. Admin users can continue managing the top-level pricing fields directly on the rate plan record.

Top-level pricing fields

The admin dashboard treats these fields as first-class inputs:

  • spaceTypeId
  • hourlyRate
  • dailyRate
  • weeklyRate
  • monthlyRate
  • currency
  • isActive

These fields are still accepted by the API and are still used as a fallback pricing source when no matching seasonal rate_plan_entry record exists.

Reservation pricing behavior

  • Hourly reservations use hourlyRate.
  • Overnight reservations shorter than 7 days use dailyRate.
  • Overnight reservations of 7 to 27 days prefer weeklyRate.
  • Overnight reservations of 28 days or more prefer monthlyRate.
  • If a higher-duration rate is missing, the reservation engine falls back to the next available lower-duration rate instead of failing immediately.

Compatibility note

This fallback behavior is intentional. The admin app still edits the top-level rate-plan fields directly, while the reservation engine also supports time-bounded rate_plan_entries. Keeping both paths active prevents pricing regressions during the migration to richer entry-based pricing.

On this page