Integrazioni e distribuzione

VIVIN collega il tuo portafoglio ai luoghi in cui affitti le stanze, al software che emette le tue fatture e alle serrature delle tue porte. Questa pagina spiega ogni tipo di integrazione, cosa fa per te e dove si configura.

Dove trovarlo: Impostazioni → Integrazioni (https://platform.vivin.app/settings/integrations). I Super amministratori e gli Amministratori hanno accesso per impostazione predefinita. Colleghi le unità alle piattaforme una per una in Vendite → Gestore canali o nell'editor dell'unità in Annunci. Per i campi di ogni scheda, vedi Impostazioni → Integrazioni.

Le integrazioni in sintesi

Tipo	Integrazioni	Dove si configura	Cosa ottieni
Piattaforme di prenotazione a medio termine	Inlife, Uniplaces, Spacest, Spotahome, Housing Anywhere, Erasmus Life Lisboa	Schede di Piattaforme di prenotazione, poi collega ogni unità	Annunci e disponibilità pubblicati sulla piattaforma. Prenotazioni create in VIVIN
Canali a breve termine	Airbnb, Booking.com	Un account del canale in Integrazioni piattaforma, oppure un link al calendario per unità	Sincronizzazione in entrambe le direzioni di prezzi, disponibilità e prenotazioni, oppure importazione in una sola direzione delle date bloccate
Il tuo sito web	Motore prenotazioni VIVIN	Scheda di Piattaforme di prenotazione	Prenotazioni dirette create in VIVIN
Altre fonti di prenotazione	Idealista, Edu Portugal, Coliving, SRF (Student Room Flat)	Schede di Piattaforme di prenotazione	Commissione (e margine, tranne per Edu Portugal) sulle prenotazioni che aggiungi a mano. Idealista riceve anche un file degli annunci ogni ora
Fatturazione	Invoice Express, Hostkit, Fatturazione VIVIN, NetSuite, A-Cube (fatturazione elettronica), Sage 50c	Integrazioni piattaforma	Fatture, ricevute e note di credito emesse al posto tuo
Serrature smart	Account Nuki	Integrazioni piattaforma	Accesso alle porte per gli inquilini
Pagamenti degli inquilini	EasyPay (carta e IBAN virtuale)	Configurato da VIVIN	Pagamenti online registrati sul piano di pagamento
Client IA	Claude, ChatGPT, Gemini e altri client MCP	Impostazioni → IA / MCP	Il tuo strumento IA può leggere i tuoi dati VIVIN

Come si incastrano i pezzi

Il collegamento a una piattaforma di prenotazione ha tre livelli, dall'account fino a ogni annuncio:

Livello	Cosa decide	Dove lo imposti
Account	Quali piattaforme usi. Le piattaforme di prenotazione sono attive per impostazione predefinita e solo quelle attive hanno una colonna in Vendite → Gestore canali.	Una scheda per piattaforma in Piattaforme di prenotazione
Unità	Quali unità riceve la piattaforma. Su Uniplaces, Spotahome, Housing Anywhere, Inlife e Idealista il feed contiene tutte le unità, a meno che tu non le escluda (le unità delle proprietà archiviate sono escluse); collegare un'unità al suo annuncio esistente abbina i due. Su Spacest ed Erasmus Life Lisboa, solo le unità che colleghi.	Annunci nelle integrazioni dell'unità e i link dell'unità
Contenuto dell'annuncio	Cosa dice e mostra l'annuncio. Le piattaforme che pubblicano annunci completi (Uniplaces, Spotahome, Housing Anywhere, Inlife, Idealista) e il Motore prenotazioni VIVIN richiedono descrizioni, servizi e foto; la scheda Prontezza per la full integration mostra cosa manca.	Le schede Integrazione completa e Foto degli editor di proprietà e unità

Piattaforme di prenotazione a medio termine

Clicca sulla scheda di una piattaforma in Piattaforme di prenotazione per aprirla, poi clicca su Modifica:

• Commissione e IVA sulla commissione contengono la tariffa della piattaforma. Le prenotazioni della piattaforma le mostrano come Commissione stimata della piattaforma. Non vengono registrate nei flussi di cassa.
• Blocco calendario (giorni): se l'ultimo soggiorno o blocco di un'unità finisce a più di questo numero di giorni da oggi, la piattaforma vede l'unità come non disponibile anche dopo quella data. Così la piattaforma non vende date troppo lontane nel futuro.
• Email integrazione è l'indirizzo email del tuo account sulla piattaforma. Dice alla piattaforma quali annunci sono tuoi.
• Margine (Nessuno, Percentuale (%) o Fisso) aumenta l'affitto per questa piattaforma. Cambia sia il prezzo che la piattaforma mostra sia l'affitto delle prenotazioni che arrivano da lì.
• IBAN virtuale (Copia IBAN) compare quando VIVIN ne ha emesso uno per la piattaforma. Daglielo per i suoi pagamenti, così VIVIN può abbinare il denaro in arrivo.
• Il pulsante (i) accanto al nome della piattaforma (per esempio Cosa supporta Uniplaces) elenca i campi dell'annuncio che la piattaforma riceve.

L'icona del cestino su una scheda disattiva la piattaforma e ne conserva i valori. Per riattivarla, clicca su Aggiungi in Integrazioni piattaforma e scegliila nel gruppo Piattaforme di prenotazione. Puoi aggiungere ogni piattaforma una sola volta.

Collega ogni unità in uno di questi due posti:

• Annunci → apri l'unità → Configurazione → Canali → Aggiungi URL annuncio sulla riga della piattaforma.
• Vendite → Gestore canali → clicca sulla cella Nessuna integrazione dell'unità → incolla l'URL completo dell'annuncio in Link dell'annuncio (un ID annuncio da solo non viene accettato) → Integra.

Per ogni unità nel feed di una piattaforma:

• VIVIN pubblica l'affitto, le spese, il deposito, le regole di soggiorno e le date non disponibili dell'unità. Ogni piattaforma legge questi dati con i suoi tempi, quindi una modifica può impiegare un po' ad apparire lì.
• Quando un inquilino prenota sulla piattaforma, VIVIN crea la prenotazione con un piano di pagamento costruito a partire dall'affitto, dalle spese dell'unità e dai valori predefiniti del tuo account. Ricevi una notifica quando la prenotazione viene creata. Ne ricevi una anche quando non può essere creata, per esempio perché le date si sovrappongono a un'altra prenotazione. Aggiungi quella prenotazione a mano.
• Per escludere un'unità da una sola piattaforma, apri la scheda Integrazione completa dell'unità e disattiva la piattaforma in Annunci nelle integrazioni (Escluso dal feed).

Le prenotazioni di Uniplaces, Spotahome, Housing Anywhere e Spacest arrivano in VIVIN tramite l'email di conferma della piattaforma:

• Inoltra ogni conferma all'indirizzo per le prenotazioni che VIVIN ti dà all'onboarding (se non lo hai, chiedilo tramite Aiuto e supporto). Una regola di inoltro automatico nella tua casella di posta è il modo più affidabile.
• VIVIN trova l'unità dall'ID annuncio della piattaforma presente nell'email. Collega prima l'unità a quell'annuncio: se l'ID annuncio non è collegato a un'unità, nessuna prenotazione viene creata. Ricevi un avviso che spiega come collegarlo quando l'email è stata inoltrata da uno degli indirizzi dei tuoi utenti o inviata alla tua Email integrazione per quella piattaforma.
• Vengono importate solo le prenotazioni confermate. Richieste, rifiuti, cambi di data, annullamenti e messaggi vengono ignorati, quindi accetta prima la richiesta sulla piattaforma.
• Una conferma che fallisce non viene riprovata. Correggi la causa (per esempio, libera le date), poi aggiungi la prenotazione a mano con quella piattaforma come Piattaforma e con ciò che l'inquilino ha pagato lì come Importo primo pagamento.

Idealista: quando VIVIN ha configurato la consegna con te, VIVIN invia a Idealista tutte le tue unità attive come file ogni ora, senza collegare le unità. Le prenotazioni di Idealista, Edu Portugal, Coliving e SRF (Student Room Flat) si aggiungono a mano: scegli la piattaforma come origine della prenotazione. Alcuni partner si collegano a un unico account di proprietario e non hanno una scheda. VIVIN li configura per te.

Airbnb e Booking.com

Ogni unità si sincronizza con Airbnb o Booking.com in uno di due modi: una Integrazione completa, con prezzi, disponibilità e prenotazioni in entrambe le direzioni tramite un account del canale in Integrazioni piattaforma, oppure un Link del calendario (iCal), che importa soltanto le date bloccate dal canale. Le prenotazioni di un'integrazione completa rispecchiano il canale, quindi le loro date, unità e inquilino si cambiano lì, non in VIVIN. Per i passaggi di configurazione e cosa importa ciascun modo, vedi Airbnb e Booking.com.

Motore prenotazioni VIVIN

La scheda Motore prenotazioni VIVIN collega il motore di prenotazione del tuo sito web. Il sito legge da VIVIN i tuoi annunci, i prezzi e la disponibilità. Le prenotazioni fatte sul sito vengono create in VIVIN come qualsiasi altra prenotazione da piattaforma. Il contenuto dell'annuncio arriva dalla scheda Integrazione completa. La scheda mostra una Chiave API integrazione di sola lettura, con visibili solo gli ultimi caratteri. Il tuo sviluppatore web trova i dettagli tecnici nell'API del motore di prenotazione.

Fatturazione

Aggiungi il tuo fornitore di fatturazione in Integrazioni piattaforma → Aggiungi:

Fornitore	Cosa inserisci
Invoice Express	ID API e Chiave API
Hostkit	All'inizio niente. Poi clicca su Chiavi per annuncio sulla scheda e aggiungi una chiave Hostkit per annuncio
Fatturazione VIVIN	Niente da collegare. Clicca su Configura sulla sua scheda per impostare i dati dell'emittente, la numerazione, le aliquote fiscali e i modelli Word
NetSuite	ID account, ID client OAuth, ID certificato e chiave privata. Clicca su Configura per impostare i valori predefiniti delle fatture e le associazioni delle classi di proprietà
A-Cube (fatturazione elettronica)	Email e password del tuo accesso ad A-Cube, più Sandbox (test) o Produzione. Poi apri Impostazioni fatturazione italiana
Sage 50c	Non è in self-service: la scheda dice Contatta il team VIVIN per abilitare

Invoice Express, Hostkit e Sage 50c funzionano ciascuno da soli: accanto a loro non si può aggiungere nessun altro fornitore di fatturazione. Fatturazione VIVIN, NetSuite e A-Cube si possono combinare. Una connessione è quella generale (badge Fallback) e ogni connessione aggiuntiva gestisce i Tipi di pagamento e/o i Proprietari che scegli. I codici fiscali, le date delle fatture e la serie delle fatture Hostkit si impostano in Impostazioni → Fatturazione, vedi Fatturazione.

Serrature smart (Nuki)

1. Vai in Impostazioni → Integrazioni, clicca su Aggiungi in Integrazioni piattaforma, scegli Account Nuki, incolla la tua Chiave API e clicca su Aggiungi integrazione.
2. Nell'editor della proprietà (Configurazione → Armadietti accesso), imposta Porta edificio o Porta proprietà su Armadietto Nuki e scegli la serratura. Nell'editor dell'unità (Configurazione → Informazioni unità), Accesso porta unità è sempre visibile: impostalo su Armadietto Nuki e scegli la serratura.
3. L'email automatica di check-in di VIVIN invita l'inquilino a usare l'app Nuki. Se una regola email sostituisce quell'email, attiva Invia invito Nuki sulla regola (Impostazioni → Comunicazioni). Per inviare di nuovo un invito, usa Reinvia accesso Nuki sulla prenotazione. In Impostazioni portale, attiva Consenti di aprire l'app Nuki dal portale per avere un link Apri l'app Nuki nella Home, oppure Consenti di aprire le porte Nuki dal portale per lo sblocco dentro il portale.

Pagamenti degli inquilini

I pagamenti con carta e IBAN virtuale (vIBAN) tramite EasyPay sono attivati per il tuo account da VIVIN, quindi non c'è nulla da aggiungere nella scheda Integrazioni. Funzionano solo sugli account che usano EUR. Con altre valute registri i pagamenti a mano. I pagamenti in arrivo vengono registrati sul piano di pagamento della prenotazione.

API partner, feed del calendario e IA

• API partner: le piattaforme di prenotazione leggono i feed dei tuoi annunci e inviano prenotazioni tramite l'API partner di VIVIN, usando un accesso che VIVIN rilascia. I dettagli tecnici sono nel riferimento API.
• Feed del calendario per unità: ogni unità ha un link pubblico al calendario VIVIN. In Vendite → Gestore canali, clicca su Copia iCal sulla riga dell'unità e incolla il link in qualsiasi piattaforma che importa calendari.
• Client IA: il banner in alto in Impostazioni → Integrazioni ha un pulsante Vai a MCP che apre Impostazioni → IA / MCP. Vedi Collega Claude, ChatGPT o altri strumenti IA.

Suggerimenti

• Non vedi la colonna di una piattaforma in Vendite → Gestore canali? Clicca su Aggiungi in Integrazioni piattaforma: se la piattaforma è nel gruppo Piattaforme di prenotazione, è disattivata, quindi sceglila per riattivarla. Idealista, Edu Portugal, Coliving e SRF non hanno mai una colonna.

Correlati

• Impostazioni → Integrazioni: ogni scheda e campo nel dettaglio
• Airbnb e Booking.com: integrazione completa e link del calendario per i soggiorni brevi
• Annunci: Canali, Breve termine e Integrazione completa dell'unità
• Riferimento API: feed partner, iCal ed endpoint delle prenotazioni
• Inserire una nuova proprietà: checklist di configurazione completa