XML-Feed für den Import von Objekten

So bereiten Sie einen XML-Feed für den Import von Objekten in Realistimo vor. Für On-Demand-Sync siehe die REST API.

Overview

Überblick

XML (diese Seite)

Was im Feed zu veröffentlichen ist und wie der Import die Felder liest.

REST

API-Schlüssel, POST /start, POST /latest-log, Limits und optionaler Callback.

Tutorial

Erste Schritte

Kopieren Sie das minimale Beispiel unten oder laden Sie ein vollständigeres Beispiel-XML herunter.
Setzen Sie agency_uid auf die Source-ID, die Realistimo Ihrer Agentur gegeben hat, und die broker_id-Werte auf bereits in Realistimo verknüpfte Agent-Source-IDs.
Fügen Sie Angebote mit stabiler offer_uid, category/subcategory, Standort (internal_id bevorzugt), images, price, description, currency=eur hinzu.
Hosten Sie den Feed unter einer öffentlichen HTTPS-URL und senden Sie sie an [email protected].
Für manuellen Sync: REST-Tutorial.

Geo-Lookup-Dateien: CSV · PostgreSQL dump

Explanation

So funktioniert die Synchronisation

Feed-Ebene: <updated> ist die Feed-Version. Ist sie seit dem letzten erfolgreichen Sync unverändert, wird der Import übersprungen.
Veralteter Feed: wenn <updated> als Datum älter als 30 Tage geparst wird, stoppt die Verarbeitung.
Angebots-Ebene: bei einem veröffentlichten Angebot werden die meisten Felder übersprungen, wenn <last_update> vorhanden und nicht neuer als die zuletzt importierte Änderung ist (Preis, Agentenzuweisung und Beschreibung werden trotzdem aktualisiert). Leeres/fehlendes <last_update> löst diesen Skip nicht aus.
Fehlende Angebote: Angebote, die im Feed fehlen, werden bei einem normalen Importlauf entfernt/archiviert.
Fehlende optionale XML-Tags werden als leer behandelt — nicht jeder optionale Tag ist nötig.

„Erforderlich“ bedeutet unten: ohne Wert schlägt Import/Veröffentlichung in der Regel fehl oder das Angebot bleibt unveröffentlicht. Viele Attribute haben Standardwerte.

How-to

So bereiten Sie einen Feed vor

Root <feed>, Broker in <Brokers>, Angebote in <offers>.
Standort: bevorzugen Sie internal_id aus der Geo-DB; Alternative ist subregion_id.
Währung: senden Sie eur.
Bei jeder echten Änderung erhöhen Sie Feed-<updated> und <last_update> der betroffenen Angebote.
Die URL muss für serverseitige Clients erreichbar sein (keine interaktive Cloudflare-Challenge).

Reference

Minimales Beispiel

Kopieren Sie dieses Skelett, ersetzen Sie Platzhalter und setzen Sie aktuelle Zeitstempel (YYYY-MM-DD HH:MM:SS, nicht älter als 30 Tage).

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

Vollständigeres Beispiel-XML herunterladen (Formreferenz — ersetzen Sie weiterhin IDs, Zeitstempel und Inhalte durch Ihre).

Agency

Tag	Beschreibung	Hinweise
`<updated>`	Feed-Version / Datum	Erforderlich Muss sich ändern, wenn sich Inhalte ändern; max. 30 Tage alt
`<agency_uid>`	Agentur-Source-ID	Erforderlich Muss mit der für Ihre Agentur konfigurierten ID übereinstimmen
`<agency_name>`, `<agency_phone>`, `<agency_email>`	Metadaten	Optional Vom Import nicht verwendet; für Kompatibilität unbedenklich
`<result_url>`	Callback nach dem Import	Optional Realistimo sendet per POST einen latest-log-förmigen JSON-Body; siehe REST

Brokers

<Brokers>/<Broker> liefert Broker-Kontaktdaten für den Feed. Die Angebots-broker_id muss einer bereits mit Ihrer Agentur in Realistimo verknüpften Agent-Source-ID entsprechen (bei der Integration eingerichtet). Die XML-BrokerID-Werte sollten dieselben IDs verwenden.

Tag	Hinweise
`<BrokerID>`	Erforderlich Agent-Source-ID (bevorzugt ≠ `agency_uid`)
`<BrokerName>`	Erforderlich Name (+ Nachname)
`<BrokerPhone>`, `<BrokerEmail>`, `<BrokerPhoto>`	Optional

