Ilmoitussyöte

Hyväksytyt muodot

• Siia XML ja Siia JSON, kuvattu tällä sivulla.
• REDE XML versio 0.93 (osoitteen ekfl.ee/schema skeeman <Objects>-asiakirja), urn:REDE/0.93-nimiavaruudella tai ilman. Myös kv.ee-portaalin oman kenttäluettelon kirjoitusasut ymmärretään.

Lähetätkö jo ilmoituksia kv.ee-portaaliin?

kv.ee tuo ilmoitukset REDE XML -muodossa (Real Estate Data Exchange), joka on virolainen standardi vuodelta 2007. Siia lukee samaa muotoa, joten järjestelmäsi ei tarvitse uutta vientiä: sen täytyy vain julkaista kv.ee-portaalille jo valmistelemansa kohteet yhtenä <Objects>-asiakirjana https-osoitteessa. Anna tämä osoite Tuonti-välilehdellä tai lataa tiedosto kerran kokeillaksesi. Muoto tunnistetaan automaattisesti, ja tämän sivun säännöt pätevät samalla tavalla.

kv.ee hakee kohteet järjestelmästäsi yksi kerrallaan (getObjectById). Siia tarvitsee ne sen sijaan yhtenä tiedostona. Pyydä järjestelmäsi toimittajalta REDE-vientiä kiinteään osoitteeseen; tiedot ovat samat. Jos se ei ole mahdollista, kirjoita osoitteeseen [email protected].

Miten REDE-tiedosto luetaan

• Vain kohteet, joiden status on active, tuodaan, ja vain kun visible on all tai puuttuu. Arkistoitu, poistettu, myyty tai vuokrattu kohde katsotaan syötteestä poistuneeksi.
• Kohteesta, joka on tarjolla sekä myyntiin että vuokralle, tulee kaksi ilmoitusta. Toinen saa kohteen tunnisteen, johon on lisätty ”-rent” tai ”-sale”.
• Hinnan on oltava euroina ja julkinen. Piilotetuksi merkittyä talon tai huoneiston numeroa ei näytetä.
• Kuvaus otetaan kaupan info-teksteistä (est, rus, eng, lav). Aareina tai hehtaareina ilmoitetut pinta-alat muunnetaan neliömetreiksi.
• Tyyppi, kunto, rakennusmateriaali, energialuokka, huoneet, kerrokset, parvekkeet, remonttivuodet, kuvat, videot ja koordinaatit otetaan mukaan. Vaihtoehdot, joilla ei ole vastinetta Siiassa, jätetään pois.
• Välittäjä yhdistetään sähköpostin perusteella, kun tiedosto sisältää myös välittäjätiedot (<Broker> ja <email>). Muuten ilmoitukset allekirjoitetaan profiilin omistajan nimellä.
• Autotallit, pysäköintipaikat ja varastot sekä Viron ulkopuoliset kohteet jätetään toistaiseksi pois.

Miten se toimii

1. 01

   Luo profiili

   Kirjaudu ja luo välitystoimiston tai rakennuttajan profiili. Kutsu välittäjäsi sähköpostitse, jotta ilmoitukset voidaan allekirjoittaa heidän nimillään.

2. 02

   Lisää syötteen osoite

   Anna Tuonti-välilehdellä tiedostosi https-osoite tai lataa tiedosto kerran kokeillaksesi.

3. 03

   Katso esikatselu

   Siia lukee syötteen julkaisematta mitään ja näyttää, kuinka monta ilmoitusta se löysi, ensimmäiset kymmenen niin kuin se ne ymmärsi, ja jokaisen ilmoituskohtaisen huomautuksen.

4. 04

   Aloita tuonti

   Mitään ei julkaista ennen kuin vahvistat. Siitä lähtien syöte luetaan tunnin välein.

Rakenne

Yksi asiakirja, jossa ovat kaikki ilmoitukset, jotka haluat Siiaan, UTF-8-muodossa. XML-muodossa juurielementti on <listings>, jossa on yksi <listing> kotia kohden. JSON-muodossa se on objekti, jossa on ”listings”-taulukko. Kenttien nimet ovat samat molemmissa.

Kentät

Hyväksytyt arvot

