---
agentTools:
  projectIndex: https://open-api-docs.guesty.com/llms.txt
---

# 2026-04-27

## Financials - 2026-04-27

*No breaking changes have been introduced to taxes; rather, the documentation now aligns with the actual product behavior.*

### Added

* Add pre-deduct commission support so you can configure automatic deduction behavior in commission settings (`PUT /channel-commissions-v2/account`, `PUT /channel-commissions-v2/listings`, `PUT /channel-commission/listings`, and `PUT /channel-commission/account`)
* Add optional `isUpsellFee` to requests for `POST /invoice-items/reservation/:reservationId`
* Add optional `realizationDates.items.from` and `realizationDates.items.to` to requests for `POST /invoice-items/reservation/:reservationId`
* Add optional `stayIndex `to requests for `POST /invoice-items/reservation/:reservationId`
* Add `DIRECT_SERVICE`, `GUESTY_BASIC_TRAVEL_COVERAGE`, `GUESTY_EXTENDED_TRAVEL_COVERAGE`, `GUESTY_SHIELD`, `PROPERTY_INSURANCE`, and `TOTAL_PAYOUT_BASED` enum values to `secondIdentifier` in requests for `POST /invoice-items/reservation/:reservationId`
* Support `parentInvoiceItemId`, `realizationDates[].from`, r`ealizationDates[].to`, and `stayIndex` in requests to `POST /price-adjustments/manual-total-amount` to allow richer mapping of manual total amount adjustments
* Support additional secondIdentifier values `DIRECT_SERVICE`, `GUESTY_BASIC_TRAVEL_COVERAGE`, `GUESTY_EXTENDED_TRAVEL_COVERAGE`, `GUESTY_SHIELD`, `PROPERTY_INSURANCE`, and `TOTAL_PAYOUT_BASED` in requests to `POST /price-adjustments/manual-total-amount`
* Support additional `normalType` values `MAR` and `MARF` in requests to `POST /price-adjustments/manual-total-amount`
* Return optional `parentInvoiceItemId`, `realizationDatesRange`, and `stayIndex` fields in `200` responses from `GET /price-adjustments/total-amount/:id` for better visibility into item-level adjustment context
* Add optional request property `channelOverrides` to `POST /taxes` and `PATCH /taxes/:id`
* Add optional request property i`sInclusive` to `POST /taxes` and `PATCH /taxes/:id`
* Add optional query parameter `applyRequiredChangesToTaxesWithSameType` to `PATCH /taxes/:id`
* Add optional response property `channelOverrides` to `POST /taxes`, `PATCH /taxes/:id`, `GET /taxes/account`, `GET /taxes/unit-type/:id`, and `GET /taxes/unit-type/:id/actual`
* Add optional response property `isInclusive` to `POST /taxes`, `PATCH /taxes/:id`, `GET /taxes/account`, `GET /taxes/unit-type/:id`, and `GET /taxes/unit-type/:id/actual`
* Expand supported request enum values for `appliedOnFees/items` in `POST /taxes` and `PATCH /taxes/:id` to include many additional fee types (for example: `ACTIVITIES`, `ADDITIONAL_BED`, `BOOKING_FEE, CLEANING`, `PARKING, POOL_HEATING`, `RESORT`, `WIFI`, `WOOD`, and others)

### Changed

* Restrict `appliedOnFees/items` to enum values in `POST /taxes and PATCH /taxes/:id`
* Restrict `conditionalOverrides.rules[].dateRange.from` and `conditionalOverrides.rules[].dateRange.to` to `MMDD_DATE_FORMAT_REGEX` in `POST /taxes` and `PATCH /taxes/:id`
* Add `vrboLite` as a possible response enum value for `appliedByDefaultOnChannels/items` in `POST /taxes`, `PATCH /taxes/:id`, `GET /taxes/account`, `GET /taxes/unit-type/:id`, and `GET /taxes/unit-type/:id/actual`
* Expand the supported `commission.of` values by adding `DIRECT_SERVICE`, `GUESTY_BASIC_TRAVEL_COVERAGE`, `GUESTY_EXTENDED_TRAVEL_COVERAGE`, `GUESTY_SHIELD`, `PROPERTY_INSURANCE`, and `TOTAL_PAYOUT_BASED` in update payloads for `PUT /channel-commission/account`, `PUT /channel-commission/listings`,  `PUT /channel-commissions-v2/account`, and `PUT /channel-commissions-v2/listings`
* Relax validation by making tax optional for payloads used by `PUT /channel-commissions-v2/account` and `PUT /channel-commissions-v2/listings`
* Allow commission tax to be omitted when it is not relevant in channel commission updates (`PUT /channel-commissions-v2/account`, `PUT /channel-commissions-v2/listings`)
* Improve consistency of channel commission update inputs to make account and listing updates more predictable (`PUT /channel-commissions-v2/account`, `PUT /channel-commissions-v2/listings`).
* Make `realizationDates.items.date` optional in requests for `POST /invoice-items/reservation/:reservationId`
* Allow `priceAdjustments[].realizationDates[].date` to be omitted in requests to `POST /price-adjustments/manual-total-amount` when using range-based realization dates (`from`/`to`)

### Removed

* Remove channel enum values `agoda`, `airbnb`, `bookingCom`, `bookingPal`, `expedia`, `homeAway`, `homeaway2`, `rentalsUnited`, `siteMinder`, and `tripAdvisor` from request property `appliedByDefaultOnChannels/items` in `POST /taxes` and `PATCH /taxes/:id`