Offers (unterstützte Felder)

Tag	Beschreibung	Hinweise
`<last_update>`	Änderungszeit des Angebots	Empfohlen Datum/Uhrzeit oder Unix-Timestamp. Wenn vorhanden und nicht neuer als die zuletzt importierte Änderung, werden die meisten Felder bei veröffentlichten Angeboten übersprungen
`<offer_uid>`	Stabile ID	Erforderlich Bei Bearbeitungen nicht ändern
`<offer_code>`	Referenzcode	Optional
`<title>`	Titel-Fragment	Optional Getrennt von der Beschreibung
`<description>`	Beschreibung	Empfohlen Für die Veröffentlichung stark erwünscht
`<images>`	URLs	Erforderlich Trenner `;`
`<price>`	Preis	Erforderlich Ganzzahlteil; bei Parent-Gebäude/Komplex auf null gesetzt
`<surface>`	Fläche m²	Erforderlich Für die meisten Typen erforderlich (außer Garage)
`<surface_parcel>`	Grundstück/Parzelle	Optional
`<currency>`	Währung	Empfohlen eur Akzeptiert: `eur`/`EUR`/`BGN`/`лв` — werden zu EUR normalisiert. Fehlende Währung wird als BGN behandelt und nach EUR umgerechnet. Bevorzugen Sie `eur`
`<category>`	`продажби` / `наеми`	Erforderlich
`<subcategory>`	Objekttyp	Erforderlich Muss ein exakter unterstützter Wert sein (siehe unten)
`<internal_id>`	Geo-Internal-ID	Empfohlen Bevorzugte Standortmethode
`<subregion_id>`	Gemappte Standort-ID	Optional Wird verwendet, wenn `internal_id` fehlt/nicht numerisch ist
`<construction_type>`	епк / панел / тухла / гредоред / метална конструкция	Optional
`<floor>`, `<floorAll>`	Etage / Etagen	Optional `floor`-Wert `0` wird ignoriert
`<building_condition>`	Completed / …	Optional
`<build_year>`	YYYY-MM-DD	Optional
`<furnished>`	0/14/23/65	Optional 0 und 23 = unmöbliert
`<heating_ids>`	IDs via `,`	Optional 4/6/18 Pellets, 35 AC, 44 Strom, 46 Fernwärme, 80 Gas
`<parking_ids>`	52, 93	Optional 52 Garage, 93 Stellplatz
`<rooms_count>`, `<bedroom_count>`, `<bath_count>`	Anzahlen	Optional
`<exterior_ids>`	42=Aufzug, 10=Asphalt	Optional Nur diese IDs werden angewendet
`<broker_id>`	Agent-Source-ID	Erforderlich Muss einem in Realistimo verknüpften Agenten entsprechen
`<construction_id>`	Parent-offer_uid	Optional Siehe How-to Gebäude/Komplex
`<youtube_link>` / `<youTube_link>`	YouTube	Optional
`<virtual_panorama_link>`	Tour	Optional
`<Exclusive>`	0/1	Optional

Werte

subcategory (unterstützte Werte)

СТАЯ, АПАРТАМЕНТ, ЕДНОСТАЕН, БОКСИОНЕРА, СТУДИО, 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, ГАРСОНИЕРА, ГАРСОНИЕРА ЛУКС
АТЕЛИЕ · АТЕЛИЕ, ТАВАН · ТАВАН · ЕТАЖ ОТ КЪЩА · КЪЩА · ВИЛА
ОФИС, МАГАЗИН, ЗАВЕДЕНИЕ, СКЛАД, ГАРАЖ, ПАРКОМЯСТО, ПРОМ. ПОМЕЩЕНИЕ, ХОТЕЛ
ПАРЦЕЛ, ЗЕМЕДЕЛСКА ЗЕМЯ
СГРАДИ, СГРАДА — ganzes Gebäude mit Preis (kein Parent für construction_id)
НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО — Parent-Gebäude
ЗАТВОРЕН КОМПЛЕКС — Parent-Komplex

Werte genau wie aufgeführt senden (kyrillisch). Unbekannte Werte lassen den Angebotsimport fehlschlagen.

building_condition

Completed, UnderConstruction, PreConstruction, SemiCompleted, NotCompleted.

construction_type

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

Ignorierte Tags

Diese Tags werden beim Import nicht angewendet. Sie dürfen im Feed vorkommen, haben aber keine Wirkung auf das Angebot: balcony_count, land_category, parcel_in_regulation, new_construction.