Understanding the Fee Configuration Detector agent

The Fee Configuration Detector agent scans your fee configurations to identify setups that may create duplicated line items in your folios, ensuring your folio figures stay accurate.

The agent is a read-only tool. It surfaces misconfigurations in your fee setup and reports them, but never changes fee settings, creates fees, or modifies reservations.

Limitations

• The agent reviews fee setups only for account-level and property-level additional fees on active properties.
• It does not analyze individual reservations, money objects, or historical charges applied to guests.

Understand the Fee Configuration Detector agent

The Fee Configuration Detector agent runs automatically once a week on Mondays at 09:00. The agent can also be triggered manually.

During each run, the agent does the following:

1. Scans fee configurations across your account and properties.
2. Identifies fee configurations where a fee:
   • Is synced to the channel
   • Is deducted from the accommodation fare
   • Is NOT bundled in the accommodation fare
3. Detects instances where Guesty both pushes the fee to an OTA as a separate line item and deducts it from the accommodation fare, creating potential line-item duplication.
4. Generates a structured report listing account-level issues first, followed by property-level issues grouped by property.

Run the Fee configuration detector agent manually

In addition to the scheduled run, you can trigger the agent manually at any time from the Agents hub.

Step by step:

1. Sign in to your Guesty account.
2. In the side navigation menu, select Agents hub.
3. At the top, select the Finance tab.
4. Click the Fee Configuration Detector tile.
5. Under "When it runs", click Run now.

Review the results and status of the run in the activity feed.

Review the activity feed

Follow the steps below to review your activity feed.

Step by step:

1. Sign in to your Guesty account.
2. In the side navigation menu, select Agents hub.
3. In the left submenu, select Agent activity.
4. Click the relevant row with the agent's name to review the report details in the right-side panel.

Understand the report status and details

The report lists account-level issues first, followed by property-level issues grouped by property.

For each flagged fee, the report displays:

• The affected channel
• Where to resolve the fee setup (On the account or property level)

A fee/channel combination is flagged when all three of the following conditions are met:

1. The fee is synced to the channel (master sync is on, and the channel configuration is enabled)
2. The fee is deducted from the accommodation fare for that channel
3. The fee is not bundled into the accommodation fare for that channel

Review and act on flagged items

Use the generated report to locate and update any misconfigured fee setups.

Account-level fees can be adjusted directly within your Financials settings, while property-specific fees can be resolved by navigating directly to the relevant property page.

Learn more in our help center articles: 

• Additional fees: Creating and syncing with channels
• Including and deducting fees in the accommodation fare