> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Quando il gestionale non sa dire se un appartamento è libero

> L'assistente non indovina: dichiara che non può stabilire se la casa è libera. Ma poi la cosa si ferma lì e nessuno lo sa. Ecco come si diagnostica, cosa si scrive allo studente, e come si chiude senza aspettare una conferma.

Ogni tanto il gestionale risponde con una disponibilità **incompleta**: copre solo una parte delle notti chieste, o restituisce un intervallo che non comprende la data. In quel caso l'assistente **non tira a indovinare**: dichiara che non è in grado di stabilire se la casa è libera o occupata.

<Note>
  **È il comportamento giusto**, ed è voluto. Dire a un ospite «è libero» quando non lo sappiamo produce una prenotazione doppia; dire «è occupato» perde una notte venduta. Meglio non sapere che dire una cosa falsa.
</Note>

<Warning>
  **Il problema è quello che succede dopo: niente.** Il messaggio resta nei log, lo studente non sa che sul suo appartamento c'è un buco, e l'assistente continua a non poter rispondere per giorni.

  Caso reale: **Villanova Suite** di **Soliséra**, prima rilevazione **7 settembre 2026**. Due giorni dopo era ancora così, e nessuno se n'era accorto.
</Warning>

## Il processo

<Steps>
  <Step title="1 · Capisci di chi è l'appartamento">
    Il nome nel messaggio è quello che vede l'ospite. Cercalo nell'**anagrafica appartamenti** per risalire allo studente: i nomi nel gestionale sono spesso diversi (Villanova Suite in anagrafica è `SUIVILLANOVA`).

    ⚠️ Non fidarti dell'identificativo tecnico che compare nel log per capire di chi è: risale a un'altra cosa. **L'anagrafica è la fonte.**
  </Step>

  <Step title="2 · Diagnostica PRIMA di scrivere">
    Scrivere «c'è un problema, controlla il tuo gestionale» fa perdere tempo a entrambi. Prima si guarda, in quest'ordine:

    1. **Il calendario di quella casa è aperto su quelle date?** È la causa più comune quando l'intervallo restituito non le comprende.
    2. **Il piano tariffario copre quel periodo?** Un piano che finisce prima produce esattamente questa risposta.
    3. **L'appartamento è pubblicato sul modulo di prenotazione online?** È lo stesso modulo che blocca le tariffe quando è spento. → [Numeri e collegamento Kross](/integrazioni/kross/panoramica)

    Il messaggio allo studente parte solo dopo, e dice **quale delle tre**.
  </Step>

  <Step title="3 · Scrivi allo studente, non all'ospite">
    L'ospite non deve sapere che è successo qualcosa: per lui la conversazione prosegue normalmente. Allo studente va **una cosa sola e precisa**: quale appartamento, quali date, cosa manca.

    Corto e umano, non un rapporto. Il senso è: «su questa casa il gestionale non ci sta dando la disponibilità per queste date, sembra sia X, puoi sistemarlo?».
  </Step>

  <Step title="4 · Chiudi rifacendo la domanda, non aspettando la conferma">
    🔴 È il passaggio che rende questa casistica diversa dalle altre. **Non si aspetta che lo studente scriva «fatto»**: si rifà la domanda al gestionale, e se torna una disponibilità completa la voce si chiude da sola.

    Se non torna, la voce **resta aperta** e risale. Così la chiusura dipende dal fatto che il dato ci sia, non dal fatto che qualcuno dica di averlo sistemato.
  </Step>
</Steps>

## Cosa non si fa

* **Non si indovina**, in nessun caso, nemmeno se «probabilmente è libero».
* **Non si chiude la voce** perché lo studente ha risposto che ha sistemato: si verifica.
* **Non si insiste con l'ospite** chiedendogli di riprovare più tardi senza aver aperto la voce: il problema non è suo e non si risolve da solo.

<Note>
  **Se il cliente ha una chiave sua** — come Soliséra o SevenHome — le chiamate di verifica consumano **il limite del cliente**, non il nostro. Dieci al minuto per struttura, condivisi con i suoi lavori automatici. Quindi la verifica si fa **una volta**, non in ciclo. → [Rate limit e trappole](/integrazioni/kross/rate-limit-trappole)
</Note>

## Da confermare alla prima esecuzione

Su Villanova Suite **la causa non è ancora stata accertata**: dal messaggio si sa solo che il gestionale ha restituito un intervallo che non copriva la notte richiesta. Alla prima diagnosi vera, **annota qui quale delle tre cause era**: dopo due o tre casi si saprà qual è quella ricorrente, e il messaggio allo studente diventerà un modello invece di un'indagine.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.