Файл с объявлениями

Подходящие форматы

• Siia XML и Siia JSON, описанные на этой странице.
• REDE XML версии 0.93 (документ <Objects> из схемы на ekfl.ee/schema), с пространством имён urn:REDE/0.93 или без него. Написание из собственного списка полей kv.ee тоже понимается.

Уже отправляете объявления на kv.ee?

kv.ee импортирует объявления в формате REDE XML (Real Estate Data Exchange), это эстонский стандарт 2007 года. Siia читает тот же формат, поэтому новая выгрузка не нужна: достаточно, чтобы ваша система публиковала объекты, которые она уже готовит для kv.ee, одним документом <Objects> по адресу https. Укажите этот адрес на вкладке «Импорт» или один раз загрузите файл, чтобы попробовать. Формат определяется автоматически, правила с этой страницы действуют так же.

kv.ee забирает объекты из вашей системы по одному (getObjectById). Siia нужны они в одном файле. Попросите поставщика вашей системы сделать выгрузку REDE по постоянному адресу, данные те же. Если это не получается, напишите на [email protected].

Как читается файл REDE

• Импортируются только объекты со статусом active и только если visible равно all или отсутствует. Архивный, удалённый, проданный или сданный объект считается ушедшим из фида.
• Объект, который предлагают и на продажу, и в аренду, становится двумя объявлениями. Второе получает номер объекта с добавкой "-rent" или "-sale".
• Цена должна быть в евро и открытой. Номер дома или квартиры, отмеченный как скрытый, не показывается.
• Описание берётся из текстов info сделки (est, rus, eng, lav). Площадь в арах или гектарах пересчитывается в м².
• Переносятся тип, состояние, материал, энергетический класс, комнаты, этажи, балконы, годы ремонта, фото, видео и координаты. Опции, которым нет соответствия на Siia, не переносятся.
• Агент определяется по e-mail, если в файле есть и записи брокеров (<Broker> с <email>). Иначе объявления подписываются именем владельца профиля.
• Гаражи, парковочные места и кладовые, а также объекты за пределами Эстонии пока не переносятся.

Как это работает

1. 01

   Создайте профиль

   Войдите и создайте профиль агентства или застройщика. Пригласите маклеров по e-mail, чтобы объявления выходили под их именами.

2. 02

   Добавьте адрес файла

   На вкладке «Импорт» введите адрес https вашего файла или один раз загрузите файл, чтобы попробовать.

3. 03

   Посмотрите предпросмотр

   Siia читает файл, ничего не публикуя, и показывает, сколько объявлений найдено, первые десять в том виде, как она их поняла, и замечания по каждому объявлению.

4. 04

   Запустите импорт

   Публикация начинается только после вашего подтверждения. Дальше файл читается каждый час.

Структура

Один документ в UTF-8 со всеми объявлениями, которые должны быть на Siia. В XML корневой элемент <listings>, внутри по одному <listing> на объект. В JSON это объект с массивом "listings". Названия полей в обоих вариантах одинаковые.

Поля

Допустимые значения

Пишите значения так, как ниже. Обычные эстонские слова тоже понимаются (korter, maja, müük, üür). Необязательное значение, которое нам неизвестно, остаётся пустым с пометкой в журнале, объявление из-за него не отклоняется.

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

Правила

• Принимаются только адреса https, и для файла, и для фотографий. Файл может быть до 20 МБ и до 5000 объявлений, должен отдаваться за 20 секунд и может перенаправлять не более 3 раз.
• Ничего не публикуется, пока владелец профиля не посмотрит предпросмотр и не нажмёт «Начать импорт». Это подтверждение сохраняется как ваше разрешение на публикацию.
• Объявление создаётся сразу опубликованным. Для этого нужны идентификатор, сделка, тип, цена, адрес, площадь, описание и хотя бы одна фотография. Остальные пропускаются, причина указана в журнале.
• Объявления сопоставляются по external_id. Изменённое обновляется, неизменённое не трогается, скачиваются только новые фотографии.
• Фотография, которую не удалось скачать, пропускается, и при следующем запуске мы пробуем снова. Объявление всё равно публикуется.
• Объявление, которого больше нет в файле, снимается только после того, как оно отсутствовало в 2 успешных запусках подряд. Если оно возвращается, оно публикуется снова.
• Если файл не читается или пуст, не меняется вообще ничего: ваши объявления остаются как были.
• После сбоев файл читается снова через 1 h, 3 h, 12 h, 24 h. После третьего сбоя подряд владелец профиля получает одно письмо.
• Объявления, введённые на Siia вручную, импорт никогда не трогает.

Полный пример

Три объявления: полная запись, самая короткая запись, которая принимается, и земельный участок.

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

Прайс-лист нового проекта

Застройщик может вести прайс-лист проекта в таблице и указать ссылку на неё на странице проекта, в разделе «Квартиры и цены». Подходят CSV и TSV, таблица Google (обычная ссылка с доступом для всех, у кого она есть, или Файл, Поделиться, Опубликовать в интернете как CSV) и JSON с массивом объектов, где ключи совпадают с названиями столбцов. Одна строка на квартиру, первая строка называет столбцы.

Названия столбцов на эстонском тоже понимаются: kood, tube, pind, korrus, rõdu, hind, staatus, plaan.

• Проверка показывает, сколько квартир добавится, изменится или отсутствует, и какие строки не читаются. До нажатия «Начать синхронизацию» ничего не меняется.
• Потом ссылка читается каждый час. Строка, которую нельзя прочитать, пропускается, остальное синхронизируется. Если таблицу не удалось скачать, ничего не меняется.
• Квартира, которой нет в таблице, отмечается проданной, если её нет 2 синхронизации подряд. Квартиры никогда не удаляются.
• Бронь покупателя на Siia действует до своего срока, даже если в таблице «свободна». «Продана» в таблице её снимает.
• Не больше 1 000 строк и 2 МБ. После ошибок пробуем снова через 1 h, 3 h, 12 h, 24 h; после 3 ошибок подряд владелец профиля получает одно письмо.

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,