Variabili del contratto
Scrivi queste variabili nei tuoi modelli di contratto e di addendum; VIVIN le sostituisce con i dati della prenotazione.
Prima di iniziare
- Dove: i modelli che carichi in Impostazioni → Contratto (
https://platform.vivin.app/settings/contract). Vedi l'elenco delle variabili disponibili qui in quella scheda apre Variabili del modello di contratto, con un pulsante di copia su ciascuna. - Piano: tutti gli account.
- Permessi: gli stessi di Contratto.
Scrivi ogni variabile tra parentesi graffe singole, con l'ortografia esatta dell'elenco; le maiuscole contano. Le variabili delle firme iniziano con %, per esempio {%TenantSignature}. Una variabile che VIVIN non conosce viene stampata vuota.
Le variabili che finiscono con InText… esistono in quattro lingue: sostituisci … con En, Pt, Es o It, per esempio {RentValueInTextPt}. Un modello può contenere la stessa clausola in due lingue.
Inquilino
| Variabile | Stampa |
|---|---|
{TenantName}, {TenantFirstName}, {TenantLastName} | Nome completo, nome e cognome |
{TenantEmail}, {TenantPhone}, {Nationality} | Email, telefono, nazionalità |
{FiscalId} | Codice fiscale |
{IdentificationId}, {TenantIdDocumentType}, {TenantIdDocumentCountry}, {TenantIdDocumentExpiryDate} | Numero del documento, tipo di documento, paese di rilascio, data di scadenza |
{TenantFiscalAddress} | Indirizzo di residenza |
{TenantDateOfBirth}, {TenantPlaceOfBirth} | Data e luogo di nascita |
{TenantResidenceAddress}, {TenantResidenceCity}, {TenantResidenceCountry} | Residenza principale |
{TenantEmergencyContact1Name}, …Relationship, …Email, …Phone | Primo contatto di emergenza (usa 2 per il secondo) |
I dati di nascita, la residenza principale e i contatti di emergenza vengono raccolti solo quando quelle sezioni sono attive in Dettagli del contratto; altrimenti restano vuoti.
Secondo inquilino e garante
Compilate dalle sezioni Secondo inquilino e Garante della scheda Info contratto della prenotazione. In una prenotazione che non li ha, restano vuote (o stampano N/A), così un solo modello va bene per ogni prenotazione.
- Secondo inquilino:
{SecondTenantName},{SecondTenantFirstName},{SecondTenantLastName},{SecondTenantEmail},{SecondTenantPhone},{SecondTenantNationality},{SecondTenantFiscalId},{SecondTenantIdentificationId},{SecondTenantIdDocumentType},{SecondTenantIdDocumentCountry},{SecondTenantIdDocumentExpiryDate},{SecondTenantFiscalAddress}. - Garante: lo stesso insieme che inizia con
Guarantor(per esempio{GuarantorName}), più{GuarantorAmount}e{GuarantorAmountInText…}, che stampano vuoto (mai0) quando non è inserito alcun importo.
Per entrambi vengono registrati solo i dati identificativi; i dati di fatturazione e bancari vengono dall'inquilino principale.
Proprietario
{OwnerName}, {OwnerFiscalId}, {OwnerFiscalAddress}, {OwnerEmail}, {OwnerPhone}, {OwnerIdDocumentType}, {OwnerIdDocumentNumber} vengono dal proprietario della proprietà in Proprietari. Sono vuote in una proprietà senza proprietario.
Proprietà, unità e prenotazione
| Variabile | Stampa |
|---|---|
{PropertyAddress} | Indirizzo della proprietà |
{ListingInternalName}, {Floor}, {RoomNumber} | Nome interno dell'unità, piano, numero della stanza |
{PropertyTotalRooms} | Numero di unità nella proprietà |
{PropertyRoomRange} | Nomi delle unità: un intervallo (H.1 a H.6) quando non manca nessun numero, altrimenti un elenco (H.1, H.3, H.6) |
{PropertyArea}, {ListingArea} | Superficie in m², due decimali; vuota se non impostata |
{PropertyAreaInText…}, {ListingAreaInText…} | Superficie in lettere: sixty-two [62] square meters (En), sessenta e dois [62] metros quadrados (Pt) |
{LeasePurpose} | La finalità del contratto della prenotazione |
{BookingSource} | La piattaforma da cui arriva la prenotazione; vuota per le prenotazioni dirette |
Le superfici vengono dalla scheda Integrazione completa dell'editor della proprietà o dell'unità. Le opzioni di finalità del contratto si impostano in Categorie.
Date e durata
| Variabile | Stampa |
|---|---|
{StartDate}, {EndDate} | Date del contratto, 01/09/2026 |
{CheckInDate}, {CheckOutDate} | Date di ingresso e di uscita |
{CheckInTime}, {CheckOutTime} | Orari di check-in e di check-out |
{StartDateInText…}, {EndDateInText…}, {CheckInDateInText…}, {CheckOutDateInText…} | Forma lunga: September 1, 2026, 1 de setembro de 2026, 1 de septiembre de 2026, 1 settembre 2026 |
{ContractDurationMonths} | Mesi interi, come numero: 6 |
{ContractDurationInText…} | Mesi interi in lettere: six [6] months (En), seis [6] meses (Pt, Es) |
{ContractDurationDays} | Giorni che avanzano dopo i mesi interi |
{ContractDurationFullInText…} | Mesi e giorni: three [3] months and thirteen [13] days (En), tres [3] meses y trece [13] días (Es) |
{ContractSignDate} | Il giorno in cui il contratto viene generato finché il soggiorno non è iniziato; dalla data di inizio in poi, la data di inizio |
{ContractGenerationDate} | Sempre il giorno in cui viene prodotto il PDF |
- La durata conta la data di fine come ultimo giorno, quindi dal 01/01 al 30/06 sono 6 mesi. I mesi parziali non vengono arrotondati per eccesso.
- Una data mancante viene stampata vuota, in entrambe le forme.
- Per i rinnovi, o per qualsiasi contratto rigenerato dopo l'inizio del soggiorno, metti
{ContractGenerationDate}sulla riga della firma;{ContractSignDate}stamperebbe la data di inizio originale.
Importi
| Variabile | Stampa |
|---|---|
{RentValue} | Affitto mensile; un intervallo (900 - 1100) quando cambia di mese in mese |
{CurrencySymbol}, {Currency} | Il simbolo della valuta della prenotazione (€, £, $) e il suo codice (EUR, GBP, USD) |
{RentJan} … {RentDec} | L'affitto di ogni mese; i mesi fuori dal contratto stampano NA |
{SecurityDeposit}, {AdministrativeFee}, {CleaningFee}, {ExitFee} | Deposito e spese; 0 quando non ce ne sono |
{ContractTotalValue} | Affitto totale del contratto, senza spese; non cambia man mano che l'inquilino paga |
{TotalValuePending} | Importo ancora da pagare |
{Debt} | Importo in debito; 0 quando il saldo non è negativo |
{AmountDueAtBookingConfirmation}, {AmountDueAtCheckIn} | Pagamenti richiesti alla conferma della prenotazione o al check-in; 0 quando non ce ne sono |
{BillsIncludedMaxValue} | Massimo di utenze incluse al mese |
{vIBAN} | L'IBAN virtuale della prenotazione per i bonifici |
{LocalRentCap}, {RentCapDifference} | Tetto dell'affitto e parte per i servizi con la doppia tariffazione |
Importi in lettere: {RentValueInText…}, {SecurityDepositInText…}, {CleaningFeeInText…}, {ContractTotalValueInText…}, {AmountDueAtBookingConfirmationInText…}, {AmountDueAtCheckInInText…} e {GuarantorAmountInText…}. Scrivono l'importo in lettere nella valuta della prenotazione, con i centesimi (eight hundred and fifty euros and fifty cents); un affitto che cambia stampa l'intervallo (nine hundred to one thousand one hundred euros).
A renda mensal é de {RentValue} {CurrencySymbol} ({RentValueInTextPt}).
The monthly rent is {CurrencySymbol}{RentValue} ({RentValueInTextEn}).
Firme e un secondo documento
| Variabile | Cosa fa |
|---|---|
{%TenantSignature} | La firma dell'inquilino, aggiunta quando firma nel portale |
{%SecondTenantSignature}, {%GuarantorSignature} | Le firme del secondo inquilino e del garante; vuote finché non firmano |
{%LandlordSignature} | La tua firma del locatore memorizzata, aggiunta quando l'inquilino firma |
{NewDocument: Name} | Divide il modello in un secondo documento, firmato insieme al contratto |
Per allegare, per esempio, il regolamento della casa, scrivi {NewDocument: House rules} su una riga a sé nel corpo del testo. Tutto ciò che sta sotto diventa un PDF separato con il nome del testo dopo i due punti; l'inquilino firma entrambi in una volta e vengono salvati entrambi nei file della prenotazione. Aggiungi le variabili delle firme sotto la riga se il secondo documento ne ha bisogno. La riga non funziona dentro una tabella, una casella di testo o un'intestazione.
Addendum
Usale nel modello di addendum insieme alle variabili ordinarie, che stampano i nuovi valori:
- Condizioni dell'ultima firma:
{PreviousStartDate},{PreviousEndDate},{PreviousCheckInDate},{PreviousCheckOutDate},{PreviousRentValue},{PreviousSecurityDeposit},{PreviousAdministrativeFee},{PreviousExitFee},{PreviousCleaningFee}. - Periodo aggiunto, per le proroghe:
{ExtensionStartDate},{ExtensionEndDate},{ExtensionRentValue}.
Risoluzione dei problemi
- Un valore viene stampato vuoto: controlla l'ortografia e le maiuscole, e che la prenotazione abbia quel dato. Attiva Stampa N/A nelle variabili vuote per vedere quali sono vuote.
- VIVIN rifiuta di generare il contratto a causa di un simbolo di valuta: usa
{CurrencySymbol}o{Currency}invece di un€,£o$scritto a mano.
Suggerimenti
- Usa una sola forma di un valore per clausola:
{StartDate} {StartDateInTextEs}stampa la data due volte e{ContractDurationInTextEs}include già il numero tra parentesi quadre. - Abbina il suffisso della lingua alla clausola che lo circonda.
Correlati
- Contratto
- Prenotazioni
- Predefiniti di prenotazione e pagamento: Dettagli del contratto
- Proprietari
- Portale inquilino