Webmegler 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 Webmegler sitt system

Hvordan fullføre aktiveringen som megler

Oversikt over metoder og formål for integrasjonen, relatert til GDPR

ℹ️ Før aktivering av integrasjonen, ved første aktivering:
For å kunne aktivere Kvass integrasjon må det inngås en databehandleravtale mellom Kvass og meglerkontoret. Meglerkontoret vil få nødvendig informasjon fra Kvass rundt dette.

Hvordan fungerer Webmegler sitt system

Les mer om integrasjonen her

Fullfør aktivering av integrasjon

Åpne e-post mottatt fra Kvass og trykk på Aktiver tjeneste.

Deretter vil du bli sendt til en aktiveringsdialog der du skal velge hvilket prosjekt i Websystemer som integrasjonen skal aktiveres på.

Det vil deretter dukke opp en liste over enheter som er tilknyttet prosjektet, og du skal nå koble sammen enhetene i Webmegler 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)

Så snart du har fullført vil du se en bekreftelse på at integrasjonen er fullført.

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

Versjon 1

Synkronisere og kopiere enhetsdata fra Webmegler
Ved statusendringer på enhet i Webmegler, synkroniseres automatisk status til sammenkoblet enhet i Kvass.
Få automatiske oppdateringer inn i Kvass ved endring på prosjekt / enhet i Webmegler. (valgfritt)
Automatisk videresending av interessenter fra Kvass til Webmegler
Automatisk linking til budportal på enheter

Metode	Når	Formålet med tilgang til metode
GET /oppdragsoversikt/by-hovedoppdrag/{oppdragsId} OAuth2 https://app.webmegler.no/auth/oppdrag.read	Under aktiveringsprosess og ved endringer	Hente ut informasjon om prosjektets tilhørende enheter.
POST /ansatte OAuth2 https://app.webmegler.no/auth/ansatte.read	Under aktiveringsprosess	Validerer om bruker er registrert i webmegler.
GET /ansatte/{employeeId}/oppdrag OAuth2 https://app.webmegler.no/auth/ansatte.read https://app.webmegler.no/auth/oppdrag.read	Under aktiveringsprosess	For å hente ut prosjekter i webmegler slik at megler kan velge hvilket prosjekt som integrasjonen skal aktiveres på.
GET /oppdrag/{oppdragsId} OAuth2 https://app.webmegler.no/auth/oppdrag.read	Under aktiveringsprosess og ved endringer	Hente ut informasjon om oppdrag for å så opprette/oppdatere enheter i Kvass.
GET /oppdrag/{oppdragsId}/bilder OAuth2 https://app.webmegler.no/auth/oppdrag.read	Under aktiveringsprosess og ved endringer	Hente ut oppdragets tilhørende bilder og plantegninger.
GET /oppdrag/{oppdragsId}/visningspaameldinger OAuth2 https://app.webmegler.no/auth/oppdrag.read	Under aktiveringsprosess og ved endringer	Visninger opprettet i Webmegler synkroniseres til Kvass
POST /oppdrag/{oppdragsId}/interessenter POST /kontakter/{kontakttype} PUT /kontakter/{kontakttype}/{id} OAuth2 https://app.webmegler.no/auth/interessenter.readwrite https://api.webmegler.no/auth/interested.write https://app.webmegler.no/auth/kontakt.write https://api.webmegler.no/auth/contact https://api.webmegler.no/auth/contact.all https://api.webmegler.no/auth/contact.role.all	Ved ny interessent	Interessenter og kontakter i Kvass synkroniseres til Webmegler under relevant oppdrag
GET deeplink/tryggbudgivning/{oppdragsId} OAuth2 https://app.webmegler.no/auth/oppdrag.read	Under aktiveringsprosess og ved endringer	Kjøper kan gå direkte til budportal via en "Kjøp" knapp for gjeldende enhet
GET /webhook/subscriptions OAuth2 https://app.webmegler.no/auth/webhookconfig.readwrite	Under aktiveringsprosess og ved endringer	Hente ut alle webhooks events tilknyttet en client
POST /webhook/configuration OAuth2 https://app.webmegler.no/auth/webhookconfig.readwrite	Under aktiveringsprosess og ved endringer	Opprette webhooks
GET /webhook/subscription/id OAuth2 https://app.webmegler.no/auth/webhookconfig.readwrite	Under aktiveringsprosess og ved endringer	Hente ut webhook subscription basert på ID

