Προδιαγραφές XML Ανταλλακτικά & Μικρές αγγελίες Οχήματα Επαληθευτής XML

Οχήματα

Πεδία

Παρακάτω μπορείτε να δείτε συνοπτικά τα πεδία που είναι διαθέσιμα για το XML των οχημάτων. Για τις κατηγορίες με έντονη γραφή, το πεδίο είναι απαραίτητο. Για τις κατηγορίες με κανονική γραφή είναι προαιρετικό. Αν έχετε αμφιβολίες μπορείτε επίσης να συμβουλευτείτε την αντίστοιχη σελίδα καταχώρησης ή δοκιμάστε το αρχείο σας στον επαληθευτή.

Κατηγορίες

Unique ID (unique_id)

Το αναγνωριστικό του προϊόντος για το XML import. Θα πρέπει να είναι μοναδικό για κάθε προϊόν, καθώς με βάση αυτό γίνεται η ενημέρωση των αγγελιών. Αν και το XML με δύο αγγελίες με κοινό unique_id θεωρείται valid, πρακτικά κατά τη διάρκεια του import η μία αγγελία (αυτό που βρίσκεται πιο κάτω μέσα στο αρχείο XML) θα αντικαταστήσει οποιαδήποτε προηγούμενη. Όταν μια αγγελία έχει συσχετιστεί με ένα unique_id και αυτό λείπει στο XML, τότε η αγγελία διαγράφεται. Σε διαφορετική περίπτωση γίνεται ενημέρωση όλων των πεδίων.

Τύπος οχήματος (vtype)

Παρακάτω μπορείτε να βρείτε τον τύπο του οχήματό σας:

Κατέβασε CSV

Κατηγορία οχήματος (category_id)

Παρακάτω μπορείτε να βρείτε την κατηγορία του οχήματος σας:

Κατέβασε CSV

Αναγνωριστικό μάρκας (make_id)

Παρακάτω μπορείτε να βρείτε το αναγνωριστικό της μάρκας σας:

Κατέβασε CSV

Αναγνωριστικό μοντέλου (model_id)

Το μοντέλο του οχήματος, παρακάτω μπορείτε να βρείτε το αναγνωριστικό του μοντέλου σας:

Κατέβασε CSV

Ιδιαιτερότητες (features)

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

Κατέβασε CSV

Μέγιστη απόσταση τεχνικού ελέγχου

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

Πιστοποιητικά Ελέγχου Κατάστασης Οχήματος

Τι είναι τα πιστοποιητικά τεχνικού ελέγχου;

Αποτελείται από 3 επιμέρους πεδία:

provider_id: Το αναγνωριστικό του παρόχου. Μπορείτε να το αναζητήσετε στην λίστα παρακάτω.
report_id: Το αναγνωριστικό της αναφοράς που σας έχει εκδόσει ο πάροχος.
vin_digits: Τα 4 τελευταία ψηφία του αριθμού πλαισίου.

Παρακάτω μπορείτε να βρείτε το αναγνωριστικό του παρόχου πιστοποιητικών:

Leasing extras

Τα διαθέσιμα αναγνωριστικά για τις ιδιαιτερότητες του leasing

Περιγραφή αγγελίας (description)

Περιλαμβάνει την αναλυτική περιγραφή του αντικειμένου που παρουσιάζεται στην αγγελία. Θα πρέπει να είναι το πολύ μέχρι 5000 χαρακτήρες, ενώ η HTML δεν επιτρέπεται.

Τιμή (price)

Η τιμή της αγγελίας θα πρέπει να είναι ένας αριθμός, με μήκος έως 10 ψηφία. Επιπλέον, θα πρέπει να περιλαμβάνει τον Φ.Π.Α. και να είναι σε ευρώ.

Χρηματοδότηση (finance)

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

Επιλογές χρηματοδότησης (finance_options)

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

Το στοιχείο finance_options θα πρέπει να αποτελείται από 3 επιμέρους στοιχεία:

interest: το επιτόκιο, σε ποσοστό %
maxinstallments: ο μέγιστος αριθμός δόσεων
mindownpayment: το ποσό της προκαταβολής, σε ποσοστό %

Online χρηματοδότηση (online_finance)

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