Kirjoita arvot kuten alla. Myös tavalliset vironkieliset sanat ymmärretään (korter, maja, müük, üür), ja tuntematon valinnainen arvo jätetään tyhjäksi ja siitä kirjataan huomautus lokiin sen sijaan, että ilmoitus hylättäisiin.

deal

sale rent

type

apartment house land commercial summer_home

condition

new_build renovated good needs_renovation

energy_label

A B C D E F G H

material

stone wood panel log

features

balcony terrace lift parking storage sauna fireplace furnished bicycle_room underfloor_heating fibre

Säännöt

• Vain https-osoitteet hyväksytään, sekä syötteelle että kuville. Syöte saa olla enintään 20 Mt ja 5000 ilmoitusta, sen on vastattava 20 sekunnin kuluessa ja se saa ohjata eteenpäin enintään 3 kertaa.
• Mitään ei julkaista ennen kuin profiilin omistaja on nähnyt esikatselun ja painanut ”Aloita tuonti”. Tämä vahvistus kirjataan luvaksesi julkaista sisältö.
• Ilmoitus luodaan suoraan julkaistuna. Hyväksytyksi tullakseen se tarvitsee tunnisteen, kauppatyypin, tyypin, hinnan, osoitteen, pinta-alan, kuvauksen ja vähintään yhden kuvan; muut ohitetaan ja luetellaan lokissa syineen.
• Ilmoitukset yhdistetään external_id-tunnisteen perusteella. Muuttunut ilmoitus päivitetään, muuttumaton jätetään ennalleen, ja vain uudet kuvat ladataan.
• Kuva, jota ei voi ladata, ohitetaan ja sitä yritetään uudelleen seuraavassa ajossa. Ilmoitus julkaistaan silti.
• Ilmoitus, jota ei enää ole syötteessä, poistetaan vasta, kun se on puuttunut 2 onnistuneesta ajosta peräkkäin. Jos se palaa, se julkaistaan uudelleen.
• Jos syötettä ei voi lukea tai se on tyhjä, mitään ei muuteta: ilmoituksesi pysyvät ennallaan.
• Epäonnistumisten jälkeen syötettä yritetään uudelleen 1 h, 3 h, 12 h, 24 h kuluttua. Kolmannen peräkkäisen epäonnistumisen jälkeen profiilin omistaja saa yhden sähköpostin.
• Tuonti ei koskaan koske Siiassa käsin kirjoitettuihin ilmoituksiin.

Täydellinen esimerkki

