Guides

Valid Enumerations

Tables of valid values for enumerations.

Suggest Edits

📘

Note

Additional tables will be added over time. Until then, please don't treat this document as a comprehensive source of all enumerations utilized throughout Guesty.


Financials


Channel Commission Sources

Channel commission sources and their supported configurations. The calculation is based on the accommodation fare or cleaning fee or both. See the endpoint for more.


Channel SourceSet CommissionSet TaxPre-deduct optionApplies to
airbnb2----
tripAdvisor----
bookingCom-✓--
hopper-✓--
manual✓✓✓fareAccommodation, fareCleaning
homeaway2 (Vrbo)✓✓-fareAccommodation, fareCleaning
expedia✓✓✓fareAccommodation, fareCleaning

Rentals United

Channel SourceSet CommissionSet TaxPre-deduct optionApplies to
rentalsUnited✓✓-fareAccommodation, fareCleaning
agoda✓✓-fareAccommodation, fareCleaning
bookingCom✓✓-fareAccommodation, fareCleaning
despegar✓✓-fareAccommodation, fareCleaning
expedia✓✓-fareAccommodation, fareCleaning
hostelWorld✓✓-fareAccommodation, fareCleaning
homeaway✓✓-fareAccommodation, fareCleaning

📘

Note

Airbnb, Booking.com, Hopper and TripAdvisor utilize a channel collect model. They collect the commission, and send the values to Guesty.


Tax Types

All taxes can be calculated per NIGHT or GUEST or STAY or PER_GUEST_PER_NIGHT, and can be a FIXED or PERCENTAGE based amount. Only percentage-based taxes can be calculated off a single fee or all fees, or a combination of the accommodation fare, cleaning fee and other additional fees.

This table lists the taxes that can be created and defined on your Guesty account.


TitleNormal Type
CITY_TAXCT
COUNTY_TAXCOT
GOODS_AND_SERVICES_TAXGST
HARMONIZED_SALES_TAXHST
HOME_SHARING_TAXHSHAT
LOCAL_TAXLT
MINIMUM_ALTERNATE_TAXMAT
OCCUPANCY_TAXOCT
STATE_TAXST
TRANSIENT_OCCUPANCY_TAXTOT
TOURISM_TAXTT
VATVAT
OTHERTAX

Payment Methods

The following table lists the available payment methods for recording external guest payment transactions only. That is, it excludes the integrated payment processor methods available in Guesty.


MethodID
BANK_TRANSFER5dee4ebd32acdf7051cd6ed6
CASH589894a91d756b9c47ce1e87
CHECK58a1930e85e33bd55ec5c8c8
CREDIT58a1930e85e33bd55ec5c8c3
CREDIT_NOTE58a1930e85e33bd55ec5c8c6
DEBIT58a1931c85e33bd55ec5c8c4
ECHECK58a1932b85e33bd55ec5c8c5
VOUCHER58a1930e85e33bd55ec5c8c7
OTHER58a1930e85e33bd55ec5c8c9

Supported Currencies

This table shows Guesty's supported currencies and their ISO 4217 alphabetic codes.


CodeCurrency
USDUS Dollar
EUREuro
AUDAustralian Dollar
CADCanadian Dollar
JPYJapanese Yen
ILSNew Israeli Shekel
GBPGreat British Pounds
HKDHong Kong Dollar
NOKNorwegian Krone
CZKCzech Koruna
BRLBrazilian Real
CHFSwiss Franc
THBThai Baht
ZARSouth African Rand
MYRMalaysian Ringgit
KRWSouth Korean won
IDRIndonesian Rupiah
PHPPhilippine peso
INRIndian rupee
NZDNew Zealand Dollar
TWDNew Taiwan dollar
PLNPolish Zloty
SGDSingapore Dollar
TRYTurkish lira
SEKSwedish Krona
VNDVietnamese dong
ARSArgentine Peso
CNYChinese Yuan
DKKDanish Krone
MXNMexican Peso

Guest Invoice Normal Types

Reservation fees are classified by Guesty according to their normalType specification. This following tables list all the normalType values for fees and taxes.


Invoice Items

Normal TypeNameDescription
AFAccommodation fare / Net rental incomeThe initial accommodation fare total of the nightly rates.
AFDAccommodation fare discountUsed to discount the initial accommodation fare amount on an existing booking.
AFAAccommodation fare adjustmentUsed to make an adjustment to the accommodation fare on an existing booking.
AFEAdditional feeThe category for all additional fees. See Predefined Additional Fees.
AFEDAdditional fee deductionDeduction of an additional fee from the accommodation fare. See here for more information.
AFOAccommodation fare (owner reservation)Accommodation fare on an owner's reservation.
ARCAirbnb Resolution CenterAirbnb Resolution Center transaction.
CFCleaning feeThe cleaning fee.
CFECancelation feeThe payment due on a cancelled booking when applicable.
CMHost Channel Fee / Channel Commission
COCoupon (Revenue Management)Used with the reservation quote flow and needs to be applied to the reservation creation request.
GCDGeneric channel discountMust be a negative amount.
LOSDLength of stay discountMust be a negative amount
PCMPrededucted Host Channel Fee / Channel CommissionMust be a negative amount.
PFPet feeThe pet fee.
PROPromotion (Revenue Management)
AFWDAccommodation Fare Weekly DiscountThe weekly length-of-stay discount.
AFMDAccommodation Fare Monthly DiscountThe monthly length-of-stay discount.
MARMarkupsThe markup is applied according to the booking source.
MARDMarkdownThe markdown is applied according to the booking source.
COCoupon (Legacy)Used with reservations v1.
CMHost Channel Fee / Channel Commission
SDCSecurity deposit charge
TAXDAF Deduction of Taxes (Airbnb)When electing to display Airbnb remitted taxes. See here for more details.

Tax Types

Use this table to help classify or map specific taxes on the guest invoice of a reservation (money.invoiceItems).


Normal TypeTitleDescription
AGSTGOODS_AND_SERVICES_TAXAirbnb VAT/GST Tax
ASTSALES_TAXAirbnb sales tax?
ATTTOURIST_TAXAirbnb Tourist Tax.
COTCOUNTY_TAX
CTCITY_TAX
GSTGOODS_AND_SERVICES_TAX
HSHATHOME_SHARING_TAX
HSTHARMONIZED_SALES_TAX
HTHOTEL_TAXAirbnb hotel tax.
LGTLODGING_TAXAirbnb lodging tax.
LTLOCAL_TAX
MATMINIMUM_ALTERNATE_TAX
OCTOCCUPANCY_TAX
RTROOM_TAXAirbnb room tax.
STSTATE_TAX
TAFTOURISM_ASSESSMENT_FEEAirbnb tourism assessment fee.
TOTTRANSIENT_OCCUPANCY_TAX
TRTTOTAL_RESERVATION_TAXESExpedia total reservation taxes.
TTTOURISM_TAX
TTHTAX_TO_HOSTAirbnb tax paid to host
VATVAT
TAXOTHER

Updated about 2 months ago