XML importa specifikācija

1. Darba sākšana

Laipni lūdzam Eiropas nekustamā īpašuma XML importa specifikācijā. Šajā dokumentā ir sniegta visa tehniskā informācija, kas nepieciešama, lai izveidotu īpašumu plūsmu, kas integrējas ar mūsu platformu.

2. Pārskats

Eiropas nekustamā īpašuma XML plūsma ir absolūtā padeve, kas nozīmē, ka katrā ģenerēšanas rekvizītā jāiekļauj visi jūsu aktīvie īpašumi. Īpašumi, kas netiks iekļauti plūsmā, tiks automātiski noņemti no mūsu platformas.

Kā tiek apstrādātas īpašības

3. Vadlīnijas un konvencijas

Tehniskās prasības

• Visi XML tagi OBLIGĀTI jāraksta ar mazajiem burtiem
• Barība OBLIGĀTI jābūt UTF-8 kodējumam
• Aprakstos rindiņu pārtraukumiem jāizmanto faktiskās jaunās rindiņas rakstzīmes (\n)
• Do NAV izmantot CDATA sekcijas
• URL ir jābūt absolūtiem (iekļaut pilnus https:// prefikss)
• Katram kontam ir nepieciešams unikāls plūsmas URL

Datu formāta standarti

4. Barības struktūra

Katra plūsma ievēro šo pamatstruktūru ar saknes elementu, kas satur plūsmas identifikāciju, aģenta informāciju un vienu vai vairākus rekvizītu mezglus.

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

Aģenta mezgla lauki

5. Rekvizītu mezglu atsauce

Galvenie lauki

<id>987654</id>

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

<ref>ABC-123</ref>

Cena

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Adrese

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

Īpašuma informācija

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

saturs

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

Mediji

<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. Īpašumu veidi

Izmantojiet šīs vērtības priekš <type> lauks:

Dzīvokļi

Komerciālais īpašums

Lauku mājas

Zeme un drupas

Citi

Pilsētas mājas

Villas

7. Funkciju saraksts

Iekļaujiet tikai tās funkcijas, kas attiecas uz jūsu īpašumu:

8. Atbalstītās valstis

Izmantojiet ISO 3166-1 divburtu kodus <country_code> lauks:

9. Rakstzīmju kodēšana

Jūsu plūsma OBLIGĀTI jābūt UTF-8 kodējumamTeksta saturā esošajām īpašajām rakstzīmēm ir jābūt pareizi atsoļotām:

10. Jūsu plūsmas pārbaude

1. darbība: XML struktūras validēšana

Pirms plūsmas iesniegšanas validējiet to, izmantojot XML validatoru:

• W3C iezīmēšanas pārbaudes pakalpojumi
• XMLValidation.com
• Lielākā daļa moderno pārlūkprogrammu (atveriet XML failu tieši)

2. darbība. Pārbaudiet rakstzīmju kodējumu

Pārliecinieties, vai jūsu plūsma ir pareizi kodēta ar UTF-8:

• W3C internacionalizācijas pārbaudītājs

3. darbība. Pārbaudiet obligātos laukus

Pārliecinieties, vai katram īpašumam ir aizpildīti visi obligātie lauki:

• <id> — Unikāls īpašuma ID
• <date> — Pēdējās modifikācijas datums
• <price> — Īpašuma cena
• <status> — Pārdošanas/īres statuss
• <type> — Īpašuma veids
• <country_code> — ISO valsts kods
• <town> — Pilsētas/ciema nosaukums
• <desc> — Īpašuma apraksts

11. Atjauninājumu automatizācija

Kad jūsu plūsma ir apstiprināta, mūsu sistēma automātiski sinhronizē jūsu īpašumus katru dienu.

Sinhronizācijas grafiks

• Barības tiek apstrādātas automātiski ik pēc 24 stundas
• Apstrāde parasti notiek starp 01:00 - 05:00 CET
• Lielu plūsmu apstrāde var aizņemt ilgāku laiku.

Labākā pieredze

• Vienmēr iekļaujiet VISAS aktīvās īpašības jūsu plūsmā
• Atjauniniet <date> lauks, kad mainās īpašuma dati
• Nodrošiniet, lai jūsu plūsmas URL būtu konsekvents un pieejams
• Uzraugiet validācijas kļūdas savā informācijas panelī

12. Palīdzības saņemšana

Ja jums ir jautājumi vai rodas problēmas ar XML plūsmu:

• E-pasts: info@european.realestate
• Saziņas veidlapa: eiropas.nekustamais.es/kontakts

Sazinoties ar atbalsta dienestu, lūdzu, iekļaujiet:

• Jūsu aģenta ID
• Jūsu plūsmas URL
• Problēmas apraksts
• Jebkādi saņemtie kļūdu ziņojumi