> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vcms.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overnight Packages

> Create packages for how you actually sell, and manage inventory and rates across every connected channel package at once.

***

## Package list

Basic information and rate information for your overnight packages, in one place. Packages can be reordered freely.

### Basic information

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-list.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=22bbd91da268ad6c5599accab5117b86" alt="Pkg List" width="4320" height="2439" data-path="images/en-pkg-list.png" />
</Frame>

Every overnight package built on a room type, with its name, inventory, and timetable at a glance.

### Rate information

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-list-rate.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=feddf5b9a1d3e8b2be06c84b14acb217" alt="Pkg List Rate" width="4320" height="2700" data-path="images/en-pkg-list-rate.png" />
</Frame>

Check and set a package's base rate and its rate periods.

* **Base rate**: the selling rate applied on any date without a period of its own.
* **Period rate**: add a period and the package sells at a different rate for those dates only.

Two things make the rate screen easier to work in.

* **Expand or collapse all**: "Expand all | Collapse all" at the top of the list opens or closes rate information for every package at once. With many packages, you get to the one you want quickly.
* **Multi-select room type filter**: the room type chips at the top take more than one selection, so you can pull up just the types you want and compare them side by side.

<Note>
  **Changes apply provisionally. Nothing is final until you press Save**

  Everything you do on the rate information tab (bulk apply, import, adding periods, sorting, editing rows) lands on screen first as a provisional change.

  * A changed package card carries a "provisional" badge, and the changed cells and order are highlighted.
  * The undo (↩︎) button on a card reverts that package to its pre-save state.
  * Press Save in the top bar to commit. Leave the page without saving and the changes are gone.
</Note>

***

## Creating a package

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/m3TFmITf6izk-Es-/images/en-create-pkg.png?fit=max&auto=format&n=m3TFmITf6izk-Es-&q=85&s=13afb5f9ef5813c18568917e7f3c7a94" alt="Create Pkg" width="4320" height="2439" data-path="images/en-create-pkg.png" />
</Frame>

Pick a room type, fill in the name, currency, timetable, and the rest, and the overnight package exists.

Here is what you enter:

* **Room type (required)**: the room type this package is connected to. Inventory follows the number of rooms in that type, and the connection cannot be changed after creation.
* **Package name (required)**: the name that distinguishes this package.
* **Currency**: the currency the package rate is in. Like the room type, it cannot be changed after creation.
* **Timetable**: the package's check-in and check-out times.
* **Inventory details**
  * **Max inventory**: caps how many can be sold, up to the number of rooms in the room type.
  * **Auto top-up**: tops the availability of every connected channel package back up so inventory stays level. If the number you set matches actual inventory, it draws down as sales come in.
  * **Units per booking**: how many rooms one booking consumes. Set it to 2 and each booking draws 2 from inventory. Inventory stays accurate even when several rooms are sold as a single package, as with capsule rooms.

<Warning>
  Change the units per booking and it applies to rate adjustments made from then on. Adjustments already in place are untouched.
</Warning>

<Accordion title="Spotting a booking with units per booking applied">
  When a booking comes in for a package that sets units per booking, that setting shows up in Bookings.

  <Frame>
    <img src="https://mintcdn.com/vendit-d49adf2c/iMOtPMA-aiucMvK8/images/booking_scaleFactor.png?fit=max&auto=format&n=iMOtPMA-aiucMvK8&q=85&s=8de714b997d133d345ca3e73043d3429" alt="Booking Scale Factor" width="3200" height="1880" data-path="images/booking_scaleFactor.png" />
  </Frame>

  * **Package**: a "booking ×2" badge next to the package name shows the units per booking currently set.
  * **Quantity**: "booking ×2 applied" shows the units per booking that was in force when the booking synced.
</Accordion>

### **Setting the package rate**

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/m3TFmITf6izk-Es-/images/en-create-pkg-rate.png?fit=max&auto=format&n=m3TFmITf6izk-Es-&q=85&s=e6c36203f0975778528133c7b68cee46" alt="Create Pkg Rate" width="4320" height="2700" data-path="images/en-create-pkg-rate.png" />
</Frame>

Turn rate management on and you control this package's rate directly.

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/m3TFmITf6izk-Es-/images/en-create-pkg-rate-select.png?fit=max&auto=format&n=m3TFmITf6izk-Es-&q=85&s=6841a88982c2e8c6141d9bcae33dbb48" alt="Create Pkg Rate Select" width="4320" height="2700" data-path="images/en-create-pkg-rate-select.png" />
</Frame>

Pick the rate to apply. If the one you need does not exist, press `+ Create rate` and make it on the spot. The [rates guide](/en/inventory-rate/rate) covers this in full.

### Package inclusions

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/_0mM2rXxeE3PsMaW/images/create-pkg-inclusions.png?fit=max&auto=format&n=_0mM2rXxeE3PsMaW&q=85&s=b19b702975103a8470629fa29e1f063f" alt="Create Pkg Inclusions" width="4096" height="2055" data-path="images/create-pkg-inclusions.png" />
</Frame>

Pick the inclusions that apply to this package alone. Their combined total becomes the package's base rate. If the inclusion you need does not exist, press `+ Create inclusion`. The [inclusions guide](/en/inventory-rate/inclusion) covers this in full.

### Extra rate adjustment

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/m3TFmITf6izk-Es-/images/en-create-pkg-rate-scale.png?fit=max&auto=format&n=m3TFmITf6izk-Es-&q=85&s=ab9e7c79f3e33481dbbae2ced2da415c" alt="Create package, rate scale factor" width="4320" height="2700" data-path="images/en-create-pkg-rate-scale.png" />
</Frame>

