For AI agents and developers

True cost of a crewed yacht charter: fee, charter VAT by cruising area, APA, delivery, local fees and crew tip.

• charterFee (required): Headline charter fee as quoted, excluding tax, in the quote currency.
• area: Cruising area: croatia (Croatia), greece (Greece), italy (Italy), france (France & Monaco), spain (Spain & Balearics), montenegro (Montenegro), turkey (Türkiye), bahamas (Bahamas), bvi (British Virgin Islands), usvi (US Virgin Islands).
• currency: Quote currency (ISO 4217). Defaults to the area's usual quote currency.
• days: Charter length in days.
• guests: Number of guests.
• taxRate: Charter tax rate in percent. Defaults to the cruising area's sourced rate; required where no reliable default exists.
• percentOutsideEu: For areas taxed pro rata by time in EU waters: % of charter time outside EU waters (must be provable).
• apaPercent: APA as % of the charter fee. Typical range 25–40%; the default of 30% is a modelling choice.
• tipPercent: Crew gratuity as % of the charter fee (MYBA guideline 5–15%).
• deliveryFee: Delivery or redelivery fee, taxed like the charter fee.
• perPersonPerDayFee: Local fee per guest per day (e.g. a cruising permit). Defaults to the area's sourced fee when quoting in USD, otherwise 0.
• otherCosts: Anything else outside the APA (flights, transfers, special requests).

Estimate UK VAT on one travel package under the Tour Operators’ Margin Scheme (TOMS), cost-based method.

• sellingPrice (required): Total price charged to the customer for the package, including any VAT.
• ukCosts: Bought-in margin scheme supplies enjoyed in the UK, at what you paid including VAT.
• nonUkCosts: Bought-in margin scheme supplies enjoyed outside the UK, at what you paid.
• inHouseCosts: Direct cost of in-house supplies (your own resources), excluding VAT you can reclaim.
• inHouseTreatment: VAT treatment of the in-house supplies under the normal rules.
• vatRate: VAT rate in percent for standard-rated elements. Defaults to the UK standard rate (20%).
• currency: Currency of the amounts (VAT returns are in sterling).

Turn supplier deposit, balance and cancellation terms into dated payment deadlines and cancellation charges.

• departureDate (required): Departure (or service start) date, YYYY-MM-DD.
• bookingDate: Booking date, YYYY-MM-DD.
• total (required): Total cost of the booking.
• currency: Currency of the amounts.
• depositType: Whether depositValue is a percentage of the total or a fixed amount.
• depositValue: Deposit due at booking (percent or amount; example default 25%).
• balanceDaysBefore: Balance due this many days before departure.
• instalments: Optional extra instalments as "daysBefore:percent" pairs, e.g. "120:25" (up to 6).
• clientBufferDays: Ask the client this many days before each supplier deadline.
• cancellation: Cancellation tiers as "daysBefore:percentForfeited" pairs (up to 8), e.g. "84:25,56:50,29:75,0:100".
• today: Reference date for flagging deadlines that have passed, YYYY-MM-DD.

Compare what a hotel keeps from OTA and direct bookings, and what shifting room nights to direct is worth.

• roomNights (required): Room nights sold per year, all channels.
• adr (required): Average daily rate (room revenue per occupied room night).
• currency: Currency of the amounts.
• nightsPerBooking: Average nights per booking (example default 2.5).
• otaSharePercent: Share of room nights booked through OTAs, %. Default: 22.2% (five-star hotels in Europe, 2023).
• otaCommissionPercent: OTA commission, % of booking value, including any visibility programme uplift. Typical 15–30%; the default of 18% is a modelling choice.
• otaPayment: 'ota' = prepaid to the OTA, which pays you net; 'property' = pay at hotel, you take the card payment.
• cardFeePercent: Card processing fee, % of the amount charged (example default 1.5%).
• cardFeeFixed: Card processing fee, fixed amount per booking (example default 0.2, in GBP).
• directDiscountPercent: Direct-booking rate discount (e.g. member rate), % off the ADR.
• bookingEnginePercent: Booking engine fee, % of direct booking value.
• marketingPercent: Metasearch, paid search and other marketing, % of direct booking value.
• directCostPerBooking: Fixed cost per direct booking (cost-per-click spend, per-booking engine fee, perk value).
• shiftPoints: Percentage points of room nights moved from OTAs to direct (example default 5).

Price a tour or experience: cost per guest by group size, break-even group size, net price for a target margin and the rack price after commission.

• fixedCostsPerDeparture (required): Costs paid once per departure whatever the group size (guide, vehicle, venue hire, permits), in total.
• variableCostsPerGuest (required): Costs paid for each guest (tickets, meals, tastings), in total per guest.
• overheadPerDeparture: Share of business overheads allocated to each departure.
• currency: Currency of the amounts.
• minGuests: Smallest group size to model.
• maxGuests: Largest group size to model.
• pricingGuests: Group size the suggested net price is based on.
• targetMarginPercent: Target margin, % of the net price you receive (default 30% is a modelling choice).
• commissionPercent: Commission the agent or OTA keeps, % of the public price (default 20% is a modelling choice; see sources for typical ranges).
• netPriceOverride: Your own net price per guest. 0 = use the suggested price.