Τιμή πολύτεκνου (multichild_price)

Η τιμή πολυτέκνου της αγγελίας θα πρέπει να είναι ακέραιος αριθμός, με μήκος έως 10 ψηφία. Επιπλέον, θα πρέπει να περιλαμβάνει τον Φ.Π.Α. και να είναι σε ευρώ. Θα πρέπει να είναι μικρότερη της κύριας τιμής.

Τιμή προσφοράς για αυτούς που παρκάρανε την αγγελία (price_parked)

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

Τιμή Χονδρικής (wholesale)

Η τιμή χονδρικής της αγγελίας θα πρέπει να είναι ακέραιος αριθμός σε ευρώ, με μήκος έως 10 ψηφία. Πρέπει να είναι μικρότερη της βασικής τιμής. Είναι προαιρετικό πεδίο και σε περίπτωση που δεν παρέχετε τιμές χονδρικής, μπορείτε να το παραλείψετε.

Φωτογραφίες (photos)

Περιλαμβάνει τα επιμέρους URI των φωτογραφιών που σχετίζονται με την αγγελία. Αν μια φωτογραφία δεν βρεθεί στο URI που παρέχεται στο πεδίο, τότε απλά αγνοείται.

Σημείωση: Τα URIs των φωτογραφιών που παρέχονται δεν θα πρέπει να είναι URL encoded.

Κατάσταση (condition)

Η κατάσταση του αντικειμένου που περιγράφεται στην αγγελία. Μπορεί να έχει 2 τιμές, Μεταχειρισμένο και Καινούριο. Το πεδίο είναι προαιρετικό και η προκαθορισμένη τιμή είναι "Μεταχειρισμένο".

Ρύποι (co2)

Μετριέται σε gr/km

Κατανάλωση εντός πόλης (fuel_city)

Μετριέται σε l/km

Κατανάλωση εκτός πόλης (fuel_motorway)

Μετριέται σε l/km

Κατανάλωση μικτή (fuel_mixed)

Μετριέται σε l/km

Youtube Video (youtube)

URI από βίντεο δημοσιευμένο στο youtube, το οποίο παρουσιάζει το αντικείμενο. Το πεδίο είναι προαιρετικό.

Αυτόματες ανανεώσεις (update_interval και cost_limit)

Μέσω του συγχρονισμού μπορείτε να κάνετε όσες αλλαγές θέλετε στα στοιχεία των αγγελιών σας χωρίς να χρεωθείτε credits όπως συμβαίνει με τις ενέργειες σας στη σελίδα. Με αυτό τον τρόπο ωστόσο δεν ενημερώνεται η ημερομηνία τροποποίησης μιας αγγελίας. Η πιο πρόσφατη ημερομηνία τροποποίησης βοηθάει στο να βρίσκονται οι αγγελίες σας πιο ψηλά στα αποτελέσματα αναζήτησης.

Προκειμένου να ανανεώσετε τις αγγελίες σας μέσω του XML, θα πρέπει να χρησιμοποιήσετε το πεδίο update_interval. Το πεδίο update_interval λέει ουσιαστικά ανά πόσες ημέρες να ανανεώνεται η συγκεκριμένη αγγελία. Το πεδίο ορίζεται ξεχωριστά για τη κάθε μία αγγελία και όχι για όλο τον κατάλογο. Μπορείτε δηλαδή να το ορίσετε μόνο σε συγκεκριμένες αγγελίες αν θέλετε, όχι υποχρεωτικά σε όλες. Μπορείτε επίσης να ορίσετε διαφορετικές τιμές σε διαφορετικές αγγελίες, πχ μικρό update_interval σε πιο σημαντικές αγγελίες που θέλετε να φαίνονται περισσότερο και μεγαλύτερο σε αγγελίες με χαμηλότερη προτεραιότητα.

