Gå til hovedinnhold

Vitec Next for megler

Les mer om hvordan megler kan aktivere Kvass integrasjon i Vitec Next.

Skrevet av Marianne Bråthen

Vitec Next for megler

For megler er det noen få steg som må gjennomføres for at integrasjonen skal fungerer sømløst. Her får du en oversikt over steg som må gjennomføres og hvordan du aktiverer.

Innhold

Hvordan fungerer Vitec-Kvass-integrasjonen

Hvordan gjennomføre installasjonen

Oversikt over funksjoner / metoder som blir tatt i bruk av integrasjonen

Ofte stilte spørsmål

Hvordan fungerer Vitec-Kvass-integrasjonen

Kvass tilbyr digitale løsninger til utbyggere for blant annet markedsføring av nyboliger, hytter og ferdighus ("Boligprosjekter"). Gjennom Kvass-plattformen leveres blant annet nettsider, boligvelgere, tilvalgsportaler, digital annonsering, analyseverktøy og integrasjonsløsninger ("Kvass-plattformen").

Eiendomsmegleren benytter “Vitec Next” ("Fagsystemet") i sin virksomhet for levering av eiendomsmeglertjenester.

Kvass-plattformen har en teknisk integrasjon med Eiendomsmeglers fagsystem som muliggjør utveksling og synkronisering av data mellom systemene ("Integrasjonen").

Integrasjonen er etablert for å sikre en effektiv, oppdatert og sammenhengende håndtering av prosjekt- og interessentdata på tvers av systemene, samt for å redusere behovet for manuelle operasjoner og risikoen for feil og inkonsistens i data.

Utveksling av data

Gjennom Integrasjonen vil data utveksles mellom Fagsystemet og Kvass-plattformen. Integrasjonen innebærer løpende oppdateringer ved endringer og statusendringer i Fagsystemet, kobling fra prosjektsiden i Kvass-plattformen til budportal, synkronisering av interessentopplysninger mellom Fagsystemet og Kvass-plattformen og, ved fullført kjøp, overføring av kjøperopplysninger og kjøperdokumenter fra Fagsystemet til Plattformen.

Kvass vil gis API-tilgang til Eiendomsmeglerens database for å hente ut data i aktuelle prosjekter, herunder følgende data:

  • Synkronisering av diverse prosjektinfo fra fagsystemet til utbyggers Kvass-konto med løpende oppdateringer ved endringer (salgsstatus, priser, prosjektbeskrivelse, bilder, plantegninger, visninger osv. - valgfrie avhukninger i Kvass)

  • Synkronisering av bilde og tilhørende kontaktinformasjon om meglere på prosjektet fra fagsystemet til utbyggers Kvass-konto, for visning på utbyggers prosjektside (valgfri avhukning i Kvass)

  • Automatisk lenking til meglers budportal fra prosjektsiden

  • Lenking til meglers visningspåmeldingsskjema fra prosjektsiden
    (valgfri avhukning i Kvass)

  • Toveis synkronisering av kontaktinformasjon til interessenter mellom meglers fagsystem og utbyggers Kvass-konto (valgfri avhukning i Kvass)

  • Ved fullført kjøp synkroniseres kjøpers kontaktinformasjon og fødselsnummer fra fagsystemet til utbyggers Kvass-konto. I tillegg synkroniseres «signert kjøpekontrakt». Dette gir utbygger tilgang til oppdatert kjøperinformasjon og -statistikk i Kvass, som kan brukes i moduler for ettermarked og tilvalgshåndtering, samtidig som behovet for manuell oversendelse av kontrakter fra megler reduseres. (valgfri avhukning i Kvass).

Kvass innhenter kun data som er nødvendig for det spesifikke prosjektet.
​

Personvern

Eiendomsmegler er behandlingsansvarlig etter EUs personvernforordning ("GDPR") for personopplysninger som behandles i Fagsystemet med tilhørende database.

Integrasjonen innebærer at Kvass gis tilgang til Eiendomsmeglerens database for å muliggjøre overføring til Kvass-plattformen. Kvass vil i forbindelse med denne tilgangen behandle personopplysninger som databehandler på vegne av sine kunder (utbyggere). Utbyggere er på sin side selvstendig behandlingsansvarlig etter GDPR for personopplysninger som hentes ut av Eiendomsmeglers database og behandles i Kvass-plattformen eller sine egne systemer.

Installasjon av Vitec Next

  1. Gå til "Innstillinger" > "Leverandører"

  2. Velg "Kvass" og hvilke avdelinger som skal få mulighet til å aktivere integrasjonen.

  3. Det er ikke behov for å inngå noen databehandleravtale med Kvass, se forklaring rundt behandlingsansvar i avsnitt over.
    ​

Aktivering av integrasjon / tjeneste for et prosjekt

  1. Gå til prosjektet der du ønsker å aktivere Kvass integrasjon og velg "Marked og tjenester" > "Bestill tjeneste"

  2. Deretter vil du bli sendt til en aktiveringsdialog der du skal fylle ut informasjon som du har mottatt på e-post fra Kvass.
    ​

  3. På neste steg får du en liste over enheter som er tilknyttet prosjektet. Nå må du koble sammen enhetene i Vitec Next med enhetene i Kvass. Systemet har laget et forslag om hvilke enheter som hører sammen og du må kontrollere / endre slik at det blir riktig. Så snart du er ferdig kan du bekrefte med "Fullfør". (dette kan ta litt tid)
    ​

  4. Så snart du har fullført vil du se en bekreftelse og statusen på bestillingen i Vitec Next skal ha endret seg til "levert".

