XML-Feed für den Import von Objekten

Überblick

Erste Schritte

1. Kopieren Sie das minimale Beispiel unten oder laden Sie ein vollständigeres Beispiel-XML herunter.
2. 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.
3. Fügen Sie Angebote mit stabiler offer_uid, category/subcategory, Standort (internal_id), images, price, description, currency=eur hinzu.
4. Hosten Sie den Feed unter einer öffentlichen HTTPS-URL und senden Sie sie an [email protected].
5. Für manuellen Sync: REST-Tutorial.

Geo-Lookup-Dateien: CSV · PostgreSQL dump

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.

So bereiten Sie einen Feed vor

1. Root <feed>, Broker in <Brokers>, Angebote in <offers>.
2. Standort: internal_id der Stadt, des Dorfes oder Stadtviertels aus den Geo-Dateien. Fehlt sie, wird der Standort in der Beschreibung gesucht; wird er nicht gefunden, bleibt das Angebot unveröffentlicht.
3. Währung: senden Sie eur.
4. Bei jeder echten Änderung erhöhen Sie Feed-<updated> und <last_update> der betroffenen Angebote.
5. Die URL muss für serverseitige Clients erreichbar sein (keine interaktive Cloudflare-Challenge).

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

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. Ein Angebot, dessen broker_id keinem verknüpften Agenten entspricht, wird nicht importiert, es sei denn, für die Agentur ist ein Ersatzagent konfiguriert.

Offers (unterstützte Felder)

Werte

subcategory (unterstützte Werte)

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

Senden Sie die Werte genau wie aufgeführt, in Großbuchstaben. Ein unbekannter Wert lässt den Import des Angebots fehlschlagen.

building_condition

• Completed (oder bds-completed) — Mit Akt 16
• SemiCompleted (oder semi_completed) — Mit Akt 15
• NotCompleted (oder not_completed) — Mit Akt 14
• UnderConstruction — Im Bau/mit Baugenehmigung
• PreConstruction (oder pre_construction) — Auf dem Grünen (konzeptionelles Projekt)

Groß-/Kleinschreibung ist relevant.

construction_type

• епк — Großflächenschalung (schleichende Schalung)
• панел — Plattenbauweise
• тухла — Ziegelstein (mit Betonplatten)
• гредоред — Ziegelstein (Trimmer)

Nur Kleinbuchstaben: Тухла wird nicht erkannt.

Standardwerte

Fehlt ein Tag oder ist er leer, trägt der Import ein:

Heizung, Zimmer, Schlafzimmer, Bäder, Bauzustand und Bauart werden bei Grundstück, landwirtschaftlicher Fläche, Garage, Stellplatz und Neubau nicht ausgefüllt.

Ignorierte Tags

Gebäude / Komplex → Wohnungen

1. Parent: subcategory ist eines von НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО, ЗАТВОРЕН КОМПЛЕКС.
2. Child: <construction_id>PARENT_OFFER_UID</construction_id>.
3. Die Reihenfolge im XML spielt keine Rolle. Ein leerer Tag entfernt die Verknüpfung. Selbstreferenz / ungültiger Parent wird ignoriert.

Grundstück und Land

Für ein Grundstück gibt es keine eigenen Tags — es wird wie ein gewöhnliches Angebot übermittelt:

1. <subcategory>ПАРЦЕЛ</subcategory> für ein Baugrundstück oder ЗЕМЕДЕЛСКА ЗЕМЯ für landwirtschaftliche Fläche. Wald, Weinberg, Weide und Obstgarten können derzeit nicht übermittelt werden.
2. <surface> ist die Objektfläche in m². Ein Wert zwischen 0 und 1 wird als Dekar gelesen: 0.8 = 800 m² (mit Punkt, nicht mit Komma). Fehlt surface, wird surface_parcel verwendet, danach die Fläche aus der Beschreibung.
3. <internal_id> der Stadt oder des Dorfes genügt — ein Stadtviertel ist nicht erforderlich.
4. Zimmer, Etage, Bauart und Möblierung werden nicht benötigt.
5. Asphaltstraße: <exterior_ids>10</exterior_ids>. Für Strom und Wasser gibt es keine Tags — schreiben Sie in die (bulgarische) Beschreibung genau „ток и вода на граница“ (oder nur „ток на граница“ / „вода на граница“). Andere Formulierungen werden möglicherweise nicht erkannt.
6. Die Zweckbestimmung wird ebenfalls aus der Beschreibung gelesen. Ist dort nichts angegeben, werden bei ПАРЦЕЛ sowohl „Wohnbebauung“ als auch „Gewerbeimmobilie“ eingetragen; bei ЗЕМЕДЕЛСКА ЗЕМЯ bleibt das Feld leer.
7. land_category und parcel_in_regulation werden ignoriert.

<offer>
  <offer_uid>parcel-1</offer_uid>
  <last_update>YYYY-MM-DD HH:MM:SS</last_update>
  <title>Парцел в село Лозен</title>
  <description>Равен парцел с лице към улица. Ток и вода на граница.</description>
  <images>https://example.com/p1.jpg;https://example.com/p2.jpg</images>
  <price>85000</price>
  <surface>1200</surface>
  <currency>eur</currency>
  <category>продажби</category>
  <subcategory>ПАРЦЕЛ</subcategory>
  <internal_id>9433</internal_id>
  <exterior_ids>10</exterior_ids>
  <broker_id>YOUR_AGENT_SOURCE_ID</broker_id>
</offer>

REST API und Support

• REST API
• [email protected] · [email protected]