Documentation around the use of linear agreements in Maxxton Software
Introduction
What is a linear agreement?
A short explanation is that a linear agreement is a guaranteed allotment that is typically paid before arrival (and the amount is not depending on the number of reservations).
The linear agreements are focussed on the French market and because of that it is designed and developed with the French market in mind.
Its main purpose is too be able to invoice the linear agreement separately from the customer reservations and it depends on the NF525-legislation implementation for invoicing.
Main difference between Allotment & Linear
Similar to the allotment method used by partners, linear reservations also use the allotment feature, but the main difference is invoicing. Invoices for linear are typically paid in January.
Allotment bookings: Bookings have actual rates which are invoiced to DC, minus commission, via Agent Settlement module. Typically done after checkout
Linear bookings: Linear cost should be invoiced to a partner. Invoice is independent from guest stay and is typically invoiced at the beginning of the (fiscal) year (commonly even before arrival).
Conceptual flow
The full process of a linear agreement can be broken down into three main conceptual flows:
Initial setup
Configuration of the linear agreement
Invoicing the linear agreement
The initial setup only needs to be done once for a distribution channel or partner. See https://maxxton.atlassian.net/wiki/spaces/TP/pages/edit-v2/1210482714?draftShareId=8f69a08f-5544-476a-b87e-923dc2810a50#Initial-setup for more details.
The next step would to do the setup of the actual linear agreement, this needs to be done for each new agreement and can be repeated as often as necessary. During this flow the user allocates the units/types for the agreement for the agreed periods and a linear contracted rate reservation is created to prepare the invoicing flow.
Initial setup
Prerequisites
The feature flag ‘Linear distribution channel’ should be enabled
Feature flags can only be enabled by Maxxton employees, if it is not yet enabled at your environment, please contact Customer Success to get this enabled.The feature flag ‘NF525 Compliancy’ should be enabled.
Linear agreements are mainly developed for the French market and it depends on the NF525 flow for generating invoices. For that reason, it is a requirement that this feature flag is enabled. Feature flags can only be enabled by Maxxton employees, if it is not yet enabled at your environment, please contact Customer Success to get this enabled.The parent distribution channel that you want to use needs to already exist
Usually distribution channels are created in a tree structure and they all use this parent / child structure. Although not strictly necessary, it is advised to have a parent available for this.The rate type that you want to use for the customer reservations needs to exist
Please note; in most scenarios this is expected to be a 0 rate since the reservation is already paid for with the linear agreement. It is required to have a valid rate type to be able to make the reservation.The reservation category that you want to use for the linear reservations need to exist
Please make sure that this reservation category should be an explicit reservation category configured to be for linear agreements. Since this is a very specific step, it is included at this page as well; see https://maxxton.atlassian.net/wiki/spaces/TP/pages/edit-v2/1210482714?draftShareId=8f69a08f-5544-476a-b87e-923dc2810a50#Configure-a-reservation-category-for-use-for-linear-contracted-rate-reservations
Access
There are several permissions required to be able to configure a new distribution channel for a linear agreement:
Channel Manager permission
Channel Manager - Distribution Channels permission
Setup
Configure a reservation category for use for linear contracted rate reservations
The main reason to use a different reservation category for the linear reservation is to make it possible to use a different ledger for linear reservations compared to ‘regular’ reservations. Using a different ledger can then be done by configuring a ledger group.
Creating a new reservation category is easy; just go to: Channel Manager → Configuration → Reservation Categories
From there it is straightforward;
Press ‘Create reservation category’
Add the name, code and description
Save the new reservation category
After you have created a new category, it is important to mark this reservation category to be used for the linear reservations. This can be done like this:
Press the ‘3-dots’-menu in the top right corner
Select ‘Settings’
Toggle the button for ‘Use for linear contracted reservation’ to enabled
Done
You could change some optional settings now too, like translations for the reservation category or the color of the reservation category. The last one isn’t that important since linear contracted rate reservations are never shown in the planning chart.
Configuration of a linear channel (first-time use)
If you are setting up a new distribution channel for use with linear for the first time, follow this path to create a new distribution channel:
Maxxton Software Home Page > Channel Manager > Distribution channels
From there follow the following steps:
Click Create distribution channel
In the following modal window, please enter the following data:
Parent: the parent distribution channel, useful to be able to inherit settings
Name: free type field for the name, important to recognise the channel. This will also be used on invoices.
Code: short language-independent identifier. You can choose the code. It needs to be unique and shouldn’t contain any whitespaces.
Description: (optional) free description of the channel, place to be able to include details if necessary.
Currency: choose the mandatory currency
Type: Choose the type of the distribution channel. Please note that if you want to use the channel for linear agreements, it needs to be either 'Touroperator' or 'Comité d’entreprise'
Once one of these types is selected, you can select the option to configure the channel to be of the type linear. Don’t forget to enable it, this can only be done during the creation of the distribution channel.
Allotment use: As soon as you have selected the type linear, it will automatically select ‘Book only from allotment’ since that is the only combination allowed.
Select Next step
Select applicable rate types for this distribution channel
Please note; that this will be the rate type that will be used for creating the reservations for customers, so this will commonly be a rate type that will have 0 rates since the stays are paid as part of the agreement instead of per reservation.Configure inventory for the new distribution channel
It would be up to you to decide how to configure the inventory, all the options offered in the workflow are supported for the linear channel as well. However, best practice would be to create a distribution channel group ‘Linear’ and add all the linear DCs in that group. If that distribution channel group is already added to the representation of (some, all, many) accommodation types, that would mean the suggested approach for adding another Linear channel is to use the distribution channel group to configure the inventory for the new channel. This would avoid a lot of manual work.
Please note; that adding inventory for a linear channel would not make it automatically bookable since a linear channel can only book from previously bought inventory. And previously bought inventory will be made available by adding allotment for the channel. Adding this inventory will make it possible to add the allotment. It will therefore not hurt to configure more accommodation types from the beginning, that will make you more flexible when actually configuring the allotment.
Select reservation categories
Now it is important to select at least two categories here; one linear and one regular for the guest stays.Press finish to create the distribution channel
You are now done, but please note that depending on the selections made in the inventory step, it might take some time to fully complete the process. It will run in the background though so you don’t need to wait for this.
Configuration of a linear agreement - unit level
Prerequisites
This flow can only be started from a distribution channel that books from allotment
This flow can only be started from a distribution channel that has the linear setting enabled. This can be done for a touroperator or CSE distribution channel. See https://maxxton.atlassian.net/wiki/spaces/TP/pages/edit-v2/1210482714?draftShareId=8f69a08f-5544-476a-b87e-923dc2810a50#Configuration-of-a-linear-channel-(first-time-use)
Access
There are several permissions required to be able to configure a new distribution channel for a linear agreement:
Channel Manager permission
Channel Manager - Distribution Channels permission
Conceptual flow
With each linear agreement that you make with a channel, you will need to go through the allotment flow. In case the distribution channel is configured to be a linear distribution channel, the flow for the allotment will work slightly different compared to the normal allotment flow. However, the allotment still plays an important role.
In the flow diagram above you can see the different steps that need to be taken. The blue steps are user actions and the yellow steps are the automatic (behind-the-scenes) actions that follow from this action.
Important to realise is that in a linear agreement there are three different types of reservations that play an important role:
linear contracted rate reservation; this type of reservation is used to store the financial agreement, the amount that the channel will pay for keeping the inventory available to the channel (regardless the usage of these periods). It is also the starting point for the invoice generation. It does not hold availability and does overlap with the allotment reservation or guest reservation. It will not show in the planning chart.
Allotment reservation; this type of reservation is used to allocate the actual units/types for the distribution channel. An allotment reservation is visible in the planning chart but does not hold any financial information. It is holding the availability until a guest reservation is made, then it will go away (partially).
(guest) reservation; this is actually a normal reservation that holds the guest stay. Important for guest registration, arrivals, departure and housekeeping. Could also be used to charge the additional costs to the customer (if any, like linen). It will show on the planning chart and will replace the allotment reservation.
Creating a new agreement from start
Adding a new unit to the agreement
{todo}
Removing an existing unit from the agreement
{todo}
Shortening the period of an agreement (one or multiple units)
{todo}
Changing the payment terms
{todo}
Generating the invoice
{todo}
Configuration of a linear agreement - type-level
Prerequisites
{todo}
Access
{todo}
Creating a new agreement from start
{todo}
Adding a new unit to the agreement
{todo}
Removing an existing unit from the agreement
{todo}
Shortening the period of an agreement (one or multiple units)
{todo}
Changing the payment terms
{todo}
Generating the invoice
{todo}