XML søkemotor (for å enklere lese og strukturere data)

https://api.webmegler.no/auth/xmlsokemotor.listing.all

https://api.webmegler.no/auth/xmlsokemotor.listing.buyer

https://api.webmegler.no/auth/xmlsokemotor.listing.privateviewings

https://api.webmegler.no/auth/xmlsokemotor.listing.project

https://api.webmegler.no/auth/xmlsokemotor.listing.seller

Versjon 2

Funksjoner fra versjon 1
2 veis synkronisering av interessenter og kontakter mellom fagsystem og Kvass. Følgende informasjon synkroniseres: Navn, e-post, tlf, selskapsnavn, org-nr, adresse
1 veis synkronisering av kjøper informasjon.
- Hent ned informasjon om kjøperen fra fagsystem ned til Kvass. Følgende kjøper-informasjon hentes: Navn, e-post, tlf, personnummer, selskapsnavn, org-nr, adresse
- Hent ned budskjema fra fagsystem til Kvass.

Metode	Når	Formålet med tilgang til metode
GET /kontakter/{type}kontakter/{id} OAuth2 : https://app.webmegler.no/auth/kontakt.read	Ved synkronisering av kontakt / interessent / kjøper	Hente kontaktens personopplysninger via kontakt id
GET /oppdrag/{oppdragsId}/dokumenter OAuth2 https://app.webmegler.no/auth/oppdrag.dokumenter.read.all https://app.webmegler.no/auth/oppdrag.read	Ved synkronisering av kjøper	Hente kjøperens budskjema
GET /oppdrag/{oppdragsId}/dokumenter/{id}/pdffile OAuth2 https://app.webmegler.no/auth/oppdrag.dokumenter.read.all https://app.webmegler.no/auth/oppdrag.read	Ved synkronisering av kjøper	Laster ned fil basert på fil-id
POST /upload OAuth2 https://app.webmegler.no/auth/oppdrag.dokumenter.write	Ved synkronisering av kjøper (ved aktiv kjøps modul i Kvass)	Laste opp kontrakter (bud og tilvalgskontrakter)
POST /oppdrag/{oppdragsId}/kjopere OAuth2 https://app.webmegler.no/auth/oppdrag.read https://app.webmegler.no/auth/oppdrag.write	Ved synkronisering av kjøper (ved aktiv kjøps modul i Kvass)	Sett en ny kjøper på et oppdrag
POST /kontakter/{kontakttype} OAuth2 https://app.webmegler.no/auth/kontakt.write	Ved synkronisering av kjøper (ved aktiv kjøps modul i Kvass)	Opprette kontakter for å deretter opprette kontakt som kjøper
GET /oppdrag/{oppdragsId}/interessenter OAuth2 https://app.webmegler.no/auth/interessenter.readwrite	Under aktiveringsprosess, ved synkronisering av interessenter og ved endringer	Interessenter opprettet i Webmegler synkroniseres til Kvass
GET /oppdrag/{oppdragsId}/kjopere OAuth2 https://app.webmegler.no/auth/oppdrag.read	Ved synkronisering av kjøpere	Kjøpere i Webmegler synkroniseres ned til Kvass
GET /ansatte/{Id} OAuth2 https://app.webmegler.no/auth/ansatte.read	Under aktiveringsprosess og ved endringer	Hente meglers kontaktinformasjon for å opprette megler som kundebehandler på prosjektet
GET /ansatte/{Id}/profilbilde OAuth2 https://app.webmegler.no/auth/ansatte.read	Under aktiveringsprosess og ved endringer	Hente meglers profilbilde for å sette profilbilde på kundebehandler