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

Πώς να προετοιμάσετε ένα XML feed για εισαγωγή αγγελιών στο Realistimo. Για on-demand sync δείτε το REST API.

Overview

Επισκόπηση

XML (αυτή η σελίδα)

Τι να δημοσιεύσετε στο feed και πώς ο import διαβάζει τα πεδία.

REST

API key, POST /start, POST /latest-log, όρια και προαιρετικό callback.

Tutorial

Ξεκινήστε

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

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

Explanation

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

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

Το «Υποχρεωτικό» παρακάτω σημαίνει: χωρίς τιμή, ο import/δημοσίευση συνήθως αποτυγχάνει ή η αγγελία μένει αδημοσίευτη. Πολλά attributes έχουν προεπιλεγμένες τιμές.

How-to

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

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

Reference

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

Αντιγράψτε αυτό το 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

Tag	Περιγραφή	Σημειώσεις
`<updated>`	Έκδοση / ημερομηνία feed	Υποχρεωτικό Πρέπει να αλλάζει όταν αλλάζει το περιεχόμενο· μέγ. 30 ημερών παλαιό
`<agency_uid>`	Source id πρακτορείου	Υποχρεωτικό Πρέπει να ταιριάζει με το id που έχει ρυθμιστεί για το πρακτορείο σας
`<agency_name>`, `<agency_phone>`, `<agency_email>`	Metadata	Προαιρετικό Δεν χρησιμοποιείται από τον import· ασφαλές για συμβατότητα
`<result_url>`	Callback μετά τον import	Προαιρετικό Το Realistimo κάνει POST σώμα JSON σε μορφή latest-log· δείτε REST

Brokers

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

Tag	Σημειώσεις
`<BrokerID>`	Υποχρεωτικό Agent source id (προτιμήστε ≠ `agency_uid`)
`<BrokerName>`	Υποχρεωτικό Όνομα (+ επώνυμο)
`<BrokerPhone>`, `<BrokerEmail>`, `<BrokerPhoto>`	Προαιρετικό

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

Tag	Περιγραφή	Σημειώσεις
`<last_update>`	Χρόνος αλλαγής αγγελίας	Προτεινόμενο Ημερομηνία/ώρα ή unix timestamp. Όταν υπάρχει και δεν είναι νεότερο από την τελευταία εισαγμένη αλλαγή, τα περισσότερα πεδία παραλείπονται σε δημοσιευμένες αγγελίες
`<offer_uid>`	Σταθερό id	Υποχρεωτικό Μην το αλλάζετε στις επεξεργασίες
`<offer_code>`	Κωδικός αναφοράς	Προαιρετικό
`<title>`	Τμήμα τίτλου	Προαιρετικό Ξεχωριστά από την περιγραφή
`<description>`	Περιγραφή	Προτεινόμενο Ισχυρά επιθυμητό για δημοσίευση
`<images>`	URLs	Υποχρεωτικό Διαχωριστικό `;`
`<price>`	Τιμή	Υποχρεωτικό Ακέραιο μέρος· μηδενίζεται για parent κτίριο/συγκρότημα
`<surface>`	Εμβαδόν m²	Υποχρεωτικό Απαιτείται για τους περισσότερους τύπους (εκτός γκαράζ)
`<surface_parcel>`	Αυλή/οικόπεδο	Προαιρετικό
`<currency>`	Νόμισμα	Προτεινόμενο eur Αποδεκτά: `eur`/`EUR`/`BGN`/`лв` — κανονικοποιούνται σε EUR. Απουσία νομίσματος θεωρείται BGN και μετατρέπεται σε EUR. Προτιμήστε `eur`
`<category>`	`продажби` / `наеми`	Υποχρεωτικό
`<subcategory>`	Τύπος ακινήτου	Υποχρεωτικό Πρέπει να είναι ακριβής υποστηριζόμενη τιμή (δείτε παρακάτω)
`<internal_id>`	Geo internal id	Προτεινόμενο Προτιμώμενη μέθοδος τοποθεσίας
`<subregion_id>`	Mapped location id	Προαιρετικό Χρησιμοποιείται όταν λείπει/δεν είναι αριθμητικό το `internal_id`
`<construction_type>`	епк / панел / тухла / гредоред / метална конструкция	Προαιρετικό
`<floor>`, `<floorAll>`	Όροφος / όροφοι	Προαιρετικό Η τιμή `floor` `0` αγνοείται
`<building_condition>`	Completed / …	Προαιρετικό
`<build_year>`	YYYY-MM-DD	Προαιρετικό
`<furnished>`	0/14/23/65	Προαιρετικό 0 και 23 = χωρίς έπιπλα
`<heating_ids>`	IDs μέσω `,`	Προαιρετικό 4/6/18 pellets, 35 AC, 44 ηλεκτρικό, 46 τηλεθέρμανση, 80 αέριο
`<parking_ids>`	52, 93	Προαιρετικό 52 γκαράζ, 93 θέση στάθμευσης
`<rooms_count>`, `<bedroom_count>`, `<bath_count>`	Αριθμοί	Προαιρετικό
`<exterior_ids>`	42=ασανσέρ, 10=άσφαλτος	Προαιρετικό Εφαρμόζονται μόνο αυτά τα ids
`<broker_id>`	Agent source id	Υποχρεωτικό Πρέπει να ταιριάζει με agent συνδεδεμένο στο Realistimo
`<construction_id>`	Parent offer_uid	Προαιρετικό Δείτε how-to κτιρίου/συγκροτήματος
`<youtube_link>` / `<youTube_link>`	YouTube	Προαιρετικό
`<virtual_panorama_link>`	Tour	Προαιρετικό
`<Exclusive>`	0/1	Προαιρετικό

Τιμές

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

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

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

building_condition

Completed, UnderConstruction, PreConstruction, SemiCompleted, NotCompleted.

construction_type

епк, панел, тухла, гредоред, метална конструкция.

Αγνοούμενα tags

Αυτά τα tags δεν εφαρμόζονται κατά τον import. Μπορεί να εμφανίζονται στο feed αλλά δεν έχουν αποτέλεσμα στην αγγελία: balcony_count, land_category, parcel_in_regulation, new_construction.