Estonia market
OST MÜÜK TEENUSED
Lisa tasuta kuulutus
Kõik kuulutused ValdkonnadTööpakkumisedReklaam KKK
Forbby › Kuulutuste importimine XML-iga

Kuulutuste importimine XML-iga

XML juhend kuulutuste importimiseks Forbby.com portaali

Kuulutuste automaatseks importimiseks forbby.com portaali on vaja kliendil oma serveris koostada XML fail, mille näidise leiab aadressilt: 
http://www.forbby.com/forbby_import_example.xml

XML väljade kirjeldused:

  • ID - number; kohustustlik
    Kuulutuse unikaalne ID kliendi andmebaasis. Selle põhjal kontrollitakse kas see kuulutus on juba varasemalt Forbby.com andmebaasi lisatud. Kui sellise ID-ga kuulutus leitakse, kirjutatakse tema andmed üle.

  • PEALKIRI - tekst; kohustuslik
    Soovitavalt kuni 100 tähemärki

  • KIRJELDUS - tekst; kohustuslik
    Kuulutuse sisu tekst. HTML on keelatud ja see kustutatakse, kasutada tohib vaid reavahetusi.

  • MARKSONAD - tekst; soovituslik
    Iga kuulutust iseloomustav märksõna eraldi väljale MARKSONA. Märksõnad peaks olema reeglina väikse algustähega (kui tegemist pole nimega, nt tootebrändiga) ning ainsuse nimetavas käändes. Märksõnadena pole soovitav kasutada omadussõnu (nt 'parim', 'mugav' vmt). Märksõnad aitavad Forbby-l kuulutuse vaatajale soovitada teisi sarnaseid kuulutusi ning aitavad ka kuulutust otsinguga paremini leida.

  • PIIRKOND - tekst; kohustuslik
    Kuulutuses kirjeldatud objekti asukoht ehk üldine aadress. Kohustuslik on lisada vähemalt maakonna nimetus. Kinnisvara puhul on soovitatav lisada nii asula kui tänav. Asukoha nimed tuleks eraldada komadega.

  • PIIRKOND_XY - tekst; soovituslik
    Asukoha GPS koordinaadid komaga eraldatult kujul: 59.4426896, 24.7531972

  • VALDKOND - tekst; kohustuslik
    Valdkondade nimetustega saab tutvuda siin: http://www.forbby.com/est/topics/
    Kuulutuse (ala)valdkonna ID number või nimetus, näiteks alavaldkonna 'Majad' puhul: '19' või 'Majad'
    Valdkonna ID numbrit näitab vastava valdkonna lehel aadressiribal t=... muutuja.
    Kui sobivat alavaldkonda pole, tuleb valida peavaldkond.

  • KASUTAJA_NIMI - tekst; kohustuslik
    Kuulutaja (firma või eraisik) nimi, mida kuulutuse juures näidata. Soovitavalt 3-30 sümbolit.

  • KASUTAJA_TYYP - tekst; soovituslik
    Väärtusteks kas 'firma' (vaikimisi) või 'eraisik'

  • KASUTAJA_EMAIL - tekst; kohustuslik
    Kuulutaja e-mail, millele kuulutusega seotud teateid saata. E-maili põhjal seotakse kuulutus Forbby.com kasutajakontoga, millel on sama meiliaadress.

  • KASUTAJA_TELEFON - tekst; soovituslik
    Kuulutaja telefon, mida kuulutuse juures näidatakse.

  • AVALIK_ALATES - kuupäev kujul YYYY-MM-DD; soovituslik
    Kuupäev, millest alates on kuulutus avalik. Vaikimisi on kuulutus avalik alates importimise kuupäevast. Kui määrata kuupäev tulevikku, siis muutub kuulutus alles sellest kuupäevast nähtavaks.

  • AVALIK_KUNI - kuupäev kujul YYYY-MM-DD; vajadusel
    Viimane kuupäev, millal kuulutus veel Forbby.com-is avalik on. Kui on määramata, on tegemist aegumatu kuulutusega.

  • STAATUS - number; soovituslik
    1 - kuulutus on avalik (vaikimisi, kui on uus kuulutus)
    0 - kuulutus on peidetud
    Kui staatus on määramata, siis kuulutuse varasemat staatust ei muudeta.
    Forbby.com jätab endale õiguse kustutada peidetud staatusega kuulutused, mis on vanemad kui 3 kuud.

  • SEISUKORD - number; soovituslik
    Kuulutatava objekti seisukord
    0 - kasutatud (vaikimisi)
    1 - uus

  • HIND - number; kohustuslik
    Kuulutatava objekti hind eurodes (punkt eraldab sente) kujul '2.50' või '455' või '23000.00'
    Kui hinnad varieeruvad, on soovitav panna väikseim hind.

  • HIND_YHIK - tekst; vajadusel
    Ühik, mida näidata hinna järel, näiteks ruutmeetri hinna korral 'm2' või kilohinna korral 'kg'.
    Kuni 5 tähte, soovitavalt lühendina.

  • HIND_TINGI - number; soovituslik
    Kas hinda saab tingida - tingimisvõimalus tekitatakse Forbby.com lehele, hinnapakkumised saadetakse kuulutaja meilile.
    0 - ei saa tingida
    1 - saab tingida, tehtud pakkumised on avalikud
    2 - saab tingida, tehtud pakkumised on peidetud (näeb vaid kuulutuse omanik)

  • URL - tekst; soovituslik
    Kuulutaja kodulehe aadress (võib olla ka veebipoe üldine aadress) algusega http:// või https://

  • EPOOD_URL - tekst; soovituslik
    Kui kuulutatav objekt on müügil e-poes, siis tuleb siin näidata konkreetne link (mitte e-poe avalehe link!), millelt antud toodet osta ja detailsemalt vaadata saab. Kuulutuse vaataja suunatakse sellele lingile pärast e-poe nupul klõpsamist.

  • EPOOD_TARNEAEG - number; soovituslik
    E-poes müüdava toote tarneaeg ööpäevades. Kui on määramata, siis tarneaega ei näidata.

  • EPOOD_GARANTII - number; soovituslik
    Kas e-poes müüdaval tootel on garantii olemas
    0 - ei ole (vaikimisi)
    1 - on olemas

  • PILDID konteineris peab olema vähemalt üks PILT väli
    Iga PILT väli sisaldab pildi URLi, millelt Forbby.com server saab pildi alla laadida.
    Esimest pilti kasutatakse kuulutuse peapildina kuulutuste nimekirjas. Iga pilt peaks olema .jpg või .jpeg laiendiga, mõõtmetelt soovituslikult 300-1000 px, maht kuni 4MB kiiremaks importimiseks. Forbby.com laeb pildid oma serverisse, et tekitada neist väiksemad pildid, mis laeksid kasutaja arvutisse kiiremini.
    Kuulutuse piltide arv pole piiratud, kuid on soovituslik jääda 10 pildi piiresse. Pilt kustutatakse, kui vastava aadressiga välja XML failist ei leitud või leiti sellelt positsioonilt teine URL. Pildi laadimine Forbby-sse toimub vaid 1 kord, kui pildi aadress importimiste käigus ei muutu.

Reeglid ja märkused

  • Kuulutus lisatakse andmebaasi vaid siis, kui kõik kohustuslikud väljad on täidetud (vt näitefaili 2. kuulutus).
  • Kuulutust kustutada ei saa, kuulutuse peitmiseks tuleb saata väli 0.
  • Kuulutus peab olema eestikeelne, kui pole kokku lepitud teisiti.

 

Tööprotsess

Forbby.com ja kliendi vahel lepitakse kokku XML faili aadress(id), millele Forbby serveril on ligipääs.
Forbby server kontrollib regulaarselt (nt 1 kord ööpäevas, sõltuvalt kokkuleppest) faili sisu ja teostab kuulutuste importimise.

XML failis sisalduvate kuulutuste arv peaks jääma 100 piiresse - st kui importimine toimub nt 1 kord ööpäevas, siis pole mõtet kaasa panna eelmisel kuupäeval imporditud kuulutuste andmeid, vaid ainult muutunud või uute kuulutuste andmed. Kui pole võimalik luua dünaamilise sisuga XML faili, siis võib kokku leppida mitme staatilise XML faili aadressid, millelt kuulutuste andmeid uuendatakse.

 

Võtke meiega ühendust, koos leiame lahenduse!