XMLguide - Vitec Hjälp Mäklarsystem

.:: XML från
Vitec Mäklarsystem
XML
Innehållsförteckning
1. Förklaring av XML-taggar............................................................................................................................................ 2
2. Taggar på objektlista .................................................................................................................................................. 2
3. Taggar på objekt ......................................................................................................................................................... 8
4. Förhandsgranska objekt ........................................................................................................................................... 32
5. Storlek På Bilder ....................................................................................................................................................... 32
6. Användarexempel för budhantering ........................................................................................................................ 33
VITEC MÄKLARSYSTEM AB
ADRESS: REDEGATAN 1 B, 426 77 V. FRÖLUNDA
BANKGIRO: 5630-8331, PLUSGIRO: 499 04 75-8, ORG NR: 55 63 67-65 00
KUNDSERVICE: 031-360 61 60, FÖRSÄLJNING: 031-360 61 20, FAX: 031-360 61 01
HEMSIDA: www.vitec.se, E-POST: [email protected]
1
XML
1. FÖRKLARING AV XML-TAGGAR
Vitec har två XML produkter. XML-koppling lista och XML-koppling komplett. De erbjuder båda
möjligheten att använda data från Vitec:s centrala databas för Vitec Mäklarsystem. Vitec
Mäklarsystem AB tar inget ansvar för hur xml-kopplingen används.
För att du ska kunna förstå och enklare kunna använda vår xml så har vi i den här guiden
sammanfattat det mest väsentliga. Vi beskriver här vad de olika taggarna innehåller för data. All
data kommer från vår kunds Vitec Mäklarsystem och vårt kundregister.
OBS! Programmera inte utifrån guiden. Utgå i första hand från xml-kopplingen och använd endast
guiden som en referens där det går att utläsa vad de olika taggarna kan ge för information.
Taggarnas utseende kan variera mellan guiden och koden.
Tips! Fält som är av typen bool (1 eller 0), är tyvärr av olika art, ibland är ”1” true och ibland är det
”-1” som är true, och ibland är värdet null. Detta pga. flera system i drift som tolkar olika. Gör därför
kontrollen tvärtom, t.ex. if (maBildonobj != null) && (maBildonobj != 0) //mäklarens bild ska visas
2. TAGGAR PÅ OBJEKTLISTA
Exempel på en objektlista i xml
http://net.sfd.se/Gateway.aspx?SFDGatewayID=58&DBSPace=26301
Dagens objekt - objektlista med de objekt som är markerade med dagens objekt
http://net.sfd.se/Gateway.aspx?SFDGatewayID=58&DBSPace=26301&DagensObjekt=1
Referenslistan - objekt som är annonserade efter att de är sålda
http://net.sfd.se/Gateway.aspx?SFDGatewayID=58&DBSPace=26301&RefObject=3
Blå rad = Kommentarer
Gul rad = Starttagg
Orange rad = Sluttagg
2
XML
Taggnamn
Exempelvärde
Kommentar
- <sfdXMLObjectList>
Det kan vara nästan hur många objekt som helst i listan.
- <objekt>
GID
OBJ26301_539959542
Unik objektnyckel
akttid
2012-09-25 0akttid8:08:21.000
Datum då objektet senast
ändrades.
ObjektUrl
http://w4.objektdata.se/pregen/542/OBJ26301_5399
59542/wp.htm?SID=iw1gtf55xqrxcjuc222yve45
Länk till Vitecs
standardwebbeskrivning.
ObjektUrlXML
http://w4.objektdata.se/pregen/542/OBJ26301_5399
59542/wp.xml?SID=iw1gtf55xqrxcjuc222yve45
Länk till ett objekts xml.
bildListaXml
http://w4.objektdata.se/pregen/886/OBJ26301_1318
932886/bilder.xml?firmanr=26301
Länk till bilder.xml som
innehåller objektets alla
bilder mm. Använd främst
bilder.xml för att bygga
bildlistor.
BildUrl
http://pics.objektdata.se/pic/pic.dll/image?url=26301
/SFDC8587FFD889348E9B30755DB454F0BC3.jpg&siz
ex=320&sizey=240
Huvudbilden från Vitec
Mäklarsystem.
Hämta önskad storlek på
bilden. Byt ut till
&sizex=(önskad
storlek)&sizey=(önskad
storlek)
Exempel
&sizex=800&sizey=400
Kommun
Hallsberg
Objektets kommun.
Omrade
Askims torg
Objektets område.
3
XML
Adress
Askåkersplan 8
Objektets adress.
Rum
6
Antal rum
ObjektTyp
0
Objekttyp är en
sammanställning av
boendeform och
upplåtelseform.
0=Villa
1=Fritidshus
2=BR-lägenhet
3=Hyresrätt
4=Tomt
5=Avstyckad gård/Gård
6=Övrigt
7=Utlandsobjekt
8=Kommersiell fastighet
9=Lokal
10=Rörelse
11=Projekt
ObjektTypText
4
Villa
Objektyp i klartext. Se
objekttyp
XML
Boendeform
0
0=en familjs friliggande,
1=två familjs friliggande,
2=Radhus, 3=Kedjehus,
4=Parhus, 5=Fritidshus,
6=Lägenhet, 7=Tomt,
8=Avstyckad Gård, 9=Övrigt,
10=Hyresrätt,
11=Gård/Jordbruk/Skog,
12=Hyresfast,
13=Industrifast,
14=Kontorsfast,
15=Industrimark, 16=Övrig
Kommersiell fastighet,
17=Butikslokal,
18=Kontorslokal,
19=Industrilokal,
20=LagerLokal, 21=OvrLokal,
22=Affärs Rörelse, 23=Övrig
Rörelse, 24=Projekt,
25=Bestånd
Boendeformtext
enfamiljs
Boendeform i klartext. Se
boendeform
Upplatform
0
0=Friköpt, 1=Tomträtt,
2=Arrende, 3=BR,
4=Andelsrätt, 5=Hyresrätt,
6=Andel i bostadsförening,
7=Lokal, 8=Bolag
Upplatformtext
Friköpt
Upplåtelseform i klartext. Se
Upplatform
Arrende_objekt
Fritext
Beskrivning av byggnad på
arrenderad mark.
Boarea
106
För Objekttyp 8,9 är det
Bruksarea som avses.
Biarea
56
Biarea
5
XML
Tomtareal
1003,5
I kvm
(endast objekttyp 0,1,6)
Avgift
3500
För upplatform
1=tomträttsavgäld/år,
2=Arrende/år,
3,4,6=Månadsavgit,
5=Månadshyra.
Beskrivning
Vackert beläget...
Säljande beskrivning (max
400 tkn)
saljrubrik
Det perfekta huset!
Säljrubrik
Pris
1200000
Objektets officiella pris
Msadress
Långevägen 12
Objektets officiella adress
mspris
1200000
Objektets officiella pris
6
XML
Kind
Status på objektet.
190=Intaget
190 + <status> (bitmask) 25
=Kommande
försäljning/förannonserat
200=Försäljning, "Till salu"
220=Försäljning, "Budgivning
pågår"
240=Försäljning,
"Reserverad" (syns i
tillsalulistor)
300=Försäljning, "Till salu",
internetannonserad
320="Budgivning pågår",
internetannonserad (se
budtyp)
340=Försäljning,
"Reserverad",
internetannonserad
350=Projekt/bestånd,
internetannonserad
510="Såld", men visas i
referenslistor
Byggnar
1984
Byggnadsår
(endast objekttyp 0,1,2,6)
VisningsDag
2008-11-01
Startdatum för
nästkommande visning.
VisningsTidStart
18:00
Starttid för nästkommande
visning.
VisningsTidSlut
19:00
Sluttid för nästkommande
visning.
7
XML
VisningsText
Öppen visning. Välkommen!
Kommentar till visningtiden.
X
6550094
RT 90 Koordinat
Y
1458505
RT 90 Koordinat
Longitude
57.70964984568052
Longitude
Latitude
11.953983306884766
Latitude
PrisAnnanValuta
240.000
Pris i annan valuta.
ValutaKod
USD
Kod för annan valuta.
DagensObjekt
True
Objektet är annonserat som
dagens objekt.
True/False.
AnnonsTid
2005-11-14 14:44:16
Objektet är annonserat.
</objekt>
</sfdXMLObjectList>
3. TAGGAR PÅ OBJEKT
Exempel på ett objekt i xml
http://w4.objektdata.se/pregen/512/OBJ26301_476118512/wp.xml?SID=xdafc5vmbwjg2i55rmefzl45
Blå rad = Kommentarer
Gul rad = Starttagg
8
XML
Orange rad = Sluttagg
Taggnamn
Exempelvärde
Kommentar
<OBJEKT gid="OBJ26301_539959542">
OBJEKT gid
OBJ26301_539959542
Unik objektnyckel
- <Firma nr="26301">
Firma nr
26301
Kundnr hos Vitec
(Hämtas från Vitecs
kundregister)
faNamn
ABC-mäklaren
Mäklarkontorets namn
(Hämtas från Vitecs
kundregister)
faAdress
Husgatan 1
Postadress
(Hämtas från Vitecs
kundregister)
faBesokAdr
Husgatan 1
Hämtas från Vitec
Mäklarsystem.
faPostnr
101 10
Kontorets postnr
(Hämtas från Vitecs
kundregister)
faPostadress
101 10 Husstad
Postnr + Ort
(Hämtas från Vitecs
kundregister)
faTel1
030-120130
Kontorets telefonnr.
(Hämtas från Vitecs
kundregister)
9
XML
faFax
030-120139
Kontorets faxnr.
(Hämtas från Vitecs
kundregister)
faHemsida
www.abc.se
Hemsidans adress.
(Hämtas från Vitec
Mäklarsystem)
faXtra
Besökskontor i hamnen
Extra rad fritextrad.
(Hämtas från Vitec
Mäklarsystem)
faKontor
Används inte
</Firma>
- <Maklare>
Mäklarens information hämtas från Vitec Mäklarsystem.
maNamn
Kalle Nilsson
Ansvarig mäklares namn
maEmail
[email protected]
Ansvarig mäklares e-post
maMobilnr
0709-101010
Ansvarig mäklares mobilnr
maTitel
Aukt. Fast.mäklare.
Ansvarig mäklares titel
maDirektnr
030-120131
Ansvarig mäklares direktnr
maBildRelurl
115154/SFD8C8E10643ECE2.jpg
Relativ url till bilden på
mäklaren.
maBildUrl
http://pics.objektdata.se/pic/pic.dll/image?url=13245
/SFD29314F086C2C431A822D2CD4B19EF51B.jpg
Absolut url till bilden på
mäklaren.
10
XML
maBildonobj
-1
Om mäklaren valt att visa
mäklarporträttet på
objekten.
-1 = True
0 = False
maInit
KN
Mäklarens initialer
maDontPublish
0
Visa mäklarens information
på personalpresentationen.
-1 = True
0 = False
</Maklare>
- <Extrakontaktperson>
Den extra kontaktpersonens information hämtas från Vitec Mäklarsystem.
ekNamn
Kalle Nilsson
Extra kontaktpersonens
namn
ekEmail
[email protected]
Extra kontaktpersonens epost
ekMobilnr
0709-101010
Extra kontaktpersonens
mobilnr
ekTitel
Assistent
Extra kontaktpersonens Titel
ekDirektnr
030-120131
Extra kontaktpersonens
direkttelefonnr
ekBildRelurl
115154/SFD8C8E10643ECE2.jpg
Relativ url till bilden på den
extra kontaktpersonen.
ekBildUrl
http://pics.objektdata.se/pic/pic.dll/image?url=15154
/SFD29314F086C2C431A822D2CD4B19EF51B.jpg
Absolut url till bilden på den
extra kontaktpersonen.
11
XML
ekBildonobj
-1
Om extra kontaktpersonen
valt att bilden på
honom/henne skall visas på
objektet.
-1 = True
0 = False
ekInit
KN
Extra kontaktpersonens
initialer
ekDontPublish
0
Visa extra kontaktpersonens
information på
personalpresentationen.
-1 = True
0 = False
</Extrakontaktperson>
- <Forening>
Förening/Jordägare (endast objekttyp 2, samt Upplåtelseform 2)
ForNamn
Boendeföreningen Katten
Namnet på föreningen.
ForTxt
Allmänt om föreningen på fliken förening. Lorem
ipsum dolor sit amet…
info om föreningen.
forKontaktNamn
Kalle Karlsson
Föreningens kontaktperson
forKontaktTel
031-3606120
Kontaktpersonens telefonnr.
maDirektnr
030-120131
Ansvarig mäklares direktnr.
</Forening>
Fastbet
12
Kärra 12:64
Fastighetsbeteckning
XML
Objekttyp
0
Objekttyp är en
sammanställning av
boendeform och
upplåtelseform.
0=Villa
1=Fritidshus
2=BR-lägenhet
3=Hyresrätt
4=Tomt
5=Avstyckad gård/Gård
6=Övrigt
7=Utlandsobjekt
8=Kommersiell fastighet
9=Lokal
10=Rörelse
11=Projekt
Objekttyptext
Villa
Objektyp i klartext. Se
objekttyp
Upplatform
0
0=Friköpt, 1=Tomträtt,
2=Arrende, 3=BR,
4=Andelsrätt, 5=Hyresrätt,
6=Andel i bostadsförening,
7=Lokal, 8=Bolag
Upplatformtext
Friköpt
Upplåtelseform i klartext. Se
upplatform
13
XML
Boendeform
0
0=en familjs friliggande,
1=två familjs friliggande,
2=Radhus, 3=Kedjehus,
4=Parhus, 5=Fritidshus,
6=Lägenhet, 7=Tomt,
8=Avstyckad Gård, 9=Övrigt,
10=Hyresrätt,
11=Gård/Jordbruk/Skog,
12=Hyresfast,
13=Industrifast,
14=Kontorsfast,
15=Industrimark, 16=Övrig
Kommersiell fastighet,
17=Butikslokal,
18=Kontorslokal,
19=Industrilokal,
20=LagerLokal, 21=OvrLokal,
22=Affärs Rörelse, 23=Övrig
Rörelse, 24=Projekt,
25=Bestånd
Boendeformtext
enfamiljs
Boendeform i klartext. Se
boendeform
Projnamn
Stenkullen
Om Objekttyp=11 finns här
projektets namn
LghRefNr
12
Lägenhetens referensnr i
föreningen, lägenhetsnr
lägenhetsnummer
14
XML
Kind
Status på objektet.
200=Försäljning, "Till salu"
220=Försäljning, "Budgivning
pågår"
240=Försäljning,
"Reserverad" (syns i
tillsalulistor)
300=Försäljning, "Till salu",
internetannonserad
320="Budgivning pågår",
internetannonserad (se
budtyp)
340=Försäljning,
"Reserverad",
internetannonserad
350=Projekt/bestånd,
internetannonserad
510="Såld", men visas i
referenslistor
Taxkod
220
Taxeringskod. Vill du ha i
klartext så får du själv skapa
en översättning. Hämta
Skatteverkets typkod
(taxkod).
(endast objekttyp 0,1,5,6,8)
Taxvarde
890000
Fastighetens taxeringsvärde.
(endast objekttyp 0,1,6)
taxbygg
300 000
Byggnadens taxeringsvärde
(endast objekttyp 0,1,6)
taxar
2008
Taxeringsår
(endast objekttyp 0,1,6)
15
XML
Rattigheter
Servitut väg: ...
Servitut/Rättigheter/Gemens
amhetsanläggningar.
(endast objekttyp 0,1,6)
Msadress
Långevägen 12
Objektets officiella adress
Adress2
492 92 Göteborg
Objektets postnr och postort.
Omrade
Långedrag
Valfri områdestext.
Kommun
Göteborg
Kommun i klartext.
Land
Sverige
Land i klartext.
Landskodiso
SE
Landskoder enligt ISO.
Sverige är SE.
Kommskatt
33,09
Kommunal skatt i objektets
kommun. Anges i procent.
Vaning
3
Våningsplan, endast
objekttyp 2,3.
Vaningav
6
Av antal våningar, endast
objekttyp 2,3.
mspris
1200000
Objektets officiella pris
pristext
Eller högstbj.
Priskommentar
nytid
den 20 maj 2003 15:04
inskickad till Vitecs centrala
databas
tomttyp
Trädgårdstomt
Tomttyp
(endast objekttyp 0,1,6)
driftskostnad
20000
Kr/år
(endast objekttyp 0,1,2,6)
16
XML
druppv
1000
Driftkostnad Uppvärmning,
Kr/år
drel
1000
Driftkostnad El, Kr/år
drva
1000
Driftkostnad Vatten, Kr/år
Drren
1000
Driftkostnad Renhållning,
Kr/år
drvag
1000
Driftkostnad
Väg/Samfällighetsavgift,
Kr/år
drsot
1000
Driftkostnad Sotning, Kr/år
drfors
1000
Driftkostnad Försäkring, Kr/år
drovr
1000
Driftkostnad Övrigt, Kr/år
drpers
1
Antal personer som
driftkostnad avser
DrEnergiforbrukning
El-förbrukning kWh/år
DrElleverantor
El-leverantör
DrNatleverantor
Nät-leverantör
DrKommentar
sträng
Kommentar till driftkostnad
pantbrevsum
650000
Summa bef. Pantbrev
(endast objekttyp 0,1,6)
17
XML
status
33812
Konvertera till binärtal.
Utläs vilka bit:ar som är satta
till 1.
2= Internet Grundannons
3= Koordinater är
Lantmäteriets
4= Lantmäteriinfo ifylld på
objektet
6= Annonserad på Hemnet
15= Annonserad på hemsida
(Webpack)
16=Annonserad på Bovision
17= Annonserad på
kommersiella.se
18= Internetannonsera 1
visningtid åt gången
19= Annonserad i
webbildslinga
20= Annonserad på
Sverigelokaler.se
21= Annonserar på
Objektvision
22=Hemnetannonsera
nyproduktion även under
begagnat
23=Hemnetannonsera
fritidshus som vinterboende
25=Förannonsera
Exempel:
33812 = 1000010000010100
Vilket ger 2, 4, 10, 15
18
XML
Hiss
-1,0
-1=hiss finns, 0 = ej angivet
(endast objekttyp 0,1,2,3,5,6)
OBS! Detta fält är gammalt
och är ersatt med HissFinns!
HissFinns
True, false, null (tomt)
True=hiss finns
False=hiss finns ej
Null(tom sträng) = ej angivet
Lkf
148001
Län-KommunFörsamlingskod. Varje del är
två siffror.
ovrigt
Trädgården har en mycket vacker…
Övrigt om tomten
(endast objekttyp 0,1,6)
Ovrigt2
Till lägenheten hör..
Allmänt om lägenheten
Ovrigtbyggn
Stor träaltan (4,5 x 10,5 m) i söderläge. 10 cm…
Övrigt byggnad
(endast objekttyp 0,1,2,6)
Ovrigabyggn
Friliggande garage med vidbyggd vedbod…
Övriga byggnader
(endast objekttyp 0,1,2,6)
OvrTomt
BR-förening med god ekonomi. Ingen
avgiftshöjning sedan jan 2000
Objekttyp 2. Allmänt om
lägenheten
Övriga objekttyper är det här
Övrig tomt på fliken
Fastighet.
(endast objekttyp 0,1,2,3,5,6)
naromradekommuni
kation
Kommunikationsmedel i
närområdet
naromradeparkering
Parkeringsmöjligheter i
närområdet
19
XML
naromradeallmant
Allmänt om närområdet
naromradenarservic
e
Affärer och annan service i
närområdet
naromradeovrigt
Övrig info om närområdet
Budtyp
0
Om en budgivningstjänst
används. 0=Ingen
webbudgivning (Manuell
hantering i Mäklarsystemet.)
2=Handelsbankens E-bud,
3=SFD WebPack Bud.
budstyle
1
0 = Ingen webbudgivning
1 = Visa budhistorik
(Gäller endast för budtyp 3)
budhistorikstyle
1
0 = mäklaren vill ej visa
budhistorik
1 = mäklaren vill visa
budhistorik
(Gäller endast för budtyp = 3)
Budrelurl
20
URL till budgivningstjänst Ebud.
XML
iExtra
10272
Obs detta fält behöver du inte
använda direkt, använd
istället resp. värdes hjälp-fält.
Läs nedan.
Konvertera till binärtal.
Utläs vilka bit:ar som är satta
till 1.
0 = Webpack Dagens objekt
Obs använd det enskilda
fältet ”dagensObjekt”
5 = Byteskrav
Obs använd det enskilda
fältet ”byteskrav”
10 = Webpack Dagens
referensobjekt
Obs använd det enskilda
fältet
”dagensReferensObjekt”
11 = Visa högsta bud på
webpres
Obs använd det enskilda
fältet ”budstyle”
13 = Visa budhistorik på
webpres
Obs använd det enskilda
fältet ”budhistorikstyle”
Exempel:
10272=10100000100000
Vilket ger 5, 11 & 13.
dagensObjekt
1 eller 0
Anger att objektet är
markerat som dagensObjekt.
dagensObjekt
1 eller 0
Anger att objektet är
markerat som
dagensReferensObjekt.
21
XML
Byteskrav
-1
-1 = Byteskrav finns
0 = Byteskrav finns ej
byteskravtext
Bytes med 3:a...
Beskrivning byteskrav
Husform
1plansvilla i vinkel
Fritext husets form.
(endast objekttyp 0,1,2,6)
Boarea
106
För Objekttyp 8,9 är det
Bruksarea som avses.
Biarea
56
Biarea
bobitext
taxeringsinformation
Källa till boarean
Rum
3
Antal rum i bostaden
(endast objekttyp 0,1,2,3,5,6)
sovrummin
1
Minimum antal sovrum
(endast objekttyp 0,1,5,6)
sovrummax
2
Maximum antal sovrum
(endast objekttyp 0,1,5,6)
Koktyp
Kök
Används i objekttyp=2,3 i
komb. Med Rum. Exvis 3 rum
+ kök.
(endast objekttyp 0,1,2,3,5,6)
Badrumbeskr
WC, dusch...
Utrustning/beskrivning
badrum.
(endast objekttyp 0,1,2,3,5,6)
22
XML
Tvattbeskr
Tvättmaskin...
Utrustning/beskrivning
tvätt/grovkök.
(endast objekttyp 0,1,2,3,5,6)
Tomtareal
1003,5
I kvm
(endast objekttyp 0,1,6)
Picurl
http://farm1.pics.objektdata.se/pic/pic.dll/image?
url=26301/SFDA89AC3FC1CD6472AA7D6D9B65E6E
043F.jpg&sizex=250
Huvudbilden från Vitec
Mäklarsystem.
Hämta önskad storlek på
bilden. Byt ut till
&sizex=(önskad
storlek)&sizey=(önskad
storlek)
Exempel
&sizex=800&sizey=400
Beskrivning
Vackert beläget...
Säljande beskrivning (max
400 tkn)
tilltrdag
2013-11-19
Datum för tillträde
Tilltrtext
Juni-aug 2004
Förslag/säljarens önskemål
om tillträde.
Vagbeskr
Sväng höger…
Vägbeskrivning
Visninfo
Ring för personlig visning.
Text som visas när det inte
finns någon inbokad visning.
(visningsinfo)
- <visningar>
I den här taggen kan flera <visning> förekomma.
- <visning>
PubStart
23
2008-11-01 18:00
Visningens starttid
XML
PubSlut
2008-11-01 19:00
Visningens sluttid
GID
VISA0C1AC66517E4CD3A64F8E24AE7A25A1
Visningens unika nyckel
Text
Öppen visning. Välkommen!
Visningskommentar
BokaVisningPublic
erad
1
0 = Visa inte länk till boka
visning
1 = Visa länk till boka visning
BokaVisningUrl
http://bokavisning.maklare.vitec.net/[firmanr]/[Objek
tGit]/?css=5d646d;333a43;515861;fff;fff
Länk till boka visning.
CSS är parameter med färger
för att styla gränssnittet.
?css=[bakgrund övre
del];[bakgrund nedre
del];[inmatningsfält];[knappa
r];[text]
BokaVisningDoljIn
nanVisning
2014-01-15 15:00:00
Datum/klockslag för när
tjänsten skall ”stängas av”.
Används oftast nån timme
innan visningen börjar för att
det inte ska dyka upp
oanmälda personer.
Hallen är ljus…
Rumsbeskrivning – oftast
många tecken.
</visning>
</visningar>
Planlosning
(endast objekttyp 0,1,2,3,5,6)
Avgift
3500
För upplatform
1=tomträttsavgäld/år,
2=Arrende/år,
3,4,6=Månadsavgit,
5=Månadshyra.
Avgifttext
Inkl värme, VA
Avgiftskommentar
24
XML
Byggnar
1984
Byggnadsår
(endast objekttyp 0,1,2,6)
Byggnartext
renoverad 1990
Kommentar till byggnadsår.
(endast objekttyp 0,1,2,6)
- <pictures numpics="14">
pictures numpics
14
Antal bilder som är
annonserade på objektet.
picture pid
1
Bild nr
Picnamn
Entréfasad
Bildens namn
Picurl
http://farm1.pics.objektdata.se/pic/pic.dll/image?url
=26301/SFDA89AC3FC1CD6472AA7D6D9B65E6E043F.
jpg&sizex=390&sizey=272
Länk till bilden. &sizex=390
bestämmer bredden.
&sizey=272 bestämmer
höjden. Storleken kan ändras
till valfritt värde i pixlar.
Thumburl
http://farm1.pics.objektdata.se/pic/pic.dll/image?url
=26301/SFDA89AC3FC1CD6472AA7D6D9B65E6E043F.
jpg&sizex=80
Länk till bilden. &sizex=80
bestämmer bredden.
Storleken kan ändras till
valfritt värde i pixlar.
Picgrupp
exteriör syd-väst
Anger vilken bildgrupp bilden
tillhör.
- <picture pid="1">
25
XML
Pickategori
Integer ex 0,1
Används för att kategorisera
bilder.
Exteriör=0
Interiör=1
Planritning=2
Kartbild=3
Tomtkarta=4
Övrigt=5
Personbild=6
Ikon=7
Webbild=8
Kontorsbild=9
Närområdesbild=10
</picture>
</pictures>
- <pdfs numpdfs="2">
pdfs numpdfs
2
Antal pdf:er som är
annonserade på objektet.
pdfurl name=""
<pdfurl name="Produktblad WebPack Bud">
Namn och Länk på en bifogad
pdf.
http://pics.objektdata.se/_media_/26301/SFD35F75B
AF39DF4880AC9D9AB06B9716C5.pdf
</pdfs>
- <pdfdokument numpdfs="2">
pdfdokument
numpdfs
2
Antal pdf:er som är
annonserade på objektet.
Name
Produktblad WebPack Bud
Namn på bifogad pdf.
url
http://pics.objektdata.se/_media_/26301/SFD35F75B
AF39DF4880AC9D9AB06B9716C5.pdf
Länken till pdf:en
- <pdf>
</pdf>
26
XML
</pdfdokument>
- <utsokbegrepp>
Det kan vara hur många utökade sökbegrepp som helst. Helt dynamiskt.
Text
Garage för en bil
Utökade sökbegrepp
definieras helt fritt i Vitec
Mäklarsystem.
</utsokbegrepp>
- <lankar>
Det kan vara hur många länkar som helst. Helt dynamiskt. Länkarna läggs in i Vitec Mäklarsystem.
- <lank>
Url
http://www.hallsberg.se
Länken som är bifogad.
Text
Hallsbergs kommun
Länkens namn
Kategori
0
Vitec Mäklarsystem har
bestämt vilken kategori
länken tillhör.
0 = Media
1 = Info
Grupp
Används ej
</lank>
</lankar>
X
6550094
RT 90 Koordinat
Y
1458505
RT 90 Koordinat
parkering
Används inte
omgivning
Används inte
27
XML
kommunikation
Stomme
Används inte
Trä
Stomme
(endast objekttyp 0,1,6)
Bjalklag
Trä
Bjälklag
(endast objekttyp 0,1,6)
Grundmur
Betong
Grundmur
(endast objekttyp 0,1,6)
Grundlaggn
Betong
Grundläggning
(endast objekttyp 0,1,6)
tak
Tegel
Tak
(endast objekttyp 0,1,6)
fasad
Trä
Fasad
(endast objekttyp 0,1,6)
plat
Aluminium
Utv.plåtarbete
(endast objekttyp 0,1,6)
fonster
3-glas
Fönster
(endast objekttyp 0,1,2,6)
uppvarmn
Fjärrvärme+olja
Uppvärmning
(endast objekttyp 0,1,2,6)
vent
Till-/frånluft via värmepump
Ventilation
VA
Kommunalt VA.
Beskrivning Vatten/Avlopp
(endast objekttyp 0,1,6)
28
XML
saljrubrik
Det perfekta huset!
Säljrubrik
andelstal
1,0982
Andelstal i förening
andelstalenhet
%
Enheten för andelstalet i
föreningen.
Andelformog
120000
Förmögenhetsvärde
Repfond
15000
Reparationsfond (i kr)
Projuniknr
871239871
Unik id för projekt. Endast
om objektet ingår i ett
projekt.
EnergiDeklUtford
0
0 = Ej vald
1 = Ej utförd
2 = Utförd
3 = Behövs ej
4 = Beställd
EnergiDeklDatum
2011-08-24
Datum för utförandet
EnergiKlass
EnergiDeklEnergifo
rbrukning
-, A, B, C, D, E, F, G
130
Energiförbrukning i
kWh/m2(Atemp) och år
- <webbudgivning>
Visabudgivningpagar
0
0 = Visa ej att
budgivning pågår publikt
1 = Man får visa att
budgivning pågår
29
XML
visahogstabud
0
0 = Visa ej högsta bud
publikt
1 = Man får visa högsta
bud publikt
visabudhistorik
0
0 = Visa ej budhistorik
publikt
1 = Man får visa
budhistorik publikt
</ webbudgivning >
Bidhistory
http://net.sfd.se/WebPack/KundSida/__ObjectBidHi
story.aspx?ObjGID=OBJ26301_539959542&DBSpace
=26301
Budhistorik om Budtyp är
3=SFD Budgivning på
webben.
OBS Använd istället urlen i
fältet ”wpbudxml” för att
hämta budhistorik och högsta
bud via xml.
highbid
http://net.sfd.se/WebPack/ObjectHighBid/__GetObj
ectHighBid.aspx?ObjGID=OBJ26301_539959542&DB
Space=26301&NumFormatSeparator=_
För närvarande högsta budet.
Ange hur du vill dela av
siffrorna. Välj lämpligt tecken
med
NumFormatSeparator=
OBS Använd istället urlen i
fältet ”wpbudxml” för att
hämta budhistorik och högsta
bud via xml.
HemnetHTML
<table border="0" cellpadding="1" cellspacing="0"…
FÄLTET ÄR OBSOLET!
Finns kvar för
bakåtkompabilitet
30
XML
WPHTML
<table….
FÄLTET ÄR OBSOLET!
Finns kvar för
bakåtkompabilitet
kartUrl
Länk till objektet på karta
WPBoendekalkyl
Länk till
boendekostnadskalkyl för
objektet
Uppdragsdag
uppdragsdag
avtalsdag
2008-06-01
Datum för kontraktskrivning
PrisAnnanValuta
Pris
ValutaKod
Valutakod
Planbestammelser
Fritext {Byggnadsplan,
detaljplan mm}
</OBJEKT>
31
XML
4. FÖRHANDSGRANSKA OBJEKT
I mäklarsystemet finns under PR-fliken en tjänst som heter ”Objektet på webben”. Denna används
för att låta säljaren förhandsgranska objektet innan det visas på marknadsplatserna.
Objekt som ännu inte är publika får inte visas på några offentliga sajter. Alla objektlistor spindlas av
google och flera marknadsplatser. Det innebär att vi inte kan ha med dessa objekt i våra listor.
Däremot finns datan för objekten hos oss. Själva wp.xml finns genererad.
För att stödja förhandsgranskning av objekt gör på följande sätt:
1.
Anropa objekt-xml för objektet http://w4.objektdata.se/pregen/746/OBJ26301_527313746/wp.xml
Länken byggs upp så här
2.
3.
a. http://w4.objektdata.se/pregen/ är statiskt, ändras aldrig.
b. /746/ är de sista 3 siffrorna i objekt-giden (OBJ26301_527313746) dvs skulle giden slutat på 825 så
hade länken innehållit /825/ istället.
c. /OBJ26301_527313746/ är objektets gid
d. wp.xml är vår genererade xml med objektdata
Läs in datan från den uppbyggda länken
Presentera objektpresentation för klienten
5. STORLEK PÅ BILDER
Hämta önskad storlek på bilden som finns i taggen <picurl>. Parametrarna sizex och sizey kan
bytas ut till Cropx och Cropy med valfri storlek. Storleken anges i pixlar. Crop beskär bilden. Size
ändrar storleken proportionerligt. Bilden minskas/ökas för att passa in men behåller proportionerna.
Exempel:
&sizex=(önskad storlek)&sizey=(önskad storlek)
http://pics.objektdata.se/pic/pic.dll/image?url=26301/SFDA89AC3FC1CD6472AA7D6D9B65E6E04
3F.jpg&sizex=800&sizey=400
32
XML
6. ANVÄNDAREXEMPEL FÖR BUDHANTERING
Här beskrivs i mer ingående detalj hur du ska använda dig av budgivning, högsta bud och
budhistorik
Noden <webbudgivning> är enbart synlig ifall du har produkten ”Webbudgivning”.
<visabudgivningpagar>
0 = Visa ej att budgivning pågår publikt
1 = Man får visa att budgivning pågår
<visahogstabud>
0 = Visa ej högsta bud publikt
1 = Man får visa högsta bud publikt
<visabudhistorik>
0 = Visa ej budhistorik publikt
1 = Man får visa budhistorik publikt
<webbudgivning>
<visabudgivningpagar>1</visabudgivningpagar>
<visahogstabud>1</visahogstabud>
<visabudhistorik>1</visabudhistorik>
</webbudgivning>
Värdena för högsta bud och budhistorik ligger i en separat xml, vars url ligger i taggen
<wpbudxml>
Exempel på hur <wpbudxml> kan se ut:
<wpbud>
<bidhistory>
<bid>
<bidder>KI</bidder>
<amount>1900000</amount>
<timestamp>2008-02-25 12:03</timestamp>
33
XML
<cancelled>0</cancelled>
</bid>
</bidhistory>
<highbid>1900000</highbid>
</wpbud>
34