Feed XML pentru importul anunțurilor

Cum să pregătiți un feed XML pentru importul anunțurilor în Realistimo. Pentru sync on-demand vedeți REST API.

Overview

Prezentare generală

XML (această pagină)

Ce să publicați în feed și cum citește importul câmpurile.

REST

Cheie API, POST /start, POST /latest-log, limite și callback opțional.

Tutorial

Începeți

Copiați exemplul minimal de mai jos sau descărcați un eșantion XML mai complet.
Setați agency_uid la source id-ul pe care Realistimo l-a dat agenției dvs. și valorile broker_id la agent source id-uri deja legate în Realistimo.
Adăugați oferte cu un offer_uid stabil, category/subcategory, locație (internal_id preferat), images, price, description, currency=eur.
Găzduiți feed-ul pe un URL HTTPS public și trimiteți-l la [email protected].
Pentru sync manual: Tutorial REST.

Fișiere geo lookup: CSV · PostgreSQL dump

Explanation

Cum funcționează sincronizarea

Nivel feed: <updated> este versiunea feed-ului. Dacă este neschimbată de la ultimul sync reușit, importul este omis.
Feed învechit: dacă <updated> este parsat ca o dată mai veche de 30 de zile, procesarea se oprește.
Nivel ofertă: pentru o ofertă publicată, dacă <last_update> este prezent și nu este mai nou decât ultima modificare importată, majoritatea câmpurilor sunt omise (prețul, asignarea agentului și descrierea se actualizează totuși). <last_update> gol/lipsă nu declanșează acel skip.
Oferte lipsă: ofertele absente din feed sunt retrase/arhivate la o rulare normală de import.
Tag-urile XML opționale lipsă sunt tratate ca goale — nu aveți nevoie de fiecare tag opțional.

„Obligatoriu” mai jos înseamnă: fără valoare, importul/publicarea eșuează de obicei sau oferta rămâne nepublicată. Multe atribute au valori implicite.

How-to

Cum să pregătiți un feed

Root <feed>, brokers în <Brokers>, oferte în <offers>.
Locație: preferați internal_id din geo DB; alternativa este subregion_id.
Monedă: trimiteți eur.
La fiecare modificare reală, actualizați <updated> al feed-ului și <last_update> pe ofertele afectate.
URL-ul trebuie să fie accesibil clienților server-side (fără challenge Cloudflare interactiv).

Reference

Exemplu minimal

Copiați acest skeleton, înlocuiți placeholder-ele și setați timestamp-uri curente (YYYY-MM-DD HH:MM:SS, nu mai vechi de 30 de zile).

<?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>

Descărcați eșantionul XML mai complet (referință de formă — înlocuiți în continuare id-urile, timestamp-urile și conținutul cu ale dvs.).

Agency

Tag	Descriere	Note
`<updated>`	Versiunea / data feed-ului	Obligatoriu Trebuie să se schimbe când se schimbă conținutul; max. 30 de zile vechime
`<agency_uid>`	Source id agenție	Obligatoriu Trebuie să coincidă cu id-ul configurat pentru agenția dvs.
`<agency_name>`, `<agency_phone>`, `<agency_email>`	Metadata	Opțional Neutilizat de import; sigur pentru compatibilitate
`<result_url>`	Callback după import	Opțional Realistimo trimite prin POST un corp JSON în formă latest-log; vezi REST

Brokers

<Brokers>/<Broker> oferă datele de contact ale brokerului pentru feed. broker_id al ofertei trebuie să coincidă cu un agent source id deja legat de agenția dvs. în Realistimo (configurat la integrare). Valorile XML BrokerID ar trebui să folosească aceleași id-uri.

Tag	Note
`<BrokerID>`	Obligatoriu Agent source id (preferabil ≠ `agency_uid`)
`<BrokerName>`	Obligatoriu Nume (+ prenume)
`<BrokerPhone>`, `<BrokerEmail>`, `<BrokerPhoto>`	Opțional

Offers (câmpuri suportate)

