Skroutz PrestaShop Module
01 Skroutz Module — Οδηγός Χρήσης
Αυτό το πρόσθετο συνδέει το PrestaShop κατάστημά σας με το Skroutz με τρεις τρόπους:
- Ροή XML Προϊόντων — δημιουργεί τη ροή προϊόντων που χρειάζεται το Skroutz για να καταχωρήσει τα προϊόντα σας.
- Skroutz Analytics — αναφέρει τις πωλήσεις σας στο Skroutz ώστε να μετρούν πόσο αποδοτική είναι η επισκεψιμότητα που σας στέλνουν.
- Παραγγελίες Skroutz Marketplace (Smart Cart) — λαμβάνει τις παραγγελίες που γίνονται στο Skroutz απευθείας στις παραγγελίες του PrestaShop, και σας επιτρέπει να τις αποδεχτείτε, να τις απορρίψετε και να τις αποστείλετε από το PrestaShop.
Μπορείτε να χρησιμοποιήσετε οποιοδήποτε από τα τρία ανεξάρτητα — για παράδειγμα, μπορείτε να χρησιμοποιήσετε μόνο τη ροή XML χωρίς να ενεργοποιήσετε ποτέ τις Παραγγελίες ή το Analytics.
Όλες οι ρυθμίσεις βρίσκονται στο Modules → Module Manager → 01 Skroutz Module → Configure, οργανωμένες σε καρτέλες (Skroutz Analytics, Order Settings), καθώς και σε δύο ξεχωριστές οθόνες στο Catalog → Skroutz XML και Orders → Skroutz Orders.
Ροή XML Προϊόντων
1.1 Δημιουργία ροής
Μεταβείτε στο Catalog → Skroutz XML → Add new feed. Μπορείτε να δημιουργήσετε περισσότερες από μία ροές (για παράδειγμα, μία ανά κατηγορία ή μάρκα) αν χρειαστεί ποτέ. Κάθε ροή έχει τις δικές της ρυθμίσεις:
| Ρύθμιση | Τι κάνει |
|---|---|
| Name | Μια ετικέτα για εσάς, για να ξεχωρίζετε τις ροές στη λίστα. |
| Unique ID | Ποιο πεδίο προϊόντος θα χρησιμοποιεί το Skroutz ως μόνιμο ID του προϊόντος. Συστήνεται το Product ID — υπάρχει πάντα. Αν επιλέξετε Reference/EAN13/UPC και κάποιο προϊόν δεν έχει αυτή την τιμή, το πρόσθετο αυτόματα επιστρέφει στο Product ID για αυτό το προϊόν, ώστε να μην έχετε ποτέ κενό ή διπλό ID. |
| MPN | Ποιο πεδίο στέλνεται ως κωδικός κατασκευαστή. Οι περισσότεροι χρησιμοποιούν τον Κωδικό Αναφοράς. |
| Choose Size Attributes / Choose Color Attributes | Πείτε στο πρόσθετο ποιες από τις ομάδες χαρακτηριστικών του καταστήματός σας αντιστοιχούν σε μέγεθος και χρώμα (π.χ. η ομάδα χαρακτηριστικών "Χρώμα"). Έτσι ξέρει το πρόσθετο πώς να χωρίσει σωστά τα προϊόντα — το Skroutz απαιτεί κάθε χρώμα να υποβάλλεται ως ξεχωριστό προϊόν, οπότε αυτή η ρύθμιση είναι σημαντική. Αν ένα προϊόν έχει παραλλαγές χρώματος και δεν έχετε ορίσει Χαρακτηριστικά Χρώματος, η δημιουργία της ροής θα εμφανίσει σφάλμα μέχρι να το ρυθμίσετε. |
| Categories | Μόνο τα προϊόντα από τις επιλεγμένες κατηγορίες μπαίνουν σε αυτή τη ροή. Αφήστε το κενό για να συμπεριληφθεί όλο το ενεργό κατάλογό σας. |
| Brands | Μόνο τα προϊόντα από τις επιλεγμένες μάρκες μπαίνουν σε αυτή τη ροή. Αφήστε το κενό για όλες τις μάρκες. |
| Language | Σε ποια γλώσσα του καταστήματος θα είναι τα ονόματα προϊόντων/περιγραφές/ονόματα κατηγοριών στη ροή. |
| Description | Αν θα σταλεί περιγραφή, και από ποιο πεδίο (σύντομη, κύρια, ή και τα δύο). |
| Weight Metric | Αν τα βάρη στέλνονται σε κιλά ή γραμμάρια. |
| Include Tax at price | Αν η τιμή που στέλνεται στο Skroutz συμπεριλαμβάνει ΦΠΑ ή όχι. |
| Include compinations/attributes | Αν θα γίνεται διάσπαση των προϊόντων με παραλλαγές στη δομή χρώματος/μεγέθους. Απενεργοποιήστε το μόνο για ροές όπου θέλετε πραγματικά μία απλή εγγραφή ανά προϊόν, ανεξάρτητα από τις παραλλαγές του. |
| Include stock | Αν στέλνονται οι πραγματικές ποσότητες αποθέματος του PrestaShop. Αν είναι ανενεργό, κάθε προϊόν αναφέρεται ως πάντα διαθέσιμο — χρήσιμο αν δεν παρακολουθείτε απόθεμα ανά προϊόν. |
| In stock / Out of stock Availability Text | Πρέπει να ταιριάζουν ακριβώς με το κείμενο που χρησιμοποιεί το ίδιο το κατάστημά σας για "διαθέσιμο" και "μη διαθέσιμο". |
Μόλις αποθηκευτεί, η οθόνη λίστας δείχνει τρία χρήσιμα στοιχεία για κάθε ροή:
- CRON links — μια έτοιμη εντολή για τον προγραμματισμό αυτόματης ανανέωσης (δείτε παρακάτω).
- XML link — ο πραγματικός σύνδεσμος της ροής. Αυτός είναι ο σύνδεσμος που δίνετε στο Skroutz όταν ρυθμίζετε τη ροή προϊόντων σας στο εργαλείο εμπόρων τους.
- Last Update — πότε ολοκληρώθηκε τελευταία φορά η δημιουργία της ροής, και αν ήταν επιτυχής.
1.2 Δημιουργία της ροής
Χειροκίνητα: πατήστε Generate Feed στη γραμμή της ροής. Ένα αναδυόμενο παράθυρο δείχνει πρόοδο σε πραγματικό χρόνο με ποσοστό και αριθμό προϊόντων που γράφτηκαν. Μπορείτε να συνεχίσετε να δουλεύετε στο διαχειριστικό όσο τρέχει — επεξεργάζεται τον κατάλογο σε μικρά κομμάτια στο παρασκήνιο, οπότε λειτουργεί ακόμα και σε πιο αργό/κοινόχρηστο hosting.
Αυτόματα (συστήνεται): αντιγράψτε τον σύνδεσμο CRON που εμφανίζεται στη λίστα ροών και ρυθμίστε μια προγραμματισμένη εργασία με τον πάροχο φιλοξενίας σας (ή οποιαδήποτε υπηρεσία "cron job") για να καλεί αυτόν τον σύνδεσμο μία φορά την ημέρα. Το Skroutz αναμένει η ροή σας να ανανεώνεται τουλάχιστον μία φορά την ημέρα.
1.3 Αν η δημιουργία αναφέρει σφάλμα
Η πιο συχνή αιτία είναι ένα προϊόν με παραλλαγές χρώματος χωρίς να έχουν οριστεί Χαρακτηριστικά Χρώματος στη ροή — ρυθμίστε το στην οθόνη επεξεργασίας της ροής και δημιουργήστε ξανά.
Skroutz Analytics
Αυτό αναφέρει τις ολοκληρωμένες πωλήσεις στο Skroutz ώστε να μπορούν να σας δείξουν (και να βελτιστοποιήσουν) πόσο αποδίδει η επισκεψιμότητά τους στο κατάστημά σας. Το χρειάζεστε μόνο αν διαφημίζεστε μέσω Skroutz Ads/σύγκριση τιμών — δεν είναι απαραίτητο για τη λειτουργία Marketplace/Smart Cart.
Μεταβείτε στην καρτέλα Configure → Skroutz Analytics:
| Ρύθμιση | Τι κάνει |
|---|---|
| Enable Analytics | Κεντρικός διακόπτης ενεργοποίησης/απενεργοποίησης. |
| Skroutz Analytics ID | Βρίσκεται στον λογαριασμό σας ως έμπορος στο Skroutz, έχει τη μορφή SA-XXXX-YYYY. Απαιτείται όταν το Analytics είναι ενεργό. |
| Remove COD fee from revenue | Αν χρεώνετε επιπλέον τους πελάτες για πληρωμή με Αντικαταβολή, ενεργοποιήστε το ώστε αυτή η χρέωση να μην υπολογίζεται ως πραγματικό έσοδο όταν αναφέρεται στο Skroutz. |
| Choose your Cash On Delivery modules | Επιλέξτε όποιο/α πρόσθετο/α πληρωμής στο κατάστημά σας αντιστοιχούν σε "πληρωμή κατά την παράδοση". Αν δεν έχετε κάποιο, επιλέξτε την επιλογή "I have no COD module" στο τέλος της λίστας. |
| Choose XML | Ποια ροή (με τις ρυθμίσεις της: Unique ID, Χαρακτηριστικά Χρώματος, κλπ.) χρησιμοποιείται για την αναγνώριση των προϊόντων στις αναφερόμενες πωλήσεις. Πρέπει να είναι η ίδια ροή που έχετε υποβάλει στο Skroutz — τα ID προϊόντων που αναφέρονται εδώ πρέπει να ταιριάζουν με όσα ήδη γνωρίζει το Skroutz από τη ροή σας. |
Μόλις ενεργοποιηθεί, δεν χρειάζεται να κάνετε τίποτα άλλο — η παρακολούθηση γίνεται αυτόματα σε κάθε σελίδα και σε κάθε ολοκληρωμένη παραγγελία.
Παραγγελίες Skroutz Marketplace (Smart Cart)
Αυτό είναι για καταστήματα που πωλούν μέσω Skroutz Marketplace: οι πελάτες αγοράζουν στο Skroutz, και η παραγγελία πρέπει να καταλήξει στο PrestaShop σας.
3.1 Μία φορά ρύθμιση στο εργαλείο εμπόρων του Skroutz
Μεταβείτε στο Configure (η κύρια σελίδα ρυθμίσεων του πρόσθετου, κάντε scroll στην ενότητα Webhook). Θα δείτε έναν έτοιμο σύνδεσμο webhook — αντιγράψτε τον στην περιοχή εμπόρων του Skroutz, στο Marketplace → Configure → Webhook URL. Έτσι ειδοποιείται το κατάστημά σας τη στιγμή που γίνεται μια παραγγελία ή αλλάζει η κατάστασή της.
Θα χρειαστείτε επίσης ένα Orders API token από το Skroutz (ζητήστε το από τον υπεύθυνο του λογαριασμού σας στο Skroutz, ή βρείτε το στην ενότητα API/ολοκληρώσεις του εργαλείου εμπόρων σας) — αυτό επιτρέπει στο κατάστημά σας να επικοινωνεί με το Skroutz (αποδοχή παραγγελιών, αποστολή κωδικών παρακολούθησης, κλπ.).
3.2 Ρυθμίσεις — καρτέλα Configure → Order Settings
| Ρύθμιση | Τι κάνει |
|---|---|
| Enable API Orders creation | Όταν είναι ενεργό, κάθε παραγγελία Skroutz γίνεται πραγματική παραγγελία στη λίστα παραγγελιών του PrestaShop, με τον πελάτη, τα προϊόντα και την τιμή ακριβώς όπως πωλήθηκαν στο Skroutz. |
| Enable stock management for marketplace orders | Μια εναλλακτική στο παραπάνω: αντί να δημιουργείται παραγγελία στο PrestaShop, το πρόσθετο απλά μειώνει το απόθεμά σας κατά την ποσότητα που πωλήθηκε στο Skroutz (και το επαναφέρει αν η παραγγελία ακυρωθεί/απορριφθεί/επιστραφεί αργότερα). Χρησιμοποιήστε το αν προτιμάτε να διαχειρίζεστε τις παραγγελίες Skroutz εντελώς από το δικό τους dashboard και θέλετε απλά να παραμένει σωστό το απόθεμα στο PrestaShop. Μπορείτε να ενεργοποιήσετε μόνο ένα από τα δύο τη φορά. |
| Choose XML for API orders | Ποια ροή χρησιμοποιείται για να αντιστοιχίζονται τα προϊόντα/παραλλαγές μιας εισερχόμενης παραγγελίας Skroutz με τα πραγματικά προϊόντα του PrestaShop σας. Χρησιμοποιήστε την ίδια ροή που υποβάλατε στο Skroutz. |
| Orders API | Επικολλήστε εδώ το Orders API token σας από το Skroutz. |
| Accept mode for new Skroutz orders | Manual: κάθε νέα παραγγελία περιμένει να πατήσετε εσείς Αποδοχή/Απόρριψη από τη σελίδα της παραγγελίας. Auto: το πρόσθετο αποδέχεται την παραγγελία στο Skroutz αυτόματα τη στιγμή που δημιουργείται στο PrestaShop (με μια προεπιλεγμένη επιλογή παραλαβής) — χρησιμοποιήστε το μόνο αν είστε σίγουροι ότι μπορείτε πάντα να εκτελέσετε ό,τι σας στέλνει το Skroutz, καθώς δεν γίνεται αυτόματος έλεγχος αποθέματος πριν την αποδοχή. |
| Choose an Order Status for the orders that are created from marketplace | Σε ποια κατάσταση παραγγελίας του PrestaShop ξεκινά μια νέα παραγγελία Skroutz (π.χ. "Σε αναμονή πληρωμής", ή μια δική σας κατάσταση για παραγγελίες marketplace). |
3.3 Τι συμβαίνει όταν έρχεται μια παραγγελία
Αν είναι ενεργή η δημιουργία παραγγελιών: μια νέα παραγγελία εμφανίζεται στο Orders → Orders (και επίσης στη λίστα Orders → Skroutz Orders για μια ειδική επισκόπηση Skroutz) μέσα σε λίγα δευτερόλεπτα από την πώληση στο Skroutz. Ο πελάτης και η διεύθυνση δημιουργούνται αυτόματα από τα στοιχεία που δίνει το Skroutz.
Το Skroutz δεν μοιράζεται το πραγματικό email του αγοραστή με τους εμπόρους, οπότε ο πελάτης δημιουργείται με ένα εικονικό email. Δεν θα μπορείτε να στείλετε email απευθείας σε αυτούς τους πελάτες μέσω PrestaShop — η επικοινωνία με τους αγοραστές Skroutz γίνεται μέσω του Skroutz.
Αν είναι ενεργή η διαχείριση αποθέματος αντί αυτού: δεν εμφανίζεται παραγγελία, αλλά θα δείτε την πώληση στο Orders → Skroutz Orders (χωρίς συνδεδεμένη παραγγελία PrestaShop), και οι ποσότητες αποθέματός σας ενημερώνονται αυτόματα.
3.4 Διαχείριση παραγγελίας από το PrestaShop
Ανοίξτε οποιαδήποτε παραγγελία Skroutz στο Orders → Orders. Θα δείτε ένα πάνελ Skroutz Marketplace Order στη σελίδα της παραγγελίας που δείχνει τον κωδικό παραγγελίας Skroutz, την τρέχουσα κατάσταση, στοιχεία μεταφορικής μόλις ανατεθεί, και τα σχετικά κουμπιά ενεργειών:
- Όσο η παραγγελία περιμένει την απόφασή σας: κουμπιά Accept ή Reject.
- Μόλις γίνει αποδοχή: μια μικρή φόρμα για να στείλετε το όνομα μεταφορικής και τον κωδικό παρακολούθησης πίσω στο Skroutz.
Όποτε αλλάζετε την κατάσταση της παραγγελίας στο PrestaShop (π.χ. τη σημαίνετε ως "Απεστάλη" αφού καταχωρίσετε κωδικό παρακολούθησης, ή "Παραδόθηκε"), το πρόσθετο ενημερώνει αυτόματα το Skroutz — δεν χρειάζεται να κάνετε κάτι επιπλέον στο Skroutz για αυτά τα βήματα.
Κάτι που δεν μπορεί να κάνει το πρόσθετο: αν έχετε ήδη αποδεχτεί μια παραγγελία και μετά χρειαστεί να την ακυρώσετε, το Skroutz δεν προσφέρει τρόπο στους εμπόρους να ακυρώσουν μια αποδεκτή παραγγελία μέσω του API — θα πρέπει να το χειριστείτε απευθείας με την υποστήριξη του Skroutz.
3.5 Η λίστα "Skroutz Orders"
Orders → Skroutz Orders σας δίνει μια απλή λίστα με κάθε πώληση Skroutz που έχει επεξεργαστεί το πρόσθετο, με την κατάσταση Skroutz της, το σύνολο, και έναν σύνδεσμο απευθείας στην αντίστοιχη παραγγελία PrestaShop (όταν υπάρχει). Γραμμές με κόκκινη ετικέτα Error χρειάζονται την προσοχή σας — περάστε το ποντίκι πάνω από την ετικέτα για να δείτε γιατί (συνήθως, κάποιο προϊόν της παραγγελίας δεν μπόρεσε να αντιστοιχιστεί με τον κατάλογό σας, που συνήθως σημαίνει ότι ο κατάλογός σας άλλαξε από την τελευταία δημιουργία της ροής).
Σύντομος οδηγός για πρώτη ρύθμιση
- Catalog → Skroutz XML → δημιουργήστε μια ροή → ρυθμίστε σωστά τα Χαρακτηριστικά Χρώματος/Μεγέθους → Generate Feed → αντιγράψτε το XML link στο Skroutz.
- Προγραμματίστε τον σύνδεσμο CRON της ροής να τρέχει καθημερινά.
- (Προαιρετικό) Configure → Skroutz Analytics → ενεργοποιήστε, επικολλήστε το Analytics ID σας, επιλέξτε την ίδια ροή.
- (Προαιρετικό, για πωλητές Marketplace) Configure → Order Settings → ενεργοποιήστε δημιουργία παραγγελιών ή διαχείριση αποθέματος, επιλέξτε την ίδια ροή, επικολλήστε το Orders API token σας, ρυθμίστε τη λειτουργία αποδοχής → αντιγράψτε το webhook URL στο εργαλείο εμπόρων του Skroutz.
Αυτό είναι όλο — μόλις γίνει δεκτή η ροή από το Skroutz και (αν χρησιμοποιείται) συνδεθεί το webhook, όλα τα υπόλοιπα τρέχουν αυτόματα.