Dokumentation för API-funktioner

Prenumerationer kan sättas upp för information som förändras i Vitec via Express eller Connect. När information förändras så kontrollerar Vitec vilka prenumerationer som berörs. Om det finns prenumerationer som matchar förändringarna så skickas notifieringar ut för berörda prenumerationerna.

Den URL som notifieras ska returnera HTTP statuskod i 200 serien. Svarar ni inte omgående så kommer vi att anta att ni svarat med 200 OK.

Manuell notifikation

Innan Vitec aktiverar prenumerationen så kan ni prova att manuellt skapa en notifiering via Vitec Connect notifikationstest

Prenumeration

En prenumeration beskriver kriterier över vilka förändringar som ska trigga notifieringar.

Ni väljer om ni vill ha uppdateringar, raderingar (om möjligt) eller båda.

  • Update - Uppdatering
  • Remove - Radering

För att skapa en prenumeration, kontakta Vitec så sätter vi upp en prenumeration åt er.

De prenumerationsmål som ni kan prenumerera på är följande:

För bostäder så går det att specificera om notifieringen endast gäller bostäder som annonseras på hemsida och vilken typ av status som bostaden ska ha. Ni väljer också vilka typer av bostäder som prenumerationen ska gälla för.

  • House - Villa
  • Cottage - Fritidshus
  • HousingCooperative - Bostadsrätt
  • Plot - Tomt
  • Condominium - Ägarlägenhet
  • Farm - Lantbruk
  • ForeignProperty - Utlandsbostad
  • CommercialProperty - Kommersiellt objekt
  • Premises - Lokal

Parametrarna kommer både med som url parametrar och som POST data i JSON format. Undantaget är data parametern som endast skickas med i POST datat.

  • name: Namnet på prenumerationen
  • type: Estate
  • subType: House, HousingCooperative, Cottage, Plot
  • data.status: Status på bostaden
  • id: Id på bostaden
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Möjliga värden på bostadsstatus:

  • AssignmentAttempt - Intagsförsök
  • AssignmentAccepted - Intaget
  • ForSale - Till salu
  • Sold - Såld
  • Paused - Vilande
  • NoAssignment - Inget uppdrag
  • AssignmentWithdrawn - Återtagen
  • ReservedNotForSale - Reserverad/Ej till salu
  • NotForSale - Ej till salu
  • SoldReferenceObject - Såld/Referensbostad
  • Coming - Kommande
  • SoonForSale - Snart till salu
  • PreSale - Försprång (Mellan kommande och till salu)
  • ReadyForRent - Hyresledig
  • TentativelyRented - Uthyrd preliminärt
  • Rented - Uthyrd
  • AppointedAdmission - Tillträdd

Exempel på notifiering för en förändring på en bostadsrätt med status till salu
http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=Estate&event=Update&customerId=M11385&id=OBJ11385_1395932274&subtype=HousingCooperative

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "Estate",
  "event": "Update",
  "customerId": "M11385",
  "id": "OBJ11385_1395932274",
  "subtype": "HousingCooperative",
  "data": {
    "status": "ForSale"
  }
}

För projekt så går det att specificera om notifieringen endast gäller projekt som annonseras på hemsida och vilken typ av status som projektet ska ha.

Parametrarna kommer både med som url parametrar och som POST data i JSON format. Undantaget är data parametern som endast skickas med i POST datat.

  • name: Namnet på prenumerationen
  • type: Project
  • data.status: Status på projektet
  • id: Id på projektet
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Möjliga värden på projektstatus:

  • Paused - Vilande
  • Ongoing - Pågående
  • SoldOut - Slutsålt
  • Upcoming - Kommande

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: Agent
  • id: Id på användaren
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Exempel:

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=User&event=Update&customerId=M11385&id=HANE99C53F2DE4F489AB1E464D0F9AFFACD

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "User",
  "event": "Update",
  "customerId": "M11385",
  "id": "HANE99C53F2DE4F489AB1E464D0F9AFFACD"
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: Office
  • id: Id på kontoret
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

