> For the complete documentation index, see [llms.txt](https://docs.interaktifotel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.interaktifotel.com/en/help-and-reference/troubleshooting.md).

# Troubleshooting

## The room is clean but check-in says it is dirty

1. Compare the unit code in the error with the card. It may refer to another property or a linked bed.
2. Confirm the property and reservation.
3. Refresh and check the current cleaning label.
4. If the room is actually prepared, verify that saving Clean succeeded.
5. For early check-in, check for another stay between actual arrival and planned departure.
6. If the error persists, give your manager the unit code, planned dates, operation time and exact error text.

Do not duplicate the reservation or accidentally close another stay to bypass the error.

## An empty room cannot be selected

Check the full date range, rental mode, sales availability and parent/child unit reservations. Check for an active guest whose departure is overdue. A room being empty today does not mean it is available throughout the selected period.

## A reservation or note is missing

First check property, date, status, floor and search filters. For notes, also check archived items and load more. If the record is still missing, review notifications and, if authorized, System Logs.

## A report total differs from what I expected

Check the date range, currency, property and report type. Distinguish revenue from payments received and expenses from outgoing payments. Make sure an old advance payment was not recorded twice. Unallocated expenses affect unit-level comparisons; current physical definitions affect occupancy calculations.

## The check-out button is disabled

Wait for the folio to load and for service saving to finish. Confirm that the reservation is still checked in. If outstanding-balance acknowledgement is required, review the balances before accepting it.

## 3D View does not open

Use the retry option. If the browser cannot display the scene, use text-based unit selection or the Room Status Board. If only one property is affected, inspect its room and physical bed definitions.

## A document language is empty or PDF generation fails

Check that the selected language has a template title and body. For PDF errors, the administrator may need to check the server-side PDF component. Calendar/report browser printing is different from guest/document PDFs generated on the server.

## What should I include in a support request?

Provide the page name, property and unit code, operation time, expected result, actual result and error text. Hide unnecessary guest identity, contact and payment information in screenshots. Do not include your password.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.interaktifotel.com/en/help-and-reference/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.