Feed XML pentru importul anunțurilor

Prezentare generală

Începeți

1. Copiați exemplul minimal de mai jos sau descărcați un eșantion XML mai complet.
2. 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.
3. Adăugați oferte cu un offer_uid stabil, category/subcategory, locație (internal_id), images, price, description, currency=eur.
4. Găzduiți feed-ul pe un URL HTTPS public și trimiteți-l la [email protected].
5. Pentru sync manual: Tutorial REST.

Fișiere geo lookup: CSV · PostgreSQL dump

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.

Cum să pregătiți un feed

1. Root <feed>, brokers în <Brokers>, oferte în <offers>.
2. Locație: internal_id al orașului, satului sau cartierului din fișierele geo. Fără el, locația este căutată în descriere; dacă nu este găsită, oferta rămâne nepublicată.
3. Monedă: trimiteți eur.
4. La fiecare modificare reală, actualizați <updated> al feed-ului și <last_update> pe ofertele afectate.
5. URL-ul trebuie să fie accesibil clienților server-side (fără challenge Cloudflare interactiv).

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

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. O ofertă al cărei broker_id nu coincide cu un agent legat nu este importată, cu excepția cazului în care agenția are configurat un agent de rezervă.

Offers (câmpuri suportate)

Valori

subcategory (valori suportate)

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

Trimiteți valorile exact ca în listă, cu majuscule. O valoare necunoscută oprește importul ofertei.

building_condition

• Completed (sau bds-completed) — Cu act 16
• SemiCompleted (sau semi_completed) — Cu act 15
• NotCompleted (sau not_completed) — Cu act 14
• UnderConstruction — În construcție/cu permis de construcție
• PreConstruction (sau pre_construction) — Pe verde (proiect conceptual)

Majusculele și minusculele contează.

construction_type

• епк — Cofraj retractabil
• панел — Panou
• тухла — Cărămidă (pe placă)
• гредоред — Cărămidă (pe grinda)

Doar litere mici: Тухла nu este recunoscut.

Valori implicite

Când un tag lipsește sau este gol, importul înregistrează:

Încălzirea, camerele, dormitoarele, băile, stadiul și tipul de construcție nu se completează pentru parcelă, teren agricol, garaj, loc de parcare și clădire nouă.

Tag-uri ignorate

Clădire / complex → apartamente

1. Parent: subcategory este unul dintre НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО, ЗАТВОРЕН КОМПЛЕКС.
2. Child: <construction_id>PARENT_OFFER_UID</construction_id>.
3. Ordinea în XML nu contează. Tag-ul gol șterge legătura. Self-ref / parent invalid este ignorat.

Teren și parcelă

Pentru o parcelă nu există tag-uri separate — se trimite ca o ofertă obișnuită:

1. <subcategory>ПАРЦЕЛ</subcategory> pentru un teren de construcție sau ЗЕМЕДЕЛСКА ЗЕМЯ pentru teren agricol. Pădure, vie, pășune și livadă nu pot fi trimise deocamdată.
2. <surface> este suprafața proprietății în m². O valoare între 0 și 1 este citită ca decare: 0.8 = 800 m² (cu punct, nu cu virgulă). Dacă surface lipsește, se folosește surface_parcel, apoi suprafața din descriere.
3. <internal_id> al orașului sau satului este suficient — cartierul nu este obligatoriu.
4. Camerele, etajul, tipul de construcție și mobilarea nu sunt necesare.
5. Drum asfaltat: <exterior_ids>10</exterior_ids>. Pentru curent și apă nu există tag-uri — scrieți în descriere (în bulgară) exact „ток и вода на граница” (sau doar „ток на граница” / „вода на граница”). Alte formulări pot să nu fie recunoscute.
6. Destinația este de asemenea citită din descriere. Dacă nu este menționată acolo, pentru ПАРЦЕЛ se înregistrează atât „Construcţie rezidențială” cât și „Construcţie industrială”, iar pentru ЗЕМЕДЕЛСКА ЗЕМЯ câmpul rămâne gol.
7. land_category și parcel_in_regulation sunt ignorate.

<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 și suport

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