Add a markup or a discount on top of the package's base rate. The final rate, calculated from the amount or percentage you enter, is shown immediately.

### Rate range

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/m3TFmITf6izk-Es-/images/en-create-pkg-rate-range.png?fit=max&auto=format&n=m3TFmITf6izk-Es-&q=85&s=bffcfe51af2e7646aa3c343d0c8dc459" alt="Create Pkg Min Max" width="4320" height="2700" data-path="images/en-create-pkg-rate-range.png" />
</Frame>

Set a minimum and maximum for the selling rate. Set both, or just one. The maximum has to be higher than the minimum.

### Occupancy-based pricing

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/m3TFmITf6izk-Es-/images/en-create-pkg-obp.png?fit=max&auto=format&n=m3TFmITf6izk-Es-&q=85&s=50d467c29aa9853c01a04d4e926edcc5" alt="Create Pkg Obp" width="4320" height="2700" data-path="images/en-create-pkg-obp.png" />
</Frame>

On channels that support occupancy-based pricing (Agoda, for one), a per-person surcharge is added to the room rate once guests exceed base occupancy. Channels without that support price against max occupancy.

***

## Setting rate periods

When you want a different rate in peak season than in the quiet months, rate periods give you the room to do it.

### Period rates

Add a period and a different rate applies for those dates only. The [periods guide](/en/inventory-rate/period) covers how to build one.

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-rate-periods.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=a0551755676d2af177b26cc7950a5cce" alt="Create Pkg Rate Period" width="4320" height="2700" data-path="images/en-pkg-rate-periods.png" />
</Frame>

### Adding a period

Connect a period you built on the periods page to a package, and it has a period rate.

* **Add to several packages at once**: if a period is connected to no package at all, an "Add N unconnected periods" link appears at the top of the list. An unconnected period sells at the base rate for those dates, so follow the link when you see it.
  <Frame>
    <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-add-unlinked-periods.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=ca26163d0e16198bc8cd7c30cc95a10a" alt="Add multiple periods" width="4320" height="2700" data-path="images/en-pkg-add-unlinked-periods.png" />
  </Frame>

* **Add to a single package**: use the "Add period" button on the package card. The adjustment stored on the period comes across as the starting value.
  <Frame>
    <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-add-period.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=82dd1e69374106aba94c27b72897f88c" alt="Add a period to one package" width="4320" height="2700" data-path="images/en-pkg-add-period.png" />
  </Frame>

* An added period slots in at its priority position from the periods page.

<Warning>
  If a period you add overlaps one already there, the higher period wins and the rate can change. Check each package's rate before you save.
</Warning>

### Applying rate periods to other packages

Period rates set on one package can be carried over to others, so you are not repeating the same periods package by package.

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-bulk-rate-plan-modal.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=dbfc573c1b623e7aa0ea0c3a31a655cd" alt="Bulk update rate plan modal" width="4320" height="2700" data-path="images/en-pkg-bulk-rate-plan-modal.png" />
</Frame>

* **Bulk apply**: from the option (⋮) menu at the top of the list, pick one package to copy from and apply it to many at once.
  <Frame>
    <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-bulk-rate-plan-button.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=600cf266f4529f9f6afab8ce5f035567" alt="Bulk update rate plan button" width="4320" height="2700" data-path="images/en-pkg-bulk-rate-plan-button.png" />
  </Frame>
* **Import**: the "Import" button on a package card pulls another package's rate periods into this one.
  <Frame>
    <img src="https://mintcdn.com/vendit-d49adf2c/AywIyZTf2npy9O_O/images/en-pkg-import-rate-plan.png?fit=max&auto=format&n=AywIyZTf2npy9O_O&q=85&s=a6a7f555cf493be5ac590b512a3f61d0" alt="Import rate plan into one package" width="4320" height="2700" data-path="images/en-pkg-import-rate-plan.png" />
  </Frame>

<Info>
  **What copies is the period structure and the adjustments, not the amounts**

  * The final rate is recalculated by applying the adjustments to each package's own rate. A package's base rate never moves.
  * Periods that exist only on the receiving package are kept, and rates you changed individually are kept too.
  * A calculated rate that falls outside the package's minimum or maximum is pulled back inside the range.
  * Packages on a fixed rate, packages with no rate set, and packages in a different currency are excluded, and the list says why.
</Info>

### Sorting periods

When periods overlap, the one higher up applies first. Out of order, they can sell at a rate you did not intend, so a package's rate periods can be sorted to match the priority on the periods page.

* **Every package**: run "Sort periods" from the option (⋮) menu. Packages already in the right order are skipped.
* **One package**: use the "Sort" button on the package card.

<Check>
  Only the order changes. No period is added or removed, and no rate or adjustment is touched.
</Check>

***

## Deleting a package

<Frame>
  <img src="https://mintcdn.com/vendit-d49adf2c/UKfCNF14vDLKzvE7/images/en-pkg-delete.png?fit=max&auto=format&n=UKfCNF14vDLKzvE7&q=85&s=9bea63de48b77c5b0b68a4aff1342e03" alt="Pkg Delete" width="2880" height="1800" data-path="images/en-pkg-delete.png" />
</Frame>

<Warning>
  An overnight package connected to a channel package cannot be deleted. Only packages with no channel package attached can go.
</Warning>
