Οδηγός εγκατάστασης Skroutz Smart Cart για WooCommerce

Οδηγός εγκατάστασης: Έξυπνο Καλάθι Skroutz για WooCommerce

Προαπαιτούμενα

• Κατάστημα ενεργό στο Skroutz, με εγκεκριμένο XML feed και ενεργοποιημένο Έξυπνο Καλάθι (Skroutz Marketplace).
• Το API token του Smart Cart από το Skroutz Merchants.
• Το id κάθε προϊόντος στο XML feed να είναι το ID του προϊόντος ή της παραλλαγής στο WooCommerce. Αν το feed σας χρησιμοποιεί SKU ή άλλο κωδικό, χρειάζεται αντιστοίχιση με τον filter obs_skroutz_cart_product_id.
• Permalinks του WordPress σε μορφή διαφορετική από «Απλή» και REST API (/wp-json/) προσβάσιμο από έξω (χωρίς μπλοκάρισμα από security plugin, firewall ή maintenance mode).
• Tax classes στο WooCommerce για τους συντελεστές ΦΠΑ που πουλάτε (π.χ. 24%, 13%, 6%).
• Backup αρχείων και βάσης.

Εγκατάσταση και License key

1. WordPress → Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση προσθέτου. Ανεβάστε το ZIP «OBS Woo Skroutz cart», Εγκατάσταση και Ενεργοποίηση.
2. Ανοίξτε το μενού Skroutz Smart Cart στο διαχειριστικό.
3. Στο πλαίσιο Activate for Update επικολλήστε το License key στο «Enter Validation Key» και πατήστε Activate.

Χάρτης ρυθμίσεων (μενού Skroutz Smart Cart)

• The url …/wp-json/obs/v1/smart_cart_orders — το webhook URL του καταστήματος. Δηλώνεται στο Skroutz Merchants στις ρυθμίσεις του Έξυπνου Καλαθιού.
• API Key — το API token του Skroutz. Χρησιμοποιείται για αποδοχή/απόρριψη, voucher και ενημέρωση αποστολής, και για την αυθεντικοποίηση του webhook. Αν μείνει κενό, το webhook απαντά 503.
• Demo email for skroutz cart orders — το email που μπαίνει ως email χρέωσης στις παραγγελίες Skroutz (το Skroutz δεν δίνει το email του πελάτη). Εκεί πηγαίνουν και τα emails του WooCommerce για αυτές τις παραγγελίες.
• Size Attribute — το attribute μεγέθους των παραλλαγών (προεπιλογή pa_size). Χρειάζεται για τις καταχωρίσεις χρώματος του Skroutz.

VAT Settings

• Enable VAT Exclusion Support — αποθηκεύει το αίτημα απαλλαγής ΦΠΑ που στέλνει το Skroutz για τιμολόγια.
• Apply 0% VAT for Primer — εφαρμόζει αυτόματα 0% ΦΠΑ όταν ζητείται απαλλαγή ή όταν η τιμή γραμμής δεν περιλαμβάνει ΦΠΑ.
• VAT Rate Mapping — για κάθε συντελεστή του Skroutz (24%, 13%, 6%, 0%, 17%, 9%) επιλέγετε το αντίστοιχο WooCommerce Tax Class.

Στη σελίδα κάθε παραγγελίας

• Πλαίσιο Skroutz Smart Cart: Accept με Χρόνο Παραλαβής, Τοποθεσία Παραλαβής και αριθμό δεμάτων όπου τα ζητά το Skroutz, ή Reject με αιτιολογία ανά προϊόν (και διαθέσιμη ποσότητα όπου απαιτείται).
• Μετά την αποδοχή: σύνδεσμος «Κατεβάστε το voucher», εταιρεία μεταφοράς και κωδικοί tracking. Αν το voucher δεν είναι ακόμη έτοιμο, εμφανίζεται κουμπί «Ανανέωση για Voucher».
• Στη λίστα παραγγελιών: μαζική ενέργεια Print Skroutz voucher και φίλτρο Skroutz FBS only.

Δοκιμή

1. Ελέγξτε ότι το webhook URL ανοίγει από έξω. Ένα GET στη διεύθυνση πρέπει να επιστρέφει μήνυμα REST (όχι σελίδα 404 του θέματος).
2. Στο WooCommerce ελέγξτε: σωστά προϊόντα και παραλλαγή, ποσά ίδια με το Skroutz, tax class, στοιχεία τιμολογίου, κατάσταση «Σε αναμονή», μείωση αποθέματος.
3. Κάντε Accept από το πλαίσιο της παραγγελίας και ελέγξτε ότι η κατάσταση γίνεται «Σε επεξεργασία» και εμφανίζεται το voucher.
4. Στο WooCommerce → Κατάσταση → Logs, πηγή skroutz-cart-requests, ελέγξτε τις κλήσεις προς το Skroutz.

Go-live checklist

• License key ενεργό, API Key αποθηκευμένο, webhook URL δηλωμένο στο Skroutz.
• Το id του XML feed αντιστοιχεί σε WooCommerce IDs (ή υπάρχει filter αντιστοίχισης).
• Size Attribute σωστό για καταστήματα με μεγέθη.
• VAT Rate Mapping συμπληρωμένο για όλους τους συντελεστές που πουλάτε.
• Τα πεδία τιμολογίου γράφονται εκεί που τα διαβάζει το plugin τιμολογίου ή το ERP σας.
• Κανένα security plugin ή firewall δεν μπλοκάρει το /wp-json/obs/v1/.

