İlan içe aktarma için XML feed

Realistimo'ya ilan içe aktarmak için bir XML feed nasıl hazırlanır. On-demand sync için REST API sayfasına bakın.

Overview

Genel bakış

XML (bu sayfa)

Feed'de ne yayınlanacağı ve import'un alanları nasıl okuduğu.

REST

API key, POST /start, POST /latest-log, limitler ve isteğe bağlı callback.

Tutorial

Başlayın

Aşağıdaki minimal örneği kopyalayın veya daha dolu bir örnek XML indirin.
agency_uid değerini Realistimo'nun acentenize verdiği source id yapın; broker_id değerlerini Realistimo'da zaten bağlı agent source id'leri yapın.
Kararlı bir offer_uid, category/subcategory, konum (internal_id tercih edilir), images, price, description, currency=eur ile ilanlar ekleyin.
Feed'i genel bir HTTPS URL'de barındırın ve [email protected] adresine gönderin.
Manuel sync için: REST tutorial.

Geo lookup dosyaları: CSV · PostgreSQL dump

Explanation

Senkronizasyon nasıl çalışır

Feed seviyesi: <updated> feed sürümüdür. Son başarılı sync'ten beri değişmediyse import atlanır.
Eski feed: <updated> 30 günden eski bir tarih olarak parse edilirse işlem durur.
İlan seviyesi: yayınlanmış bir ilanda <last_update> varsa ve son içe aktarılan değişiklikten daha yeni değilse çoğu alan atlanır (fiyat, agent ataması ve açıklama yine güncellenir). Boş/eksik <last_update> bu skip'i tetiklemez.
Eksik ilanlar: feed'de olmayan ilanlar normal bir import çalıştırmasında kaldırılır/arşivlenir.
Eksik isteğe bağlı XML tag'leri boş kabul edilir — her isteğe bağlı tag gerekli değildir.

Aşağıdaki «Zorunlu» şu anlama gelir: değer olmadan import/yayın genellikle başarısız olur veya ilan yayınlanmamış kalır. Birçok attribute'un varsayılan değerleri vardır.

How-to

Feed nasıl hazırlanır

Root <feed>, broker'lar <Brokers> içinde, ilanlar <offers> içinde.
Konum: geo DB'den internal_id tercih edin; alternatif subregion_id.
Para birimi: eur gönderin.
Her gerçek değişiklikte feed <updated> ve etkilenen ilanlarda <last_update> değerlerini güncelleyin.
URL, sunucu taraflı istemciler tarafından erişilebilir olmalıdır (etkileşimli Cloudflare challenge olmamalı).

Reference

Minimal örnek

Bu iskeleti kopyalayın, placeholder'ları değiştirin ve güncel timestamp'ler koyun (YYYY-MM-DD HH:MM:SS, 30 günden eski olmamalı).

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <updated>YYYY-MM-DD HH:MM:SS</updated>
  <agency_uid>YOUR_AGENCY_SOURCE_ID</agency_uid>
  <Brokers>
    <Broker>
      <BrokerID>YOUR_AGENT_SOURCE_ID</BrokerID>
      <BrokerName>Ivan Ivanov</BrokerName>
      <BrokerPhone>0888000000</BrokerPhone>
      <BrokerEmail>[email protected]</BrokerEmail>
    </Broker>
  </Brokers>
  <offers>
    <offer>
      <offer_uid>offer-1</offer_uid>
      <last_update>YYYY-MM-DD HH:MM:SS</last_update>
      <description>Test listing</description>
      <images>https://example.com/a.jpg</images>
      <price>100000</price>
      <surface>70</surface>
      <currency>eur</currency>
      <category>продажби</category>
      <subcategory>2-СТАЕН</subcategory>
      <internal_id>8545</internal_id>
      <broker_id>YOUR_AGENT_SOURCE_ID</broker_id>
    </offer>
  </offers>
</feed>

Daha dolu örnek XML indir (şekil referansı — yine de id'leri, timestamp'leri ve içeriği sizinkilerle değiştirin).

Agency

Tag	Açıklama	Notlar
`<updated>`	Feed sürümü / tarihi	Zorunlu İçerik değişince değişmeli; en fazla 30 gün eski
`<agency_uid>`	Acente source id	Zorunlu Acenteniz için yapılandırılmış id ile eşleşmeli
`<agency_name>`, `<agency_phone>`, `<agency_email>`	Metadata	İsteğe bağlı Import tarafından kullanılmaz; uyumluluk için güvenli
`<result_url>`	Import sonrası callback	İsteğe bağlı Realistimo latest-log şeklinde JSON gövdesi POST eder; bkz. REST

Brokers

<Brokers>/<Broker> feed için broker iletişim bilgilerini sağlar. İlan broker_id, Realistimo'da acentenize zaten bağlı bir agent source id ile eşleşmelidir (entegrasyon sırasında ayarlanır). XML BrokerID değerleri aynı id'leri kullanmalıdır.

