NAV Navbar
  • Εισαγωγή
  • Γενικές πληροφορίες
  • Authentication
  • Προδιαγραφές
  • Fields
  • Παραρτήματα
  • Μηνύματα Σφάλματος
  • Εισαγωγή

    Στο εγχειρίδιο θα βρείτε όλες τις πληροφορίες που χρειάζεστε για να αξιοποιήσετε με επιτυχία τις υπηρεσίες της Χρυσής Ευκαιρίας όσον αφορά στη φόρτωση, αποθήκευση και πολυκαναλική δημοσίευση των αγγελιών των Παρόχων.

    Αν το προτιμάτε, μπορείτε να βρείτε τις πληροφορίες αυτές συγκεντρωμένες και σε ένα SDK.

    Γενικές πληροφορίες

    Περιγραφή

    To Bulk Import Tool είναι μια υπηρεσία μαζικής αποστολής - καταχώρησης αγγελιών και των τυχόν ψηφιακών αρχείων που συνδέονται μαζί τους, και δημοσίευσής τους στην πολυκαναλική υποδομή της Χρυσής Ευκαιρίας.

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

    Η υπηρεσία:

    Σύνοψη διαδικασίας

    Ο Παροχέας μπορεί να χρησιμοποιήσει τη διαδικασία ακολουθώντας τα εξής βήματα:

    1. Μορφοποιεί τις αγγελίες χρησιμοποιώντας την προδιαγραφή Unified Ad format ορίζοντας ταυτόχρονα τα ψηφιακά αρχεία τα οποία τις συνοδεύουν.
    2. Δημιουργεί αρχεία σε zipped μορφή που περιέχουν τις αγγελίες και τα συνοδευόμενα ψηφιακά αρχεία.
    3. Αποστέλλει στους ειδικά διαμορφωμένους Διακομιστές τής Χρυσής Ευκαιρίας μέσω HTTP POST request, χρησιμοποιώντας τα διαπιστευτήρια που έλαβε κατά την εγγραφή του στην υπηρεσία.
    4. Η υπηρεσία τούς απαντάει με τα αποτελέσματα της διαδικασίας και τα πιθανά λάθη.

    Υποδοχή πακέτων

    Παράδειγμα αποστολής:

    <html>
      <form action="http://import.xe.gr/request/add" 
          enctype="multipart/form-data" method="POST">
        <div>
          <strong>Φόρμα δοκιμαστική χρήσης υπηρεσίας μαζικής καταχώρησης</strong>
        </div>
    
        <table>
          <tr>
            <td>Username (Xρήστη υπηρεσίας μαζικής καταχώρησης)</td>
            <td><input type="text" name="username" size="30"></td>
          </tr>
          <tr>
            <td>Password (Xρήστη υπηρεσίας μαζικής καταχώρησης)</td>
            <td><input type="text" name="password" size="30"></td>
          </tr>
          <tr>
            <td>Αρχείο Αγγελιών</td>
            <td><input type="file" name="file" size="40"></td>
          </tr>
          <tr>
            <td colspan="2" align="center">
              <input type="submit" value="Αποστολή αρχείου">
            </td>
          </tr>
        </table>
      </form>
    </html>
    

    Η υποδοχή αρχείων μαζικής φόρτωσης αγγελιών εξυπηρετείται από 2 διαφορετικά endpoints προσβάσιμα μέσω HTTP (POST request). Συγκεκριμένα:

    Και στις δύο περιπτώσεις η παράμετροι του POST request είναι τρεις:

    Παράμετρος Description
    file το αρχείο που περιλαμβάνει το xml request καθώς και τις εικόνες
    username το username χρήσης της υπηρεσίας
    password το password χρήσης της υπηρεσίας

    Κατά τη διαδικασία παραλαβής του αρχείου γίνεται xsd validation καθώς και έλεγχοι που αφορούν το package id κ.ά.. Η απάντηση του request ενημερώνει αν η παραλαβή ολοκληρώθηκε με επιτυχία και το πακέτο είναι έτοιμο για επεξεργασία ή αν παρουσιάστηκε κάποιο σφάλμα. Η επεξεργασία του πακέτου γίνεται ασύγχρονα. Όταν ολοκληρωθεί η επεξεργασία του πακέτου αποστέλεται ενημερωτικό email που περιγράφει αναλυτικά τα αποτελέσματα επεξεργασίας.

    Επεξεργασία πακέτων

    Η διαδικασία εξυπηρέτησης των αιτημάτων εκτελείται σε 2 χρόνους και αποτελείται από τα παρακάτω βήματα:

    1ος χρόνος

    2ος χρόνος

    Εμφάνιση αλλαγών στο site του xe.gr

    Οι αγγελίες τις οποίες διαχειρίζεται ο μηχανισμός μαζικής καταχώρησης είναι άμεσα προσβάσιμες, μετά την ολοκλήρωση της επιτυχούς επεξεργασίας, από τη διαχειριστική πλατφόρμα (Pro) που διατίθεται στους επαγγελματίες. Ωστόσο, οι αλλαγές αυτές θα εμφανιστούν στο site του xe.gr μετά από κάποιο χρονικό διάστημα λόγω διαδικασιών συγχρονισμού που επιφέρουν μια μικρή καθυστέρηση.

    Πολιτικές δημοσίευσης

    Οι πολιτικές δημοσίευσης ορίζουν τον τρόπο και τους κανόνες με βάση τους οποίους γίνεται η ενημέρωση των αγγελιών τού Παροχέα στους Διακομιστές της Χρυσής Ευκαιρίας.

    Πολιτική “RENEW ALL STOCK”

    Για όλες τις αγγελίες του Παροχέα που φορτώνονται:

    Πολιτική "INCREMENTAL"

    Η πολιτική αυτή:

    Η πολιτική δηλώνεται στο xml element Package.policy και μπορεί να πάρει τις τιμές:

    Η σχέση μετξύ τύπου πακέτου και πολιτικών δημοσίευσης εμφανίζεται στον κάτωθι πίνακα

    Πολιτική Δημοσίευσης Mήνυμα
    RENEW ALL STOCK AddItemsRequest
    INCREMENTAL AddItemsRequest
    INCREMENTAL RemoveItemsRequest

    Authentication

    Testing

    Για να μπορείτε να στέλνετε δοκιμαστικά αγγελίες για πλαίσια τής ανάπτυξης τής γέφυρας, χρειάζεστε ένα λογαριασμό μεσίτη.

    Ακολουθούν τα στοιχεία ενός τέτοιου αλλά δοκιμαστικού λογαριασμού. Οι αγγελίες που στέλνετε με αυτό το λογαριασμό θα επεξεργάζονται κανονικά αλλά δεν θα δημοσιεύονται.

    Τα στοιχεία τού λογαριασμού για να στέλνετε δοκιμαστικά τις αγγελίες:

    Στοιχείο Τιμή
    Όνομα TEST ACCOUNT
    Όνομα σύνδεσης batchImportTest@gmail.com
    Κωδικός 999999
    AuthToken 1C12807239C511E083E1A3E108D089EC
    Agent ID 10004616

    Πιστοποιημένοι αριθμοί τηλεφώνων:

    Στα πακέτα που θα στέλνετε, στον κωδικό τού κάθε πακέτου, τοποθετείτε το πρόθεμα <Πρόθεμα που θα σας δώσουμε>-BIT-SANDBOX-. Μετά την επεξεργασία των πακέτων, θα λαμβάνετε ένα email με τα αποτελέσματα, πόσες αγγελίες επεξεργάστηκαν, πόσες επιτυχώς, πόσες ανεπιτυχώς και γιατί.

    Production

    Επικοινωνείστε μαζί μας για να προχωρήσουμε στη δημιουργία του λογαριασμού.

    Προδιαγραφές

    Unified Ad Format

    Το Unified Ad Format είναι η πρόταση της Χρυσής Ευκαιρίας για την προτυποποίηση του ορισμού μιας αγγελίας. Περιέχει επίσης πληροφορίες (metadata) απαραίτητες για τη διαχείριση των ψηφιακών αρχείων που τις συνοδεύει, των δημοσιεύσεων ή των προϊόντων που χρησιμοποιούν για τη δημοσιευσή τους, τα μέσα στα οποία θα δημοσιευτούν καθώς και την πολιτική ενημέρωσης που θα ακολουθήσει το σύστημα.

    Το Unified Ad Format είναι ένα έγγραφο XML και μπορεί να περιέχει πάνω από μια αγγελίες.

    PackageId

    Κάθε τέτοιο έγγραφο αποτελεί ένα πακέτο (Package) και σημαίνεται με το μοναδικό PackageId που είναι ευθύνη του παρόχου. Με το μοναδικό PackageId – άλλο κάθε φορά – ο Παροχέας αλλά και το σύστημα μπορεί να παρακολουθήσει με ευκολία την πορεία επεξεργασίας του πακέτου. Στην απλούστερη μορφή του θα μπορούσε να είναι ένας συνδυασμός κάποιου αναγνωριστικού του παρόχου μαζί με ένα timestamp. Η πληροφορία αυτή θα χρησιμοποιείται στην συνέχεια για τον εντοπισμό του πακέτου και για την παροχή πληροφορίας αναφορικά με το αποτέλεσμα της επεξεργασίας του πακέτου και των περιεχομένων αγγελιών (ποσοστό αγγελιών που καταχωρήθηκαν με επιτυχία, errors και warnings τα οποία παράχθηκαν).

    Βασικά τμήματα πακέτου

    Το έγγραφο αποτελείται από δυο βασικά τμήματα:

    1. Μεταδεδομένα που αφορούν το πακέτο στο σύνολό του, τον Παροχέα και το κατάστημα όπου θα δημοσιευτούν οι αγγελίες (σήμερα μόνο το xe.gr) κ.ά..
    2. Πληροφορία που αφορά τις αγγελίες και μπορεί να υπάρχει πάνω από μια φορές, μία για κάθε αγγελία, τα Item.

    Η πληροφορία που παρέχεται σε αυτό το επίπεδο αφορά:

    XML structure

    Η δομή του XML ορίζεται από το root Element με το όνομα AddItemsRequest (RemoveItemsRequest για διαγραφή) που ορίζει και το όνομα της υπηρεσίας. Σε κάθε περίπτωση το root element περιλαμβάνει τα μεταδεδομένα του πακέτου (Package Metadata) και τα Item elements.

    Package Metadata

    Αίτημα προσθήκης αγγελιών

    <?xml version="1.0" encoding="UTF-8"?> 
    <AddItemsRequest>
        <Package.xeAuthToken>YOURTOKENHERE</Package.xeAuthToken> 
        <Package.schemaVersion>1.0</Package.schemaVersion> 
        <Package.id>1</Package.id> 
        <Package.timestamp>2010-11-30T18:33</Package.timestamp> 
        <Package.storeId>Store 1</Package.storeId> 
        <Package.trademark>XE</Package.trademark> 
        <Package.skipAssets>true</Package.skipAssets> 
        <Item>.........</Item>
        <Item>.........</Item>
        ...................
    </AddItemsRequest>
    

    Αίτημα διαγραφής αγγελιών

    <?xml version="1.0" encoding="UTF-8"?>
    <RemoveItemsRequest>
        <Package.xeAuthToken>YOURTOKENHERE</Package.xeAuthToken> 
        <Package.schemaVersion>1.0</Package.schemaVersion> 
        <Package.id>1</Package.id> 
        <Package.timestamp>2010-11-30T18:33</Package.timestamp> 
        <Package.storeId>Store 1</Package.storeId> 
        <Package.trademark>XE</Package.trademark> 
        <Item>.........</Item>
        <Item>.........</Item>
        ...................
    </RemoveItemsRequest>
    

    Τα μεταδεδομένα του Package είναι της μορφής Package.<πεδίο> και περιγράφονται στον παρακάτω πίνακα. Είναι όλα τύπου STRING.

    Πεδίο Υποχρεωτικό Περιγραφή
    xeAuthToken ΝΑΙ Κωδικός αυθεντικοποίησης - Σε κάθε Παροχέα αποδίδεται από το σύστημα ένας κωδικός ο οποίος πρέπει να χρησιμοποιείται σε κάθε επικοινωνία με αύτη την υπηρεσία
    schemaVersion NAI Έκδοση του request που χρησιμοποιείται (παρέχεται από το σύστημα. Σήμερα 1.1)
    id NAI Κωδικός πακέτου που παρέχεται από τον πελάτη και οφείλει να είναι μοναδικός για κάθε Παροχέα και πακέτο.
    timestamp NAI Ημερομηνία εισαγωγής πακέτου σύμφωνα με το πρότυπο UTC
    storeId OXI Αναγνωριστικό καταστήματος (Σήμερα μόνο xe.gr)
    trademark OXI Λεκτικό αναγνωριστικό αποστολέα. Το αναγνωριστικό εμφανίζεται στο κείμενο της αγγελίας κατά την δημοσίευσή της στο xe.gr
    skipAssets OXI Στέλνονται πακέτα χωρίς να επηρεάζονται κατά την ενημέρωση μιας αγγελίας οι φωτογραφίες που υπάρχουν μέχρι εκείνη την ώρα. Είναι τιμή per package και όχι per αγγελία. Αν είναι true, όλα τα assets αγνοούνται. Η τιμή true ή false είναι case insensitive.

    Τα παραπάνω πεδία ορίζονται στο σώμα του request όπως φαίνεται δίπλα και η πληροφορία αυτή προσαρτάται στην πληροφορία που αφορά το κάθε Item.

    Item Metadata

    Ως μεταδεδομένα αναφέρουμε όλα τα πεδία του item τα οποία δε σχετίζονται με περιγραφικά χαρακτηριστικά και δεν ανήκουν στα elements που περιγράφονται στις επόμενες παραγράφους.

    Attributes

    <Item type="re_prof" refId="4f4c33f6-d705-43a5-9180-6cdc181bdcf4"> 
        <Item.ownerId>90</Item.ownerId>
        <Item.majorPhone>210/200002047></Item.majorPhone> 
        <Item.departmentOnCategory>Real Estate</Item.departmentOnCategory> 
        <Item.otherPhones>
            <Item.phone><![CDATA[ 6236/760183]]></Item.phone> 
        </Item.otherPhones>
        <Item.internetText></Item.bodyText>
        <Item.addOnText>
          <![CDATA[κοντά στο μετρό και σε σχολεία]]>
        </Item.internetText>
        <Item.bodyText></Item.bodyText>
        <Transaction.type>LET.NORMAL</Transaction.type>
        .......
    </Item>
    

    Κάθε Item έχει τα ακόλουθα δύο υποχρεωτικά attributes:

    Πεδίο Τύπος Περιγραφή
    type LOOKUP Τύπος αγγελίας. (Οικόπεδο, Κατοικία κ.ά.).
    refId STRING Μοναδικός κωδικός αγγελίας που παρέχεται από τον Παροχέα και χρησιμοποιείται στη συνέχεια για τον εντοπισμό της. Χρησιμοποιείται από τον Παροχέα για να συνδέσει την αγγελία του με μοναδικό τρόπο με τη δική του Βάση Δεδομένων.

    Elements

    Κάθε Item έχει τα ακόλουθα elements. Είναι της μορφής Item.<πεδίο> και είναι όλα τύπου String.

    Πεδίο Υποχρεωτικό Περιγραφή
    ownerId ΝΑΙ Κωδικός ιδιοκτήτη της αγγελίας.
    majorPhone ΝΑΙ Κύριο τηλέφωνο αγγελίας. (Πιστοποιημένο)
    departmentOnCategory ΟΧΙ Κατηγοριοποίηση (Σήμερα έχει μόνο την τιμή ‘Real Estate’)
    otherPhones ΟΧΙ Άλλα τηλέφωνα.

    Σημειώσεις

    Το Item.ownerID είναι ο μοναδικός κωδικός που έχει ήδη αποδοθεί από το σύστημα στον ιδιοκτήτη της αγγελίας (μεσίτη). Ένα πακέτο μπορεί να περιέχει αγγελίες διαφορετικών ιδιοκτητών (Franchisees), αρκεί ο αποστολέας (Franchiser) να μπορεί να χρησιμοποιήσει το ownerId του Franchisee με τον οποίο έχει συμφωνία διαχείρισης των αγγελιών του. Το σύστημα ελέγχει για τη σχέση του ownerid (Franchisee) και του Franchiser που αποστέλλει το πακέτο.

    <Item.otherPhones>
      <Item.phone>2100000000</Item.phone>`
      <Item.phone>2100000001</Item.phone>
    </Item.otherPhones>
    

    Το πεδίο Item.otherPhones περιλαμβάνει στοιχεία της μορφής Item.phone (δείτε δίπλα). Τα τηλέφωνα αυτά θα πρέπει να είναι πιστοποιημένα για να γίνουν αποδεκτά και να εμφανιστούν στην αγγελία. Η πιστοποίηση γίνεται ακολουθώντας τις συνήθεις διαδικασίες της Χρυσής Ευκαιρίας κατά τη διαδικασία registration του Παροχέα.

    Item Fields

    Αν θέλαμε να περιγράψουμε το συνολικό εμβαδόν 100 τετραγωνικών μιας κατοικίας θα έπρεπε στην λίστα πεδίων της αγγελίας να υπάρχει o εξής κώδικας

    <Field>
           <Name>Item.area</Name>
           <Value>100</Value>
    </Field>
    

    Όπου Item.area είναι το όνομα του χαρακτηριστικού και το 100 είναι η τιμή του χαρακτηριστικού.

    Ο κατάλογος των πεδίων που αφορούν το item παρέχονται με την μορφή ζευγών <όνομα πεδίου, τιμή πεδίου>.

    Τύποι χαρακτηριστικών – δυνατές τιμές

    Τα χαρακτηριστικά μπορούν να έχουν έναν από τους παρακάτω τύπους τιμών:

    OTHER value

    Τα χαρακτηριστικά που έχουν τύπο LOOKUP παρέχουν ένα σύνολο τιμών από τα οποία ο Παροχέας πρέπει να επιλέξει. Υπάρχει η περίπτωση όμως, για κάποιο LOOKUP χαρακτηριστικό, να υποστηρίζεται η δυνατότητα ο Παροχέας να δώσει τη δική του τιμή. Το σύστημα τότε θα επιλέξει κατά την επεξεργασία την τιμή OTHER. Δεν υπάρχει ιδιαίτερος τρόπος να δώσει ο Παροχέας την τιμή OTHER. Σε κάποιο LOOKUP χαρακτηριστικό που υποστηρίζει OTHER πχ Item.Style απλά δίνουμε την τιμή, πχ: <Value>Ιδιοκατασκευή</Value>

    Fields

    Εισαγωγή

    Κατάλογος χαρακτηριστικών (fields) για κάθε τύπο αγγελίας και οι εξαρτήσεις τους

    Ακουλουθεί η πλήρης λίστα χαρακτηριστικών (fields) που προσφέρονται για κάθε τύπο αγγελίας. Σε ιδιαίτερη στήλη αναφέρεται ποια από αυτά είναι υποχρεωτικά. Στο τέλος κάθε τύπου αναφέρονται οι εξαρτήσεις των χαρακτηριστικών εφόσον υπάρχουν. Για παράδειγμα – όπως φαίνεται και από τον πίνακα Εξαρτήσεις χαρακτηριστικών - το Item.buildable_area εξαρτάται από το Item.buildable. Για να έχουμε δηλαδή Item.buildable_area πρέπει να υπάρχει το Item.buildable και να έχει την τιμή true.

    Κάποια πεδία μπορούν να πάρουν πολλαπλές τιμές από τις διαθέσιμες οι οποίες δίνονται χωρισμένες με κόμμα π.χ. τοItem.viewType μπορεί να έχει τις τιμές <Value>MOUNTAIN,FOREST</Value>.

    Τέλος, για τα πεδία που υπόκεινται σε έλεγχο τιμής, πέραν της υποχρεωτικής παρουσίας ή της τιμής από λίστες LOOKUP, περιγράφεται το είδος του ελέγχου.

    Αγγελίες Κατοικίας

    Χαρακτηριστικό Τύπος Υπ. Περιγραφή MC Σχόλια
    Item.type LOOKUP ΝΑΙ Είδος
    Item.subtype LOOKUP Υποείδος ΝΑΙ
    Item.area FLOAT ΝΑΙ Εμβαδόν
    Item.level LOOKUP ΝΑΙ Επίπεδο ΝΑΙ
    Item.constructionType LOOKUP Είδος κατασκευής ΝΑΙ
    Item.condition LOOKUP ΝΑΙ Κατάσταση
    Item.conditionDetails LOOKUP Λεπτομερής κατάσταση. Εξαρτάται από το Item.condition και ενεργοποιείται όταν Item.condition=USED
    Item.constructionYear INTEGER ΝΑΙ Έτος κατασκευής Μεγαλύτερη του 1900 και μικρότερη ή ίση του τρέχοντος έτους
    Item.refurbishmentYear INTEGER Έτος ανακαίνισης Μεγαλύτερη του 1900 και μικρότερη ή ίση του τρέχοντος έτους
    Item.floors INTEGER Όροφοι
    Item.floorsArea FLOAT Εμβαδόν ορόφων
    Item.orientation LOOKUP Είδος προσανατολισμού NAI
    Item.bedrooms INTEGER Αριθμός υπνοδωματίων
    Item.masterBedrooms INTEGER Αριθμός κυρίων υπνοδωματίων Μικρότερη απο την τιμή του πεδίου Item.bedrooms
    Item.bathrooms INTEGER Μπάνια
    Item.wc INTEGER Πλήθος WC Επιπλέον των Item.bathrooms
    Item.hasParking 0/1 Διαθέτει parking
    Item.parkingType LOOKUP Είδος parking NAI
    Item.hasStorage 0/1 Διαθέτει αποθήκη
    Item.storageArea FLOAT Εμβαδόν αποθήκης
    Item. hasAutonomousHeating 0/1 Διαθέτει αυτόνομη θέρμανση
    Item.hasCentralHeating 0/1 Διαθέτει κεντρική θέρμανση
    Item.hasAircondition 0/1 Διαθέτει aircondition
    Item.hasSecureDoor 0/1 Διαθέτει πόρτα ασφαλείας
    Item.viewType LOOKUP Τύπος θέας NAI
    Item.hasFireplace 0/1 Διαθέτει τζάκι
    Item.hasSolarBoiler 0/1 Διαθέτει ηλιακό θερμοσίφωνα
    Item.withoutElevator 0/1 Χωρίς ανελκυστήρα
    Item.hasNaturalGas 0/1 Διαθέτει φυσικό αέριο
    Item.hasGarden 0/1 Διαθέτει κήπο
    Item.gardenArea FLOAT Εμβαδόν κήπου
    Item.location STRING Περιοχή
    Item.land FLOAT Εμβαδόν οικοπέδου Δεκαδικός με ακρίβεια 1 ψηφίου.
    Item.availabilityType LOOKUP Τύπος διαθεσιμότητας
    Item.hasPrivateTerrace 0/1 Διαθέτει ιδιόκτητη ταράτσα
    Item.terraceArea FLOAT Εμβαδόν ταράτσας
    Item.hasPool 0/1 Διαθέτει πισίνα
    Item.hasTents 0/1 Διαθέτει τέντες
    Item. isWithoutCommunalCharge 0/1 Χωρίς κοινόχρηστα
    Item. isSuitableForProfessionalUse 0/1 Κατάλληλο για επαγγελματική χρήση
    Item.isFurnished 0/1 Είναι επιπλωμένο
    Item.availableFrom STRING Διαθέσιμο από
    Item.spacesPlan STRING Διαμόρφωση χώρων
    Item.isSuitableForStudents 0/1 Κατάλληλο για φοιτητές
    Item.isAgentAccepted 0/1 Δεκτοί μεσίτες
    Item.hasSemiOpenSpaces 0/1 Διαθέτει ημιυπαίθριους χώρους
    Item.semiOpenSpacesArea FLOAT Εμβαδόν ημιυπαίθριων χώρων
    Item.energy_class LOOKUP Ενεργειακή κλάση A A_PLUS B B_PLUS C D E Z H NOT_EFFICIENT NOT_APPLICABLE
    Εξαρτώμενο χαρακτηριστικό Πρωτεύον χαρακτηριστικό
    Item.storageArea Item.hasStorage
    Item.semiOpenSpacesArea Item.hasSemiOpenSpaces
    Item.garden_area Item.hasGarden
    Item.terraceArea Item.hasPrivateTerrace
    Item.floors Item.floorsArea
    Item.parkingType Item.hasParking

    Αγγελίες Επαγγελματικής Στέγης

    Χαρακτηριστικό Τύπος Υπ. Περιγραφή MC Σχόλια
    Item.type LOOKUP ΝΑΙ Είδος
    Item.constructionType LOOKUP Είδος κατασκευής ΝΑΙ
    Item.totalArea FLOAT ΝΑΙ Συνολικό εμβαδόν
    Item.level LOOKUP ΝΑΙ Επίπεδο ΝΑΙ
    Item.floorsArea FLOAT Εμβαδόν ορόφων
    Item.condition LOOKUP ΝΑΙ Κατάσταση
    Item.conditionDetails LOOKUP Λεπτομερής κατάσταση. Εξαρτάται από το Item.condition και ενεργοποιείται όταν Item.condition=USED
    Item.constructionYear INTEGER ΝΑΙ Έτος κατασκευής Μεγαλύτερη του 1900 και μικρότερη ή ίση του τρέχοντος έτους
    Item.refurbishmentYear INTEGER Έτος ανακαίνισης Μεγαλύτερη του 1900 και μικρότερη ή ίση του τρέχοντος έτους
    Item.spacesLayout STRING Διαμόρφωση χώρων
    Item.hasWC 0/1 Διαθέτει WC
    Item.hasLoadingRamp 0/1 Διαθέτει ράμπα φορτοεκφόρτωσης
    Item.hasLoft 0/1 Διαθέτει πατάρι
    Item.loftArea FLOAT Εμβαδόν παταριού
    Item.height FLOAT Ύψος
    Item.hasStorage 0/1 Διαθέτει αποθήκη
    Item.storageArea FLOAT Εμβαδόν αποθήκης
    Item.hasParking 0/1 Διαθέτει parking
    Item.parkingType LOOKUP Τύπος parking
    Item.parkingArea FLOAT Εμβαδόν parking
    Item.parkingSlots INTEGER Θέσεις parking
    Item. hasAutonomousHeating 0/1 Διαθέτει αυτόνομη θέρμανση
    Item.hasAircondition 0/1 Διαθέτει aircondition
    Item.hasElevator 0/1 Διαθέτει ανελκυστήρα
    Item.elevatorPayload INTEGER Βάρος ανύψωσης ανελκυστήρα
    Item.electricityType LOOKUP Τύπος ρεύματος ΝΑΙ
    Item.hasNaturalGas 0/1 Διαθέτει φυσικό αέριο
    Item.location STRING Τοποθεσία
    Item.isWithInLand 0/1 Σε οικόπεδο Προειδοποίηση για τιμές μικρότερες του 50 και μεγαλύτερες του 50000
    Item.availabilityType LOOKUP Τύπος διαθεσιμότητας
    Item. isWithoutCommunalCharge 0/1 Χωρίς κοινόχρηστα
    Item.availableFrom STRING Διαθέσιμο από
    Item.isAgentAccepted 0/1 Δεκτοί μεσίτες
    Item.hasStructuredCabling 0/1 Διαθέτει δομημένη καλωδίωση
    Item.isSingleSpace 0/1 Είναι ενιαίος χώρος
    Item.isFurnished 0/1 Είναι επιπλωμένο
    Item.isEquiped 0/1 Είναι εξοπλισμένο
    Item.orientation LOOKUP Τύπος προσανατολισμού ΝΑΙ
    Item.energy_class LOOKUP Ενεργειακή κλάση A A_PLUS B B_PLUS C D E Z H NOT_EFFICIENT NOT_APPLICABLE

    Υπόμνημα: Υπ. = Υποχρεωτικό MC = Πολλαπλές τιμές

    Εξαρτώμενο χαρακτηριστικό Πρωτεύον χαρακτηριστικό
    Item.storageArea Item.hasStorage
    Item.elevatorPayload Item.hasElevator
    Item.parkingType Item.hasParking
    Item.parkingArea Item.hasParking
    Item.parkingSlots Item.hasParking
    Item.loftArea Item.hasLoft

    Αγγελίες Parking

    Χαρακτηριστικό Τύπος Υπ. Περιγραφή MC Σχόλια
    Item.type LOOKUP ΝΑΙ Είδος
    Item.area FLOAT ΝΑΙ Εμβαδόν
    Item.usage LOOKUP Είδος χρήσης ΝΑΙ
    Item.slots INTEGER Θέσεις
    Item.level LOOKUP ΝΑΙ Επίπεδο
    Item.hasElectricDoor 0/1 Διαθέτει ηλεκτρική πόρτα
    Item.hasAlarm 0/1 Διαθέτει συναγερμό
    Item.isAgentAccepted 0/1 Δεκτοί μεσίτες

    Υπόμνημα: Υπ. = Υποχρεωτικό MC = Πολλαπλές τιμές

    Αγγελίες Γης

    Χαρακτηριστικό Τύπος Υπ. Περιγραφή MC Σχόλια
    Item.type LOOKUP ΝΑΙ Είδος
    Item.contains STRING Περιέχει
    Item.area FLOAT ΝΑΙ Εμβαδόν
    Item.buildFactor FLOAT Συντελεστής δόμησης Δεκαδικός με ακρίβεια 2 ψηφίων. Προειδοποίηση για τιμές μεγαλύτερες του 3.
    Item.coverFactor FLOAT Συντελεστής κάλυψης Δεκαδικός με ακρίβεια 2 ψηφίων και τιμή μικρότερη ή ίση με 1
    Item.cityPlanType LOOKUP Σχέδιο πόλης
    Item.dimensions STRING Διαστάσεις
    Item.facadeDimension FLOAT Πρόσοψη
    Item.isWhole 0/1 Άρτιο
    Item.isBuildable 0/1 Οικοδομήσιμο
    Item.buildableArea FLOAT Οικοδομήσιμο εμβαδόν
    Item.containsBuilding 0/1 Περιέχει κτίσμα
    Item.buildingArea FLOAT Εμβαδόν κτίσματος
    Item.viewType LOOKUP Τύπος θέας NAI
    Item.utilities STRING Παροχές
    Item.availabilityType LOOKUP Τύπος διαθεσιμότητας
    Item.availableFrom STRING Διαθέσιμο από
    Item.isProffesional 0/1 Κατάλληλο για επαγγελματική χρήση
    Item.location STRING Τοποθεσία
    Item.AntiparoxiAccepted 0/1 Δεκτή αντιπαροχή
    Item.hasBuildLicense 0/1 Διαθέσιμη άδεια χρήσης
    Item.sides INTEGER Αριθμός όψεων
    Item.isAgentAccepted 0/1 Δεκτοί μεσίτες
    Item.isCorner 0/1 Γωνιακό
    Item.isSeeThrough 0/1 Διαμπερές
    Item.distanceToShore INTEGER Απόσταση από θάλασσα
    Item.tilt LOOKUP Τύπος κλίσης ΝΑΙ
    Item.canDrill 0/1 Γεώτρηση
    Item.isFenced 0/1 Περιφραγμένο

    Υπόμνημα: Υπ. = Υποχρεωτικό MC = Πολλαπλές τιμές

    Εξαρτώμενο χαρακτηριστικό Πρωτεύον χαρακτηριστικό
    Item.buildableArea Item.buildable
    Item.buildingArea Item.containsBuilding

    Αγγελίες Εξοχικής Κατοικίας

    Τα πεδία των Εξοχικών Κατοικιών είναι τα ίδια με αυτά των Κατοικιών, με την προσθήκη των Item.activity, Item.utilities και Item.proximityTo.

    Χαρακτηριστικό Τύπος Υπ. Περιγραφή MC Σχόλια
    Item.type LOOKUP ΝΑΙ Είδος
    Item.subtype LOOKUP Υποείδος ΝΑΙ
    Item.area FLOAT ΝΑΙ Εμβαδόν
    Item.level LOOKUP ΝΑΙ Επίπεδο ΝΑΙ
    Item.constructionType LOOKUP Είδος κατασκευής ΝΑΙ
    Item.condition LOOKUP ΝΑΙ Κατάσταση
    Item.conditionDetails LOOKUP Λεπτομερής κατάσταση. Εξαρτάται από το Item.condition και ενεργοποιείται όταν Item.condition=USED
    Item.constructionYear INTEGER ΝΑΙ Έτος κατασκευής Μεγαλύτερη του 1900 και μικρότερη ή ίση του τρέχοντος έτους
    Item.refurbishmentYear INTEGER Έτος ανακαίνισης Μεγαλύτερη του 1900 και μικρότερη ή ίση του τρέχοντος έτους
    Item.floors INTEGER Όροφοι
    Item.floorsArea FLOAT Εμβαδόν ορόφων
    Item.orientation LOOKUP Είδος προσανατολισμού NAI
    Item.bedrooms INTEGER Αριθμός υπνοδωματίων
    Item.masterBedrooms INTEGER Αριθμός κυρίων υπνοδωματίων Μικρότερη απο την τιμή του πεδίου Item.bedrooms
    Item.bathrooms INTEGER Μπάνια
    Item.wc INTEGER Πλήθος WC Επιπλέον των Item.bathrooms
    Item.hasParking 0/1 Διαθέτει parking
    Item.parkingType LOOKUP Είδος parking NAI
    Item.hasStorage 0/1 Διαθέτει αποθήκη
    Item.storageArea FLOAT Εμβαδόν αποθήκης
    Item. hasAutonomousHeating 0/1 Διαθέτει αυτόνομη θέρμανση
    Item.hasCentralHeating 0/1 Διαθέτει κεντρική θέρμανση
    Item.hasAircondition 0/1 Διαθέτει aircondition
    Item.hasSecureDoor 0/1 Διαθέτει πόρτα ασφαλείας
    Item.viewType LOOKUP Τύπος θέας NAI
    Item.hasFireplace 0/1 Διαθέτει τζάκι
    Item.hasSolarBoiler 0/1 Διαθέτει ηλιακό θερμοσίφωνα
    Item.withoutElevator 0/1 Χωρίς ανελκυστήρα
    Item.hasNaturalGas 0/1 Διαθέτει φυσικό αέριο
    Item.hasGarden 0/1 Διαθέτει κήπο
    Item.gardenArea FLOAT Εμβαδόν κήπου
    Item.location STRING Περιοχή
    Item.land FLOAT Εμβαδόν οικοπέδου Δεκαδικός με ακρίβεια 1 ψηφίου.
    Item.availabilityType LOOKUP Τύπος διαθεσιμότητας
    Item.hasPrivateTerrace 0/1 Διαθέτει ιδιόκτητη ταράτσα
    Item.terraceArea FLOAT Εμβαδόν ταράτσας
    Item.hasPool 0/1 Διαθέτει πισίνα
    Item.hasTents 0/1 Διαθέτει τέντες
    Item. isWithoutCommunalCharge 0/1 Χωρίς κοινόχρηστα
    Item. isSuitableForProfessionalUse 0/1 Κατάλληλο για επαγγελματική χρήση
    Item.isFurnished 0/1 Είναι επιπλωμένο
    Item.availableFrom STRING Διαθέσιμο από
    Item.spacesPlan STRING Διαμόρφωση χώρων
    Item.isSuitableForStudents 0/1 Κατάλληλο για φοιτητές
    Item.isAgentAccepted 0/1 Δεκτοί μεσίτες
    Item.hasSemiOpenSpaces 0/1 Διαθέτει ημιυπαίθριους χώρους
    Item.semiOpenSpacesArea FLOAT Εμβαδόν ημιυπαίθριων χώρων
    Item.energy_class LOOKUP Ενεργειακή κλάση A A_PLUS B B_PLUS C D E Z H NOT_EFFICIENT NOT_APPLICABLE
    Item.activity STRING Δραστηριότητα
    Item.utilities STRING Παροχές
    Item.proximityTo LOOKUP Θέση
    Εξαρτώμενο χαρακτηριστικό Πρωτεύον χαρακτηριστικό
    Item.storageArea Item.hasStorage
    Item.semiOpenSpacesArea Item.hasSemiOpenSpaces
    Item.garden_area Item.hasGarden
    Item.terraceArea Item.hasPrivateTerrace
    Item.floors Item.floorsArea
    Item.parkingType Item.hasParking

    Οικονομικά στοιχεία

    Παράδειγμα οικονομικών πληροφοριών

    <Item type="..." refId="..."> 
        ...
        <Transaction.price>10.000</Transaction.price> 
        <Transaction.currency>EUR</Transaction.currency> 
        <Transaction.frequency>ONCE</Transaction.frequency> 
        <Transaction.type>SELL.NORMAL</Transaction.type> 
        <Transaction.isOffer>0</Transaction.isOffer> 
        <Transaction.isPromo>1</Transaction.isPromo> 
        <Transaction.isNegotiable>0</Transaction.isNegotiable>
    </Item>
    

    Τα οικονομικά στοιχεία της αγγελίας περιλαμβάνουν τα παρακάτω πεδία:

    Πεδίο Τύπος Υποχρεωτικό Περιγραφή
    Transaction.price FLOAT Τιμή
    Transaction.currency LOOKUP Νόμισμα με βάση τη διεθνή γραφή
    Transaction.frequency LOOKUP Συχνότητα καταβολής
    Transaction.type LOOKUP ΝΑΙ Τύπος
    Transaction.isOffer 0/1 Ένδειξη προσφοράς
    Transaction.isPromo 0/1 Ένδειξης προώθησης
    Transaction.isNegotiable 0/1 Ένδειξη διαπραγματεύσιμης τιμής

    Τα πεδία αυτά περιγράφονται στο σώμα κάθε Item στο XML document και όχι στην λίστα των χαρακτηριστικών της. Δίπλα παρουσιάζεται ένα παράδειγμα χρήσης των παραπάνω πεδίων στο σώμα ενός Item/Αγγελίας.

    Η τιμή του Transaction.currency είναι προκαθορισμένη σε ευρώ (EUR) αν δεν συμπεριληφθεί αυτό το πεδίο στο request. Η κωδικοποίηση των νομισμάτων θα ακολουθεί τα διεθνές πρότυπο ISO 4217 που χρησιμοποιεί κωδικούς τριών γραμμάτων για να περιγράψει τα ονόματα των νομισμάτων.

    Η τιμές που μπορούν να πάρουν τα LOOKUP πεδία παρουσιάζονται στο παράρτημα Α.

    Γεωγραφική πληροφορία

    Παράδειγμα γεωγραφικών πληροφοριών

    <AddItemsRequest>
      <Item>
         <Fields>
              <Field>
                  <Name>Geo.areaId</Name>
                  <Value>100</Value>
              </Field>
              <Field>
                  <Name>Geo.subAreaDescription</Name>
                  <Value>Υποπεριοχή</Value>
              </Field>
              <Field>
                  <Name>Geo.streetName</Name>
                  <Value> ασομούλη</Value>
              </Field>
              <Field> 
                  <Name>Geo.streetNumber</Name>
                  <Value>100</Value>
              </Field>
              <Field>
                  <Name>Geo.longitude</Name>
                  <Value>13.222</Value>
              </Field>
              <Field>
                  <Name>Geo.latitude</Name>
                  <Value>1.567</Value>
              </Field>
              <Field>
                  <Name>Geo.postcode</Name>
                  <Value>11740</Value>
              </Field>
         </Fields>
      </Item>
    </AddItemsRequest>
    

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

    Πεδίο Τύπος Υποχρεωτικό Περιγραφή
    Geo.areaId LOOKUP NAI Kωδικός περιοχής
    Geo.subAreaDescription STRING Εξαρτάται από το Geo.areaId Λεκτικό υποπεριοχής
    Geo.streetName STRING Όνομα οδού
    Geo.streetNumber STRING Αριθμός οδού
    Geo.longitude FLOAT Γεωγραφικό μήκος
    Geo.latitude FLOAT Γεωγραφικό πλάτος
    Geo.postcode STRING Ταχυδρομικός κώδικας

    Μία αγγελία real estate ξεκινάει πάντα με το όνομα της περιοχής που αντιστοιχεί στο Geo.areaId. Όμως ο χρήστης μπορεί να προσδιορίσει περαιτέρω την περιοχή, π.χ. αν έχει επιλέξει το Geo.areaId που αντιστοιχεί στο « Νέος Κόσμος», μπορεί να προσδιορίσει πιο λεπτομερώς το ακριβές σημείο αποστέλλοντας στο πεδίο Geo.subAreaDescription την τιμή Ελευθεροτυπία, το οποίο είναι ένα τοπωνύμιο.

    Στο παράρτημα Β παρουσιάζονται:

    Για όσους κωδικούς δεν υπάρχει «ΛΕΚΤΙΚΟ ΑΓΓΕΛΙΑΣ» είναι απαραίτητο να αποστέλλεται κείμενο υποπεριοχής.

    Συνημμένα ψηφιακά αρχεία

    Περιγραφή assets (μιας εικόνας και ενός βίντεο)

    <Item>
        ........
        <Asset>
          <Asset.type>IMAGE</Asset.type>
            <Asset.id>filename.jpg</Asset.id>
            <Asset.fileType>jpg</Asset.fileType>
            <Asset.status>ACTIVE</Asset.status>
            <Asset.isPrimary>0</Asset.isPrimary>
            <Asset.caption>Main image</Asset.caption>
            <Asset.order>1</Asset.order>
            <Asset.uri>filename.jpg</Asset.uri>
            <Asset.properties key="something">100</Asset.properties>
        </Asset>
        ........
        <Asset>
            <Asset.type>VIDEO</Asset.type>
            <Asset.id>v1</Asset.id>
            <Asset.isPrimary>0</Asset.isPrimary>
            <Asset.order>1</Asset.order>
            <Asset.caption>Ermis Bronze στη Χρυσή Ευκαιρία</Asset.caption>
            <Asset.uri><![CDATA[http://www.youtube.com/watch?v=NebuqG1OFXM]]></Asset.uri>
        </Asset>
        ........
    </Item>
    

    Ο μηχανισμός εισαγωγής αγγελιών στο σύστημα της Χρυσής Ευκαιρίας επιτρέπει κάθε αγγελία να συνοδεύεται από εικόνες ή video τα οποία δεν θα είναι πάνω από 10 φωτογραφίες + 1 video. Η πληροφορία που αφορά κάθε αρχείο περιγράφεται σε ένα στοιχείο Asset το οποίο περιλαμβάνεται στο σώμα του στοιχείου Item. Τα πεδία που χρησιμοποιούνται για την περιγραφή της εικόνας περιγράφονται στον παρακάτω πίνακα:

    Πεδίο Τύπος Υποχρεωτικό Περιγραφή
    Asset.type LOOKUP ΝΑΙ Τύπος Αρχείου (IMAGE ή VIDEO)
    Asset.id STRING ΝΑΙ Κωδικός
    Asset.fileType LOOKUP Ο τύπος της εικόνας. Αν δεν υπάρχει θεωρείται jpg
    Asset.status LOOKUP Κατάσταση εικόνας (για μελλοντική χρήση - στην τρέχουσα έκδοση πάντα ACTIVE)
    Asset.isPrimary 0/1 ΝΑΙ Ένδειξη κύριας εικόνας ή βίντεο
    Asset.caption FLOAT Λεκτικό περιγραφής (για μελλοντική χρήση)
    Asset.order FLOAT ΝΑΙ Σειρά εμφάνισης
    Asset.uri STRING ΝΑΙ Το όνομα τού αρχείου τής εικόνας ως ή το URL τού Video (το url τού video μέσα σε <![CDATA[]]>)
    Asset.properties KEY / VALUE(STRING) Placeholder για έξτρα πληροφορία

    Σειρά εμφάνισης των εικόνων στο xe.gr

    Για τον καθορισμό της σειράς εμφάνισης των εικόνων στο xe.gr χρησιμοποιούνται τα πεδία Asset.isPrimary και Asset.order:

    Παρατηρήσεις:

    Σύνοψη

    Στην παρακάτω εικόνα φαίνεται η σύνοψη της δομής μίας αγγελίας.

    Outline

    Παραρτήματα

    Lookup values

    A. Πίνακες LOOKUP των χαρακτηριστικών

    Είδος -Υποείδος (Item.type - Item.subtype)

    Item.type Τιμή Περιγραφή Τιμή Item.subtype Περιγραφή
    re_land AGROTEMAXIO Αγροτεμάχιο
    EKTASH Έκταση
    OIKOPEDO Οικόπεδο
    re_parking CLOSED Κλειστό
    OPEN Ανοιχτό
    YPOGEIO Υπόγειο
    PILOTIS Πιλοτής
    re_prof ADVERTISING Διαφημιστικός Χώρος
    APARTMENT Διαμέρισμα
    APOTHIKI Αποθήκη
    BIOTEXNIA Βιοτεχνικός Χώρος
    EXHIBITION Εκθεσιακός Χώρος
    FLOORAPARTMENT Οροφοδιαμέρισμα
    INDUSTRIAL Βιομηχανικός Χώρος
    KTIRIO Κτίριο
    OFFICE Γραφείο
    OIKIA Οικία
    PROF Επαγγελματικός Χώρος
    RETAIL Κατάστημα
    ROOM Αίθουσα
    STORAGE Αποθηκευτικός Χώρος
    XVROS Χώρος
    re_residence APARTMENT Διαμέρισμα FLOORFLAT Οροφοδιαμέρισμα
    LOFT Δώμα
    PENTHOUSE Ρετιρέ
    SINGLEROOM Γκαρσονιέρα
    BUILDING Κτήριο
    HOUSE Μονοκατοικία
    OIKEIA Οικία
    SPLIT_LEVEL Μεζονέτα
    re_residence_hol APARTMENT Διαμέρισμα FLOORFLAT Οροφοδιαμέρισμα
    LOFT Δώμα
    PENTHOUSE Ρετιρέ
    SINGLEROOM Γκαρσονιέρα
    BUILDING Κτήριο
    HOUSE Μονοκατοικία
    OIKEIA Οικία
    SPLIT_LEVEL Μεζονέτα

    Σχέδιο πόλης (Item.cityPlanType)

    Τιμή Περιγραφή
    IN Εντός σχεδίου πόλης
    OUT Εκτός σχεδίου πόλης
    TOBE Υπό ένταξη

    Τύπος Θέας (Item.viewType)

    Τιμή Περιγραφή
    FOREST Θέα δάσος
    MOUNTAIN Θέα βουνό
    SEA Θέα Θάλασσα
    UNLIMITED Απεριόριστη θέα

    Διαθεσιμότητα(Item.availabilityType)

    Τιμή Περιγραφή
    AVAILABLE Ελεύθερο
    OCCUPATED Μισθωμένο

    Κλίση (Item.tilt)

    Τιμή Περιγραφή
    AMFITHEATRIKO Αμφιθεατρικό
    LEVEL Επίπεδο
    TILTED Επικλινές

    Χρήση parking (Item.usage)

    Τιμή Περιγραφή
    BIKE Μοτοσικλέτας
    BOAT Σκάφους
    CAR Αυτοκινήτου
    CARAVAN Τροχόσπιτου

    Επίπεδο(Item.level)

    Είδος Αγγελίας Τιμή Περιγραφή
    re_parking GROUND Ισόγειο
    LEV_1 1
    LEV_2 2
    LEV_3 3
    LEV_4 4
    SUB_1 -1
    SUB_2 -2
    SUB_3 -3
    SUB_4 -4
    re_prof - re_residence - re_residence_hol L0 Ισόγειο
    L1 1
    L2 2
    L3 3
    L4 4
    L5 5
    L6 6
    L7 7
    L8 8
    LH Ημιόροφος
    LHH Υπερυψωμένο
    S1 Υπόγειο
    SH Ημιυπόγειο

    Κατάσταση - Λεπτομερής κατάσταση (Item.condition - Item.ConditionDetails)

    Τιμή Περιγραφή Τιμή Περιγραφή
    NEWBUILT Νεόδμητο
    UNDER_CONSTRUCTION
    UNFINISHED Ημιτελές
    USED Άλλη GOOD Καλή Κατάσταση
    NEEDS_REPAIR Χρίζει επισκευής
    PERFECT Άριστη κατάσταση
    REFURBISHED Ανακαινισμένο

    Είδος parking(Item.parkingType)

    Τιμή Περιγραφή
    CLOSED Κλειστό
    OPEN Ανοιχτό
    YPOGEIO Υπόγειο
    PILOTIS Πιλοτής

    Τύπος ρεύματος (Item.electricityType)

    Τιμή Περιγραφή
    INDUSTRIAL Βιομηχανικό
    SINGLE_PHASED Μονοφασικό
    TRI_PHASED Τριφασικό

    Τύπος προσανατολισμού (Item.orientation)

    Τιμή Περιγραφή
    DIAMPERES Διαμπερές
    ESWTERIKO Εσωτερικό
    GONIAKO Γωνιακό
    PROSOPSEOS Προσόψεως

    Είδος κατασκευής (Item.constructionType)

    Τιμή Περιγραφή
    LOFT Loft
    LYOMENO Λυόμενο
    NEOKLASIKO Νεοκλασικό
    PRESERVED Διατηρητέο
    PROKAT Προκατασκευή
    ROCK Πέτρινο
    STUDIO Στούντιο
    TRADITIONAL Παραδοσιακό
    VILA Βίλα

    Οικονομικά Στοιχεία

    Μονάδα (Item.Transaction.currency)

    Τιμή Περιγραφή
    EUR Ευρώ

    Συχνότητα(Transaction.frequency)

    Τιμή Περιγραφή
    ANNUALY Ετήσια
    DAILY Ημερήσια
    HOURLY Ωριαία
    MONTHLY Μηνιαία
    ONCE Εφ'άπαξ
    QUARTERLY Τετραμηνιαία
    WEEKLY Εβδομαδιαία

    Τύπος Συναλλαγής (Transaction.Type)

    Τιμή Περιγραφή
    SELL.NORMAL Πώληση
    SELL.EXCHANGE Ανταλλαγή
    SELL.AUCTION Πλειστηριασμός
    SELL.GIFT Δωρεά
    SELL.ANTIPAROXI Αντιπαροχή
    BUY.NORMAL Ζήτηση για αγορά
    BUY.EXCHANGE Ζήτηση για ανταλλαγή
    BUY.GIFT Ζήτηση για δωρεά
    BUY.ANTIPAROXI Ζήτηση για αντιπαροχή
    RENT.NORMAL Ζήτηση για Ενοικίαση
    LET.NORMAL Ενοικίαση

    Ψηφιακά αρχεία

    Τύπος (Asset.type)

    Τιμή Περιγραφή
    IMAGE Εικόνα

    Τύπος αρχείου (Asset.fileType)

    Τιμή Περιγραφή
    jpg Εικόνα JPEG

    Κατάσταση(Asset.status)

    Τιμή Περιγραφή
    ACTIVE Ενεργή
    INACTIVE Μή ενεργή

    Γεωγραφική κωδικοποίηση

    Παρακαλούμε ανατρέξτε στο εγχειρίδιο, σελίδα 47, ή στο αρχείο geo.xls του SDK.

    XSD (Schemata) Ver 1.0

    AddItemsRequest

    Το σχήμα της έκδοσης 1.1 αντιμετωπίζει τα metadata του πακέτου και των χαρακτηριστικών καθώς και τα Items που αφορούν αντικείμενα του Real Estate

    <?xml version="1.0" encoding="UTF-8"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.xe.gr" xmlns="http://www.xe.gr" elementFormDefault="qualified">
                <xs:simpleType name="transCurrency"> 
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="EUR" /> 
                    </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="transFrequency"> 
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="ANNUALY" />                  <xs:enumeration value="DAILY" />                    <xs:enumeration value="HOURLY" />                   <xs:enumeration value="MONTHLY" />                  <xs:enumeration value="ONCE" />                     <xs:enumeration value="QUARTERLY" />                    <xs:enumeration value="WEEKLY" />
                    </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="transType">
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="SELL.NORMAL"></xs:enumeration>                   <xs:enumeration value="SELL.GIFT"></xs:enumeration>                     <xs:enumeration value="SELL.EXCHANGE"></xs:enumeration>                     <xs:enumeration value="SELL.ANTIPAROXI"></xs:enumeration>                   <xs:enumeration value="SELL.AUCTION"></xs:enumeration>                  <xs:enumeration value="BUY.NORMAL"></xs:enumeration>                    <xs:enumeration value="BUY.GIFT"></xs:enumeration> 
                        <xs:enumeration value="BUY.EXCHANGE"></xs:enumeration>                  <xs:enumeration value="BUY.ANTIPAROXI"></xs:enumeration>                    <xs:enumeration value="RENT.NORMAL"></xs:enumeration>                   <xs:enumeration value="LET.NORMAL"></xs:enumeration>
                    </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="itemType"> 
                        <xs:restriction base="xs:string">
                         <xs:enumeration value="re_land" /> 
                         <xs:enumeration value="re_misc" /> 
                         <xs:enumeration value="re_parking" /> 
                         <xs:enumeration value="re_prof" /> 
                         <xs:enumeration value="re_residence" /> 
                         <xs:enumeration value="re_residence_hol" />
                        </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="xeBoolean"> 
                        <xs:restriction base="xs:string">
                         <xs:enumeration value="0" /> 
                         <xs:enumeration value="1" />
                        </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="assetType"> 
                <xs:restriction base="xs:string">
                 <xs:enumeration value="IMAGE" /> 
                 <xs:enumeration value="VIDEO" />
                </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="assetFileType"> 
                        <xs:restriction base="xs:string">
                         <xs:enumeration value="jpg" /> 
                        </xs:restriction>
                </xs:simpleType>
                <xs:simpleType name="assetStatus"> 
                        <xs:restriction base="xs:string">
                         <xs:enumeration value="ACTIVE" /> 
                         <xs:enumeration value="INACTIVE" />
                        </xs:restriction>
                </xs:simpleType>
                <xs:complexType name="assetProperty"> 
                    <xs:simpleContent> 
                     <xs:extension base="xs:string">
                     <xs:attribute name="key" type="xs:string"/> 
                     </xs:extension>
                    </xs:simpleContent>
                </xs:complexType>
                <xs:complexType name="otherPhones"> 
                            <xs:sequence>
                                        <xs:element name="Item.phone" type="xs:string" minOccurs="1" maxOccurs="5"/>
                            </xs:sequence>
                </xs:complexType>
                <xs:complexType name="field"> <xs:sequence>
                 <xs:element name="Name" type="xs:string"/> 
                 <xs:element name="Value" type="xs:string"/>
                </xs:sequence>
                </xs:complexType> 
                <xs:complexType name="asset">
                <xs:sequence>
                <xs:element name="Asset.type" type="assetType"/> 
                <xs:element name="Asset.id" type="xs:string"/>
            <xs:element name="Asset.fileType" type="assetFileType" minOccurs=''0''/>            <xs:element name="Asset.status" type="assetStatus" minOccurs="0"/> 
                <xs:element name="Asset.isPrimary" type="xeBoolean"/>
                <xs:element name="Asset.caption" type="xs:string" minOccurs="0"/> 
                <xs:element name="Asset.order" type="xs:integer" minOccurs="0"/> 
                <xs:element name="Asset.uri" type="xs:string"/>
                <xs:element name="Asset.properties" type="assetProperty" minOccurs="0"/> 
            </xs:sequence>
            </xs:complexType> 
            <xs:complexType name="item">
                <xs:sequence>
                        <xs:element name="Item.ownerId" type="xs:string"/>
                        <xs:element name="Item.majorPhone" type="xs:string"/>
                        <xs:element name="Item.departmentOnCategory" type="xs:string" minOccurs="0"/>
                        <xs:element name="Item.otherPhones" type="otherPhones" minOccurs="0"/>                  <xs:element name="Item.internetText" type="xs:string" minOccurs="0"/>                   <xs:element name="Item.addOnText" type="xs:string" minOccurs="0"/>                  <xs:element name="Item.bodyText" type="xs:string" minOccurs="0"/>                   <xs:element name="Transaction.price" type="xs:string" minOccurs="0"/>
                        <xs:element name="Transaction.currency" type="transCurrency" minOccurs="0"/>
                        <xs:element name="Transaction.frequency" type="transFrequency"
    minOccurs="0"/>
                        <xs:element name="Transaction.type" type="transType"/>
                        <xs:element name="Transaction.isOffer" type="xs:string" minOccurs="0"/>                     <xs:element name="Transaction.isPromo" type="xs:string" minOccurs="0"/>
                        <xs:element name="Transaction.isNegotiable" type="xs:string" minOccurs="0"/>
                        <xs:element name="Field" type="field" minOccurs="1" maxOccurs="100"/>                   <xs:element name="Asset" type="asset" minOccurs="0" maxOccurs="10"/>
                </xs:sequence>
                <xs:attribute name="type" type="itemType" use="required"/> 
                <xs:attribute name="refId" type="xs:string" use="required"/>
            </xs:complexType>
    
            <xs:element name="AddItemsRequest"> 
             <xs:complexType>
                    <xs:sequence>
                        <xs:element name="Package.xeAuthToken" type="xs:string"/> 
                        <xs:element name="Package.schemaVersion" type="xs:string"/>
                        <xs:element name="Package.id" type="xs:string"/>
                        <xs:element name="Package.timestamp" type="xs:string"/>
                        <xs:element name="Package.storeId" type="xs:string" minOccurs="0">                  <xs:element name="Package.trademark" type="xs:string" minOccurs="0"/>                   <xs:element name="Package.policy" type="xs:string" minOccurs="0"/>                  <xs:element name="Item" type="item" minOccurs="1" maxOccurs="unbounded"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
    
    </xs:schema>
    

    Μηνύματα Σφάλματος

    Αποστολή πακέτου

    Μήνυμα Λάθους Επεξήγηση
    CREDENTIALS DO NOT MATCH WITH AUTH TOKEN Τα στοιχεία αυθεντικοποίησης (username,password) δεν αντιστοιχούν στο κλειδί αυθεντικοποίησης (authtoken)
    FILE HANDLING ERROR Σφάλμα κατά τον χειρισμό του zip αρχείου, πρόβλημα με την δομή του
    FAILED XSD VALIDATION Μη έγκυρο XML αρχείο, απέτυχε το XSD validation

    Επεξεργασία πακέτου

    Σε επίπεδο πακέτου:

    Μήνυμα Λάθους Επεξήγηση
    DUPLICATE ID Ο κωδικός πακέτου έχει χρησιμοποιηθεί ήδη )
    XML PARSING ERROR Σφάλμα κατα την ανάγνωση του αρχείου xml)
    NO MATCHING POLICY FOUND Μη έγκυρη πολιτική χρήσης, αναντιστοιχία ανάμεσα στην επιλεγμένη πολιτική χρήσης (INCREMENTAL/RENEW_ALL_STOCK) και σε αυτή που αναφέρεται στο πακέτο του request )
    REQUEST TYPE NOT ALLOWED BY POLICY Μη αποδεκτός τύπος αιτήματος , ο τύπος αιτήματος/πολιτικής δεν είναι κάποιος απο τους επιτρεπτούς (INCREMENTAL/RENEW_ALL_STOCK) )

    Σε επίπεδο αγγελίας:

    Μήνυμα Λάθους Επεξήγηση
    INVALID AGENT Μή έγκυρος agent
    ΙNVALID CONTACT PHONE Μή πιστοποιημένος αριθμός τηλεφώνου επικοινωνίας
    UPDATE NOT ALLOWED BY POLICY Η ενημέρωση της αγγελλίας δεν επιτρέπεται απο την πολιτική
    DELETION NOT ALLOWED BY POLICY Η διαγραφή δεν επιτρέπεται απο την πολιτική
    ITEM NOT FOUND Ο κωδικός αναφοράς δεν βρέθηκε
    IMAGE MANIPULATION FAILED Σφάλμα κατα την επεξεργασία εικόνων
    INVALID AGENT MODERATION POLICY Λάθος πολιτική τροποποίσης για τον agent (moderation/no moderation)
    SYSTEM ERROR Σφάλμα συστήματος, οφείλεται σε εσωτερικό σφάλμα στους servers του xe.gr
    INVALID UPDATE TYPE CHANGED Αδυναμία ενημέρωσης της αγγελίας καθώς αλλάζει ο τύπος της

    Καθώς και άλλα σφάλματα validation της αγγελίας τα οποία είναι περιγραφικά σε κάθε περίπτωση.