Αντιμετώπιση προβλημάτων

Η παραγγελία του Skroutz δεν εμφανίζεται καθόλου στο WooCommerce

• Αιτία: Το webhook URL δεν είναι δηλωμένο σωστά στο Skroutz, τα permalinks είναι «Απλά», ή security plugin / firewall μπλοκάρει το /wp-json/.
• Λύση: Αντιγράψτε το URL ακριβώς όπως φαίνεται στη σελίδα ρυθμίσεων, ορίστε permalinks διαφορετικά από «Απλή» και επιτρέψτε το /wp-json/obs/v1/smart_cart_orders στο firewall.

Το webhook απαντά 401 ή 503

• Αιτία: 503: δεν έχει αποθηκευτεί API Key. 401: το κλειδί δεν ταιριάζει ή το αίτημα περνά από proxy που κρύβει την πραγματική IP.
• Λύση: Αποθηκεύστε το σωστό API token του Skroutz. Αν το site είναι πίσω από reverse proxy, η OBS δηλώνει τα δίκτυα του proxy με τον filter obs_skroutz_cart_trusted_proxy_networks.

Το webhook απαντά 400

• Αιτία: Το αίτημα δεν έχει event_type ή στοιχεία παραγγελίας (π.χ. χειροκίνητη δοκιμή ή λάθος URL).
• Λύση: Βεβαιωθείτε ότι στο Skroutz έχει δηλωθεί το URL του Smart Cart και όχι άλλο endpoint, και ελέγξτε τα logs πριν το επανεκτελέσετε.

Η παραγγελία μπαίνει χωρίς προϊόντα ή με μηδενικό ποσό

• Αιτία: Το id του προϊόντος στο XML δεν αντιστοιχεί σε προϊόν ή παραλλαγή του WooCommerce (π.χ. το feed στέλνει SKU).
• Λύση: Ορίστε το id του feed στο WooCommerce ID ή προσθέστε αντιστοίχιση με τον filter obs_skroutz_cart_product_id. Από την έκδοση 1.2.11 μια τέτοια γραμμή απορρίπτεται και το Skroutz ξαναστέλνει όταν διορθωθεί ο κατάλογος.

Μπαίνει λάθος χρώμα ή μέγεθος

• Αιτία: Το Skroutz στέλνει καταχώριση χρώματος και το μέγεθος δεν αναγνωρίζεται, ή το Size Attribute δεν είναι το πραγματικό attribute μεγέθους.
• Λύση: Ορίστε στο Size Attribute το attribute των παραλλαγών (π.χ. pa_size) και αναβαθμίστε στην τελευταία έκδοση.

Δεν μειώνεται το απόθεμα

• Αιτία: Το προϊόν δεν αντιστοιχίστηκε, η διαχείριση αποθέματος είναι ανενεργή στο προϊόν/παραλλαγή, ή πρόκειται για παραγγελία FBS (το απόθεμα είναι στην αποθήκη του Skroutz).
• Λύση: Ελέγξτε την αντιστοίχιση και τη διαχείριση αποθέματος. Οι παραγγελίες FBS φέρουν ετικέτα FBS και σημείωση στην παραγγελία· εκεί η μη μείωση είναι σωστή.

Η ίδια παραγγελία δημιουργείται πολλές φορές

• Αιτία: Παλαιότερη έκδοση χωρίς προστασία επανάληψης όταν το Skroutz ξαναστέλνει το webhook.
• Λύση: Αναβαθμίστε στην τελευταία έκδοση. Διαγράψτε ή ακυρώστε τα διπλότυπα αφού επιβεβαιώσετε ποια είναι η πρώτη παραγγελία.

Δεν αλλάζει η κατάσταση όταν αλλάζει στο Skroutz

• Αιτία: Το Skroutz δεν έστειλε event αλλαγής, έχει ενεργοποιηθεί ο filter skip_order_status_update, ή η παραγγελία δεν βρέθηκε (π.χ. δημιουργήθηκε πριν την εγκατάσταση).
• Λύση: Ελέγξτε τα logs και το ιστορικό αιτημάτων στο Skroutz Merchants. Η αντιστοίχιση καταστάσεων αλλάζει με τον filter obs_skroutz_cart_update_order_status.

Ο ΦΠΑ γυρίζει σε 24% σε προϊόντα μειωμένου συντελεστή

• Αιτία: Δεν έχει συμπληρωθεί το VAT Rate Mapping ή λείπει το αντίστοιχο tax class.
• Λύση: Δημιουργήστε τα tax classes στο WooCommerce και αντιστοιχίστε κάθε συντελεστή στο VAT Rate Mapping. Αναβαθμίστε στην τελευταία έκδοση.

Μετά την ενεργοποίηση HPOS εξαφανίστηκε το πλαίσιο Skroutz ή ο σύνδεσμος voucher δεν δουλεύει

• Αιτία: Παλαιότερη έκδοση πριν τις διορθώσεις HPOS και voucher URL.
• Λύση: Αναβαθμίστε στην τελευταία έκδοση του plugin.

«Could not validate» στο License key

• Αιτία: Το κλειδί αφορά άλλο plugin ή άλλο domain.
• Λύση: Χρησιμοποιήστε το κλειδί του Έξυπνου Καλαθιού για το domain όπου είναι εγκατεστημένο. Για αλλαγή domain επικοινωνήστε με την OBS.