Σε αυτόν τον οδηγό θα δείτε βήμα-βήμα πώς να εγκαταστήσετε και να ρυθμίσετε το plugin ώστε να δέχεστε παραγγελίες από Skroutz (Smart Cart) στο WooCommerce, χρησιμοποιώντας API Key + Webhook URL, όπως ακριβώς εμφανίζονται στις ρυθμίσεις του plugin.
Περιεχόμενα
1) Πριν ξεκινήσετε (απαραίτητα)
Για να λειτουργεί σωστά η διασύνδεση θα χρειαστείτε:
-
Ενεργό site σε WordPress με WooCommerce.
-
Πρόσβαση στο Skroutz Merchant περιβάλλον (για API token & Webhook).
-
SSL (https) ενεργό στο domain.
-
Τα προϊόντα σας να “ταιριάζουν” με αυτά που βλέπει το Skroutz (ό,τι έχετε ήδη στήσει για Smart Cart / marketplace).
2) Εγκατάσταση & ενεργοποίηση
Η εγκατάσταση γίνεται όπως σε κάθε πρόσθετο:
-
Συνδεθείτε στο WordPress ως διαχειριστής.
-
Πηγαίνετε Πρόσθετα → Προσθήκη νέου.
-
Πατήστε Μεταφόρτωση πρόσθετου.
-
Επιλέξτε το αρχείο .zip από την αγορά.
-
Πατήστε Εγκατάσταση και μετά Ενεργοποίηση.
3) Ενεργοποίηση άδειας (License)
Στη σελίδα ρυθμίσεων του plugin εμφανίζεται “License Required” μέχρι να ενεργοποιηθεί η άδεια.
-
Πατήστε Activate License και συμπληρώστε τα στοιχεία άδειας που έχετε λάβει με την αγορά.
-
Μόλις ενεργοποιηθεί, θα μπορείτε να χρησιμοποιήσετε τις λειτουργίες του plugin κανονικά.
4) API Configuration (API Key + Webhook URL)
4.1 API Key (από Skroutz)
Στο Skroutz Merchant panel, στην ενότητα σύνδεσης με e-shop:
-
Βρείτε το σημείο API παραγγελιών.
-
Πατήστε Δημιουργία νέου API token.
-
Κάντε copy το token.
-
Στο WordPress → ρυθμίσεις plugin → API Configuration → πεδίο API Key, κάντε paste.
4.2 Webhook URL (από το plugin προς Skroutz)
Στις ρυθμίσεις του plugin θα δείτε έτοιμο το Webhook URL (π.χ. endpoint τύπου /wp-json/...).
-
Κάντε copy το Webhook URL από το plugin.
-
Στο Skroutz Merchant panel, στην ενότητα Webhook παραγγελιών:
-
Κάντε paste στο πεδίο Webhook URL
-
Ενεργοποιήστε το checkbox Ενεργοποίηση
-
-
Πατήστε Αποθήκευση στο Skroutz.
Από εδώ και πέρα, οι νέες παραγγελίες Smart Cart θα στέλνονται στο site σας μέσω webhook.
5) Order Settings (Demo Email + Size Attribute)
5.1 Demo Email
Στο πεδίο Demo Email ορίζετε ένα email που θα χρησιμοποιείται για τις παραγγελίες Smart Cart.
-
Αν το αφήσετε κενό: το plugin (όπως γράφει και στο UI) μπορεί να χρησιμοποιεί το email του πελάτη.
-
Αν βάλετε demo email: χρήσιμο για staging / δοκιμές ή όταν θέλετε όλες οι παραγγελίες να “πέφτουν” σε ένα συγκεκριμένο email.
5.2 Size Attribute
Το πεδίο Size Attribute θέλει το attribute slug του WooCommerce που αντιστοιχεί στο μέγεθος (π.χ. pa_size, pa_megethos).
-
Βρείτε το από Προϊόντα → Ιδιότητες (Attributes) και χρησιμοποιήστε το slug.
-
Αν στο Skroutz περνάνε επιλογές μεγέθους και θέλετε σωστό “δέσιμο” με παραλλαγές, αυτό βοηθάει σημαντικά.
6) Έλεγχος λειτουργίας (test)
Για να επιβεβαιώσετε ότι όλα δουλεύουν:
-
Βεβαιωθείτε ότι:
-
Έχετε βάλει σωστό API Key στο plugin
-
Έχετε κάνει paste το Webhook URL στο Skroutz
-
Έχετε Ενεργοποίηση στο webhook και Αποθήκευση
-
-
Κάντε ένα test order από το περιβάλλον του Skroutz (όπου παρέχεται).
-
Ελέγξτε στο WooCommerce → Παραγγελίες ότι δημιουργήθηκε νέα παραγγελία.
7) Συχνές ερωτήσεις (FAQ)
Δεν έρχονται παραγγελίες στο WooCommerce, τι να ελέγξω;
Δεν έρχονται παραγγελίες στο WooCommerce — τι να ελέγξω;
-
Έχει γίνει Αποθήκευση στο Skroutz αφού βάλατε το webhook;
-
Είναι ενεργό το Ενεργοποίηση στο webhook;
-
Το site είναι προσβάσιμο με https και δεν μπλοκάρει requests (firewall/WAF/cache);
API Key λάθος/ληγμένο
-
Δημιουργήστε νέο API token από Skroutz και αντικαταστήστε το στο plugin.
Δεν “δένουν” σωστά τα μεγέθη / παραλλαγές
-
Ελέγξτε ότι στο Size Attribute έχετε βάλει σωστό slug (π.χ.
pa_size) και ότι οι παραλλαγές σας το χρησιμοποιούν.
Δεν έρχονται παραγγελίες στο WooCommerce — τι να ελέγξω;
-
Έχει γίνει Αποθήκευση στο Skroutz αφού βάλατε το webhook;
-
Είναι ενεργό το Ενεργοποίηση στο webhook;
-
Το site είναι προσβάσιμο με https και δεν μπλοκάρει requests (firewall/WAF/cache);
API Key λάθος/ληγμένο
-
Δημιουργήστε νέο API token από Skroutz και αντικαταστήστε το στο plugin.
Δεν “δένουν” σωστά τα μεγέθη / παραλλαγές
-
Ελέγξτε ότι στο Size Attribute έχετε βάλει σωστό slug (π.χ.
pa_size) και ότι οι παραλλαγές σας το χρησιμοποιούν.
8) Υποστήριξη
Για οποιοδήποτε πρόβλημα ή απορία σχετικά με τη ρύθμιση/λειτουργία του plugin, μπορείτε να επικοινωνήσετε με την τεχνική υποστήριξη στο info@vgdevsolutions.gr