Ανταλλακτικά & Μικρές αγγελίες

Πεδία

Unique ID (unique_id)

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

ΠΡΟΣΟΧΗ: Εάν έχετε ήδη αγγελίες στο car.gr, αυτές που έχουν Κωδικό Καταστήματος είναι το υποσύνολο που θα επηρεαστεί. Οι κωδικοί που δεν υπάρχουν στο XML θα διαγραφούν, κι αν είναι διαφορετικοί, θα αντικατασταθούν από αυτούς που έχετε στο XML. Γενικά το αρχείο σας πρέπει να αναπαριστά το σύνολο του καταλόγου που θέλετε να προβάλλετε. Φροντίστε στο XML να υπάρχουν όλοι οι κωδικοί που έχετε και στον κατάλογο σας για να μην έχετε απώλεια δεδομένων.

Τίτλος αγγελίας (title)

Περιλαμβάνει τον τίτλο της αγγελίας. Ο τίτλος θα πρέπει να είναι το πολύ μέχρι 200 χαρακτήρες.

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

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

Κατηγορία (category_id)

Η κατηγορία στην οποία θα τοποθετηθεί η αγγελία. Θα πρέπει να είναι ένα ακέραιο ID από τη λίστα κατηγοριών.

Τιμή (price)

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

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

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

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

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

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

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

Μοντέλα αυτοκινήτων (makemodels)

Τα μοντέλα αυτοκινήτων στα οποία "ταιριάζει" το ανταλλακτικό της συγκεκριμένης αγγελίας. Το στοιχείο περιλαμβάνει 4 επιμέρους χαρακτηριστικά, τα:
make, model, yearfrom, yearto.

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

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

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

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

Εξωτερικός σύνδεσμος (external_link)

Εξωτερικός σύνδεσμος για το προϊόν που οδηγεί σε κάποιο e-shop για απευθείας αγορά ή σελίδα με περισσότερες πληροφορίες. Το πεδίο είναι προαιρετικό.

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.

Εμφάνιση μόνο σε εμπόρους (dealersonly)

Μπορείτε να θέσετε αυτό το πεδίο στις αγγελίες σας για να φαίνονται μόνο σε εμπόρους.

Εξτρα πεδία (extra_fields)

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

Το κάθε extra_field αποτελείται από:

Το name αντικατοπτρίζει το όνομα του πεδίου.

Online Αγορά (weight_kg, availability, stock_count)

Με αυτά τα 3 πεδία μπορείτε να συμπεριλάβετε την αγγελία στην Online Αγορά του Car.gr. Εξ αρχής δεν είναι υποχρεωτικά, αλλά αν συμπληρωθεί έστω ένα από αυτήν την τριάδα, τότε και τα υπόλοιπα 2 γίνονται υποχρεωτικά. Απαιτούνται ειδικά δικαιώματα για να ενεργοποιηθούν.

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

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

  
    <?xml version="1.0" encoding="UTF-8"?>
    <cardealer>
        <lastupdate>2016-01-25T10:45:00Z</lastupdate>
        <classifieds>
            <classified>
                <unique_id>1112313111</unique_id>
                <manufacturer_number>DFGGAVD5884</manufacturer_number>
                <aftermarket_number>943AVD5884</aftermarket_number>
                <title><![CDATA[Δεξί εμπρός φανάρι για CITROEN C4 PI234CASSO]]></title>
                <description><![CDATA[Φανάρι εμπρός ελαφρώς μεταχειρισμένο]]></description>
                <category_id>101</category_id>
                <category_id>102</category_id>
                <price>31.00</price>
                <makemodels>
                    <makemodel>
                        <make>CITROEN</make>
                        <model>C4 PICASSO</model>
                        <yearfrom>2006</yearfrom>
                        <yearto>2013</yearto>
                    </makemodel>
                    <makemodel>
                        <make>CITROEN</make>
                        <model>C4 PICASSO</model>
                        <yearfrom>2013</yearfrom>
                        <yearto>2016</yearto>
                    </makemodel>
                </makemodels>
                <photos>
                    <photo>http://photos.car.gr/658555_1_t.jpg</photo>
                    <photo>http://photos.car.gr/658555_2_t.jpg</photo>
                </photos>
                <condition>Μεταχειρισμένο</condition>
            </classified>
        </classifieds>
    </cardealer>

Λίστα Κατηγοριών ανταλλακτικών