Oversikt over funksjoner / metoder som blir tatt i bruk av integrasjonen.

  • Synkronisering av diverse prosjektinfo fra fagsystemet til utbyggers Kvass-konto med løpende oppdateringer ved endringer (salgsstatus, priser, prosjektbeskrivelse, bilder, plantegninger, visninger osv. (valgfrie avhukninger i Kvass)

  • Synkronisering av bilde og tilhørende kontaktinformasjon om meglere på prosjektet fra fagsystemet til utbyggers Kvass-konto, for visning på utbyggers prosjektside
    (valgfri avhukning i Kvass)

  • Automatisk lenking til meglers budportal fra prosjektsiden

  • Lenking til meglers visningspåmeldingsskjema fra prosjektsiden (valgfri avhukning i Kvass)

  • Toveis synkronisering av kontaktinformasjon til interessenter mellom meglers fagsystem og utbyggers Kvass-konto (valgfri avhukning i Kvass)

  • Ved fullført kjøp synkroniseres kjøpers kontaktinformasjon og fødselsnummer fra fagsystemet til utbyggers Kvass-konto. I tillegg overføres «signert kjøpekontrakt» til utbyggers Kvasskonto. Dette gir utbygger tilgang til oppdatert kjøperinformasjon og -statistikk i Kvass, som kan brukes i moduler for ettermarked og tilvalgshåndtering, samtidig som behovet for manuell oversendelse av kontrakter fra megler reduseres (valgfri avhukning i Kvass).

API-tilganger (Scopes) i Vitec

EstateDocuments

API - tilganger (scopes)

Beskrivelse

GET

{installationId}/Estates/{estateId}/Documents

Hente en liste over dokumenter fra et oppdrag
​

Følgende:

  • Plantegning (41)

  • Signert kjøpekontrakt (97)

GET

{installationId}/Estates/{estateId}/Documents/{documentId}

Hente et dokument fra et oppdrag

Følgende:

  • Plantegning (41)

  • Signert kjøpekontrakt (97)

Estates

API - tilganger (scopes)

Beskrivelse

POST

{installationId}/Estates/{estateId}/RegisterInterest

Registrere en interessent på et oppdrag

GET

{installationId}/Estates/{estateId}

Hente et oppdrag

GET

{installationId}/EstateId

Hente estateId for et oppdrag basert på oppdragsnummer

GET

{installationId}/Estates/{estateId}/Project

Hente et prosjekt

GET

{installationId}/Estates/{estateId}/Showings

Hente informasjon om visninger for et oppdrag

Diagnostics

API - tilganger (scopes)

Beskrivelse

POST

{installationId}/Diagnostics/HelloWorld

Teste tilkobling til installasjon

Contacts

API - tilganger (scopes)

Beskrivelse

GET

{installationId}/Contacts/{contactId}

Hente informasjon knyttet til en kontakt

GET

{installationId}/Estates/{estateId}/ContactInformation

Hente fullstendig informasjon, inkludert fødselsnummer, om ulike oppdragsparter knyttet til et oppdrag

GET

{installationId}/Estates/{estateId}/AllContactRelations

Hente liste over kontakter knyttet til et oppdrag

(Interessenter, budgiver, kjøper)

EstateImages

API - tilganger (scopes)

Beskrivelse

GET

{installationId}/Estates/{estateId}/Images

Hente en liste over bilder tilhørende et oppdrag

GET

{installationId}/Estates/{estateId}/Images/{imageId}

Laste ned et bilde fra et oppdrag

GET

{installationId}/Estates/{estateId}/ScaledImages/{imageId}

Laste ned nedskalert bilde fra et oppdrag

GET

{installationId}/Estates/{estateId}/ImageByCategory/{categoryName}

Laste ned første bilde med angitt kategori fra et oppdrag

Employees

API - tilganger (scopes)

Beskrivelse

GET

{installationId}/Employees/{employeeId}

Hente informasjon om en ansatt (for å sette megler på prosjektet i Kvass)

GET

{installationId}/Employees/{employeeId}/Picture

Hente bilde av en ansatt (for å sette megler på prosjektet i Kvass)

Department

API - tilganger (scopes)

Beskrivelse

GET

{installationId}/Departments/{departmentId}

Hente ett kontor

GET

{installationId}/Departments/{departmentId}/Picture

Hente standard bilde for en avdeling

Orders

API - tilganger (scopes)

Beskrivelse

POST

{installationId}/Orders/{orderId}/Status

Sette ny status på en ordre

GET

{installationId}/Orders/{orderId}/Status

Hente status på en ordre

GET

{installationId}/Estates/{estateId}/Orders/{orderId}

Hente ordre for et oppdrag

POST

{installationId}/Orders/{orderId}/StatusRequest

Sette ny status på en ordre, inkludert liste av lenker

Ofte stilte spørsmål

I Vitec Next står det "krever manuell håndtering", hva må til for å fullføre aktivering?

Trykk på bestillingen og velg "gå til leverandøren"
​

Fyll inn felter som er sendt til megler per mail.
​

Under aktivering av bestilling dukker det opp en feilmelding. Hva gjør jeg?
Send en mail til [email protected] eller benytt chat funksjonen i nedre høyre hjørne. Send gjerne screenshots og info om hvor feilmeldingen oppstod.

Svarte dette på spørsmålet?