Documentation

General supplements and discounts

Once you have the board and occupancy supplements and discounts, a new “base price” is considered on which apply the rest of supplements/discounts and frees. 

The main sub process consists:

  1. Check the valid general supplements and discounts
  2. Check the valid frees
  3. Check the combinable offers and frees
  4. Apply the selected records and calculate de price 

This section shows the way to apply the rest of general supplements and discounts. The different general supplements and discounts type’s codes are: 

Type

Description

B

Early Booking

K

Turbo Early Booking

U

Last minute

L

Long stay

M

Minimum stay

O

Operation days

E

Fixed stay

V

Arrival day

G

General

General supplement/discount types

This information is also in the CNSU structure. The record validation and check consists in:

  • Application dates
  • Rate
  • Room type
  • Room characteristic
  • Board
  • Passenger’s age
  • Operation day
  • Opaque indicator 

The record with the [CNSU.Opaque] value true must apply only when the service is for packaging. 

Except the supplement type G (General), if two or more records are valid with the same type [CNSU.Type], only one can be applied per pax and night. The selected record will be the most restrictive.

Early Booking – Type B 

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the day of the stay

Limit date

The booking date is earlier or equal than [CNSU.Limit date]

Days of advance

The booking date is earlier or equal than [CNSU.Number of days]

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed
  3. The earlier as possible
  4. The minimum and maximum age informed

 

Apply to:

The nights of stay which overlaps the supplement/discount

Early booking supplement/discount summary

Turbo Early Booking – Type K

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the day of the stay

Limit date

The booking date is earlier or equal than [CNSU.Limit date]

Days of advance

The booking date is earlier or equal than [CNSU.Number of days]

Days of stay

The length of stay is greater than [CNSU.Length of stay]

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed
  3. The [CNSU.Length of stay] with greater value
  4. The earlier as possible
  5. The minimum and maximum age informed

 

Apply to:

The nights of stay which overlaps the supplement/discount

Turbo early booking supplement/discount summary

Last Minute – Type U

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the day of the stay

Limit date

The booking date is greater or equal than [CNSU.Limit date]

Days of advance

The booking date is later or equal than [CNSU.Number of days]

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed
  3. The earlier as possible
  4. The minimum and maximum age informed

 

Apply to:

The nights of stay which overlaps the supplement/discount

Last minute supplement/discount summary

Long Stay – Type L

Application rules

Concept

Condition

Operation days

The supplement/discount dates cover all the days of the stay

Days of stay

The length of stay is greater than [CNSU.Length of stay]

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed
  3. [CNSU.Length of stay] with greater value
  4. The minimum and maximum age informed

 

Apply to:

All the nights of the stay

Long stay supplement/discount summary 

Minimum stay – Type M

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps some day of the stay

Days of stay

The length of stay is lower than [CNSU.Length of stay]

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed
  3. [CNSU.Length of stay] with lower value
  4. The minimum and maximum age informed

 

Apply to:

All the nights of the stay

Minimum stay supplement/discount summary

 

Operation dates – Type O

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the day of the stay

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed

 

Apply to:

The nights of stay which overlaps the supplement/discount

Operation dates supplement/discount summary

Fixed stay – Type E

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the travel start day

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed

 

Apply to:

Only the number of nights specified

Fixed stay summary

Arrival day – Type V

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the travel start day

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed

 

Apply to:

All the nights of the stay

Arrival day supplement/discount summary 

General – Type G

Application rules

Concept

Condition

Operation days

The supplement/discount dates overlaps the day of the stay

Application order

  1. [CNSU.Order] with lower value
  2. [CNSU.Rate] informed

 

Apply to:

All the nights of stay which overlaps the supplement/discount

General supplement/discount summary

General supplements/discounts price calculation

Once you have checked the general supplements/discounts and frees valid to apply, then you have to apply them in order to get the price.

The records must be processed by order [CNSU.Order].

Daily price

At this point you have to take in consideration the [CCON.Daily price] value. If true, then the first night’s price is the real price for all the night of the stay.

Example:

A 5 night’s service with a price per night 120, 120, 134, 134 and 110. The [CCON.Daily price] value is true. The price per night will be: 120, 120, 120, 120 and 120.

The application process depends on:

  • Amount or percentage
  • Is cumulative (*)
  • Is per pax or per service
  • Application type

Example:

Cumulative

Base price

Occupancy suppl/disc

Previous general suppl/disc

General suppl/disc

Is cumulative

Amount

100

20

40

10%

N

12

100

20

40

10%

Y

16

General supplement/discount valuation example

 