Kolme ilmoitusta: täydellinen merkintä, lyhin hyväksyttävä merkintä ja tontti.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Siia listing feed, version 1. Documentation: https://siia.ee/for-agents/feed -->
<listings version="1" generated_at="2026-11-13T08:00:00+02:00">

  <!-- A full entry: address in parts, coordinates, three languages. -->
  <listing>
    <external_id>KB-10231</external_id>
    <deal>sale</deal>
    <type>apartment</type>
    <price currency="EUR">189000</price>
    <address>
      <county>Harju maakond</county>
      <city>Tallinn</city>
      <district>Kalamaja</district>
      <street>Vabriku</street>
      <house>12</house>
      <unit>5</unit>
    </address>
    <coordinates lat="59.447310" lng="24.731420"/>
    <area>54.3</area>
    <rooms>2</rooms>
    <bedrooms>1</bedrooms>
    <bathrooms>1</bathrooms>
    <floor>3</floor>
    <floors_total>5</floors_total>
    <built_year>1962</built_year>
    <renovated_year>2021</renovated_year>
    <condition>renovated</condition>
    <energy_label>C</energy_label>
    <material>stone</material>
    <balcony_area>4.5</balcony_area>
    <features>
      <feature>balcony</feature>
      <feature>storage</feature>
      <feature>fibre</feature>
    </features>
    <headline lang="et">Renoveeritud kahetoaline korter Kalamajas</headline>
    <headline lang="ru">Двухкомнатная квартира после ремонта в Каламая</headline>
    <headline lang="en">Renovated two-room apartment in Kalamaja</headline>
    <description lang="et"><![CDATA[Valgusküllane korter vaikse sisehoovi poole. Uus elektrisüsteem ja torustik, rõdu õhtupäikesega.

Trammipeatus on kolme minuti kaugusel.]]></description>
    <description lang="ru"><![CDATA[Светлая квартира с окнами в тихий двор. Новая электрика и трубы, балкон на вечернее солнце.]]></description>
    <description lang="en"><![CDATA[A bright apartment facing a quiet courtyard. New wiring and plumbing, a balcony with evening sun.]]></description>
    <agent_email>[email protected]</agent_email>
    <photos>
      <photo>https://media.example.ee/listings/10231/01.jpg</photo>
      <photo>https://media.example.ee/listings/10231/02.jpg</photo>
      <photo>https://media.example.ee/listings/10231/03.jpg</photo>
    </photos>
    <floor_plan>https://media.example.ee/listings/10231/plan.png</floor_plan>
    <updated_at>2026-11-12T16:40:00+02:00</updated_at>
  </listing>

  <!-- The shortest entry that is accepted: one address line (Siia looks up the rest), one language. -->
  <listing>
    <external_id>KB-10244</external_id>
    <deal>rent</deal>
    <type>apartment</type>
    <price currency="EUR">650</price>
    <address>
      <line>Sõpruse pst 202, Tallinn</line>
    </address>
    <area>38</area>
    <rooms>1</rooms>
    <description lang="et">Möbleeritud ühetoaline korter Mustamäel. Vaba alates detsembrist.</description>
    <photos>
      <photo>https://media.example.ee/listings/10244/01.jpg</photo>
    </photos>
    <updated_at>2026-11-10T09:15:00+02:00</updated_at>
  </listing>

  <!-- Land: plot_area instead of area. -->
  <listing>
    <external_id>KB-10250</external_id>
    <deal>sale</deal>
    <type>land</type>
    <price currency="EUR">42000</price>
    <address>
      <county>Tartu maakond</county>
      <city>Kambja vald</city>
      <district>Kulli küla</district>
      <street>Kuuse</street>
    </address>
    <coordinates lat="58.262100" lng="26.705300"/>
    <plot_area>1850</plot_area>
    <cadastral_number>28201:001:0345</cadastral_number>
    <headline lang="et">Elamumaa krunt Kulli külas</headline>
    <description lang="et">Tasane krunt asfalttee ääres, elekter ja vesi krundi piiril.</description>
    <description lang="en">A level residential plot by a paved road, electricity and water at the boundary.</description>
    <agent_email>[email protected]</agent_email>
    <photos>
      <photo>https://media.example.ee/listings/10250/01.jpg</photo>
      <photo>https://media.example.ee/listings/10250/02.jpg</photo>
    </photos>
    <updated_at>2026-11-01T12:00:00+02:00</updated_at>
  </listing>

</listings>

