fbpx
XML αρχείο skroutz

Οδηγίες για XML αρχείο skroutz

Οι βασικές πληροφορίες και τα υποχρεωτικά πεδία που πρέπει να υπάρχουν σε κάθε προϊόν του αρχείου XML σας για να μπορέσετε να ξεκινήσετε τις πωλήσεις μέσω του skroutz.gr

Τι είναι τα αρχεία .xml;

.xml αρχεία είναι αρχεία που χρησιμοποιούνται από μια ποικιλία εφαρμογών, διότι αυτά αναφέρονται σε αρχεία που είναι γραμμένα σε Extensible Markup Language. Αυτό είναι μια μορφή που περιέχει τις ετικέτες και τα χρησιμοποιεί για τον ορισμό αντικειμένου καθώς και ιδιότητες.

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

Σε γενικές γραμμές το XML αρχείο είναι απαραίτητο να πληροί τις εξής προδιαγραφές:

  1. Να καθορίζει το encoding.
  2. Να παρέχει πληροφορία την ώρα που δημιουργήθηκε.
  3. Να είναι valid.
  4. Να είναι σε συμπιεσμένη μορφή (zip ή gzip) αν το μέγεθος του υπερβαίνει τα 10MB.
  5. Να μην επαναλαμβάνει τα ίδια προϊόντα.
  6. Να περιλαμβάνει τον Φ.Π.Α στις τιμές.

Τα περιεχόμενα του xml αρχείου πρέπει να είναι τα ακόλουθα:

  1. Unique ID
  2. Όνομα (name)
  3. Link προϊόντος (product link)
  4. Link εικόνας (image link)
  5. Τιμή (price)
  6. Διαθεσιμότητα (availability)
  7. Κατηγορία (category name)
  8. Κατασκευαστής (manufacturer)
  9. MPN
  10. Βάρος (weight)

 

Unique ID
Αν αλλάξει o τίτλος ενός προϊόντος ώστε να αφορά διαφορετικό μοντέλο (π.χ. από Sony LDF700, γίνει Sony LDF800), το προϊόν θα απενεργοποιηθεί. Τα Unique ID πρέπει πάντα να αφορούν το ίδιο προϊόν.

Το Unique ID δεν μπορεί να υπάρχει σε παραπάνω από ένα προϊόν. Αν υπάρχει παραπάνω από μία φορά μέσα στο feed, τότε το προϊόν θα αποθηκευθεί με τα στοιχεία της τελευταίας σε σειρά εμφάνισης.

Σε περίπτωση που το commerce engine σας υποστηρίζει παραπάνω από μία γλώσσες, τα προϊόντα θα πρέπει να περιλαμβάνονται ΜΟΝΟ μία φορά και κατά προτίμηση στα Ελληνικά.

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

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

Product Link
Είναι ο σύνδεσμος που οδηγεί στη σελίδα του καταστήματός σας για το συγκεκριμένο προϊόν. Θα πρέπει να είναι έγκυρος σύνδεσμος και να ξεκινάει με https.

Image Link
Είναι η εικόνα (φωτογραφία) του προϊόντος. Πρέπει να είναι σύνδεσμος σε εικόνα και να ξεκινάει με https. Scripts που παράγουν εικόνες υπάρχει πιθανότητα να μη λειτουργούν σωστά, γι’ αυτό και είναι προτιμητέο ο σύνδεσμος να οδηγεί στο πραγματικό αρχείο.

Όσο πιο μεγάλη είναι η εικόνα, τόσο το καλύτερο. Οι εικόνες αποθηκεύονται από το Skroutz και δημιουργείται ένα κατάλληλου μεγέθους thumbnail.

Η αποστολή φωτογραφιών με ενσωματωμένο το λογότυπο του καταστήματος ή οποιοδήποτε υδατογράφημα ΔΕΝ επιτρέπεται.

Τα links ΔΕΝ πρέπει να είναι URL-encoded.

Αποφύγετε να βάζετε “Νο Image” εικόνες γιατί αν αργότερα την αλλάξετε, το Skroutz δεν θα την ανανεώσει. Αν κάποιο προϊόν σας δεν έχει φωτογραφία, στείλτε ως σύνδεσμο το κενό string. Όταν αργότερα προστεθεί η εικόνα, το σύστημα θα καταλάβει τη διαφορά και θα την ανανεώσει.

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

Οδηγίες για XML αρχείο skroutz

Category Name
Είναι η κατηγορία του προϊόντος. Είναι απαραίτητο να περιλαμβάνει όλη τη διαδρομή μέχρι την κατηγορία του προϊόντος.

Price
Είναι η τιμή του προϊόντος με Φ.Π.Α.. Αν η τιμή δεν περιλαμβάνει Φ.Π.Α., θα προστεθεί το ανώτατο ποσοστό για όλα τα είδη των προϊόντων.

Η τιμή θα πρέπει να είναι ίδια για όλους και να μην έχει προϋποθέσεις εφαρμογής.

