Variables del contrato
Escribe estas variables en tus plantillas de contrato y de adenda; VIVIN las sustituye por los datos de la reserva.
Antes de empezar
- Dónde: las plantillas que subes en Configuración → Contrato (
https://platform.vivin.app/settings/contract). Ver la lista de variables disponibles aquí en esa pestaña abre Variables de la plantilla de contrato, con un botón de copiar en cada una. - Plan: todas las cuentas.
- Permisos: los mismos que en Contrato.
Escribe cada variable entre llaves simples, tal como aparece en la lista; las mayúsculas importan. Las variables de firma empiezan por %, por ejemplo {%TenantSignature}. Una variable que VIVIN no conoce se imprime en blanco.
Las variables que terminan en InText… existen en cuatro idiomas: sustituye … por En, Pt, Es o It, por ejemplo {RentValueInTextPt}. Una misma plantilla puede contener la misma cláusula en dos idiomas.
Inquilino
| Variable | Imprime |
|---|---|
{TenantName}, {TenantFirstName}, {TenantLastName} | Nombre completo, nombre y apellidos |
{TenantEmail}, {TenantPhone}, {Nationality} | Correo, teléfono, nacionalidad |
{FiscalId} | Número fiscal |
{IdentificationId}, {TenantIdDocumentType}, {TenantIdDocumentCountry}, {TenantIdDocumentExpiryDate} | Número del documento, tipo de documento, país de expedición, fecha de caducidad |
{TenantFiscalAddress} | Domicilio particular |
{TenantDateOfBirth}, {TenantPlaceOfBirth} | Fecha y lugar de nacimiento |
{TenantResidenceAddress}, {TenantResidenceCity}, {TenantResidenceCountry} | Residencia habitual |
{TenantEmergencyContact1Name}, …Relationship, …Email, …Phone | Primer contacto de emergencia (usa 2 para el segundo) |
Los datos de nacimiento, la residencia habitual y los contactos de emergencia solo se recogen mientras esas secciones están activadas en Detalles del contrato; si no, estas variables quedan en blanco.
Segundo inquilino y avalista
Se rellenan desde las secciones Segundo inquilino y Avalista de la pestaña Información del contrato de la reserva. En una reserva que no los tiene, quedan en blanco (o se imprimen como N/A), así que una sola plantilla sirve para todas las reservas.
- Segundo inquilino:
{SecondTenantName},{SecondTenantFirstName},{SecondTenantLastName},{SecondTenantEmail},{SecondTenantPhone},{SecondTenantNationality},{SecondTenantFiscalId},{SecondTenantIdentificationId},{SecondTenantIdDocumentType},{SecondTenantIdDocumentCountry},{SecondTenantIdDocumentExpiryDate},{SecondTenantFiscalAddress}. - Avalista: el mismo conjunto, empezando por
Guarantor(por ejemplo{GuarantorName}), más{GuarantorAmount}y{GuarantorAmountInText…}, que se imprimen en blanco (nunca0) cuando no se ha introducido ningún importe.
De los dos solo se registran los datos de identidad; los datos de facturación y bancarios vienen del inquilino principal.
Propietario
{OwnerName}, {OwnerFiscalId}, {OwnerFiscalAddress}, {OwnerEmail}, {OwnerPhone}, {OwnerIdDocumentType}, {OwnerIdDocumentNumber} vienen del propietario de la propiedad en Propietarios. Quedan en blanco en una propiedad sin propietario.
Propiedad, unidad y reserva
| Variable | Imprime |
|---|---|
{PropertyAddress} | Dirección de la propiedad |
{ListingInternalName}, {Floor}, {RoomNumber} | Nombre interno de la unidad, planta, número de habitación |
{PropertyTotalRooms} | Número de unidades de la propiedad |
{PropertyRoomRange} | Nombres de las unidades: un rango (H.1 a H.6) cuando no falta ningún número, y si no, una lista (H.1, H.3, H.6) |
{PropertyArea}, {ListingArea} | Superficie en m², con dos decimales; en blanco si no está definida |
{PropertyAreaInText…}, {ListingAreaInText…} | Superficie en letras: sixty-two [62] square meters (En), sessenta e dois [62] metros quadrados (Pt) |
{LeasePurpose} | La finalidad del contrato de la reserva |
{BookingSource} | Plataforma de la que vino la reserva; en blanco en las reservas directas |
Las superficies vienen de la pestaña Integración completa del editor de la propiedad o de la unidad. Las opciones de finalidad del contrato se definen en Categorías.
Fechas y duración
| Variable | Imprime |
|---|---|
{StartDate}, {EndDate} | Fechas del contrato, 01/09/2026 |
{CheckInDate}, {CheckOutDate} | Fechas de entrada y de salida |
{CheckInTime}, {CheckOutTime} | Horas de check-in y de check-out |
{StartDateInText…}, {EndDateInText…}, {CheckInDateInText…}, {CheckOutDateInText…} | Forma larga: September 1, 2026, 1 de setembro de 2026, 1 de septiembre de 2026, 1 settembre 2026 |
{ContractDurationMonths} | Meses completos, como número: 6 |
{ContractDurationInText…} | Meses completos en letras: six [6] months (En), seis [6] meses (Pt, Es) |
{ContractDurationDays} | Días que sobran después de los meses completos |
{ContractDurationFullInText…} | Meses y días: three [3] months and thirteen [13] days (En), tres [3] meses y trece [13] días (Es) |
{ContractSignDate} | El día en que se genera el contrato mientras la estancia no ha empezado; desde la fecha de inicio, la fecha de inicio |
{ContractGenerationDate} | Siempre el día en que se produce el PDF |
- La duración cuenta la fecha de fin como último día, así que del 01/01 al 30/06 son 6 meses. Los meses parciales no se redondean hacia arriba.
- Una fecha que falta se imprime en blanco, en las dos formas.
- En las renovaciones, o en cualquier contrato regenerado después de que la estancia haya empezado, pon
{ContractGenerationDate}en la línea de la firma;{ContractSignDate}imprimiría la fecha de inicio original.
Dinero
| Variable | Imprime |
|---|---|
{RentValue} | Alquiler mensual; un rango (900 - 1100) cuando cambia de un mes a otro |
{CurrencySymbol}, {Currency} | El símbolo de la moneda de la reserva (€, £, $) y su código (EUR, GBP, USD) |
{RentJan} … {RentDec} | Alquiler de cada mes; los meses fuera del contrato se imprimen como NA |
{SecurityDeposit}, {AdministrativeFee}, {CleaningFee}, {ExitFee} | Depósito y tasas; 0 cuando no hay |
{ContractTotalValue} | Alquiler total del contrato, sin tasas; no cambia a medida que el inquilino paga |
{TotalValuePending} | Importe que falta por pagar |
{Debt} | Importe en deuda; 0 cuando el saldo no es negativo |
{AmountDueAtBookingConfirmation}, {AmountDueAtCheckIn} | Pagos exigidos en la confirmación de la reserva o en el check-in; 0 cuando no hay |
{BillsIncludedMaxValue} | Máximo de suministros incluidos por mes |
{vIBAN} | El IBAN virtual de la reserva para las transferencias |
{LocalRentCap}, {RentCapDifference} | Tope de alquiler y parte de servicios con doble tarificación |
Importes en letras: {RentValueInText…}, {SecurityDepositInText…}, {CleaningFeeInText…}, {ContractTotalValueInText…}, {AmountDueAtBookingConfirmationInText…}, {AmountDueAtCheckInInText…} y {GuarantorAmountInText…}. Escriben el importe en la moneda de la reserva con los céntimos (eight hundred and fifty euros and fifty cents); un alquiler que cambia imprime el rango (nine hundred to one thousand one hundred euros).
A renda mensal é de {RentValue} {CurrencySymbol} ({RentValueInTextPt}).
The monthly rent is {CurrencySymbol}{RentValue} ({RentValueInTextEn}).
Firmas y un segundo documento
| Variable | Qué hace |
|---|---|
{%TenantSignature} | La firma del inquilino, que se añade cuando firma en el portal |
{%SecondTenantSignature}, {%GuarantorSignature} | Las firmas del segundo inquilino y del avalista; en blanco hasta que firman |
{%LandlordSignature} | Tu firma del arrendador guardada, que se añade cuando firma el inquilino |
{NewDocument: Name} | Divide la plantilla en un segundo documento, que se firma junto con el contrato |
Para adjuntar unas normas de la casa, por ejemplo, escribe {NewDocument: House rules} en una línea propia del cuerpo. Todo lo que hay debajo se convierte en un PDF aparte con el nombre del texto que va después de los dos puntos; el inquilino firma los dos a la vez y ambos se guardan en los archivos de la reserva. Añade variables de firma debajo de la línea si el segundo documento las necesita. La línea no hace nada dentro de una tabla, un cuadro de texto o un encabezado.
Adenda
Usa estas en la plantilla de adenda junto con las variables normales, que imprimen los valores nuevos:
- Condiciones de la última firma:
{PreviousStartDate},{PreviousEndDate},{PreviousCheckInDate},{PreviousCheckOutDate},{PreviousRentValue},{PreviousSecurityDeposit},{PreviousAdministrativeFee},{PreviousExitFee},{PreviousCleaningFee}. - Período añadido, en las ampliaciones:
{ExtensionStartDate},{ExtensionEndDate},{ExtensionRentValue}.
Solución de problemas
- Un valor se imprime en blanco: comprueba la ortografía y las mayúsculas, y que la reserva tenga ese dato. Activa Imprimir N/A en las variables vacías para ver cuáles están vacías.
- VIVIN se niega a generar el contrato por un símbolo de moneda: usa
{CurrencySymbol}o{Currency}en lugar de un€,£o$escrito a mano.
Consejos
- Usa una sola forma de un valor por cláusula:
{StartDate} {StartDateInTextEs}imprime la fecha dos veces, y{ContractDurationInTextEs}ya incluye el número entre corchetes. - Haz coincidir el sufijo de idioma con la cláusula que lo rodea.
Relacionado
- Contrato
- Reservas
- Valores predeterminados de reservas y pagos: Detalles del contrato
- Propietarios
- Portal del inquilino