Specyfikacja importu XML

1. Pierwsze kroki

Witamy w europejskiej specyfikacji importu XML dla nieruchomości. Ten dokument zawiera wszystkie szczegóły techniczne potrzebne do utworzenia kanału informacyjnego o nieruchomościach, który integruje się z naszą platformą.

2. Przegląd

Kanał XML dotyczący europejskich nieruchomości to kanał absolutny, co oznacza, że ​​powinien zawierać wszystkie Twoje aktywne właściwości za każdym razem, gdy zostanie wygenerowany. Właściwości nieuwzględnione w kanale zostaną automatycznie usunięte z naszej platformy.

Jak przetwarzane są nieruchomości

3. Wytyczne i konwencje

Wymagania techniczne

• Wszystkie znaczniki XML MUSI być mała litera
• Kanał MUSI być zakodowany w UTF-8
• Podziały wierszy w opisach muszą używać rzeczywistych znaków nowego wiersza (\n)
• Do NIE posługiwać się CDATA działy
• Adresy URL muszą być bezwzględne (zawierać pełne https:// prefiks)
• Każde konto wymaga unikalnego adresu URL kanału

Standardy formatu danych

4. Struktura kanału

Każdy kanał ma tę podstawową strukturę, z elementem głównym zawierającym identyfikację kanału, informacje o agencie i jeden lub więcej węzłów właściwości.

<?xml version="1.0" encoding="UTF-8"?>
<root>

    <european_realestate>
        <feed_version>1</feed_version>
    </european_realestate>

    <agent>
        <id>YOUR_AGENT_ID</id>
        <name>Agency Name</name>
        <email>contact@agency.com</email>
        <!-- Additional agent fields... -->
    </agent>

    <property>
        <!-- Property 1 fields... -->
    </property>

    <property>
        <!-- Property 2 fields... -->
    </property>

    <!-- Additional properties... -->

</root>

Pola węzła agenta

5. Odniesienie do węzłów właściwości

Pola rdzeniowe

<id>987654</id>

<date>2026-01-08 12:00:00</date>

<ref>ABC-123</ref>

Ceny

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Lokalizacja

<country_code>ES</country_code>

<town>Marbella</town>

<region>Málaga</region>

<postcode>29600</postcode>

<location_detail>Costa del Sol</location_detail>

<location>
    <latitude>36.5108</latitude>
    <longitude>-4.8855</longitude>
</location>

Szczegóły nieruchomości

<type>apartment</type>

<condition>good_condition</condition>

<bedrooms>3</bedrooms>
<bathrooms>2</bathrooms>
<rooms>6</rooms>
<garage>1</garage>

<year_built>2020</year_built>

<surface_area>
    <built>150</built>
    <plot>500</plot>
</surface_area>

<energy_rating>
    <consumption>B</consumption>
    <emissions>C</emissions>
</energy_rating>

Treść

<title>Stunning 3-Bedroom Apartment with Sea Views</title>

<desc>Beautiful modern apartment located in the heart of Marbella...</desc>

<url>https://example.com/property/123456</url>

<notes>Key available at office. Call before viewing.</notes>

Media

<images>
    <image id="1">
        <url>https://example.com/images/main.jpg</url>
        <title>Living Room</title>
    </image>
    <image id="2">
        <url>https://example.com/images/bedroom.jpg</url>
        <title>Master Bedroom</title>
    </image>
</images>

<virtual_tour>https://my.matterport.com/show/?m=XXXXX</virtual_tour>

<video>
    <url>https://youtube.com/watch?v=XXXXX</url>
    <type>youtube</type>
</video>

<features>
    <feature>swimming_pool</feature>
    <feature>air_conditioning</feature>
    <feature>sea_views</feature>
</features>

6. Typy nieruchomości

Użyj tych wartości dla <type> pole:

Apartamenty

Nieruchomość komercyjna

Domy wiejskie

Ziemia i ruiny

Inne

Domy miejskie

Villas

7. Lista funkcji

Uwzględnij tylko te cechy, które dotyczą Twojej nieruchomości:

8. Obsługiwane kraje

Użyj kodów ISO 3166-1 alfa-2 dla <country_code> pole:

9. Kodowanie znaków

Twój kanał MUSI być zakodowany w UTF-8. Znaki specjalne w treści tekstowej muszą być odpowiednio zabezpieczone:

10. Testowanie kanału

Krok 1: Sprawdź poprawność struktury XML

Przed przesłaniem kanału należy go zweryfikować przy użyciu walidatora XML:

• Usługa walidacji znaczników W3C
• XMLValidation.com
• Większość nowoczesnych przeglądarek (otwiera plik XML bezpośrednio)

Krok 2: Sprawdź kodowanie znaków

Sprawdź, czy Twój kanał jest poprawnie zakodowany w formacie UTF-8:

• Sprawdzanie internacjonalizacji W3C

Krok 3: Sprawdź wymagane pola

Upewnij się, że wszystkie wymagane pola są obecne dla każdej nieruchomości:

• <id> — Unikalny identyfikator nieruchomości
• <date> — Data ostatniej modyfikacji
• <price> — Cena nieruchomości
• <status> — Status sprzedaży/wynajmu
• <type> — Typ nieruchomości
• <country_code> — kod kraju ISO
• <town> — Nazwa miasta/miejscowości
• <desc> — Opis nieruchomości

11. Automatyzacja aktualizacji

Po zatwierdzeniu Twojego kanału, nasz system będzie automatycznie synchronizować Twoje nieruchomości każdego dnia.

Harmonogram synchronizacji

• Kanały są przetwarzane automatycznie co 24 godzin
• Przetwarzanie zazwyczaj odbywa się pomiędzy 01:00 - 05:00 czasu środkowoeuropejskiego
• Przetwarzanie dużych plików może zająć więcej czasu

Najlepsze praktyki

• Zawsze uwzględniaj WSZYSTKIE aktywne nieruchomości w Twoim kanale
• Zaktualizuj <date> pole, gdy zmieniają się dane dotyczące nieruchomości
• Upewnij się, że adres URL Twojego kanału jest spójny i dostępny
• Monitoruj wszelkie błędy walidacji na swoim pulpicie

12. Uzyskiwanie pomocy

Jeśli masz pytania lub napotkasz problemy z kanałem XML:

• E-mail: info@european.realestate
• Formularz kontaktowy: european.realestate/kontakt

Kontaktując się z pomocą techniczną, prosimy o podanie:

• Twój identyfikator agenta
• Adres URL Twojego kanału
• Opis problemu
• Wszelkie otrzymane komunikaty o błędach