Vanzari
Inchirieri
Pentru a putea publica prin intermediul API in VDI.ro trebuie sa indepliniti 2 conditii:
Pentru a adauga un cont de agent trebuie sa trimiteti un JSON valid prin metoda POST care sa contina campurile de mai jos, la adresa:
https://api.vdi.ro/api?apikey=CHEIE_API&cat=add
idintern
obligatoriu
ID-ul intern al agentului in soft-ul intern. Trebuie sa fie o valoare numerica unica.
firstname
obligatoriu
Numele agentului
lastname
obligatoriu
Prenumele agentului
phone
obligatoriu
Numarul principal de telefon al agentului. Se accepta doar cifre.
phone2
optional
Numarul secundar de telefon al agentului. Se accepta doar cifre.
phone3
optional
Numarul al 3-lea de telefon al agentului. Se accepta doar cifre.
obligatoriu
Adresa de e-mail a agentului.
position
optional
Functia agentului in format text (nu se accepta TAG-uri HTML).
photo
optional
Fotografia agentului. Se trimite un link de forma https://www.siteulmeu.ro/pozaagent.jpg. Se accepta poze in format JPG sau PNG.
city
optional
Localitatea principala in care isi desfasoara activitatea agentul.
optional
Link-ul profilului de Facebook al agentului. Informatia se va afisa in pagina de profil a agentului.
optional
Link-ul profilului de Twitter al agentului. Informatia se va afisa in pagina de profil a agentului.
youtube
optional
Link-ul canalului de Youtube al agentului. Informatia se va afisa in pagina de profil a agentului.
optional
Link-ul profilului de Pinterest al agentului. Informatia se va afisa in pagina de profil a agentului.
optional
Link-ul profilului de Instagram al agentului. Informatia se va afisa in pagina de profil a agentului.
cv
optional
CV-ul sau descrierea agentului in format text (nu se accepta TAG-uri HTML)
{
"idintern" : "18",
"firstname" : "Andrei",
"lastname" : "Vasile",
"email" : "andrei.vasile@agentiamea.ro",
"phone" : "0722000000",
"phone2" : "",
"phone3" : "",
"position" : "Consultant Imobiliar",
"photo" : "https://www.agentiamea.ro/pozaagent.jpg",
"city" : "Bucuresti",
"facebook" : "",
"twitter" : "",
"youtube" : "",
"pinterest" : "",
"instagram" : "",
"cv" : ""
}
Pentru a modifica un cont de agent trebuie sa trimiteti un JSON valid prin metoda POST care sa contina campurile de mai jos, la adresa:
https://api.vdi.ro/api?apikey=CHEIE_API&cat=edit
idintern
obligatoriu
ID-ul intern al agentului in soft-ul intern. Trebuie sa fie o valoare numerica unica.
firstname
obligatoriu
Numele agentului
lastname
obligatoriu
Prenumele agentului
phone
obligatoriu
Numarul principal de telefon al agentului. Se accepta doar cifre.
phone2
optional
Numarul secundar de telefon al agentului. Se accepta doar cifre.
phone3
optional
Numarul al 3-lea de telefon al agentului. Se accepta doar cifre.
obligatoriu
Adresa de e-mail a agentului.
position
optional
Functia agentului in format text (nu se accepta TAG-uri HTML).
photo
optional
Fotografia agentului. Se trimite un link de forma https://www.siteulmeu.ro/pozaagent.jpg. Se accepta poze in format JPG sau PNG.
city
optional
Localitatea principala in care isi desfasoara activitatea agentul.
optional
Link-ul profilului de Facebook al agentului. Informatia se va afisa in pagina de profil a agentului.
optional
Link-ul profilului de Twitter al agentului. Informatia se va afisa in pagina de profil a agentului.
youtube
optional
Link-ul canalului de Youtube al agentului. Informatia se va afisa in pagina de profil a agentului.
optional
Link-ul profilului de Pinterest al agentului. Informatia se va afisa in pagina de profil a agentului.
optional
Link-ul profilului de Instagram al agentului. Informatia se va afisa in pagina de profil a agentului.
cv
optional
CV-ul sau descrierea agentului in format text (nu se accepta TAG-uri HTML)
{
"idintern" : "18",
"firstname" : "Andrei",
"lastname" : "Vasile",
"email" : "andrei.vasile@agentiamea.ro",
"phone" : "0722000000",
"phone2" : "",
"phone3" : "",
"position" : "Consultant Imobiliar",
"photo" : "https://www.agentiamea.ro/pozaagent.jpg",
"city" : "Bucuresti",
"facebook" : "",
"twitter" : "",
"youtube" : "",
"pinterest" : "",
"instagram" : "",
"cv" : ""
}
Pentru a sterge un cont de agent trebuie sa trimiteti un JSON valid prin metoda POST care sa contina campurile de mai jos, la adresa:
https://api.vdi.ro/api?apikey=CHEIE_API&cat=del
ATENTIE: in cazul in care se doreste stergerea unui agent iar acesta mai are oferte asociate, acestea NU vor fi sterse in mod automat. Ofertele ramase se vor pastra iar ca si date de contact vor fi datele de contact ale agentiei.
idintern
obligatoriu
ID-ul intern al agentului in soft-ul intern. Trebuie sa fie o valoare numerica unica.
{
"idintern" : "18"
}
Pentru a prelua lista de conturi de agenti asociati la o agentie trebuie sa apelati adresa :
https://api.vdi.ro/api?apikey=CHEIE_API&cat=list
ATENTIE: in cazul in care se doreste resincronizarea contului, in cazul in care au ramas conturi de agenti pe VDI.ro, puteti apela aceasta metoda iar ulterior puteti sterge conturile nedorite.
[
{
"idintern" : "18",
"firstname" : "Andrei",
"lastname" : "Vasile",
"email" : "andrei.vasile@agentiamea.ro",
"phone" : "0722000000"
},
{
"idintern" : "22",
"firstname" : "Ciprian",
"lastname" : "Toader",
"email" : "ciprian.toader@agentiamea.ro",
"phone" : "0722000001"
}
]
Pentru a adauga o oferta trebuie sa trimiteti un JSON valid prin metoda POST care sa contina campurile de mai jos, la adresa:
https://api.vdi.ro/apioferte?apikey=CHEIE_API&cat=add
idintern
obligatoriu
ID-ul intern al ofertei in soft-ul intern. Trebuie sa fie o valoare numerica unica.
idagent
obligatoriu
Id-ul intern al agentului la care i se asociaza oferta
judetul
obligatoriu
Judetul din care face parte oferta. Lista de judete si zonarea completa aici!
localitatea
obligatoriu
Localitatea din care face parta oferta. Lista de localitati si zonarea completa aici!
cartierul
optional
Zona sau cartierul din care face parte oferta. Lista de zone si cartiere precum si zonarea completa aici!
tipoferta
obligatoriu
Tipul ofertei. Valoarea transmisa trebuie sa fie intre 1 si 8 dupa cum urmeaza:
tipoperatiune
obligatoriu
Tipul operatiunii. Valoarea transmisa trebuie sa fie 1 sau 2 dupa cum urmeaza:
titlu
obligatoriu
Titlul ofertei, acesta trebuie sa aiba minim 10 caractere si maxim 200 de caractere. Nu se accepta TAG-uri HTML.
titluen
optional
Titlul ofertei in limba engleza, acesta trebuie sa aiba minim 10 caractere si maxim 200 de caractere. Nu se accepta TAG-uri HTML.
descriere
obligatoriu
Descrierea ofertei, acesta trebuie sa aiba minim 10 caractere. Nu se accepta TAG-uri HTML.
descriereen
optional
Descrierea ofertei in limba engleza, acesta trebuie sa aiba minim 10 caractere. Nu se accepta TAG-uri HTML.
video
optional
Video pentru oferta de forma https://www.youtube.com/watch?v=lTq2z2dI98c. Nu se accepta alt format, nu se accepta cod embed.
vrtour
optional
Tur virtual pentru oferta de forma https://my.matterport.com/show/?m=34DRoMkgMLx. Nu se accepta alt format, nu se accepta cod embed. Se accepta tururi virtuale de pe orice platforma ex: Matterport, theasys, cupix, kuula etc.
adresa
optional
Adresa exacta a ofertei.
metrou
optional
Apropiere de metrou. Daca oferta este in apropiere de metrou se trimite valoarea 1, altfel valoarea trimisa trebuie sa fie 0.
latitudine
optional
Coordonata latitudine a ofertei.
longitudine
optional
Coordonata longitudine a ofertei.
arie
optional
Daca se doreste afisarea pe harta a unei arii, se trimite valoarea 1, iar daca se doreste afisarea coordonatelor exacte, se trimite valoarea 0.
regimhotelier
optional
Daca oferta este in regim hotelier se transmite valoarea 1, altfel se trimite 0
executare
optional
Daca oferta este in executare silita se transmite valoarea 1, altfel se trimite 0
exclusiva
optional
Daca oferta este in reprezentare exclusiva se transmite valoarea 1, altfel se trimite 0. Oferta in reprezentare exclusiva se va afisa pe harta cu locatie exacta, nu cu arie.
avemcheile
optional
Daca agentul care are oferta in portofoliu are cheile proprietaii se transmite valoarea 1, altfel se trimite 0
comision0
optional
Daca oferta este comision 0 se transmite valoarea 1, altfel se trimite 0
comision
optional
Valoarea comisionului de forma 2% + TVA sau 500 euro.
idansamblu
optional
ID-ul intern al proiectului/ansamblului din care face parte oferta, in cazul apartamentelor sau caselor noi ce fac parte din proiecte rezidentiale.
pretvanzare
obligatoriu
Pretul de vanzare al ofertei in cazul in care aceasta este la vanzare. Se pot trimite atat pretul de vanzare cat si cel de inchiriere in cazul in care oferta e si la vanzare si la inchiriat.
pretinchiriere
obligatoriu
Pretul de inchiriere al ofertei in cazul in care aceasta este la inchiriere. Se pot trimite atat pretul de vanzare cat si cel de inchiriere in cazul in care oferta e si la vanzare si la inchiriat.
moneda
obligatoriu
Moneda in care este exprimat pretul de vanzare sau de inchiriere. Valoarea transmisa trebuie sa fie 1 sau 2 dupa cum urmeaza:
plustva
optional
Plus TVA poate avea valoarea 1 daca la pret se adauga TVA sau 0 daca pretul nu este cu TVA.
negociabil
optional
Negociabil poate avea valoarea 1 daca pretul este negociabil sau 0 daca pretul este fix si nu este negociabil.
pretper
optional
Pret Per daca se doreste specificata o notita la pret, daca pretul este pe noapte in cazul regimului hotelier sau pret pe luna la chirii, se specifica sub forma de text acest lucru, exemplu "pe noapte".
pretmp
optional
Daca pretul este pe metru patrat atunci trebuie trimisa valoarea pretului pe metru patrat, altfel se trimite 0. Valoarea asteptata este de tip numeric.
clasaenergetica
optional
Clasa Energetica se refera la tipul de clasa energetica al apartamentului, casei sau al cladirii in cauza. Se trimite sub forma de text
suprafatautila
obligatoriu
Suprafata utila este camp numeric obligatoriu pentru toate tipurile de oferte cu exceptia terenurilor. La terenuri se specifica valoarea 0
suprafataconstruita
obligatoriu
Suprafata construita este camp numeric obligatoriu pentru toate tipurile de oferte cu exceptia terenurilor. La terenuri se specifica valoarea 0
suprafatateren
obligatoriu
Suprafata construita este camp numeric obligatoriu pentru tipurile de oferte case si terenuri. La restul tipurilor de oferte este optional si se poate specifica valoarea 0
anulconstructiei
optional
Anul in care a fost finalizata constructia. Valoare numerica intra 1850 si 2030
confort
optional
Confortul apartamentului sau al casei. Valoarile acceptate sunt:
compartimentare
optional
Compartimentarea apartamentului, casei sau a spatiului. Valorile acceptate sunt:
clasabirouri
optional
Clasa spatiului de birou. Valorile acceptate sunt:
numarbucatarii
optional
Numarul de bucatarii. Valoare numerica intre 0 si 100
numarbai
optional
Numarul de bai. Valoare numerica intre 0 si 100
regiminaltime
optional
Regimul de inaltime la cladirii. Valoare text de forma D+S+P+1+M+Pod
terenparcelabil
optional
Daca terenul este parcelabil se trimite valoarea 1, daca nu valoarea 0.
tipteren
optional
Pentru tipul terenului se trimite una din valorile:
destinatieteren
optional
Pentru destinatia terenului se trimite una din valorile:
amprenta
optional
Amprenta la sol a constructiei. Valoare numerica
pot
optional
Procentul de ocupare al terenului. Valoare text
cut
optional
Coeficientul de utilizare a terenului. Valoare text
locuriparcare
optional
Numarul de locuri de parcare disponibile al ofertei. Valoare numerica
deschidere
optional
Deschiderea la sosea a ofertei. Valoare text
numarfronturi
optional
Numarul de fronturi. Valoare numerica intre 0 si 4
demisol
optional
Daca exista demisol se trimite valoarea 1, daca nu valoarea 0.
subsol
optional
Daca exista subsol se trimite valoarea 1, daca nu valoarea 0.
parter
optional
Daca exista parter se trimite valoarea 1, daca nu valoarea 0.
mansarda
optional
Daca exista mansarda se trimite valoarea 1, daca nu valoarea 0.
pod
optional
Daca exista pod se trimite valoarea 1, daca nu valoarea 0.
numarterase
optional
Numarul de terase pe care le detine oferta. Valoarea trimisa trebuie sa fie numerica.
suprafataterase
optional
Suprafata teraselor pe care le detine oferta. Valoarea trimisa trebuie sa fie numerica.
numarcamere
obligatoriu
Numarul de camere. Valoarea trimisa trebuie sa fie numerica si este obligatorie la apartamente, garsoniere si case.
numardormitoare
optional
Numarul de dormitoare pe care le detine oferta. Valoarea trimisa trebuie sa fie numerica.
numarbai
obligatoriu
Numarul de bai. Valoarea trimisa trebuie sa fie numerica si este obligatorie la apartamente, garsoniere si case.
etaj
obligatoriu
Etajul la care este situat apartamentul sau garsoniera. Campul este obligatoriu pentru apartamente si garsoniere si optional pentru celelalte tipuri de oferte. Valori acceptate:
etaje
obligatoriu
Numar de etaje al cladirii. Campul este obligatoriu pentru apartamente, garsoniere, case si optional pentru celelalte tipuri de oferte. Valori acceptate:
tipimobil
optional
Tipul imobilului din care face parte apartamentul, garsoniera sau casa.
Valori acceptate pentru apartamente si garsoniere:
tipspatiu
optional
Tipul spatiului, se trimite pentru proprietatile de tip spatiu comercial, de birou, industrial. Valori acceptate:
inaltimespatiu
optional
Inaltimea spatiului pentru ofertele de tip spatiu comercial, birou si industrial. Valoarea asteptata este de tip numerica exprimata in metri, ex "3".
disponibilitate
optional
Disponibilitatea se poate trimite la toate tipurile de oferte. Valoarea asteptata este de tip text, ex. "10 iunie".
stadiuconstructie
optional
Stadiul constructiei se trimite valoare numerica. Valori acceptate:
poze
obligatoriu
Lista cu pozele ofertei. Se trimite sub forma unui sir de URL-uri separate de virgula. Ex "https://www.site.ro/poza1.jpg,https://www.site.ro/poza2.jpg"
optiuni
optional
Lista cu optiuni,dotari, vecinatati, imbunatatiri de care dispune oferta. Se trimite sub forma unui text, optiunile fiind separate de virgula. Ex "16,12,8,10,36,63". Lista optiunilor se gaseste aici.
vditop
obligatoriu
In cazul in care aveti promovari in pachet de tipul bronze si doriti sa aplicati promovare de tip bronze pe oferta, specificati valoarea 1, altfel valoarea 0. Puteti aplica promovari de tip bronze doar in limita pachetului ales. In cazul in care adaugati mai multe promovari decat cele disponibile in pachet, un mesaj de eroare va fi returnat. Lista pachetelor de promovare se gaseste aici.
vditop1
obligatoriu
In cazul in care aveti promovari in pachet de tipul silver si doriti sa aplicati promovare de tip silver pe oferta, specificati valoarea 1, altfel valoarea 0. Puteti aplica promovari de tip silver doar in limita pachetului ales. In cazul in care adaugati mai multe promovari decat cele disponibile in pachet, un mesaj de eroare va fi returnat. Lista pachetelor de promovare se gaseste aici.
vditop2
obligatoriu
In cazul in care aveti promovari in pachet de tipul gold si doriti sa aplicati promovare de tip gold pe oferta, specificati valoarea 1, altfel valoarea 0. Puteti aplica promovari de tip gold doar in limita pachetului ales. In cazul in care adaugati mai multe promovari decat cele disponibile in pachet, un mesaj de eroare va fi returnat. Lista pachetelor de promovare se gaseste aici.
vdicolaborare
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, se trimite valoarea 1 altfel se trimite valoarea 0. Daca oferta se trimite spre colaborare, ea va fi disponibila in modului de colaborari din contul de agent din Softimobiliar CRM si in modulul de colaborari din contul agentului din VDI.ro
vdicolaborarecomision
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, si valoarea parametrului vdicolaborare=1 se trimite in acest camp, valoarea numerica a procentului de comision oferit la colaborare. Exemplu daca se ofera 2% comision la colaborare, atunci valoarea trimisa este 2
vdicolaborarecomision1
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, si valoarea parametrului vdicolaborare=1 se trimite in acest camp, valoarea numerica a sumei fixe totale a comisionului oferit la colaborare. Daca se ofera 1000 Eur la colaborare comision fix, atunci valoarea trimisa este 1000. Daca se trimite o valoare pentru unul din parametrii vdicolaborarecomision sau vdicolaborarecomision1 celalalt trebuie sa aiba valoarea 0.
vdimodcolaborare
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, poate specifica si modalitatea de colaborare. Valorile acceptate sunt:
vdidetaliicolaborare
optional
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, si valoarea parametrului vdicolaborare=1 se pot trimite in acest camp sub forma de text, mai multe detalii despre modalitatea de colaborare.
{
"idintern" : "386059",
"avemcheile" : "0",
"idansamblu" : "0",
"vditop" : "0",
"vditop1" : "0",
"vditop2" : "0",
"idagent" : "3273",
"judetul" : "Bucuresti Ilfov",
"localitatea" : "Chiajna",
"cartierul" : "Chiajna",
"tipoferta" : "1",
"tipoperatiune" : "2",
"titlu" : "Garsoniera de vanzare Militari Residece",
"titluen" : "",
"descriere" : "Va oferim spre vanzare o garsoniera, situat pe strada Rezervelor, Militari Residence. Apartamentul se afla la etajul 7 intr-un bloc de 8 etaje + mansarda locuita, construit in 2015 si are o suprafata de 40 mp. Situata la 3 minute de capatul STB 178,138,278 Militari Residence de pe strada Tineretului.In apropierea apartamentului se afla urmatoarele: farmacii, fast-food, cofetarii, magazine alimentare dar si Tineretului Plaza, complex La Strada.",
"descriereen" : "",
"video" : "",
"vrtour" : "",
"latitudine" : "44.44737",
"longitudine" : "25.98688",
"exclusiva" : "0",
"comision0" : "0",
"vdicolaborare" : "1",
"vdicolaborarecomision" : "0",
"vdicolaborarecomision1" : "0",
"vdidetaliicolaborare" : "",
"vdimodcolaborare" : "1",
"comision" : "1%",
"executare" : "0",
"adresa" : "",
"pretvanzare" : "40700",
"pretinchiriere" : "0",
"negociabil" : "0",
"pretper" : "",
"pretmp" : "",
"plustva" : "0",
"moneda" : "1",
"clasaenergetica" : "A",
"consumenergieprimara" : "0",
"indiceconsumco2" : "0",
"consumenergieregenerabila" : "0",
"etaj" : "7",
"etaje" : "8",
"subsol" : "0",
"demisol" : "0",
"parter" : "0",
"mansarda" : "1",
"pod" : "0",
"suprafatautila" : "40",
"suprafataconstruita" : "47.5",
"suprafatateren" : "0",
"deschidere" : "0",
"numarfronturi" : "0",
"anulconstructiei" : "2015",
"confort" : "1",
"compartimentare" : "decomandat",
"numarcamere" : "1",
"numardormitoare" : "0",
"numarbucatarii" : "1",
"numarbai" : "1",
"disponibilitate" : "",
"numarterase" : "0",
"suprafataterase" : "0",
"inaltimespatiu" : "0",
"clasabirouri" : "",
"regiminaltime" : "",
"tipteren" : "",
"destinatieteren" : "",
"terenparcelabil" : "0",
"amprenta" : "",
"pot" : "",
"cut" : "",
"metrou" : "0",
"locuriparcare" : "1",
"tipspatiu" : "",
"tipimobil" : "",
"stadiuconstructie" : "",
"optiuni" : "16,12,8,10,36,63,133,51,19,21,127,124,30,31,46,45,43,116,42,41,53,114,109,108,106,99,96,94,95,93,92,87,79,145,77,23,75,73,6,7,3,1,28,27,26",
"poze" : "https://www.site.ro/imagine1.jpg,https://www.site.ro/imagine2.jpg"
}
Pentru a modifica o oferta trebuie sa trimiteti un JSON valid prin metoda POST care sa contina campurile de mai jos, la adresa:
https://api.vdi.ro/apioferte?apikey=CHEIE_API&cat=mod
idintern
obligatoriu
ID-ul intern al ofertei in soft-ul intern. Trebuie sa fie o valoare numerica unica.
idagent
obligatoriu
Id-ul intern al agentului la care i se asociaza oferta
judetul
obligatoriu
Judetul din care face parte oferta. Lista de judete si zonarea completa aici!
localitatea
obligatoriu
Localitatea din care face parta oferta. Lista de localitati si zonarea completa aici!
cartierul
optional
Zona sau cartierul din care face parte oferta. Lista de zone si cartiere precum si zonarea completa aici!
tipoferta
obligatoriu
Tipul ofertei. Valoarea transmisa trebuie sa fie intre 1 si 8 dupa cum urmeaza:
tipoperatiune
obligatoriu
Tipul operatiunii. Valoarea transmisa trebuie sa fie 1 sau 2 dupa cum urmeaza:
titlu
obligatoriu
Titlul ofertei, acesta trebuie sa aiba minim 10 caractere si maxim 200 de caractere. Nu se accepta TAG-uri HTML.
titluen
optional
Titlul ofertei in limba engleza, acesta trebuie sa aiba minim 10 caractere si maxim 200 de caractere. Nu se accepta TAG-uri HTML.
descriere
obligatoriu
Descrierea ofertei, acesta trebuie sa aiba minim 10 caractere. Nu se accepta TAG-uri HTML.
descriereen
optional
Descrierea ofertei in limba engleza, acesta trebuie sa aiba minim 10 caractere. Nu se accepta TAG-uri HTML.
video
optional
Video pentru oferta de forma https://www.youtube.com/watch?v=lTq2z2dI98c. Nu se accepta alt format, nu se accepta cod embed.
vrtour
optional
Tur virtual pentru oferta de forma https://my.matterport.com/show/?m=34DRoMkgMLx. Nu se accepta alt format, nu se accepta cod embed. Se accepta tururi virtuale de pe orice platforma ex: Matterport, theasys, cupix, kuula etc.
adresa
optional
Adresa exacta a ofertei.
metrou
optional
Apropiere de metrou. Daca oferta este in apropiere de metrou se trimite valoarea 1, altfel valoarea trimisa trebuie sa fie 0.
latitudine
optional
Coordonata latitudine a ofertei.
longitudine
optional
Coordonata longitudine a ofertei.
arie
optional
Daca se doreste afisarea pe harta a unei arii, se trimite valoarea 1, iar daca se doreste afisarea coordonatelor exacte, se trimite valoarea 0.
regimhotelier
optional
Daca oferta este in regim hotelier se transmite valoarea 1, altfel se trimite 0
executare
optional
Daca oferta este in executare silita se transmite valoarea 1, altfel se trimite 0
exclusiva
optional
Daca oferta este in reprezentare exclusiva se transmite valoarea 1, altfel se trimite 0. Oferta in reprezentare exclusiva se va afisa pe harta cu locatie exacta, nu cu arie.
avemcheile
optional
Daca agentul care are oferta in portofoliu are cheile proprietaii se transmite valoarea 1, altfel se trimite 0
comision0
optional
Daca oferta este comision 0 se transmite valoarea 1, altfel se trimite 0
comision
optional
Valoarea comisionului de forma 2% + TVA sau 500 euro.
idansamblu
optional
ID-ul intern al proiectului/ansamblului din care face parte oferta, in cazul apartamentelor sau caselor noi ce fac parte din proiecte rezidentiale.
pretvanzare
obligatoriu
Pretul de vanzare al ofertei in cazul in care aceasta este la vanzare. Se pot trimite atat pretul de vanzare cat si cel de inchiriere in cazul in care oferta e si la vanzare si la inchiriat.
pretinchiriere
obligatoriu
Pretul de inchiriere al ofertei in cazul in care aceasta este la inchiriere. Se pot trimite atat pretul de vanzare cat si cel de inchiriere in cazul in care oferta e si la vanzare si la inchiriat.
moneda
obligatoriu
Moneda in care este exprimat pretul de vanzare sau de inchiriere. Valoarea transmisa trebuie sa fie 1 sau 2 dupa cum urmeaza:
plustva
optional
Plus TVA poate avea valoarea 1 daca la pret se adauga TVA sau 0 daca pretul nu este cu TVA.
negociabil
optional
Negociabil poate avea valoarea 1 daca pretul este negociabil sau 0 daca pretul este fix si nu este negociabil.
pretper
optional
Pret Per daca se doreste specificata o notita la pret, daca pretul este pe noapte in cazul regimului hotelier sau pret pe luna la chirii, se specifica sub forma de text acest lucru, exemplu "pe noapte".
pretmp
optional
Daca pretul este pe metru patrat atunci trebuie trimisa valoarea pretului pe metru patrat, altfel se trimite 0. Valoarea asteptata este de tip numeric.
clasaenergetica
optional
Clasa Energetica se refera la tipul de clasa energetica al apartamentului, casei sau al cladirii in cauza. Se trimite sub forma de text
suprafatautila
obligatoriu
Suprafata utila este camp numeric obligatoriu pentru toate tipurile de oferte cu exceptia terenurilor. La terenuri se specifica valoarea 0
suprafataconstruita
obligatoriu
Suprafata construita este camp numeric obligatoriu pentru toate tipurile de oferte cu exceptia terenurilor. La terenuri se specifica valoarea 0
suprafatateren
obligatoriu
Suprafata construita este camp numeric obligatoriu pentru tipurile de oferte case si terenuri. La restul tipurilor de oferte este optional si se poate specifica valoarea 0
anulconstructiei
optional
Anul in care a fost finalizata constructia. Valoare numerica intra 1850 si 2030
confort
optional
Confortul apartamentului sau al casei. Valoarile acceptate sunt:
compartimentare
optional
Compartimentarea apartamentului, casei sau a spatiului. Valorile acceptate sunt:
clasabirouri
optional
Clasa spatiului de birou. Valorile acceptate sunt:
numarbucatarii
optional
Numarul de bucatarii. Valoare numerica intre 0 si 100
numarbai
optional
Numarul de bai. Valoare numerica intre 0 si 100
regiminaltime
optional
Regimul de inaltime la cladirii. Valoare text de forma D+S+P+1+M+Pod
terenparcelabil
optional
Daca terenul este parcelabil se trimite valoarea 1, daca nu valoarea 0.
tipteren
optional
Pentru tipul terenului se trimite una din valorile:
destinatieteren
optional
Pentru destinatia terenului se trimite una din valorile:
amprenta
optional
Amprenta la sol a constructiei. Valoare numerica
pot
optional
Procentul de ocupare al terenului. Valoare text
cut
optional
Coeficientul de utilizare a terenului. Valoare text
locuriparcare
optional
Numarul de locuri de parcare disponibile al ofertei. Valoare numerica
deschidere
optional
Deschiderea la sosea a ofertei. Valoare text
numarfronturi
optional
Numarul de fronturi. Valoare numerica intre 0 si 4
demisol
optional
Daca exista demisol se trimite valoarea 1, daca nu valoarea 0.
subsol
optional
Daca exista subsol se trimite valoarea 1, daca nu valoarea 0.
parter
optional
Daca exista parter se trimite valoarea 1, daca nu valoarea 0.
mansarda
optional
Daca exista mansarda se trimite valoarea 1, daca nu valoarea 0.
pod
optional
Daca exista pod se trimite valoarea 1, daca nu valoarea 0.
numarterase
optional
Numarul de terase pe care le detine oferta. Valoarea trimisa trebuie sa fie numerica.
suprafataterase
optional
Suprafata teraselor pe care le detine oferta. Valoarea trimisa trebuie sa fie numerica.
numarcamere
obligatoriu
Numarul de camere. Valoarea trimisa trebuie sa fie numerica si este obligatorie la apartamente, garsoniere si case.
numardormitoare
optional
Numarul de dormitoare pe care le detine oferta. Valoarea trimisa trebuie sa fie numerica.
numarbai
obligatoriu
Numarul de bai. Valoarea trimisa trebuie sa fie numerica si este obligatorie la apartamente, garsoniere si case.
etaj
obligatoriu
Etajul la care este situat apartamentul sau garsoniera. Campul este obligatoriu pentru apartamente si garsoniere si optional pentru celelalte tipuri de oferte. Valori acceptate:
etaje
obligatoriu
Numar de etaje al cladirii. Campul este obligatoriu pentru apartamente, garsoniere, case si optional pentru celelalte tipuri de oferte. Valori acceptate:
tipimobil
optional
Tipul imobilului din care face parte apartamentul, garsoniera sau casa.
Valori acceptate pentru apartamente si garsoniere:
tipspatiu
optional
Tipul spatiului, se trimite pentru proprietatile de tip spatiu comercial, de birou, industrial. Valori acceptate:
inaltimespatiu
optional
Inaltimea spatiului pentru ofertele de tip spatiu comercial, birou si industrial. Valoarea asteptata este de tip numerica exprimata in metri, ex "3".
disponibilitate
optional
Disponibilitatea se poate trimite la toate tipurile de oferte. Valoarea asteptata este de tip text, ex. "10 iunie".
stadiuconstructie
optional
Stadiul constructiei se trimite valoare numerica. Valori acceptate:
poze
obligatoriu
Lista cu pozele ofertei. Se trimite sub forma unui sir de URL-uri separate de virgula. Ex "https://www.site.ro/poza1.jpg,https://www.site.ro/poza2.jpg"
optiuni
optional
Lista cu optiuni,dotari, vecinatati, imbunatatiri de care dispune oferta. Se trimite sub forma unui text, optiunile fiind separate de virgula. Ex "16,12,8,10,36,63". Lista optiunilor se gaseste aici.
vditop
obligatoriu
In cazul in care aveti promovari in pachet de tipul bronze si doriti sa aplicati promovare de tip bronze pe oferta, specificati valoarea 1, altfel valoarea 0. Puteti aplica promovari de tip bronze doar in limita pachetului ales. In cazul in care adaugati mai multe promovari decat cele disponibile in pachet, un mesaj de eroare va fi returnat. Lista pachetelor de promovare se gaseste aici.
vditop1
obligatoriu
In cazul in care aveti promovari in pachet de tipul silver si doriti sa aplicati promovare de tip silver pe oferta, specificati valoarea 1, altfel valoarea 0. Puteti aplica promovari de tip silver doar in limita pachetului ales. In cazul in care adaugati mai multe promovari decat cele disponibile in pachet, un mesaj de eroare va fi returnat. Lista pachetelor de promovare se gaseste aici.
vditop2
obligatoriu
In cazul in care aveti promovari in pachet de tipul gold si doriti sa aplicati promovare de tip gold pe oferta, specificati valoarea 1, altfel valoarea 0. Puteti aplica promovari de tip gold doar in limita pachetului ales. In cazul in care adaugati mai multe promovari decat cele disponibile in pachet, un mesaj de eroare va fi returnat. Lista pachetelor de promovare se gaseste aici.
vdicolaborare
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, se trimite valoarea 1 altfel se trimite valoarea 0. Daca oferta se trimite spre colaborare, ea va fi disponibila in modului de colaborari din contul de agent din Softimobiliar CRM si in modulul de colaborari din contul agentului din VDI.ro
vdicolaborarecomision
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, si valoarea parametrului vdicolaborare=1 se trimite in acest camp, valoarea numerica a procentului de comision oferit la colaborare. Exemplu daca se ofera 2% comision la colaborare, atunci valoarea trimisa este 2
vdicolaborarecomision1
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, si valoarea parametrului vdicolaborare=1 se trimite in acest camp, valoarea numerica a sumei fixe totale a comisionului oferit la colaborare. Daca se ofera 1000 Eur la colaborare comision fix, atunci valoarea trimisa este 1000. Daca se trimite o valoare pentru unul din parametrii vdicolaborarecomision sau vdicolaborarecomision1 celalalt trebuie sa aiba valoarea 0.
vdimodcolaborare
obligatoriu
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, poate specifica si modalitatea de colaborare. Valorile acceptate sunt:
vdidetaliicolaborare
optional
In cazul in care agentul doreste sa ofere spre colaborare catre alti agenti oferta, si valoarea parametrului vdicolaborare=1 se pot trimite in acest camp sub forma de text, mai multe detalii despre modalitatea de colaborare.
{
"idintern" : "386059",
"avemcheile" : "0",
"idansamblu" : "0",
"vditop" : "0",
"vditop1" : "0",
"vditop2" : "0",
"idagent" : "3273",
"judetul" : "Bucuresti Ilfov",
"localitatea" : "Chiajna",
"cartierul" : "Chiajna",
"tipoferta" : "1",
"tipoperatiune" : "2",
"titlu" : "Garsoniera de vanzare Militari Residece",
"titluen" : "",
"descriere" : "Va oferim spre vanzare o garsoniera, situat pe strada Rezervelor, Militari Residence. Apartamentul se afla la etajul 7 intr-un bloc de 8 etaje + mansarda locuita, construit in 2015 si are o suprafata de 40 mp. Situata la 3 minute de capatul STB 178,138,278 Militari Residence de pe strada Tineretului.In apropierea apartamentului se afla urmatoarele: farmacii, fast-food, cofetarii, magazine alimentare dar si Tineretului Plaza, complex La Strada.",
"descriereen" : "",
"video" : "",
"vrtour" : "",
"latitudine" : "44.44737",
"longitudine" : "25.98688",
"exclusiva" : "0",
"comision0" : "0",
"vdicolaborare" : "1",
"vdicolaborarecomision" : "0",
"vdicolaborarecomision1" : "0",
"vdidetaliicolaborare" : "",
"vdimodcolaborare" : "1",
"comision" : "1%",
"executare" : "0",
"adresa" : "",
"pretvanzare" : "40700",
"pretinchiriere" : "0",
"negociabil" : "0",
"pretper" : "",
"pretmp" : "",
"plustva" : "0",
"moneda" : "1",
"clasaenergetica" : "A",
"consumenergieprimara" : "0",
"indiceconsumco2" : "0",
"consumenergieregenerabila" : "0",
"etaj" : "7",
"etaje" : "8",
"subsol" : "0",
"demisol" : "0",
"parter" : "0",
"mansarda" : "1",
"pod" : "0",
"suprafatautila" : "40",
"suprafataconstruita" : "47.5",
"suprafatateren" : "0",
"deschidere" : "0",
"numarfronturi" : "0",
"anulconstructiei" : "2015",
"confort" : "1",
"compartimentare" : "decomandat",
"numarcamere" : "1",
"numardormitoare" : "0",
"numarbucatarii" : "1",
"numarbai" : "1",
"disponibilitate" : "",
"numarterase" : "0",
"suprafataterase" : "0",
"inaltimespatiu" : "0",
"clasabirouri" : "",
"regiminaltime" : "",
"tipteren" : "",
"destinatieteren" : "",
"terenparcelabil" : "0",
"amprenta" : "",
"pot" : "",
"cut" : "",
"metrou" : "0",
"locuriparcare" : "1",
"tipspatiu" : "",
"tipimobil" : "",
"stadiuconstructie" : "",
"optiuni" : "16,12,8,10,36,63,133,51,19,21,127,124,30,31,46,45,43,116,42,41,53,114,109,108,106,99,96,94,95,93,92,87,79,145,77,23,75,73,6,7,3,1,28,27,26",
"poze" : "https://www.site.ro/imagine1.jpg,https://www.site.ro/imagine2.jpg"
}
Pentru a sterge o oferta trebuie sa trimiteti un JSON valid prin metoda POST care sa contina campurile de mai jos, la adresa:
https://api.vdi.ro/apioferte?apikey=CHEIE_API&cat=del
idintern
obligatoriu
ID-ul intern al ofertei in soft-ul intern. Trebuie sa fie o valoare numerica unica.
{
"idintern" : "18"
}
Pentru a prelua lista de oferte publicate de o agentie si promovarile acestora trebuie sa apelati adresa :
https://api.vdi.ro/apioferte?apikey=CHEIE_API&cat=list
ATENTIE: in cazul in care se doreste resincronizarea contului, in cazul in care au ramas oferte neretrase pe VDI.ro, puteti apela aceasta metoda iar ulterior puteti sterge ofertele nedorite.
[
{
"idintern" : "18",
"vditop" : "1",
"vditop1" : "0",
"vditop2" : "0"
},
{
"idintern" : "22",
"vditop" : "0",
"vditop1" : "1",
"vditop2" : "0"
}
]