The different application type values are:

  • B – Base: Applied to base price [CNCT]
  • R – Board: Applied to board price [CNSR]
  • N – Night: Applied to base price + board price of the night
  • A – Absolute: Only in occupancy supplements and discounts
  • T – Only once: The same as type N but only the first night
  • U – Only once per period: The same as type T but the first night covering the stay
  • M – Absolute + Board: Only in occupancy supplements and discounts + board price of the night

Example:

Booking with 1 pax and 1 night

Standard capacity of the room 2

Concept

Amount

Is per pax

Is cumulative

Application type

Service

Pax

Base

Board

Base

Board

Base

100

Y

N

 

0

0

100

0

Board suppl/disc

20

Y

N

 

0

0

0

20

Occupancy suppl/disc [I]

60

Y

N

 

0

0

60

0

General suppl/disc type B

-10%

N

N

N

-16

-2

0

0

General suppl/disc type G

10%

Y

Y

N

-1.6

-0.2

16

2

General suppl/disc type G

10%

Y

N

N

0

0

16

2

TOTAL: 196.2

-17.6

-2.2

192

24

General supplement/discount valuation example

Example:

Booking with 2 pax and 1 night   

Standard capacity of the room 2

Concept

Amount

Is per pax

Is cumulative

Application type

Service

Pax

Base

Board

Base

Board

Base

100

Y

N

 

0

0

100

0

Board suppl/disc

20

Y

N

 

0

0

0

20

General suppl/disc type B

-10%

N

N

N

-20

-4

0

0

General suppl/disc type G

10%

Y

Y

B

-2

0

10

0

General suppl/disc type G

10%

Y

N

R

0

0

0

2

TOTAL: 238

-22

-4

220

44

General supplement/discount valuation example

Example:

Booking with 2 adults and 1 child, 1 night

Standard capacity of the room 2

Concept

Amount

Is per pax

Is cumulative

Application type

Service

Adult

Child

Base

Board

Base

Board

Base

Board

Base

100

Y

N

 

0

0

100

0

100

0

Board suppl/disc

20

Y

N

 

0

0

0

20

0

20

Occupancy suppl/disc [N]

-50%

Y

N

 

0

0

0

0

-50

0

General suppl/disc type B

-10%

N

N

N

-25

-6

0

0

0

0

General suppl/disc type G

10%

Y

Y

B

-2.5

0

10

0

5

0

General suppl/disc type G

10%

Y

N

R

0

0

0

2

0

2

TOTAL: 307.5

-27.5

-6

220

44

55

22

General supplement/discount valuation example

(*) Cumulative supplements (IsCumulative field)

This field defines if the calculation of discounts will be combined over the subtotal depending on the selected order.

►Example 1: Order with IsCumulative field to N

COST 100€/unit in DBL in BB (there are two discounts that can be applied in the same booking and IsCumulative field is N for both):

20170731:20201231:20170130::LES:L:N:N:0:N::-12.0:Y::::::::::6::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:
20170731:20201231:20170130::EBD:B:N:N:1:N::-10.0:Y:::::::::30:::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:

This means that both are applied independently without being accumulated in the valuation of the booking, this is, first is applied 12% of LES on the total base (100 €) and 10% of EBD on the total base (100 €) without being combined between them.

►Example 2: Order with IsCumulative field to Y

COST 100 € / unit in DBL on BB (there are two discounts that can be applied within the same booking and IsCumulative field is Y for both):

20170731:20201231:20170130::LES:L:N:N:0:N::-12.0:Y::::::::::6::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:
20170731:20201231:20170130::EBD:B:N:N:1:N::-10.0:Y:::::::::30:::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:

This means that a reservation that meets the conditions to apply both discounts Long Stay and Early Booking, first is applied 12% of LES on the total cost (100 €) and then 10% of EBD on the subtotal of the cost (88 €).

►Example 3: Order with some supplements/discounts with IsCumulative field to Y

20170731:20201231:20170130::SV:G:N:N:0:N:10::N::DBL:ST:::::::::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:
20170731:20201231:20170130::EBD:B:N:N:1:N::-10.0:Y:::::::::30:::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:
20170731:20201231:20170130::LES:L:N:N:2:N::-5.0:N::::::::::6::Y:Y:Y:Y:Y:Y:Y:0.000:0.000:

a) A booking with Sea View supplement and early booking discount: 10% EB will be applied over the 10 euros of Sea View Supplement since IsCumulative field is Y and it has into account the supplements/discounts with a previous order.

b) A booking with Sea View and Long Stay (LES): 5% LES discount will not be applied over the 10 euros of Sea View supplement since IsCumulative field is N.

c) A booking which applies Sea View, Early Booking and Long Stay (LES): -10% EB will be applied over 10 euro Sea View supplement but LES will be applied over the base price of the room.