Skip to main content
Operations diventa utile quando tira i dati dal gestionale (pulizie da check-out, revenue soggiorni) invece di inserirli a mano. Il collegamento segue lo stesso principio di Kross: credenziali server-side, mapping listing→appartamento, verifica dal vivo.

​
Prerequisiti

  • Anagrafica appartamenti presente in Operations (o riconciliata dal registro).
  • Credenziali API del PMS dello studente (Hostaway account+key, o le 3 credenziali Kross).

​
Step (in ordine)

1

Anagrafica pronta

Gli appartamenti esistono in Operations (nome, costo/prezzo pulizia, tipo PM/SUB, fee%). Seed dal registro canonico, non re-inserire.
2

Credenziali PMS server-side

Env del PMS (es. HOSTAWAY_ACCOUNT_ID + HOSTAWAY_API_KEY, o le 3 credenziali Kross nel Vault). Mai lato client: l’app usa la service-role solo server-side.
3

Mappa listing → appartamento

Nel tab del PMS: collega ogni listing all’appartamento (link/crea/scollega). Il match si fa per nome interno (che coincide tra Notion/Conduit/PMS).
4

Importa pulizie & revenue

Anteprima pulizie da check-out → confermi (salta le esistenti). Sync revenue soggiorni (somma base rate per arrivo nel mese). Early/late check-in si tirano dai financeField della prenotazione.

​
Trappole note (Hostaway)

  • Filtro check-out: i parametri corretti sono departureStartDate / departureEndDate (gli altri vengono ignorati e tornano tutto).
  • Le fee (early/late, cleaning) stanno nei financeField, visibili solo su /reservations/{id}?includeResources=1, non nella lista.
  • Alcuni appartamenti non sono su Hostaway (sono su Kross): per il loro revenue serve l’altro PMS.

​
Come verificare (con test di connessione)

1

Test di connessione al gestionale

Dopo aver inserito le credenziali, lancia il test: deve tornare verde e leggere almeno un listing/una prenotazione reale.
2

Controllo su dati reali

Import pulizie: confronto “nostre vs PMS” nel tab (✓ = nostra, H = da PMS); l’import è cancellation-safe (rimuove le cancellate, non tocca le manuali). Revenue soggiorni: il totale sync deve avvicinarsi al gross atteso (base rate, non gross totale).
Da verificare (in corso). Stiamo testando che il collegamento Operations ↔ Kross funzioni per tutti gli studenti (non solo per chi è su Hostaway). Finché non è confermato su tutti: dopo ogni collegamento fai sempre il test di connessione + il controllo su dati reali sopra, e segnala se un caso non torna. Non dare per scontato che funzioni senza la verifica.
La chiave service-role dà accesso pieno al DB: tienila solo server-side su Vercel, mai nel client.
Fonti: memoria project_cosmica_dubai_operations (Hostaway sync, financeField, mapping), reference_operations_webinar_demo. Anagrafica: Notion, Anagrafica canonica.
▷ Prompt Claude Code: Collega il gestionale a Operations · incolla in Claude Code:

Operations (piattaforma)

Entra e apri il launcher Operations

Anagrafica canonica

Seed appartamenti (no duplicati)