Αν βάλετε σε μια αγγελία update_interval 0, τότε θα επιχειρείται ανανέωση πάντα κάθως πάντα θα έχει ηλικία μεγαλύτερη από 0 ημέρες. Αν βάλετε τιμή 1 θα επιχειρείται ανανέωση όταν είναι μεγαλύτερη από 1 ημέρα κ.ο.κ. Σε κάθε ανανέωση καταναλώνονται credit ανάλογα την κατηγορία της αγγελίας σύμφωνα με αυτόν τον πίνακα. Οι ανανεώσεις αυτές καταναλώνουν και από τις 200 δωρεάν ημερήσιες ανανεώσεις και από τις επι πληρωμή και εφαρμόζονται πάνω στις αγγελίες με σειρά παλαιότητας, από την πιο παλιά στην πιο καινούρια.

Σαν μέτρο ασφαλείας υπάρχει και το πεδίο cost_limit το οποίο θέτει ένα άνω όριο στο πόσα credits θέλετε να ξοδέψετε κάθε μέρα. Αυτό το πεδίο ισχύει για όλο το αρχείο. Αν πχ βάλετε update_interval 0 σε όλες τις αγγελίες σας και cost_limit 90, αυτό σημαίνει ότι κάθε μέρα θα ανανεώνονται οι 90 πιο παλιές σας αγγελίες ανταλλακτικών (κοστίζουν 1 credit) ή 30 αυτοκίνητα (κοστίζουν 5 credit) ή κάποιος συνδιασμός των 2.

Παράρτημα - Παραδείγματα

Σύντομο παράδειγμα XML

    
  <?xml version="1.0" encoding="UTF-8"?>
  <cardealer>
    <lastupdate>2016-09-13T11:58:10Z</lastupdate>
    <vehicles>
      <vehicle>
          <unique_id>300894</unique_id>
          <description>
              <![CDATA[Μηχανή BMW καινούρια του 2006]]>
          </description>
          <vtype>bike</vtype>
          <category_id>12</category_id>
          <make_id>298</make_id>
          <model_id>2183</model_id>
          <price>3000</price>
        <dealersonly>true</dealersonly>
          <condition>Καινούριο</condition>
          <regiyear>2006</regiyear>
          <regimonth>10</regimonth>
          <power>120</power>
          <engine>1400</engine>
          <color>Κόκκινο σκούρο</color>
          <mileage>120000</mileage>
          <fueltype>Βενζίνη</fueltype>
          <variant>TSI</variant>
          <features>
              <feature>37</feature>
          </features>
              <photos>
                  <photo>http://photos.car.gr/658555_1_t.jpg</photo>
                  <photo>http://photos.car.gr/658555_2_t.jpg</photo>
              </photos>
      </vehicle>
      <vehicle>
          <unique_id>300893</unique_id>
          <description>
              <![CDATA[Opel Astra του 2006 με full extra]]>
          </description>
          <vtype>car</vtype>
          <category_id>12</category_id>
          <make_id>208</make_id>
          <model_id>624</model_id>
          <price>3000</price>
        <multichild_price>2500</multichild_price>
          <wholesale>2900</wholesale>
          <condition>Μεταχειρισμένο</condition>
          <regiyear>2006</regiyear>
          <regimonth>10</regimonth>
          <power>120</power>
          <engine>1400</engine>
          <color>Κόκκινο σκούρο</color>
          <mileage>120000</mileage>
          <fueltype>Βενζίνη</fueltype>
          <variant>TSI</variant>
          <transmission>manual</transmission>
          <drive>4x2</drive>
          <airbags>6</airbags>
          <rim_size>23</rim_size>
          <numplate>even</numplate>
          <seats>5</seats>
          <doors>5</doors>
          <features>
              <feature>160</feature>
          </features>
              <photos>
                  <photo>https://photos.car.gr/1489007_1_b.jpg</photo>
                  <photo>http://photos.car.gr/658555_2_t.jpg</photo>
              </photos>
      </vehicle>
    </vehicles>
  </cardealer>

XML Validator

Παρακάτω μπορείτε να εισάγετε το σύνδεσμο του XML σας για να δείτε αν είναι έγκυρο ή όχι.

ΠΡΟΣΟΧΗ: Μπορείτε να ελέγξετε την ίδια διεύθυνση μόνο μία φορά ανά 1 λεπτό.

Το car.gr διατηρεί το δικαίωμα χρήσης των δεδομένων των αγγελιών που καταχωρούνται.

Για διευκρινίσεις μπορείτε να απευθυνθείτε στο xml@car.gr

Προηγούμενο Επόμενο