Интеграция и Експорт на обяви чрез XML

1. Какво е нужно за издаване на API ключ

Всички заявки към API-то трябва да бъдат автентифицирани с вашия уникален API KEY. Ключът се предава чрез HTTP хедър, а не в самия XML файл.

За да получите ключ, влезте в профила си във Venue, отворете Настройки на акаунта → API & Интеграции и натиснете "Генерирай".

2. Логика на синхронизация (Full-Sync)

Venue използва модел на пълна синхронизация. Това означава, че файлът, който изпращате, трябва да съдържа всички ваши активни обяви в момента.

• Ако подадете обява с external_id, което не съществува в базата ни – тя се създава.
• Ако обявата вече съществува – тя се обновява.
• Ако имате активна обява във Venue, но нейното external_id липсва в изпратения XML файл – системата автоматично я сваля от пазара (архивира).

3. Примерна XML Структура

<?xml version="1.0" encoding="UTF-8"?>
<venue_feed>
  <listings>
    <listing>
      <!-- ЗАДЪЛЖИТЕЛНО: Уникално ID от вашия софтуер -->
      <external_id>CRM-99213</external_id> 
      
      <!-- МАПИНГ ПО КАДАСТЪР: Свързва офертата с официалната карта -->
      <cadastre_id>68134.4082.16.1.15</cadastre_id> 
      
      <!-- МАРКЕТИНГ ДАННИ -->
      <status>FOR_SALE</status> <!-- FOR_SALE или FOR_RENT -->
      <price currency="EUR">150000</price>
      <description><![CDATA[ Продава се страхотен апартамент... ]]></description>
      
      <!-- ПОВЕРИТЕЛНОСТ: Замъглява точния адрес на картата -->
      <hide_exact_location>true</hide_exact_location>

      <!-- МЕДИЯ -->
      <images>
        <image>https://crm-system.bg/photos/1.jpg</image>
        <image>https://crm-system.bg/photos/2.jpg</image>
      </images>

      <!-- ДЕТАЙЛИ: Попълват се, за да презапишат системните данни -->
      <details>
        <type>apartment</type>
        <bedrooms>2</bedrooms>
        <bathrooms>1</bathrooms>
        <living_sqm>85</living_sqm>
        <construction_type>tuhla</construction_type>
        <year_built>2022</year_built>
      </details>
      
      <!-- ХАРАКТЕРИСТИКИ -->
      <features>
        <feature>elevator</feature>
        <feature>parking_underground</feature>
      </features>
    </listing>
  </listings>
</venue_feed>

4. Речник на стойностите

Venue използва четими на английски стрингове (вместо цифрови ID-та). Ето пълният списък с поддържани стойности:

Основни Типове (details.type)

Вид Строителство (details.construction_type)

Характеристики за Сгради / Апартаменти

Изпращат се като тагове вътре във <features> масива.

Характеристики за Парцели / Земи

Важат само ако типът на имота е земя (lot, regulated_plot, agricultural и др.).