Sludinājumu plūsma

Pieņemtie formāti

• Siia XML un Siia JSON, kas aprakstīti šajā lapā.
• REDE XML versija 0.93 (shēmas <Objects> dokuments, ekfl.ee/schema), ar nosaukumtelpu urn:REDE/0.93 vai bez tās. Tiek saprasts arī kv.ee lauku saraksta pieraksts.

Jau sūtāt sludinājumus uz kv.ee?

kv.ee importē sludinājumus REDE XML formātā (Real Estate Data Exchange), kas ir Igaunijas 2007. gada standarts. Siia nolasa to pašu formātu, tāpēc jauns eksports nav vajadzīgs: pietiek, ja jūsu sistēma publicē objektus, ko tā jau sagatavo kv.ee, kā vienu <Objects> dokumentu https adresē. Norādiet šo adresi cilnē Imports vai vienreiz augšupielādējiet failu, lai izmēģinātu. Formāts tiek atpazīts automātiski, un šīs lapas noteikumi attiecas tāpat.

kv.ee paņem objektus no jūsu sistēmas pa vienam (getObjectById). Siia tie vajadzīgi vienā failā. Palūdziet savas sistēmas piegādātājam REDE eksportu pastāvīgā adresē, dati ir tie paši. Ja tas neizdodas, rakstiet uz [email protected].

Kā tiek nolasīts REDE fails

• Tiek importēti tikai objekti ar statusu active un tikai tad, ja visible ir all vai tā nav. Arhivēts, dzēsts, pārdots vai izīrēts objekts tiek uzskatīts par plūsmu atstājušu.
• Objekts, kas piedāvāts gan pārdošanai, gan īrei, kļūst par diviem sludinājumiem. Otrais saņem objekta identifikatoru ar piebildi "-rent" vai "-sale".
• Cenai jābūt eiro un publiskai. Mājas vai dzīvokļa numurs, kas atzīmēts kā slēpts, netiek rādīts.
• Apraksts tiek ņemts no darījuma info tekstiem (est, rus, eng, lav). Platība aros vai hektāros tiek pārrēķināta m².
• Tiek pārņemts veids, stāvoklis, būvmateriāls, energoefektivitātes klase, istabas, stāvi, balkoni, renovācijas gadi, fotoattēli, video un koordinātas. Iespējas, kam Siia nav atbilsmes, netiek pārņemtas.
• Aģents tiek atrasts pēc e-pasta, ja failā ir arī brokeru ieraksti (<Broker> ar <email>). Citādi sludinājumi tiek parakstīti ar profila īpašnieka vārdu.
• Garāžas, autostāvvietas un noliktavas telpas, kā arī objekti ārpus Igaunijas pagaidām netiek pārņemti.

Kā tas darbojas

1. 01

   Izveidojiet profilu

   Piesakieties un izveidojiet aģentūras vai attīstītāja profilu. Uzaiciniet māklerus pa e-pastu, lai sludinājumus varētu parakstīt ar viņu vārdiem.

2. 02

   Pievienojiet plūsmas adresi

   Cilnē Imports ievadiet sava faila https adresi vai, lai izmēģinātu, augšupielādējiet failu vienreiz.

3. 03

   Apskatiet priekšskatījumu

   Siia nolasa plūsmu, neko nepublicējot, un parāda, cik sludinājumu atrada, pirmos desmit tā, kā tos saprata, un katras piezīmes katram sludinājumam.

4. 04

   Sāciet importu

   Kaut kas tiek publicēts tikai pēc jūsu apstiprinājuma. No tā brīža plūsma tiek nolasīta katru stundu.

Struktūra

Viens dokuments ar visiem sludinājumiem, ko vēlaties Siia portālā, UTF-8 kodējumā. XML saknes elements ir <listings> ar vienu <listing> katram mājoklim. JSON tas ir objekts ar masīvu "listings". Lauku nosaukumi abos ir vienādi.

Lauki

Pieņemtās vērtības

