XML feed για εισαγωγή αγγελιών

Επισκόπηση

Ξεκινήστε

1. Αντιγράψτε το ελάχιστο παράδειγμα παρακάτω ή κατεβάστε ένα πληρέστερο δείγμα XML.
2. Ορίστε το agency_uid στο source id που έδωσε το Realistimo στο πρακτορείο σας και τις τιμές broker_id σε agent source ids ήδη συνδεδεμένα στο Realistimo.
3. Προσθέστε αγγελίες με σταθερό offer_uid, category/subcategory, τοποθεσία (internal_id), images, price, description, currency=eur.
4. Φιλοξενήστε το feed σε δημόσιο HTTPS URL και στείλτε το στο [email protected].
5. Για χειροκίνητο sync: REST tutorial.

Αρχεία geo lookup: CSV · PostgreSQL dump

Πώς λειτουργεί ο συγχρονισμός

• Επίπεδο feed: το <updated> είναι η έκδοση του feed. Αν είναι αμετάβλητο από τον τελευταίο επιτυχή sync, ο import παραλείπεται.
• Παρωχημένο feed: αν το <updated> αναλύεται ως ημερομηνία παλαιότερη από 30 ημέρες, η επεξεργασία σταματά.
• Επίπεδο αγγελίας: για δημοσιευμένη αγγελία, αν υπάρχει <last_update> και δεν είναι νεότερο από την τελευταία εισαγμένη αλλαγή, τα περισσότερα πεδία παραλείπονται (τιμή, ανάθεση agent και περιγραφή ενημερώνονται ακόμη). Κενό/απόν <last_update> δεν ενεργοποιεί αυτό το skip.
• Απόντες αγγελίες: αγγελίες που λείπουν από το feed αφαιρούνται/αρχειοθετούνται σε κανονική εκτέλεση import.
• Τα απουσιάζοντα προαιρετικά XML tags αντιμετωπίζονται ως κενά — δεν χρειάζεστε κάθε προαιρετικό tag.

Πώς να προετοιμάσετε ένα feed

1. Root <feed>, brokers σε <Brokers>, αγγελίες σε <offers>.
2. Τοποθεσία: internal_id της πόλης, του χωριού ή της συνοικίας από τα geo αρχεία. Χωρίς αυτό, η τοποθεσία αναζητείται στην περιγραφή· αν δεν βρεθεί, η αγγελία παραμένει αδημοσίευτη.
3. Νόμισμα: στείλτε eur.
4. Σε κάθε πραγματική αλλαγή, ενημερώστε το feed <updated> και το <last_update> στις επηρεαζόμενες αγγελίες.
5. Το URL πρέπει να είναι προσβάσιμο από server-side clients (χωρίς διαδραστικό Cloudflare challenge).

Ελάχιστο παράδειγμα

Αντιγράψτε αυτό το skeleton, αντικαταστήστε τα placeholders και ορίστε τρέχοντα timestamps (YYYY-MM-DD HH:MM:SS, όχι παλαιότερα από 30 ημέρες).

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

Κατεβάστε πληρέστερο δείγμα XML (αναφορά σχήματος — αντικαταστήστε ακόμη ids, timestamps και περιεχόμενο με τα δικά σας).

Agency

Brokers

Το <Brokers>/<Broker> παρέχει στοιχεία επικοινωνίας broker για το feed. Το broker_id της αγγελίας πρέπει να ταιριάζει με agent source id ήδη συνδεδεμένο στο πρακτορείο σας στο Realistimo (ρυθμίζεται κατά την ενσωμάτωση). Οι τιμές XML BrokerID πρέπει να χρησιμοποιούν τα ίδια ids. Μια αγγελία της οποίας το broker_id δεν αντιστοιχεί σε συνδεδεμένο agent δεν εισάγεται, εκτός αν έχει οριστεί εφεδρικός agent για το πρακτορείο.

Offers (υποστηριζόμενα πεδία)

Τιμές

subcategory (υποστηριζόμενες τιμές)