{
  "version": 1,
  "generated_at": "2026-11-13T08:00:00+02:00",
  "listings": [
    {
      "external_id": "KB-10231",
      "deal": "sale",
      "type": "apartment",
      "price": 189000,
      "address": {
        "county": "Harju maakond",
        "city": "Tallinn",
        "district": "Kalamaja",
        "street": "Vabriku",
        "house": "12",
        "unit": "5"
      },
      "coordinates": { "lat": 59.44731, "lng": 24.73142 },
      "area": 54.3,
      "rooms": 2,
      "bedrooms": 1,
      "bathrooms": 1,
      "floor": 3,
      "floors_total": 5,
      "built_year": 1962,
      "renovated_year": 2021,
      "condition": "renovated",
      "energy_label": "C",
      "material": "stone",
      "balcony_area": 4.5,
      "features": ["balcony", "storage", "fibre"],
      "headline": {
        "et": "Renoveeritud kahetoaline korter Kalamajas",
        "ru": "Двухкомнатная квартира после ремонта в Каламая",
        "en": "Renovated two-room apartment in Kalamaja"
      },
      "description": {
        "et": "Valgusküllane korter vaikse sisehoovi poole. Uus elektrisüsteem ja torustik, rõdu õhtupäikesega.\n\nTrammipeatus on kolme minuti kaugusel.",
        "ru": "Светлая квартира с окнами в тихий двор. Новая электрика и трубы, балкон на вечернее солнце.",
        "en": "A bright apartment facing a quiet courtyard. New wiring and plumbing, a balcony with evening sun."
      },
      "agent_email": "[email protected]",
      "photos": [
        "https://media.example.ee/listings/10231/01.jpg",
        "https://media.example.ee/listings/10231/02.jpg",
        "https://media.example.ee/listings/10231/03.jpg"
      ],
      "floor_plan": "https://media.example.ee/listings/10231/plan.png",
      "updated_at": "2026-11-12T16:40:00+02:00"
    },
    {
      "external_id": "KB-10244",
      "deal": "rent",
      "type": "apartment",
      "price": 650,
      "address": "Sõpruse pst 202, Tallinn",
      "area": 38,
      "rooms": 1,
      "description": { "et": "Möbleeritud ühetoaline korter Mustamäel. Vaba alates detsembrist." },
      "photos": ["https://media.example.ee/listings/10244/01.jpg"],
      "updated_at": "2026-11-10T09:15:00+02:00"
    },
    {
      "external_id": "KB-10250",
      "deal": "sale",
      "type": "land",
      "price": 42000,
      "address": {
        "county": "Tartu maakond",
        "city": "Kambja vald",
        "district": "Kulli küla",
        "street": "Kuuse"
      },
      "coordinates": { "lat": 58.2621, "lng": 26.7053 },
      "plot_area": 1850,
      "cadastral_number": "28201:001:0345",
      "headline": { "et": "Elamumaa krunt Kulli külas" },
      "description": {
        "et": "Tasane krunt asfalttee ääres, elekter ja vesi krundi piiril.",
        "en": "A level residential plot by a paved road, electricity and water at the boundary."
      },
      "agent_email": "[email protected]",
      "photos": [
        "https://media.example.ee/listings/10250/01.jpg",
        "https://media.example.ee/listings/10250/02.jpg"
      ],
      "updated_at": "2026-11-01T12:00:00+02:00"
    }
  ]
}

Uudiskohteen hinnasto

Rakennuttaja voi pitää kohteen hinnastoa taulukossa ja antaa sen linkin kohteen sivulla kohdassa Asunnot ja hinnat. Hyväksytään CSV tai TSV, Google-taulukko (tavallinen jakolinkki kaikille, joilla on linkki, tai Tiedosto, Jaa, Julkaise verkossa CSV-muodossa) tai JSON, jossa on taulukko olioista, joiden avaimina ovat sarakkeiden nimet. Yksi rivi asuntoa kohden, ensimmäinen rivi nimeää sarakkeet.

Myös vironkieliset sarakenimet käyvät: kood, tube, pind, korrus, rõdu, hind, staatus, plaan.

• Tarkista näyttää, montako asuntoa lisättäisiin, muutettaisiin tai puuttuu, ja mitä rivejä ei voida lukea. Mikään ei muutu ennen kuin valitset Aloita synkronointi.
• Sen jälkeen linkki luetaan kerran tunnissa. Rivi, jota ei voida lukea, jätetään pois ja loput synkronoidaan. Jos taulukkoa ei voida ladata, mitään ei muuteta.
• Asunto, jota ei ole taulukossa, merkitään myydyksi, kun se puuttuu 2 synkronoinnista peräkkäin. Asuntoja ei koskaan poisteta.
• Ostajan Siiassa tekemä varaus pysyy voimassa, vaikka taulukossa lukisi vapaa. Myyty taulukossa päättää sen.
• Enintään 1 000 riviä ja 2 Mt. Epäonnistumisen jälkeen yritämme uudelleen 1 h, 3 h, 12 h, 24 h kuluttua; 3 peräkkäisen epäonnistumisen jälkeen profiilin omistaja saa yhden sähköpostin.

code,rooms,area_m2,floor,balcony_m2,price,status,plan_url
A-1,1,31.5,0,,149000,available,https://example.ee/plans/a-1.pdf
A-2,2,48.5,1,5.2,219000,available,https://example.ee/plans/a-2.pdf
A-3,2,50.0,1,5.2,226000,reserved,
A-4,3,72.4,2,8.0,315000,sold,https://example.ee/plans/a-4.pdf
B-1,4,96.0,3,12.5,429000,available,