> ## 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.

# Reconciliation: PMS e abbinamento

> Come il tool prende le prenotazioni da KrossBooking, con quali credenziali, e le regole con cui abbina gli incassi Booking, Airbnb e Stripe ai movimenti bancari.

## Il PMS supportato

Oggi il tool parla **solo con KrossBooking**. Non c'è un adattatore per Hostaway o altri PMS: uno studente su un altro gestionale può usare il tool solo per i movimenti bancari, senza abbinamento.

## Da dove prende le credenziali Kross

Dalla **Mattone Platform**, non da un form nel tool. La platform conserva per ogni studente la terna Kross (hotel, utente, password) usata anche da Conduit; il tool la chiede alla platform con una firma fra servizi e la tiene in memoria 5 minuti. Lo studente **non inserisce nulla** nel tool: se Kross è collegato sulla platform, funziona anche qui.

**È il flusso attivo in produzione dal 5 settembre 2026**, da entrambi i lati: il tool in produzione espone la lettura dello stato credenziali e la platform risponde all'indirizzo che il tool interroga. Se una sincronizzazione dice «non collegato», il posto dove guardare è il collegamento KrossBooking sulla platform, non il tool.

Per casi residui esiste un **ripiego**, usato solo quando la platform non ha una credenziale utilizzabile. **Non c'è un form nel tool per impostarlo**: lo può fare solo il team Mattone. Se non c'è né la platform né il ripiego, la sincronizzazione risponde «non collegato» e rimanda a collegare KrossBooking sulla platform.

<Warning>
  Le chiamate a Kross partono dall'indirizzo del server del tool, che deve essere nella **lista IP autorizzata** della chiave partner Mattone. Il filtro IP non si spegne mai: vedi [KrossBooking, filtro IP e trappole](/integrazioni/kross/rate-limit-trappole). Un errore HTTP 400 con «not allowed» è il filtro IP, non le credenziali.
</Warning>

## Cosa importa da Kross

Le **prenotazioni** del periodo scelto (con l'esito per proprietario), una riga per codice prenotazione: ricaricare lo stesso periodo non duplica. La chiamata ai payout Kross serve solo a recuperare il nome della stanza: **gli importi dei payout Booking non vengono presi da Kross**, ma dai movimenti bancari e dai file di payout caricati.

## Come abbina gli incassi

Quando lanci la riconciliazione dall'app, il tool guarda **solo i movimenti in entrata** e li classifica dalla descrizione bancaria:

| Canale | Riconosce il movimento se | Come abbina |
| - | - | - |
| **Booking** | la descrizione contiene `booking.com` | prima cerca un payout Booking con **stesso importo e stesso riferimento**; se non c'è, cerca la **combinazione di prenotazioni** la cui somma dà esattamente l'importo del bonifico (vedi sotto) |
| **Airbnb** | descrizione o riferimento contengono `airbnb` | cerca un payout Airbnb con importo uguale (±1 centesimo) e data di payout **non successiva** al movimento |
| **Stripe** | descrizione contiene `stripe` | somma i pagamenti Stripe dello stesso versamento automatico, finestra da 60 giorni prima a 30 dopo, tolleranza 5 centesimi |

Ogni movimento riceve uno stato:

* **Matched**: la somma delle prenotazioni abbinate torna col bonifico (differenza ≤ 5 centesimi).
* **Partial**: abbinato ma la differenza è sopra i 5 centesimi. Tipico di un rimborso o di una commissione non prevista: va guardato a mano.
* **Unmatched**: nessuna prenotazione trovata.
* **Ignored**: lo hai escluso tu a mano.

### La combinazione di prenotazioni, per Booking

Un bonifico Booking senza payout dedicato viene ricostruito cercando quali prenotazioni, sommate, danno esattamente quella cifra. Tre cose da sapere, perché spiegano quasi tutti gli Unmatched:

* **Si parte dagli importi che Booking stessa dichiara** nel resoconto fatture caricato nel tool. Le prenotazioni prese da KrossBooking sono il **ripiego**, usato solo quando quel resoconto non basta a far tornare la somma. Se il resoconto Booking non è stato caricato, il tool lavora già in ripiego.
* **Guarda al massimo 30 prenotazioni** per volta, le più recenti. Un bonifico che raggruppa più soggiorni di così non viene ricostruito, anche se la combinazione esiste.
* **Si ferma sopra i 100.000 €**: bonifici più grandi non vengono scomposti.

### Il nome dell'ospite

Il confronto per somiglianza fra nomi, che si vede sui pagamenti Stripe, **non serve ad abbinare il bonifico**: quello si abbina per importo e data. Il nome serve dopo, per collegare il singolo pagamento alla prenotazione giusta e riempire le righe di dettaglio. Un nome scritto male sposta i dettagli, non lo stato del movimento.

## Cosa resta fuori, e perché

* **Le uscite non vengono mai riconciliate**: nessuna uscita riceve uno stato o delle righe proprie. Una sola eccezione, e in sola lettura: gli **addebiti di commissione verso Booking.com** vengono guardati per sapere quanta commissione è stata pagata su ogni struttura, e serve solo a far tornare i conti dei bonifici in entrata.
* **Incassi non da canale** (bonifici diretti, giroconti, fatture): restano fra i movimenti, non entrano nella riconciliazione.
* Un movimento Booking la cui descrizione **non contiene** `booking.com` (alcune banche accorciano) finisce fuori canale: in quel caso mappa come descrizione la colonna completa dell'export.

<Warning>
  **La riconciliazione si lancia solo dall'app.** È l'unica via che applica il filtro sulle entrate, ed è quella che devi usare sempre. Se vedi un addebito comparire fra i movimenti da riconciliare, non è normale: segnalalo al team invece di sistemarlo a mano.
</Warning>

## Cosa prova che sta funzionando

Sul tenant Cosmica, da gennaio a maggio 2026, gli incassi Booking, Airbnb e Stripe sono stati abbinati quasi tutti (una manciata di Partial al mese, 1-2 Unmatched su centinaia). Se sul tuo tenant vedi molti Unmatched, prima di pensare a un bug controlla: periodo Kross sincronizzato che copre i soggiorni (i bonifici arrivano settimane dopo), payout caricati, descrizioni bancarie complete.


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