Το πεδίο τιμής μπορεί να δεχτεί μέχρι 2 δεκαδικά ψηφία.

Availability
Το πεδίο αυτό πρέπει να αναφέρει την έκφραση διαθεσιμότητας που χρησιμοποιείτε και στο site σας.

To Skroutz χρησιμοποιεί ένα προκαθορισμένο σύνολο από εκφράσεις διαθεσιμότητας, οι οποίες διασταυρώνονται με αυτές που περιλαμβάνονται στο XML σας.

  • Άμεση παραλαβή / Παράδοση 1 έως 3 ημέρες
    αφορά στα ηλεκτρονικά καταστήματα που έχουν και φυσική παρουσία. Αυτό σημαίνει πως διαθέτουν το προϊόν στο κατάστημα και υπάρχει δυνατότητα παραλαβής από το χώρο του φυσικού καταστήματος.
  • Παράδοση σε 1 – 3 ημέρες
    αφορά προϊόντα τα οποία δεν είναι άμεσα διαθέσιμα στο κατάστημα (φυσικό ή ηλεκτρονικό), αλλά ενδέχεται να είναι διαθέσιμα για αποστολή από την αποθήκη ή/και τον εκάστοτε προμηθευτή του καταστήματος.
  • Παράδοση σε 4 – 10 ημέρες
    αφορά προϊόντα τα οποία δεν είναι άμεσα διαθέσιμα στο κατάστημα, αλλά σε κάθε περίπτωση θα παραδοθούν εντός αυτού του διαστήματος.
  • Κατόπιν Παραγγελίας
    αφορά προϊόντα τα οποία δεν υπάρχουν σε απόθεμα και παραδίδονται μόνο κατόπιν παραγγελίας. Στα προϊόντα αυτά ο χρόνος παράδοσης σε καμία περίπτωση δε μπορεί να ξεπερνάει τις 30 ημερολογιακές ημέρες, δηλαδή, το μέγιστο όριο που ορίζεται από τη νομοθεσία για το ηλεκτρονικό εμπόριο και τις πωλήσεις από απόσταση.

Manufacturer
Ο κατασκευαστής του προϊόντος.
Ο κατασκευαστής θα πρέπει να περιλαμβάνεται και στον τίτλο, ανεξάρτητα από το αν περιλαμβάνεται και στο πεδίο κατασκευαστή.

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

EAN / Barcode
Ο διεθνής αριθμός είδους (EAN) που χρησιμοποιείται για την ταυτοποίηση των προϊόντων λιανικής.

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

MPN / ISBN
Είναι ο μοναδικός κωδικός που δίνει ο κατασκευαστής στα προϊόντα του. Χρησιμοποιείται για την ταυτοποίηση των προϊόντων σε περίπτωση που αυτό δεν είναι εμφανές από το μοντέλο.

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

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

InStock
Η κατάσταση του αποθέματος (stock) του προϊόντος.

  • Y
    σημαίνει ότι το προϊόν υπάρχει σε stock, δηλαδή είναι ετοιμοπαράδοτο και υπάρχει στην αποθήκη σας ή στο κατάστημά σας.
  • N
    σημαίνει ότι το προϊόν δεν υπάρχει σε stock.

Όταν δεν υπάρχει πληροφορία από το κατάστημα, το πεδίο αυτό θεωρείται ότι έχει την τιμή N.

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

Το κόστος αυτό είναι ΑΝΕΞΑΡΤΗΤΟ του βάρους και της τοποθεσίας αποστολής. Αν τα μεταφορικά σας έχουν προϋποθέσεις, αυτό το πεδίο είναι υποχρεωτικό να είναι κενό.

Αν τα μεταφορικά δεν ισχύουν έστω και για ένα προϊόν, θα απενεργοποιηθούν για όλα τα προϊόντα του XML.

Color
To χρώμα του προϊόντος. Το πεδίο χρώματος λειτουργεί ως χαρακτηριστικό του συγκεκριμένου προϊόντος και δεν μπορεί να περιλαμβάνει διαφορετικές καταχωρίσεις προϊόντων.

Οφείλει να περιέχει το χρώμα του προϊόντος που αποτυπώνεται στην εικόνα που το συνοδεύει.

Εφόσον για κάποιο μοντέλο υπάρχουν περισσότερα του ενός χρώματα, αυτά πρέπει να στέλνονται ως διαφορετικά προϊόντα με ξεχωριστό Unique ID.

Όταν ολοκληρώσετε τις απαραίτητες εργασίες με το XML θα το στείλετε στην Skroutz να το ελέγξουν. Εφόσον σας εγκρίνουν θα πρέπει να κάνετε την απαραίτητη πληρωμή κι έπειτα θα πρέπει να συμπληρώσετε τα στοιχεία καταστήματος και να ορίσετε τα κόστη αποστολών και να ρυθμίσετε τις πληρωμές.

Για περισσότερες πληροφορίες εδώ

https://developer.skroutz.gr/el/feedspec/