Skip to main content

General Information

First-time workspace setup

Complete Getting Started — Recommended Setup Sequence step 1 (this tab — company identity and branding) before step 2 Preferences and settings steps 3–12 — full tab map: Recommended setup order. Finish steps 13–15 in Listings, Bookings, and Tenants, then Onboarding a New Property — Step 7. Guided steps 4–12: Onboarding a New Property. Lockout catch-up: Getting Started. Workflow pairing after go-live: Account Settings — Setup sequence after go-live.

This tab configures your company's identity, branding, and core operational timing parameters. The values you set here appear across the entire platform — in tenant-facing communications, generated contracts, invoices, and the Tenant Portal.

Direct access

Open Account Settings > Settings > General Information at platform.vivin.app/settings/general (or platform.vivin.app/settings, which opens the same tab by default). See Deep Links for neighbouring routes.

Pair with other Account Settings tabs

Before go-live, also verify Preferences (default check-in/out times and preparation days — not on this tab) and Subscription (Vivin platform billing and card-on-file). Vivin platform subscription charges on Subscription are distinct from internal LLM spend on AI usage API (operator JWT, USD provider cost). Section-to-doc pairing: General Information section cross-reference. Hub tab matrix: Account Settings — Tab cross-reference.

The General Information card (company contact, fiscal details, and IBAN) matches the fields in the tables below; use the card’s edit control to change values, then continue with Branding on the same page. Default check-in/check-out times and preparation days live on Preferences — not on this tab.

Account Settings — General Information selected, company details card with edit control

General Information Section

Pair with other General Information sections

Company identity fields here feed Invoicing & Payments exports and connected Integrations (Invoice-xpress fiscal identity) — complete this card before issuing first invoices. Full pairing matrix: General Information section cross-reference.

FieldDescription
Company NameYour business name as it appears in documents, emails, and the Tenant Portal.
Contact EmailThe primary email address tenants and team members will see as the sender for system notifications.
Phone NumberYour company's contact number, included in outgoing communications where applicable.
Fiscal ID / VAT NumberYour company's tax identification number, used for invoice generation and legal documents.
AddressYour company's registered address, printed on contracts and invoices.
tip

Use a shared team email address (e.g., [email protected]) as the Contact Email rather than a personal address. This ensures continuity if team members change and gives tenants a consistent point of contact.

Branding Section

Pair with other General Information sections

Logo and brand colour propagate to Contract templates PDF headers, Emails lifecycle templates, and the Tenant Portal — upload branding before first onboarding send. Full pairing matrix: General Information section cross-reference.

These settings control how the platform appears to your team and to tenants in the Tenant Portal.

Account Settings — General Information, Branding card (logo, brand color, website URL)

Each card uses the same pencil → edit → Save / Cancel pattern as other Account Settings tabs. The screenshots below show company details and branding in edit mode (values unchanged before Cancel).

Account Settings — General Information, company details card in edit mode with Save and Cancel

Account Settings — General Information, Branding card in edit mode (logo, brand color, website URL fields)

Walkthrough: open General Information, edit the Branding card, review fields, then Cancel without saving (use Save only when you intend to update tenant-facing branding).
FieldDescription
LogoUpload your company logo (PNG or JPG). It appears in the top navigation bar and in generated PDFs (contracts, invoices).
Brand ColorA hex color code that sets the primary accent color in the Tenant Portal and in email headers. Use your brand's primary color for a consistent, professional look.
Website URLYour company's website. Displayed in tenant-facing communications and the Tenant Portal.

Where Branding Appears

Your branding settings are applied in several places across the platform:

  • Tenant Portal — The logo is displayed in the portal header, and the brand color is used as the primary accent for buttons, links, and highlights throughout the tenant-facing interface.
  • Generated Contracts — The logo is embedded in the header of PDF contracts generated from your Contract template.
  • Automated Emails — The logo and brand color appear in the header of all tenant-facing emails (onboarding, check-in, check-out, and payment reminders configured in Emails).
  • Invoices — If connected to an invoicing provider (e.g., Invoice-xpress via Integrations), your company name, fiscal ID, and address are printed on every invoice.
tip

When choosing a brand color, pick a color with sufficient contrast against a white background — it is used for buttons and links in the Tenant Portal. Very light colors (e.g., pale yellow) may be difficult for tenants to read or click.

Booking times and preparation (Preferences)

Pair with other General Information sections

Preparation buffers edited on Preferences — Booking Defaults (times and preparation) shape Sales availability and channel iCal exports — coordinate changes before peak booking season. Full pairing matrix: General Information section cross-reference.

Default check-in time, check-out time, mid-term preparation days, short-term preparation days, and advance notice are configured on Account Settings > Preferences in the Booking Defaults card (subtitle: default check-in/out times and preparation periods). They are account-wide defaults used in booking views, operational planning, and availability calculations.