Tag	Notlar
`<BrokerID>`	Zorunlu Agent source id (tercihen ≠ `agency_uid`)
`<BrokerName>`	Zorunlu Ad (+ soyad)
`<BrokerPhone>`, `<BrokerEmail>`, `<BrokerPhoto>`	İsteğe bağlı

Offers (desteklenen alanlar)

Tag	Açıklama	Notlar
`<last_update>`	İlan değişiklik zamanı	Önerilen Tarih/saat veya unix timestamp. Varsa ve son içe aktarılan değişiklikten daha yeni değilse, yayınlanmış ilanlarda çoğu alan atlanır
`<offer_uid>`	Kararlı id	Zorunlu Düzenlemelerde değiştirmeyin
`<offer_code>`	Referans kodu	İsteğe bağlı
`<title>`	Başlık parçası	İsteğe bağlı Açıklamadan ayrı
`<description>`	Açıklama	Önerilen Yayın için güçlü şekilde istenir
`<images>`	URL'ler	Zorunlu Ayırıcı `;`
`<price>`	Fiyat	Zorunlu Tam sayı kısmı; parent bina/kompleks için sıfırlanır
`<surface>`	Alan m²	Zorunlu Çoğu tip için zorunlu (garaj hariç)
`<surface_parcel>`	Bahçe/arsa	İsteğe bağlı
`<currency>`	Para birimi	Önerilen eur Kabul edilen: `eur`/`EUR`/`BGN`/`лв` — EUR’ye normalize edilir. Eksik para birimi BGN kabul edilip EUR’ye çevrilir. `eur` tercih edin
`<category>`	`продажби` / `наеми`	Zorunlu
`<subcategory>`	Mülk tipi	Zorunlu Desteklenen tam bir değer olmalı (aşağıya bakın)
`<internal_id>`	Geo internal id	Önerilen Tercih edilen konum yöntemi
`<subregion_id>`	Mapped location id	İsteğe bağlı `internal_id` eksik/sayısal değilse kullanılır
`<construction_type>`	епк / панел / тухла / гредоред / метална конструкция	İsteğe bağlı
`<floor>`, `<floorAll>`	Kat / katlar	İsteğe bağlı `floor` değeri `0` yok sayılır
`<building_condition>`	Completed / …	İsteğe bağlı
`<build_year>`	YYYY-MM-DD	İsteğe bağlı
`<furnished>`	0/14/23/65	İsteğe bağlı 0 ve 23 = eşyasız
`<heating_ids>`	`,` ile ID'ler	İsteğe bağlı 4/6/18 pelet, 35 AC, 44 elektrik, 46 merkezi, 80 gaz
`<parking_ids>`	52, 93	İsteğe bağlı 52 garaj, 93 otopark yeri
`<rooms_count>`, `<bedroom_count>`, `<bath_count>`	Sayılar	İsteğe bağlı
`<exterior_ids>`	42=asansör, 10=asfalt	İsteğe bağlı Yalnızca bu id'ler uygulanır
`<broker_id>`	Agent source id	Zorunlu Realistimo'da bağlı bir agent ile eşleşmeli
`<construction_id>`	Parent offer_uid	İsteğe bağlı Bina/kompleks how-to'ya bakın
`<youtube_link>` / `<youTube_link>`	YouTube	İsteğe bağlı
`<virtual_panorama_link>`	Tour	İsteğe bağlı
`<Exclusive>`	0/1	İsteğe bağlı

Değerler

subcategory (desteklenen değerler)

СТАЯ, АПАРТАМЕНТ, ЕДНОСТАЕН, БОКСИОНЕРА, СТУДИО, 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, ГАРСОНИЕРА, ГАРСОНИЕРА ЛУКС
АТЕЛИЕ · АТЕЛИЕ, ТАВАН · ТАВАН · ЕТАЖ ОТ КЪЩА · КЪЩА · ВИЛА
ОФИС, МАГАЗИН, ЗАВЕДЕНИЕ, СКЛАД, ГАРАЖ, ПАРКОМЯСТО, ПРОМ. ПОМЕЩЕНИЕ, ХОТЕЛ
ПАРЦЕЛ, ЗЕМЕДЕЛСКА ЗЕМЯ
СГРАДИ, СГРАДА — fiyatlı bütün bina (construction_id için parent değil)
НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО — parent construction
ЗАТВОРЕН КОМПЛЕКС — parent complex

Değerleri listede olduğu gibi gönderin (Kiril). Bilinmeyen değerler ilan import'unun başarısız olmasına yol açar.

building_condition

Completed, UnderConstruction, PreConstruction, SemiCompleted, NotCompleted.

construction_type

епк, панел, тухла, гредоред, метална конструкция.

Yok sayılan tag'ler

Bu tag'ler import sırasında uygulanmaz. Feed'de görünebilirler ancak ilan üzerinde etkisi yoktur: balcony_count, land_category, parcel_in_regulation, new_construction.