Rakstiet vērtības tā, kā norādīts zemāk. Tiek saprasti arī parastie igauņu vārdi (korter, maja, müük, üür), un nezināma neobligāta vērtība tiek atstāta tukša ar piezīmi žurnālā, sludinājumu nenoraidot.

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

Noteikumi

• Tiek pieņemtas tikai https adreses, gan plūsmai, gan fotoattēliem. Plūsma var būt līdz 20 MB un 5000 sludinājumiem, tai jāatbild 20 sekunžu laikā, un tā drīkst pāradresēt ne vairāk kā 3 reizes.
• Nekas netiek publicēts, pirms profila īpašnieks nav apskatījis priekšskatījumu un nospiedis "Sākt importu". Šis apstiprinājums tiek reģistrēts kā jūsu atļauja publicēt saturu.
• Sludinājums tiek izveidots uzreiz aktīvs. Lai to pieņemtu, vajadzīgs identifikators, darījums, veids, cena, adrese, platība, apraksts un vismaz viens fotoattēls. Pārējie tiek izlaisti un ar iemeslu norādīti žurnālā.
• Sludinājumi tiek sasaistīti pēc external_id. Mainīts sludinājums tiek atjaunināts, nemainīts paliek, kā ir, un tiek lejupielādēti tikai jauni fotoattēli.
• Fotoattēls, ko nevar lejupielādēt, tiek izlaists un mēģināts vēlreiz nākamajā palaišanā. Sludinājums tik un tā tiek publicēts.
• Sludinājums, kura vairs nav plūsmā, tiek noņemts tikai tad, ja tā nav bijis 2 veiksmīgās palaišanās pēc kārtas. Ja tas atgriežas, tas tiek publicēts vēlreiz.
• Ja plūsmu nevar nolasīt vai tā ir tukša, nekas netiek mainīts: jūsu sludinājumi paliek, kā bija.
• Pēc kļūmēm plūsma tiek mēģināta vēlreiz pēc 1 h, 3 h, 12 h, 24 h. Pēc trešās kļūmes pēc kārtas profila īpašnieks saņem vienu e-pastu.
• Sludinājumus, kas Siia portālā ievadīti ar roku, imports nekad neskar.

Pilns piemērs

Trīs sludinājumi: pilns ieraksts, īsākais ieraksts, kas tiek pieņemts, un zemes gabals.

<?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"
    }
  ]
}

Jaunā projekta cenrādis

Attīstītājs var glabāt projekta cenrādi tabulā un norādīt tās saiti projekta lapā, sadaļā Dzīvokļi un cenas. Der CSV un TSV, Google tabula (parasta kopīgošanas saite visiem, kam ir saite, vai Fails, Kopīgot, Publicēt tīmeklī kā CSV) un JSON ar objektu masīvu, kura atslēgas ir kolonnu nosaukumi. Viena rinda katram dzīvoklim, pirmā rinda nosauc kolonnas.

Der arī igauņu kolonnu nosaukumi: kood, tube, pind, korrus, rõdu, hind, staatus, plaan.

• Pārbaude parāda, cik dzīvokļu tiktu pievienoti, mainīti vai trūkst, un kuras rindas nevar nolasīt. Pirms Sākt sinhronizāciju nekas nemainās.
• Pēc tam saite tiek nolasīta katru stundu. Rinda, ko nevar nolasīt, tiek izlaista, pārējais tiek sinhronizēts. Ja tabulu nevar lejupielādēt, nekas nemainās.
• Dzīvoklis, kura nav tabulā, tiek atzīmēts kā pārdots, ja tā nav 2 sinhronizācijas pēc kārtas. Dzīvokļi nekad netiek dzēsti.
• Pircēja rezervācija Siia portālā ir spēkā līdz savam termiņam, arī ja tabulā ir pieejams. Pārdots tabulā to izbeidz.
• Ne vairāk kā 1 000 rindas un 2 MB. Pēc kļūdām mēģinām vēlreiz pēc 1 h, 3 h, 12 h, 24 h; pēc 3 kļūdām pēc kārtas profila īpašnieks saņem vienu vēstuli.

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,