För kontakter går det att ange vilken typ av kontakt som avses (Personer, företag och/eller dödsbo).

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: Contact
  • subType: Person, Company, Estate, Association
  • id: Id på kontakten
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Ni väljer vilka typer av kontaktrelationer som prenumerationen ska gälla för.

  • EstateContactBuyer - Köpare
  • EstateContactSeller - Säljare
  • EstateContactSpeculator - Spekulanter

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: EstateContact
  • subType: EstateContactBuyer, EstateContactSeller, EstateContactSpeculator
  • relId1: Id på bostaden
  • relType1: Bostadens typ
  • relId2: Id på kontakten
  • relType2: Kontaktens typ
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Exempel på notifiering för en förändring där en säljare tillkommer på en bostad

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=EstateContact&event=Update&customerId=M11385&subType=EstateContactSeller&relId1=OBJ11385_1395932274&relType1=HousingCooperative&relId2=ADRB1173057ECD04D66B9D798812E09C1B5&relType2=Estate

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "EstateContact",
  "event": "Update",
  "customerId": "M11385",
  "subType": "EstateContactSeller",
  "relId1": "OBJ11385_1395932274",
  "relType1": "HousingCooperative",
  "relId2": "ADRB1173057ECD04D66B9D798812E09C1B5",
  "relType2": "Estate"
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: EstateContact
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör
  • subType: ViewingParticipant
  • relId1: Id på bostaden
  • relType1: Bostadens typ
  • relId2: Id på kontakten
  • relType2: Kontaktens typ
  • relId3: Id på visningen
  • relType3: Viewing

Exempel på notifiering för en förändring där en ny visningsdeltagare läggs till

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=EstateContact&event=Update&customerId=M11385&subType=ViewingParticipant&relId1=OBJ11385_1395932274&relType1=HousingCooperative&relId2=ADRB1173057ECD04D66B9D798812E09C1B5&relType2=Estate&relId3=VISF20A42E75479481A98E2D55322305353&relType3=Viewing

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "EstateContact",
  "event": "Update",
  "customerId": "M11385",
  "subType": "ViewingParticipant",
  "relId1": "OBJ11385_1395932274",
  "relType1": "HousingCooperative",
  "relId2": "ADRB1DEE2F28780457D9D9791F5E3C3C2A1",
  "relType2": "Person",
  "relId3": "VISF20A42E75479481A98E2D55322305353",
  "relType3": "Viewing"
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: OfficeEstateAgent
  • subType: Affiliation
  • relId1: Id på användaren
  • relType1: User
  • relId2: CustomerId för kontoret, exempel M20005
  • relType2: Office
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Exempel på notifiering för en förändring där en mäklare har fått en ny tillhörighet till ett kontor

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=OfficeEstateAgent&event=Update&customerId=M11385&subType=Affiliation&relId1=HANE99C53F2DE4F489AB1E464D0F9AFFACD&relType1=User&relId2=M11385&relType2=Office

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "OfficeEstateAgent",
  "event": "Update",
  "customerId": "M11385",
  "subType": "Affiliation",
  "relId1": "HANE99C53F2DE4F489AB1E464D0F9AFFACD",
  "relType1": "User",
  "relId2": "M11385",
  "relType2": "Office"
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • id: Id på mötesbokningen
  • type: Meeting
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör
  • relId1: Id på bostaden
  • relType1: Bostadens typ
  • relId2: Id på kontakten
  • relType2: Kontaktens typ

Exempel på notifiering för en förändring där en ny mötebokning läggs till

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=Meeting&event=Update&customerId=M11385&id=CAL7216862FF0AD4AE38061A04A9AC4D60D&relId1=OBJ11385_1395932274&relType1=HousingCooperative&relId2=ADRB1173057ECD04D66B9D798812E09C1B5&relType2=Estate

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "Meeting",
  "event": "Update",
  "customerId": "M11385",
  "id": "CAL7216862FF0AD4AE38061A04A9AC4D60D",
  "subType": "EstateContactSeller",
  "relId1": "OBJ11385_1395932274",
  "relType1": "HousingCooperative",
  "relId2": "ADR3ADC7B7B0A9447CA97FCAB43E36B582C",
  "relType2": "Person"
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • id: Id på noteringen
  • type: Note
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör
  • relId1: Id på bostaden
  • relType1: Bostadens typ
  • relId2: Id på kontakten
  • relType2: Kontaktens typ

