Invoice Screen & Protect

Protection Types

There are 4 types of protections:

Basic Protection
Damage Waiver
Screen and Protect (S&P)
Standalone Protection

Invoicing Rules

Partners are invoiced each month for each approved or flagged verification with a checkout date in that invoicing month.
Damage Waiver is an exception: it is charged based on the month of creation rather than the checkout date.

Cancellation and Rejection Fees

All cancelled or rejected verifications are charged a cancellation or rejection fee of 0.25 (local currency).
If a verification is both cancelled and rejected, only one fee is charged (whichever occurred first):
- Cancellation fee is charged on the month of cancellation.
- Rejection fee is charged on the month of creation.

Flagged Verifications

Verifications flagged by Wilbur (is_flag_protected = false) will have a Flagged status.
Flagged verifications are charged the rejection fee of 0.25 on the month of creation.
Flagged verifications are not protected.

Special Rules for Damage Waiver

Damage Waiver is not refundable, meaning the fee is charged even if the booking is cancelled. If is rejected it means it was never charged, so it applies the rejection fee only.
Damage Waiver is not impacted by is_flag_protected. Verifications with is_flag_protected = false are still charged.

Fee Calculation

To calculate the nightly fee for each booking:

Join Protection Types with Price Tables:
- Match using id_currency and protection_amount.
Long-Stay vs. Short-Stay Fees:
- For bookings with number_of_nights > 30, use the long_stay_fee from the prices table.
- For shorter stays, use the short_stay_fee.

Discounts

Sales representatives can apply discounts to partners. Discounts are valid only during their active periods (based on start and end dates) and are categorized as follows:

Generic Discount:
- Applies to the whole account, excluding Damage Waiver.
- Configured with a start and end date.
Volume Discount:
- Applies based on the volume of approved or flagged bookings with a checkout date in that month. It doesn’t apply to Damage Waiver.
- Verifications flagged by Wilbur (is_flag_protected = false) will have a Flagged status but these don’t count towards the Volume Discount.

Total Fee Calculation:

First it applies the price increment and then the discount. For example:

booking_fee = 100
general_discount = 10
price_increase = 5
charged_fee = (100 * 1.05) * 0.90 = 94.5

Important Notes:

Damage Waiver is always excluded from discounts.
Only one discount can be applied to an account at a time. Discounts cannot coexist.

Price Increase

A Price Increase mechanism exists but is not currently in use. It may be implemented in the future.

Example

user	is_protected	monthly_volume_discount	threshold_approved_booking_volume	monthly_volume_discount_start_date_utc	monthly_volume_discount_end_date_utc	id_currency
joaquin_travel	TRUE	10	5	01/11/2024	30/06/2028	1

id_verification	protection_type	protection_starting_level	protection_basic_amount	protection_extended_amount	verification_status	checkin_date_utc	checkout_date_utc	number_of_nights	is_cancelled	cancelled_at_utc	cancelled_date_utc	creation_at_utc	creation_date_utc	cosmos_created_date_utc	nightly_fee	booking_fee	cancellation_fee	rejected_fee	discount_percentage	fee_amount	discount_amount	final_fee	invoice_month
1	DAMAGE WAIVER	[NULL]	5,000	[NULL]	FLAGGED	01/01/2025	15/01/2025	14	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ -	£ 30.00	£ -	£ -	10	£ 30.00	£ 3.00	£ 27.00	1
2	BASIC PROTECTION	[NULL]	500	[NULL]	APPROVED	01/02/2025	05/04/2025	63	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 1.75	£ -	£ -	£ -	0	£ 110.25	£ -	£ 110.25	4
3	DAMAGE WAIVER	[NULL]	5,000	[NULL]	APPROVED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ -	£ 30.00	£ -	£ -	10	£ 30.00	£ 3.00	£ 27.00	1
4	BASIC PROTECTION	[NULL]	500	[NULL]	APPROVED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 3.75	£ -	£ -	£ -	10	£ 15.00	£ 1.50	£ 13.50	1
5	DAMAGE WAIVER	[NULL]	10,000	[NULL]	APPROVED	01/01/2025	15/03/2025	73	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ -	£ 40.00	£ -	£ -	0	£ 40.00	£ -	£ 40.00	3
6	STANDALONE PROTECTION	500	[NULL]	5,000,000	APPROVED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 13.75	£ -	£ -	£ -	10	£ 55.00	£ 5.50	£ 49.50	1
7	SCREEN & PROTECT	[NULL]	500	100,000	APPROVED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 7.00	£ -	£ -	£ -	10	£ 28.00	£ 2.80	£ 25.20	1
8	SCREEN & PROTECT	[NULL]	250	5,000,000	REJECTED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ -	£ -	£ -	£ 0.25	0	£ 0.25	£ -	£ 0.25	12
9	SCREEN & PROTECT	[NULL]	500	100,000	REJECTED	01/03/2025	05/03/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ -	£ -	£ -	£ 0.25	0	£ 0.25	£ -	£ 0.25	12
10	SCREEN & PROTECT	[NULL]	250	1,000,000	APPROVED	01/01/2025	15/03/2025	73	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 5.25	£ -	£ -	£ -	10	£ 383.25	£ 38.33	£ 344.93	3
11	STANDALONE PROTECTION	250	[NULL]	5,000,000	FLAGGED	01/01/2025	10/01/2025	9	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 14.00	£ -	£ -	£ -	10	£ 126.00	£ 12.60	£ 113.40	1
12	BASIC PROTECTION	[NULL]	500	[NULL]	FLAGGED	01/01/2025	11/01/2025	10	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 3.75	£ -	£ -	£ -	10	£ 37.50	£ 3.75	£ 33.75	1
13	SCREEN & PROTECT	[NULL]	250	50,000	FLAGGED	01/02/2025	16/02/2025	15	TRUE	17/12/2024	17/12/2024	17/12/2024	01/01/2024	03/12/2024	£ -	£ -	£ 0.25	£ -	0	£ 0.25	£ -	£ 0.25	1
14	STANDALONE PROTECTION	250	[NULL]	5,000,000	APPROVED	01/01/2025	05/10/2025	277	TRUE	05/04/2025	05/04/2025	05/01/2025	01/01/2024	17/12/2024	£ -	£ -	£ 0.25	£ -	0	£ 0.25	£ -	£ 0.25	4
15	SCREEN & PROTECT	[NULL]	500	1,000,000	APPROVED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 11.00	£ -	£ -	£ -	10	£ 44.00	£ 4.40	£ 39.60	1
16	BASIC PROTECTION	[NULL]	500	[NULL]	APPROVED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 3.75	£ -	£ -	£ -	10	£ 15.00	£ 1.50	£ 13.50	1
17	SCREEN & PROTECT	[NULL]	5,000	50,000	FLAGGED	01/01/2025	09/01/2025	8	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 6.00	£ -	£ -	£ -	10	£ 48.00	£ 4.80	£ 43.20	1
18	SCREEN & PROTECT	[NULL]	5,000	50,000	APPROVED	01/01/2025	25/01/2025	24	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ 6.00	£ -	£ -	£ -	10	£ 144.00	£ 14.40	£ 129.60	1
19	DAMAGE WAIVER	[NULL]	250	[NULL]	FLAGGED	01/01/2025	05/01/2025	4	FALSE	[NULL]	[NULL]	01/01/2024	01/01/2024	17/12/2024	£ -	£ 15.00	£ -	£ -	0	£ 15.00	£ -	£ 15.00	1

14 KiB Raw Blame History Unescape Escape