How preparation days affect availability

Preparation days create an automatic buffer between consecutive bookings in a unit. The system uses the values from Preferences when calculating availability in the Sales module and when validating new booking dates.

Example

If Mid-term Prep is set to 3 and a tenant's booking ends on March 31:

  • The unit is marked as unavailable from April 1 through April 3 (3 preparation days).
  • The earliest a new booking can start is April 4.
  • This buffer appears automatically in Sales (Overview and Pricing) and on connected external platforms.

This prevents back-to-back bookings that leave no time for cleaning, inspection, and turnaround. Adjust the values based on your team's capacity:

  • 1 day — sufficient if you have a dedicated cleaning team that can turn a unit around the same day
  • 2–3 days — standard for most mid-term operations, allowing cleaning, inspection, and minor repairs
  • 5+ days — use for properties that require deep cleaning or renovation between tenants
Important

Check-in and check-out times are included in the automated emails sent to tenants. If you change these times, the new values will apply to all future emails — but tenants who already received their check-in or check-out email will have the old time. Coordinate time changes carefully with your operations team.

Key Rules

Pair with other General Information sections

Account-wide branding and preparation defaults affect Onboarding a New Property and arrival-week Managing a Check-in — document team SOPs when contact email or prep days change mid-season. Full pairing matrix: General Information section cross-reference.

Summary
  1. Branding is account-wide. All properties, tenants, and documents use the same logo, brand color, and company information. You cannot configure different branding per property.

  2. Changes affect future communications only. Updating your company name, logo, or contact email changes what new emails and documents show — but previously sent emails and generated PDFs retain the old values.

  3. Preparation days prevent back-to-back bookings. The system automatically blocks the configured number of days after every check-out (values on Preferences). This applies to both manual bookings and bookings imported from external platforms.

  4. Check-in/check-out times are informational. These times are included in tenant emails and used for operational planning, but the system does not enforce them — a booking status can be changed at any time of day. Edit them on Preferences, not General Information.

General Information section cross-reference

Use this table when one General Information topic naturally leads into another Account Settings tab, operator module, workflow, or concept — each row links to the docs you should read before or after saving company identity and branding.

| General Information topic / section | Pair with these docs | | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | General Information Section | Invoicing & Payments, Integrations (Invoice-xpress) | | Branding Section | Contract templates, Emails, Tenant Portal | | Booking times and preparation (Preferences) | Preferences — Booking Defaults (times and preparation), Sales — Overview | | Key Rules | Onboarding a New Property, Managing a Check-in, Handling a Late Payment — Step 1 | | Lockout catch-up after password recovery | Resetting a Management User Password, Getting Started — Lockout catch-up, Common Workflows — Lockout catch-up | | Pending manual receipt approval | Invoicing & Payments, Users and roles — Role permissions (Approve payments), Finance — Pending manual payments | | Reject/revert mistaken receipts | Payment Allocation — Correcting mistaken receipts, Finance — Row actions on in-payment rows | | Notification row-click navigation | /notifications row-click after identity defaults on this tab | Account Settings — Notification row-click navigation, Common Workflows — Notification row-click navigation, Notifications module — Notification row-click navigation | | Payment alert to receivables triage | payment overdue after company contact defaults | Account Settings — Payment alert to receivables triage, Common Workflows — Payment alert to receivables triage, Handling a Late Payment — Step 1 | | Confirmation alert triage | Upcoming alerts after first reservations on branded workspace | Account Settings — Confirmation alert triage, Common Workflows — Confirmation alert triage, Processing a New Booking — Step 5b | | Finance debt receivables triage | Portfolio Top debtors / Debt Aging after settings on this tab | Account Settings — Finance debt receivables triage, Common Workflows — Finance debt receivables triage, Finance module — Finance debt receivables triage | | Finance Income status drill-down | Income → In debt vs Debt Aging after settings on this tab | Account Settings — Finance Income status drill-down, Common Workflows — Finance Income status drill-down, FAQ — Finance Income status drill-down hub | | Cash flow forecast drill-down | Cash flow forecast month bars vs Income segments | Account Settings — Cash flow forecast drill-down, Common Workflows — Cash flow forecast drill-down, FAQ — Cash flow forecast drill-down hub | | Portfolio segmentation by tenant category | Tenant categories, Common Workflows — Portfolio segmentation, Bookings — Other filters |


Pair with other General Information guide sections

Related below links this Account Settings tab to modules, workflows, concepts, and escalation paths. Pair Documentation map & escalation with Account Settings hub — Documentation map & escalation; pair Upstream & downstream workflows with Account Settings — Tab cross-reference. Topic-to-section pairing in sections above: General Information section cross-reference. Full hub matrix: Account Settings — Section cross-reference.

Documentation map & escalation

Upstream & downstream workflows

Pair with other General Information guide sections

