Προδιαγραφές XML feed για Skroutz: όλα τα πεδία

Η δομή του αρχείου

Το root element είναι ελεύθερο (π.χ. <mywebstore>) και μέσα του: το <created_at> — timestamp δημιουργίας στη μορφή YYYY-MM-DD HH:MM — και το <products> με τα <product> elements. Αν το timestamp λείπει → λείπει ημερομηνία δημιουργίας· αν είναι παλαιότερο από 48 ώρες → μπαγιάτικο feed. Συνιστάται καθημερινή ανανέωση. Κενό <products>; → κανένα προϊόν στο feed.

Το αρχείο πρέπει να είναι έγκυρο XML (άκυρο XML = όλο το κατάστημα εκτός) με σωστά δηλωμένο encoding — UTF-8, ISO-8859-7 ή windows-1253 (λάθος encoding = αλαμπουρνέζικα ελληνικά). Αρχεία πάνω από 10MB πρέπει να είναι συμπιεσμένα (gzip/zip).

Τα υποχρεωτικά πεδία, ένα-ένα

Για κάθε πεδίο: το όριο ή η μορφή του, και τι σπάει όταν λείπει ή είναι λάθος:

• Μοναδικό ID (id) — έως 200 χαρακτήρες, σταθερό, μοναδικό στο feed. → Λείπει ID · Διπλότυπο ID
• Όνομα (name) — έως 300 χαρακτήρες, με κατασκευαστή, μοντέλο, χρώμα. → Λείπει όνομα · Πάνω από 300 χαρ. · Διπλότυπο όνομα
• Link (link) — έως 1000 χαρακτήρες, HTTPS, σελίδα προϊόντος (όχι κατηγορίας), χωρίς session IDs. → Λείπει link · Χωρίς HTTPS · Διπλότυπο link
• Εικόνα (image) — έως 400 χαρακτήρες, HTTPS, όχι AVIF, τουλάχιστον 1000px στη μία διάσταση. → Λείπει εικόνα · Χωρίς HTTPS · Προβληματικό URL · Λάθος κατάληξη
• Κατηγορία (category) — έως 250 χαρακτήρες, ΠΛΗΡΕΣ μονοπάτι, π.χ. «Ηλεκτρονικά > Hardware > Δίσκοι». → Λείπει κατηγορία · Ελλιπές μονοπάτι
• Τιμή (price) — με ΦΠΑ, έως 2 δεκαδικά, EUR. → Λείπει τιμή · Άκυρη τιμή
• ΦΠΑ (vat) — 0–100%, έως 2 δεκαδικά· αν λείπει, εφαρμόζεται ο μέγιστος συντελεστής. → Λείπει ΦΠΑ · Άκυρος ΦΠΑ
• Διαθεσιμότητα (availability) — έως 60 χαρακτήρες, ΜΟΝΟ από την επιτρεπτή λίστα (βλ. παρακάτω). → Λείπει · Εκτός λίστας
• Κατασκευαστής (manufacturer) — έως 100 χαρακτήρες, ο πραγματικός κατασκευαστής. → Λείπει brand
• MPN/ISBN (mpn) — έως 80 χαρακτήρες, ποτέ δεν επινοείται. → Λείπει MPN · Διπλότυπο MPN
• EAN (ean) — έως 13 ψηφία, ποτέ δεν επινοείται. → Άκυρο EAN · Λάθος check digit · Λείπει EAN
• Περιγραφή (description) — έως 10.000 χαρακτήρες, ΧΩΡΙΣ HTML. → HTML σε πεδίο · Φτωχή περιγραφή
• Απόθεμα (quantity) — ακέραιος 0–9.999.999. → Λείπει · Άκυρο

Καλό να ξέρεις: τα εναλλακτικά ονόματα tags

Ο parser των πλατφορμών (και του FeedClinic) δέχεται εναλλακτικά ονόματα tags — π.χ. id/UniqueID/PRODUCTID, name/title, link/url, image/imageurl. Δεν χρειάζεται να μετονομάσεις τα tags του plugin σου· αρκεί το περιεχόμενο να είναι σωστό.

Τα 4 επιτρεπτά availability strings (ΑΚΡΙΒΩΣ έτσι)

Ελεύθερο κείμενο («Σε στοκ», «Κατόπιν παραγγελίας») μπορεί να μην ερμηνευτεί σωστά — αναλυτικά, και πώς γίνεται αυτόματη κανονικοποίηση, στον οδηγό availability strings. Τα ακριβή strings:

• Άμεσα διαθέσιμο
• Διαθέσιμο από 1 έως 3 ημέρες
• Διαθέσιμο από 4 έως 6 ημέρες
• Διαθέσιμο από 7 έως 12 ημέρες

Προαιρετικά πεδία με μια ματιά

Έξτρα εικόνες (έως 15/προϊόν), size (μόνο ρούχα/παπούτσια), weight, shipping, color, wholesale_price (χωρίς ΦΠΑ), outlet (Y/N), author (βιβλία), expiration_date, country_of_origin, specifications (key-value χαρακτηριστικά). Για μεγέθη υπάρχουν και <variations> με δικά τους required πεδία (variationid, availability, size, quantity).

Οι γενικοί κανόνες που πιάνουν τους περισσότερους

• Κανένα HTML σε κανένα πεδίο — ο πιο συχνός «αόρατος» παραβάτης είναι η περιγραφή που έρχεται με <p> και <br> από το e-shop
• Τιμές πάντα με ΦΠΑ
• Τα IDs δεν επαναλαμβάνονται μέσα στο feed
• Όχι URL encoding στα links

Πώς ελέγχεις το δικό σου feed απέναντι σε όλα αυτά

Κανείς δεν διαβάζει 13 πεδία × 5.000 προϊόντα με το μάτι. Επικόλλησε το URL του feed σου στη δωρεάν διάγνωση του FeedClinic — σε περίπου 1 λεπτό παίρνεις αναφορά με κάθε απόκλιση από τις παραπάνω προδιαγραφές, ταξινομημένη ανά σοβαρότητα, με εξήγηση και προτεινόμενη διόρθωση. Ό,τι είναι τεχνικά ασφαλές (encoding, HTML, availability, διπλότυπα, http→https) διορθώνεται και αυτόματα, με καταγραφή πριν/μετά.

Σχετικά: τα 10 πιο συχνά λάθη σε XML feed · όλα τα σφάλματα feed · οι διαφορές της μορφής BestPrice.