• СТАЯ, АПАРТАМЕНТ, ЕДНОСТАЕН, БОКСИОНЕРА, СТУДИО, 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, ГАРСОНИЕРА, ГАРСОНИЕРА ЛУКС
• АТЕЛИЕ · АТЕЛИЕ, ТАВАН · ТАВАН · ЕТАЖ ОТ КЪЩА · КЪЩА · ВИЛА
• ОФИС, МАГАЗИН, ТЪРГОВСКИ ОБЕКТ, ЗАВЕДЕНИЕ, СПОРТ, САЛОН ЗА КРАСОТА, СКЛАД, ГАРАЖ, ПАРКОМЯСТО, ПРОМ. ПОМЕЩЕНИЕ, ХОТЕЛ
• БИЗНЕС ИМОТ, ДРУГО — επιχειρηματικό ακίνητο
• ПАРЦЕЛ, ЗЕМЕДЕЛСКА ЗЕМЯ — δείτε οικόπεδο και γη
• СГРАДИ, СГРАДА — ολόκληρο κτίριο με τιμή (όχι parent για construction_id)
• НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО — parent construction
• ЗАТВОРЕН КОМПЛЕКС — parent complex

Στείλτε τις τιμές ακριβώς όπως αναφέρονται, με κεφαλαία γράμματα (κυριλλικά). Άγνωστες τιμές προκαλούν αποτυχία του import της αγγελίας.

building_condition

• Completed (ή bds-completed) — Με πράξη 16
• SemiCompleted (ή semi_completed) — Με πράξη 15
• NotCompleted (ή not_completed) — Με πράξη 14
• UnderConstruction — Υπό κατασκευή/με άδεια κατασκευής
• PreConstruction (ή pre_construction) — Στο πράσινο (προμελέτη)

Τα κεφαλαία και πεζά γράμματα έχουν σημασία.

construction_type

• епк — ΕΠΚ (συρόμενος κοφράζ)
• панел — Πάνελ
• тухла — Τούβλο (σε πλάκα)
• гредоред — Τούβλο (σε δοκάρι)

Μόνο με πεζά γράμματα: το Тухла δεν αναγνωρίζεται.

Προεπιλεγμένες τιμές

Όταν ένα tag λείπει ή είναι κενό, ο import καταγράφει:

Θέρμανση, δωμάτια, υπνοδωμάτια, μπάνια, στάδιο και τύπος κατασκευής δεν συμπληρώνονται για οικόπεδο, αγροτεμάχιο, γκαράζ, θέση στάθμευσης και νέο κτίριο.

Αγνοούμενα tags

Κτίριο / συγκρότημα → διαμερίσματα

1. Parent: το subcategory είναι ένα από НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО, ЗАТВОРЕН КОМПЛЕКС.
2. Child: <construction_id>PARENT_OFFER_UID</construction_id>.
3. Η σειρά στο XML δεν έχει σημασία. Κενό tag καθαρίζει τον σύνδεσμο. Self-ref / μη έγκυρο parent αγνοείται.

Οικόπεδο και γη

Για οικόπεδο δεν υπάρχουν ξεχωριστά tags — υποβάλλεται ως συνηθισμένη αγγελία:

1. <subcategory>ПАРЦЕЛ</subcategory> για οικόπεδο προς δόμηση ή ЗЕМЕДЕЛСКА ЗЕМЯ για αγροτεμάχιο. Δάσος, αμπέλι, βοσκότοπος και οπωρώνας δεν μπορούν προς το παρόν να υποβληθούν.
2. Το <surface> είναι το εμβαδόν του ακινήτου σε m². Τιμή μεταξύ 0 και 1 διαβάζεται ως στρέμματα: 0.8 = 800 m² (με τελεία, όχι κόμμα). Αν λείπει το surface, χρησιμοποιείται το surface_parcel και μετά το εμβαδόν από την περιγραφή.
3. Αρκεί το <internal_id> της πόλης ή του χωριού — η συνοικία δεν είναι υποχρεωτική.
4. Δωμάτια, όροφος, τύπος κατασκευής και επίπλωση δεν χρειάζονται.
5. Ασφαλτόδρομος: <exterior_ids>10</exterior_ids>. Για ρεύμα και νερό δεν υπάρχουν tags — γράψτε στην (βουλγαρική) περιγραφή ακριβώς «ток и вода на граница» (ή μόνο «ток на граница» / «вода на граница»). Άλλες διατυπώσεις μπορεί να μην αναγνωριστούν.
6. Ο προορισμός αναγνωρίζεται επίσης από την (βουλγαρική) περιγραφή. Αν δεν αναφέρεται εκεί, για ПАРЦЕЛ καταγράφονται «Οικιστική κατασκευή» και «Βιομηχανική κατασκευή», ενώ για ЗЕМЕДЕЛСКА ЗЕМЯ το πεδίο μένει κενό.
7. Τα land_category και parcel_in_regulation αγνοούνται.

<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 και υποστήριξη

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