Deeper workflow reads

Pair with other General Information guide sections

Workflow reads pair with Common Workflows hub subsection index and Workflow cross-reference. Each workflow sub-guide reciprocates with [Deeper workflow reads](./general-information.md#deeper-workflow-reads) anchors on Account Settings bullets — hub parity: Account Settings hub — Deeper workflow reads. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Pair with other General Information guide sections
  • Preferences — Check-in/out times, preparation-day defaults, and advance notice (not on this tab)
  • Subscription — Vivin platform billing identity (distinct from tenant-facing branding here)
  • Emails — Customize the emails that include check-in/check-out times and company contact
  • Contract templates — Generated contracts that use your logo and company details
  • Owners — Register landlords before property setup (operator identity here is distinct from owner payout records)
  • Tenant categories — Default segment for integration-created tenants after company identity is set
  • Integrations — Marketplace sender names and channel copy that complement company contact details
  • Chatbot — Tenant-facing bot branding that shares logo assets from this page
  • Preferences — In-app notifications — Account-wide arrival and payment alert categories

Operator modules & tenant-facing surfaces

Pair with other General Information guide sections

Deeper concept reads

Pair with other General Information guide sections

Module documentation hubs

Pair with other General Information guide sections
  • Dashboard — Post-login KPI snapshot with bell notification triage
  • Analytics — Month-range portfolio KPI charts
  • Finance — Portfolio ledgers and invoicing exports using company fiscal details
  • Bookings — Operator UI for reservations receiving lifecycle mail with your branding
  • Operations — Maintenance tickets and check-in/out coordination
  • Utilities — Bills Included ceiling model and tenant overage charges
  • Tenants — Tenant directory and With Debt segmentation
  • Notifications — Full /notifications history
  • AI Chat — Vivin-internal AI Assistant for portfolio Q&A
  • Audit — Portfolio-wide Manual Blocks and Discounts review
  • Booking engine details — Rich marketplace payload editor via the Full integration pill

Lockout catch-up after password recovery

Pair with other General Information guide sections

Operational backlog after sign-in recovery pairs with Resetting a Management User Password — Step 3 before you resume company identity and branding on this tab. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Pending manual receipt approval

Pair with other General Information guide sections

Receipt approval pairs with Invoicing & Payments tenant collections (distinct from operator company identity here) and Users and roles (Approve payments permission). Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Reject/revert mistaken receipts

Pair with other General Information guide sections

Receipt cleanup pairs with Payment Allocation two-layer receipts and Invoicing & Payments export providers that print company fiscal details from this tab. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Portfolio segmentation by tenant category

Pair with other General Information guide sections

Notification row-click navigation

Pair with other General Information guide sections

Company branding on this tab does not change /notifications row-click targets — finish alert triage on the opened booking before revisiting General Information contact fields. Hub parity: Account Settings — Notification row-click navigation. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Payment alert to receivables triage

Pair with other General Information guide sections

Fiscal identity here does not clear payment overdue alerts — route row-clicks via Notification triage — Step 4 before Finance → Overview sign-off. Hub parity: Account Settings — Payment alert to receivables triage. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Confirmation alert triage

Pair with other General Information guide sections

First Upcoming Booking created alerts after go-live still need Processing a New Booking — Step 5b on Transactions — company identity saves do not approve confirmation receipts. Hub parity: Account Settings — Confirmation alert triage. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Finance debt receivables triage

Pair with other General Information guide sections

Company fiscal identity on this tab feeds Finance → Overview receivables exports — pair Total Debt triage with due-date settings on Invoicing & Payments. Hub parity: Account Settings — Finance debt receivables triage. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Handling a Late Payment collections

Pair with other General Information guide sections

Company fiscal identity on this tab feeds Finance → Overview receivables exports — pair Total Debt triage with due-date settings on Invoicing & Payments Hub parity: Account Settings — Handling a Late Payment collections. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Finance Income status drill-down

Pair with other General Information guide sections

Branding and contact defaults do not change Income chart segments — when Total Debt looks wrong after setup, open Finance → Overview for Paid / Scheduled / In debt drill-down. Hub parity: Account Settings — Finance Income status drill-down. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Cash flow forecast drill-down

Pair with other General Information guide sections

Post-login Cash Flow Forecast on Dashboard reflects collections after payment-deadline settings on Invoicing & Payments — not company identity fields here. Hub parity: Account Settings — Cash flow forecast drill-down. Full pairing matrix: General Information section cross-reference · Account Settings — Section cross-reference.

Key glossary terms

Pair with other General Information guide sections

Companion API guides

Pair with other General Information guide sections
  • API Reference hub — Partner HTTP contracts and integration feeds (hub)
  • AI usage API — Operator JWT ledger (GET /ai-usage/summary) when auditing internal AI cost after branding or contact-field changes coincide with chat adoption