Tag	Descriere	Note
`<last_update>`	Ora modificării ofertei	Recomandat Dată/oră sau unix timestamp. Când este prezent și nu este mai nou decât ultima modificare importată, majoritatea câmpurilor sunt omise la ofertele publicate
`<offer_uid>`	Id stabil	Obligatoriu Nu schimbați la editări
`<offer_code>`	Cod de referință	Opțional
`<title>`	Fragment de titlu	Opțional Separat de descriere
`<description>`	Descriere	Recomandat Puternic dorit pentru publicare
`<images>`	URL-uri	Obligatoriu Separator `;`
`<price>`	Preț	Obligatoriu Partea întreagă; zero pentru parent clădire/complex
`<surface>`	Suprafață m²	Obligatoriu Obligatoriu pentru majoritatea tipurilor (cu excepția garajului)
`<surface_parcel>`	Curte/parcelă	Opțional
`<currency>`	Monedă	Recomandat eur Acceptate: `eur`/`EUR`/`BGN`/`лв` — normalizate la EUR. Lipsa monedei e tratată ca BGN și convertită în EUR. Preferăți `eur`
`<category>`	`продажби` / `наеми`	Obligatoriu
`<subcategory>`	Tip proprietate	Obligatoriu Trebuie să fie o valoare suportată exactă (vezi mai jos)
`<internal_id>`	Geo internal id	Recomandat Metodă preferată de locație
`<subregion_id>`	Id locație mapat	Opțional Folosit când `internal_id` lipsește/nu este numeric
`<construction_type>`	епк / панел / тухла / гредоред / метална конструкция	Opțional
`<floor>`, `<floorAll>`	Etaj / etaje	Opțional Valoarea `floor` `0` este ignorată
`<building_condition>`	Completed / …	Opțional
`<build_year>`	YYYY-MM-DD	Opțional
`<furnished>`	0/14/23/65	Opțional 0 și 23 = nemobilat
`<heating_ids>`	ID-uri prin `,`	Opțional 4/6/18 pelete, 35 AC, 44 electricitate, 46 termoficare, 80 gaz
`<parking_ids>`	52, 93	Opțional 52 garaj, 93 loc de parcare
`<rooms_count>`, `<bedroom_count>`, `<bath_count>`	Numărători	Opțional
`<exterior_ids>`	42=lift, 10=asfalt	Opțional Doar aceste id-uri sunt aplicate
`<broker_id>`	Agent source id	Obligatoriu Trebuie să coincidă cu un agent legat în Realistimo
`<construction_id>`	Parent offer_uid	Opțional Vedeți how-to clădire/complex
`<youtube_link>` / `<youTube_link>`	YouTube	Opțional
`<virtual_panorama_link>`	Tour	Opțional
`<Exclusive>`	0/1	Opțional

Valori

subcategory (valori suportate)

СТАЯ, АПАРТАМЕНТ, ЕДНОСТАЕН, БОКСИОНЕРА, СТУДИО, 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, ГАРСОНИЕРА, ГАРСОНИЕРА ЛУКС
АТЕЛИЕ · АТЕЛИЕ, ТАВАН · ТАВАН · ЕТАЖ ОТ КЪЩА · КЪЩА · ВИЛА
ОФИС, МАГАЗИН, ЗАВЕДЕНИЕ, СКЛАД, ГАРАЖ, ПАРКОМЯСТО, ПРОМ. ПОМЕЩЕНИЕ, ХОТЕЛ
ПАРЦЕЛ, ЗЕМЕДЕЛСКА ЗЕМЯ
СГРАДИ, СГРАДА — clădire întreagă cu preț (nu un parent pentru construction_id)
НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО — parent construction
ЗАТВОРЕН КОМПЛЕКС — parent complex

Trimiteți valorile exact ca în listă (chirilice). Valorile necunoscute fac importul ofertei să eșueze.

building_condition

Completed, UnderConstruction, PreConstruction, SemiCompleted, NotCompleted.

construction_type

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

Tag-uri ignorate

Aceste tag-uri nu sunt aplicate la import. Pot apărea în feed, dar nu au efect asupra ofertei: balcony_count, land_category, parcel_in_regulation, new_construction.