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

Τι πρότυπο να επιλέξω;

Το car.gr μπορεί να δεχτεί 2 ειδών πρότυπα, το Car.gr XML και XML γενικού εμπορίου. Το ποιο θα επιλέξετε εξαρτάται από το τι είδους κατάλογο έχετε και τι δυνατότητες θέλετε να χρησιμοποιήσετε. Ακολουθεί ένας συνοπτικός πίνακας με τις διαφορές για να σας βοηθήσει να επιλέξετε.

Car.gr XML XML γενικού εμπορίου
Οχήματα Υποστηρίζει πλήρως Οχήματα Μόνο ποδήλατα
Ανταλλακτικά Υποστηρίζονται πλήρως Υποστηρίζονται, αλλά δεν μπορείτε να βάλετε μάρκα-μοντέλο εφαρμογής (πχ ότι ταιριάζει σε VW Golf του '08)
Μικρές αγγελίες Ναι Ναι
Αντιστοίχιση κατηγοριών Πρέπει να γίνει εκ των προτέρων από εσάς, ώστε στο αρχείο να υπάρχουν έτοιμα τα αναγνωριστικά του car.gr Μπορεί να γίνει εκ των υστέρων με ειδικό μενού στο πάνελ σας
Κόστος υλοποίησης Πιθανόν να χρειαστείτε custom υλοποίηση, απευθυνθείτε στον κατασκευαστή της ιστοσελίδας/e-shop σας Πιθανόν να το έχετε ήδη έτοιμο και να λειτουργεί σε κάποια πλατφόρμα σύγκρισης τιμών

Car.gr XML

Συνοπτικά, θα πρέπει το αρχείο XML να πληρεί τις παρακάτω προδιαγραφές:
  • Να καθορίζει το encoding.
  • Να υπάρχει η πληροφορία για την ώρα και ημερομηνία τελευταίας τροποποίησης.
  • Να είναι valid σύμφωνα με τα πρότυπα w3 (μπορείτε να το ελέγξετε εδώ).
  • Η κάθε αγγελία να έχει το δικό της, μοναδικό unique ID.
  • Να περιλαμβάνει τον Φ.Π.Α. στις τιμές που αναφέρονται.

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

XML Declaration

Το XML θα πρέπει να είναι κωδικοποιημένο σε UTF-8. Το πεδίο ημερομηνίας τροποποίησης (πεδίο lastupdate) δείχνει την ημερομηνία της τελευταίας τροποποίησης του XML σε μορφή ISO 8601 (δείτε εδώ λεπτομέρειες για τη μορφή ημερομηνίας). Παρακάτω μπορείτε να δείτε ένα παράδειγμα για το πώς πρέπει να ξεκινά το αρχείο.

  
        <?xml version="1.0" encoding="UTF-8"?>
        <cardealer>
        <lastupdate>2016-01-25T10:45:00Z</lastupdate>
        ...
        </cardealer>
        
Σημείωση: Σε περίπτωση που δεν ενημερώνεται το πεδίο lastupdate με την ημερομηνία τροποποίησης του αρχείου, δεν θα γίνεται ενημέρωση προϊόντων. Το πεδίο αυτό υποδεικνύει ότι υπάρχει κάποια ενημέρωση στα προϊόντα, και δεν θα πρέπει να έχει πάντα την τρέχουσα ημερομηνία.

Μέγεθος και τύπος αρχείου

Οι τύποι αρχείου που μπορούμε να δεχτούμε είναι .xml ή συμπιεσμένες μορφές .zip και .gz.
  • Το συνολικό μέγεθος του αρχείου δεν πρέπει να υπερβαίνει τα 100 ΜΒ (ασυμπίεστο).
  • Ο συνολικός αριθμός αγγελιών να μην υπερβαίνει τις 60.000.

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

  
        <?xml version="1.0" encoding="UTF-8"?>
        <cardealer>
            <lastupdate>2017-08-02T13:07:29Z</lastupdate>
            <include>https://www.mysite.gr/path_to_file_1.xml</include>
            <include>https://www.mysite.gr/path_to_file_2.xml</include>
            <include>https://www.mysite.gr/path_to_file_3.xml</include>
        </cardealer>
      

Κόστος και κανόνες

Η υπηρεσία του συγχρονισμού δεν έχει κάποιο κόστος. Ωστόσο υπόκειται σε κάποιους κανόνες. Όταν κάνετε κάποια χειροκίνητη καταχώριση ή τροποποίηση αγγελίας από την σελίδα του car.gr χρεώνεστε κάποια credit, ενημερώνεται η ημερομηνία τροποποίησης της αγγελίας και ανεβαίνετε στην κορυφή των αποτελεσμάτων. Στην υπηρεσία του συγχρονισμού όμως, οι αλλαγές δεδομένων και οι ανανεώσεις αγγελιών είναι δύο ανεξάρτητες ενέργειες. Μπορείτε να κάνετε όσες αλλαγές θέλετε δωρεάν, χωρίς να καταναλώνονται credits, ωστόσο οι αλλαγές αυτές δεν ενημερώνουν την ημερομηνία τροποποίησης της αγγελίας και κάθε καινούρια αγγελία ξεκινάει με ηλικία 20 ημερών.
Εάν επιθυμείτε να ανανεώσετε τις αγγελίες σας, μπορείτε να υλοποιήσετε τον μηχανισμό update_interval που περιγράφεται παρακάτω ή από τον Πίνακα Ελέγχου σας. Δεν μπορείτε να διαγράφετε τον κατάλογο σας και να τον ξαναεισάγετε με άλλους κωδικούς.

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

XSD ανταλακτικών και οχημάτων