Add up a luxury trip budget by category (stay, flights, transfers, guiding, dining, fees, insurance, gratuities, contingency).

• travellers: Number of travellers.
• nights: Number of nights.
• rooms: Number of rooms.
• currency: Currency of the amounts.
• roomRate: Accommodation per room per night, including taxes and service charges.
• flightPerPerson: Return flights per person.
• transfersTotal: Transfers for the whole party.
• guidingPerDay: Private guiding and experiences per day, for the whole party.
• guidingDays: Days with private guiding or experiences (capped at nights + 1).
• diningPerPersonPerDay: Dining and drinks per person per day, counted for each night.
• feesPerPerson: Park, permit and entry fees per person, whole trip.
• insurancePerPerson: Travel insurance per person, whole trip.
• gratuitiesTotal: Gratuities for the whole trip.
• contingencyPercent: Contingency, % of every other cost (default 10% is a planning choice, not a benchmark).

Day-by-day jet lag plan: when to sleep, seek light and avoid light before and after a flight across time zones.

• homeTimeZone (required): IANA time zone at home, e.g. Europe/London.
• destinationTimeZone (required): IANA time zone at the destination, e.g. Asia/Dubai.
• departure (required): Departure, local time at home, YYYY-MM-DDTHH:MM.
• arrival (required): Arrival, local time at the destination, YYYY-MM-DDTHH:MM.
• bedtime: Usual bedtime at home, HH:MM (24-hour).
• wakeTime: Usual wake time at home, HH:MM (24-hour).
• preflightDays: Days before departure to start shifting sleep (0 = none; 2–3 suggested).
• strategy: Shift the body clock earlier (advance), later (delay), or let the planner choose (auto).
• caffeine: Include a daily caffeine cut-off.

Travel agent commission, host agency split, and markup vs margin for one booking.

• mode: commission = supplier pays a % of the selling price; net = you mark up a net rate.
• sellingPrice: mode=commission: the commissionable price the client pays.
• commissionPercent: mode=commission: commission as a % of the selling price. Default 10 is a modelling choice.
• netCost: mode=net: what the supplier charges you.
• targetBasis: mode=net: whether targetPercent is a margin (on price) or a markup (on cost).
• targetPercent: mode=net: target margin (max 95) or markup (max 1000) in percent.
• advisorSharePercent: Share of the commission or markup the advisor keeps after a host agency or consortium split; 100 = no split. Default 80 is a modelling choice.
• currency: Currency of the amounts.

Margin on a trip sold in one currency and paid for in another: at the quoted rate, the rate now and under scenario moves.

• supplierCost (required): Total supplier cost, in the supplier currency.
• supplierCurrency: Currency the supplier is paid in.
• clientPrice (required): Price agreed with the client, in the client currency.
• clientCurrency: Currency the client pays in.
• quotedRate (required): Rate used when quoting: units of supplier currency per 1 unit of client currency (e.g. 1.18 for 1 GBP = 1.18 EUR). Ignored when the currencies match.
• rateNow: Rate now, or the rate you expect to pay at, same convention. Defaults to quotedRate.
• depositPercent: Share of the supplier cost due as a deposit, %; the rest is the balance (example default 30%).
• depositDate: Deposit due date, YYYY-MM-DD (optional).
• depositFixedRate: Rate at which the deposit was paid or fixed; 0 = still open.
• balanceDate: Balance due date, YYYY-MM-DD (optional).
• balanceFixedRate: Rate at which the balance was paid or fixed; 0 = still open.
• lockedRate: Optional locked rate to compare for the open amount (e.g. a rate offered by your FX provider); 0 = none.
• scenarioMoves: Comma-separated % moves in the client currency, each applied up and down from the rate now (up to 6; example default "2,5,10").
• today: Reference date for days to each payment, YYYY-MM-DD.

Classify a UK trip as a package, a linked travel arrangement or neither under the Package Travel Regulations 2018.

• rules: Which rules apply, by the date the contract is concluded. "from-2027-04-06" applies the 2026 amendments (no linked travel arrangements).
• sameTrip: All the services are for the same trip or holiday.
• transport: Includes carriage of passengers (flight, train, coach, ferry, transfer).
• flight: The transport includes a flight (ATOL pointer). Ignored if transport is false.
• accommodation: Includes accommodation that is not part of the carriage and not residential.
• vehicleHire: Includes car, motor vehicle or motorcycle hire.
• otherTourist: Includes other tourist services (excursions, tours, tickets, ski passes, spa treatments).
• otherSignificant: The other tourist service is a significant proportion of the value (rule of thumb 25%+) or an essential feature. Only relevant with exactly one of transport, accommodation or vehicle hire.
• otherAfterStart: The other tourist service was selected and bought after the transport, stay or car hire had started (reg. 2(6)(b)).
• combination: How the services were put together. One of: single-contract, single-point-of-sale, inclusive-price, sold-as-package, gift-box, data-passed-24h, separate-payment-single-visit, targeted-link-24h, separately-booked.
• under24Hours: Covers less than 24 hours with no overnight accommodation (exclusion, reg. 3(2)(a)).
• notForProfit: Offered occasionally, not for profit, to a limited group (exclusion, reg. 3(2)(b)).
• generalAgreement: Bought under a general agreement for business travel (exclusion, reg. 3(2)(c)).