Exempel på notifiering för en förändring där en ny notering läggs till

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=Note&event=Update&customerId=M11385&id=NOT7216862FF0AD4AE38061A04A9AC4D60D&relId1=OBJ11385_1395932274&relType1=HousingCooperative&relId2=ADRB1173057ECD04D66B9D798812E09C1B5&relType2=Estate

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "Note",
  "event": "Update",
  "customerId": "M11385",
  "id": "NOT7216862FF0AD4AE38061A04A9AC4D60D",
  "subType": "EstateContactSeller",
  "relId1": "OBJ11385_1395932274",
  "relType1": "HousingCooperative",
  "relId2": "ADR3ADC7B7B0A9447CA97FCAB43E36B582C",
  "relType2": "Person"
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: Area
  • id: Id på området
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Exempel på notifiering för en förändring där ett område ändras

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=Area&event=Update&customerId=M11385&id=STD7216862FF0AD4AE38061A04A9AC4D60D

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "Area",
  "event": "Update",
  "customerId": "M11385",
  "id": "STD7216862FF0AD4AE38061A04A9AC4D60D",
}

Gäller inkommande leads från externa tjänster. Notifieringar kommer enbart att skickas för inkommna leads som levererats av samma partner.

Parametrarna kommer både med som url parametrar och som POST data i JSON format. Undantaget är data parametern som endast skickas med i POST datat.

  • name: Namnet på prenumerationen
  • type: IncomingLead
  • data.partnerId: Id på partner som är källan av leadet
  • data.externalId: Id på leadet hos partnern som skickat leadet
  • data.cause: Orsaken till lead uppdateringen
  • id: Id på leadet
  • event: Update, Remove
  • customerId: Kund-id på det kontoret som ändringen tillhör

Möjliga värden på cause parametern är:

  • LeadAccepted - Ett bostad-lead blir accepterat. Status för affären - Pågående
  • LeadContacted - Ett kontaktlead får status "Kontaktad", dvs flödet tar slut. Kan jämföras med uppdrag för ett bostad-lead. Status för affären - Finns ingen affär, men motsvarande Uppdrag
  • NewMeeting - Ett nytt kundmöte har skapats för en bostad med koppling till ett bostad-lead. Status för affären - Pågående
  • NewComeback - En ny återkomst har skapats för en kontakt med koppling till ett lead (bostad eller kontakt-lead). Status för affären - Pågående
  • LeadPostponed - Leadet har blivit uppskjutet. Status för affären - Pågående
  • LeadCanceled - Ett lead har blivit avböjt eller borttaget eller en bostad har fått status "Inget uppdrag" eller motsvarande. Status för affären - Inget uppdrag
  • Assigned - Bostaden har fått status uppdrag eller högre. Status för affären - Uppdrag
  • AssignedValuation - Uppdragstyp för bostaden ändras till Värdering. Kan t.ex. hända när ett kundmöte följs upp. Status för affären - Uppdrag (Värderingsuppdrag)
  • AssignedContractWriting - Uppdragstyp för bostaden ändras till Skrivning. Status för affären - Uppdrag (Skrivuppdrag)
  • NoAssigment - Bostaden har fått status Inget uppdrag, Återtagen eller Ej till salu.

Exempel på notifiering för en uppdatering av ett inkommande lead

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=IncomingLead&event=Update&customerId=M11385&id=LED7216862FF0AD4AE38061A04A9AC4D60D

POST data: 

{
  "name": "prenumerationsnamn",
  "type": "IncomingLead",
  "event": "Update",
  "customerId": "M11385",
  "id": "LED7216862FF0AD4AE38061A04A9AC4D60D",
  "data": {
    "partnerId": "PC1",
    "externalId": "lead-id-of-partner",
    "cause": "LeadAccepted"
  }
}

Parametrarna kommer både med som url parametrar och som POST data i JSON format.

  • name: Namnet på prenumerationen
  • type: Merge
  • event: Merge
  • customerId: Kund-id på det kontoret som ändringen tillhör
  • subType: Person
  • id: Id på målet med sammanslagningen
  • destinationId: Id på målet med sammanslagningen
  • sourceIds: Array med id på sammanslagna källor, dessa kommer att vara raderade och ersatta med destinationId

Exempel på notifiering för en sammanslagning för kontakt

http://connect.maklare.vitec.net/Reciever/?name=prenumerationsnamn&type=Merge&event=Merge&customerId=M11385&subType=Person&id=ADR8462BF8CEC9D4A3D875A7B4449997B00

POST data: 

{
  "name": "prenumerationsnamn",
  "id": "ADR8462BF8CEC9D4A3D875A7B4449997B00",
  "type": "Merge",
  "event": "Merge",
  "customerId": "M11385",
  "subType": "Person",
  "destinationId": "ADR8462BF8CEC9D4A3D875A7B4449997B00",
  "sourceIds": ["ADRAC382A6314634AEB9ECC72A284B0DE09"]
}