Skroutz Marketplace & XML για WooCommerce: οδηγός

Το Skroutz Marketplace & XML για WooCommerce συνδέει το κατάστημά σας με το Skroutz.gr. Δημιουργεί το XML feed προϊόντων για το Skroutz (απλά και μεταβλητά προϊόντα, μεγέθη, χρώματα, EAN, κόστος αποστολής), φέρνει τις παραγγελίες του Skroutz Marketplace στο WooCommerce για να τις αποδεχτείτε ή να τις απορρίψετε, δείχνει το voucher και τον αριθμό αποστολής της courier, και στέλνει τις αλλαγές αποθέματος και τιμής στο Skroutz μέσω του Products API. Ο οδηγός καλύπτει την εγκατάσταση, όλες τις ρυθμίσεις και την καθημερινή χρήση.

Απαιτήσεις

• WordPress 6.5 ή νεότερο και WooCommerce 3.4 ή νεότερο (υποστηρίζεται το High-Performance Order Storage)
• PHP 7.4 ή νεότερη
• Λογαριασμός Skroutz Merchants. Για τις παραγγελίες του Marketplace χρειάζεστε επίσης το API Token από τον λογαριασμό σας στο Skroutz Merchants, και για τις άμεσες ενημερώσεις ένα ξεχωριστό Products API Token.
• Κλειδί άδειας wpslash.com για το plugin

Εγκατάσταση

1. Κατεβάστε το .zip του plugin από τη σελίδα αδειών στο wpslash.com μετά την αγορά.
2. Πηγαίνετε στο WordPress Admin > Plugins > Add New, πατήστε Upload Plugin και επιλέξτε το αρχείο που κατεβάσατε.
3. Πατήστε Install Now και μετά Activate. Το WooCommerce πρέπει να είναι ήδη ενεργό.
4. Επικολλήστε το κλειδί άδειας στην οθόνη αδειών που ανοίγει το plugin και πατήστε Activate. Από εκεί και πέρα οι ενημερώσεις έρχονται στον πίνακα ελέγχου του WordPress.

Ρύθμιση και παραμετροποίηση

Πηγαίνετε στο WooCommerce > Settings > Skroutz Smart Cart. Η καρτέλα έχει τρεις ενότητες: Smart Cart Settings, XML Feed και Products API (Live Updates). Ξεκινήστε από το XML feed: το Skroutz εμφανίζει τα προϊόντα σας από το feed, και οι παραγγελίες του Marketplace και οι άμεσες ενημερώσεις λειτουργούν μόνο για προϊόντα που υπάρχουν ήδη σε αυτό.

XML Feed

• Feed URL: η διεύθυνση του feed σας. Αντιγράψτε τη στον λογαριασμό σας στο Skroutz Merchants όταν δηλώνετε το feed.
• Unique ID: η τιμή που στέλνεται στο Skroutz ως κωδικός προϊόντος: Product ID (Default), SKU ή ένα Custom Field (επιλέξτε το στο Custom Field for Unique ID). Διαλέξτε το μία φορά και κρατήστε το: αν το αλλάξετε αργότερα, το Skroutz βλέπει τα προϊόντα σας ως καινούρια.
• Select Default Brand Taxonomy: πού βρίσκονται οι μάρκες σας, για παράδειγμα στα Brands (product_brand) του WooCommerce ή σε ένα attribute μάρκας. Από εκεί συμπληρώνεται ο κατασκευαστής κάθε προϊόντος.
• MPN Field: ο κωδικός κατασκευαστή: WooCommerce SKU, ένα Attribute (ορίστε το στο Select Attibute) ή ένα Custom Field (ορίστε το στο Custom Field for MPN Field).
• EAN Field: το meta key του προϊόντος με το EAN/barcode. Το πεδίο GTIN, UPC, EAN, or ISBN του WooCommerce αποθηκεύεται ως _global_unique_id. Το Skroutz ζητά EAN για τα ηλεκτρονικά.
• Product Categories require EAN: τα προϊόντα αυτών των κατηγοριών μένουν εκτός feed όταν δεν έχουν EAN. Αφήστε το κενό αν δεν το χρειάζεστε.
• Size Attribute και Color Attribute: τα attributes που χρησιμοποιείτε για μέγεθος και χρώμα. Τα χρειάζονται τα καταστήματα ρούχων και υποδημάτων.
• Default Availability for in Stock Products και Default Availability for BackOrder Products: ο χρόνος παράδοσης που εμφανίζεται στο Skroutz, για παράδειγμα Παράδοση 1 – 3 Εργάσιμες. Με το Overwrite Availability ένα attribute ορίζει διαφορετική διαθεσιμότητα ανά προϊόν.
• Default Quantity: η ποσότητα που στέλνεται για διαθέσιμα προϊόντα χωρίς διαχείριση αποθέματος. Αφήστε το κενό για να μη στέλνεται ποσότητα.
• Default VAT Rate (%): χρησιμοποιείται όταν οι φόροι του WooCommerce είναι απενεργοποιημένοι ή ένα προϊόν δεν έχει συντελεστή ΦΠΑ (24 από προεπιλογή).

• Shipping: τα Shipping Cost (Up to 2KG), Shipping Cost (Additional KG) και Free Shipping for Orders Over υπολογίζουν το κόστος αποστολής κάθε προϊόντος από το βάρος του. Χρησιμοποιήστε τα μόνο αν όλα τα προϊόντα σας έχουν βάρος. Αλλιώς αφήστε τα κενά και ισχύουν οι κανόνες αποστολής του λογαριασμού σας στο Skroutz Merchants.
• Inclusions: στέλνετε μόνο ορισμένες κατηγορίες, ετικέτες ή μάρκες. Αφήστε και τα τρία κενά για να συμπεριληφθούν όλα.
• Exclusions: εξαιρείτε κατηγορίες, ετικέτες ή μάρκες, και με το Exclude Backorder Items όλα τα προϊόντα σε backorder. Το Hide Individual Products προσθέτει ένα checkbox Hide from Skroutz σε κάθε προϊόν και παραλλαγή.

• Enable Price Override: στέλνετε διαφορετική τιμή στο Skroutz. Με το Price Override Field στο Create Field, εμφανίζεται πεδίο Skroutz Price σε κάθε προϊόν και παραλλαγή. Αν κρατάτε ήδη αυτή την τιμή σε ένα meta key, επιλέξτε Already using another field και διαλέξτε το στο Custom Price Meta Key. Τα προϊόντα χωρίς τιμή Skroutz στέλνουν την τιμή του WooCommerce.
• Feed Cron Method: με το WordPress Cron το feed ξαναχτίζεται με βάση το πρόγραμμα. Αν το site έχει λίγη κίνηση ή το WP-Cron είναι κλειστό, επιλέξτε Server Cron (URL) και καλέστε το Server Cron URL από τον πίνακα ελέγχου της φιλοξενίας σας, για παράδειγμα κάθε 5 λεπτά. Κάθε κλήση χτίζει την επόμενη παρτίδα.
• Generate XML Feed Every: κάθε 1, 2, 6, 12 ή 24 ώρες.
• Batch Size: προϊόντα ανά παρτίδα (100 από προεπιλογή). Κρατήστε την προεπιλογή, εκτός αν ο server σας είναι γρήγορος.

• Τα Remove HTML from Description και Description Length (Full description ή First 100 characters) κρατούν μικρό το feed.
• Add Attributes on Title: προσθέτει το μέγεθος και το χρώμα, ή όλα τα attributes, στο τέλος του ονόματος του προϊόντος στο feed.
• Split Colour Variations: το Skroutz θέλει ένα χρώμα ανά προϊόν. Με αυτή την επιλογή, ένα προϊόν σε πολλά χρώματα στέλνεται ως ένα προϊόν ανά χρώμα, με link στο συγκεκριμένο χρώμα και τα μεγέθη του. Δώστε σε κάθε χρωματική παραλλαγή τη δική της εικόνα.
• Alternate Skroutz Image: το Skroutz θέλει εικόνες σε λευκό ή διάφανο φόντο. Ενεργοποιήστε το για να στέλνετε διαφορετική εικόνα: το Create Field προσθέτει το πλαίσιο Skroutz Alternate Image σε προϊόντα και παραλλαγές, αλλιώς επιλέξτε τα custom fields που ήδη χρησιμοποιείτε.

Πατήστε Save changes. Η αποθήκευση της ενότητας XML Feed μηδενίζει την κατάσταση του feed, οπότε η επόμενη εκτέλεση το χτίζει ξανά από την αρχή.

Smart Cart Settings (παραγγελίες Marketplace)

1. Αντιγράψτε το Webhook URL και επικολλήστε το ως webhook URL στον λογαριασμό σας στο Skroutz Merchants. Εκεί στέλνει το Skroutz τις νέες και τις ενημερωμένες παραγγελίες.
2. Επικολλήστε το API Token από τον λογαριασμό σας στο Skroutz Merchants. Με αυτό το plugin αποδέχεται και απορρίπτει παραγγελίες.
3. Ορίστε το Unique ID ίδιο με το Unique ID του XML feed, ώστε οι παραγγελίες να βρίσκουν τα σωστά προϊόντα.
4. Επιλέξτε Default Status for New Orders (Not Accepted) (On hold από προεπιλογή) και Default Status for Accepted Orders (Processing από προεπιλογή).
5. Προαιρετικά τσεκάρετε το Automatic Order Acceptance: κάθε παραγγελία Skroutz γίνεται αποδεκτή μόλις φτάσει, με την πρώτη διαθέσιμη ώρα παραλαβής.
6. Πατήστε Save changes.

Products API (άμεσες ενημερώσεις)

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

1. Στο Skroutz Merchants πηγαίνετε στο Products > Feed Updates και δημιουργήστε ένα token. Είναι διαφορετικό από το API token των παραγγελιών Marketplace.
2. Τσεκάρετε το Enable Live Updates και επικολλήστε το token στο Products API Token.
3. Κρατήστε το API Batch Size στο 100, εκτός αν αλλάζετε χιλιάδες προϊόντα μαζί (το Skroutz δέχεται έως 500 ανά αίτημα).
4. Πατήστε Save changes. Το Synchronization Status δείχνει τα προϊόντα σε αναμονή και την τελευταία αποστολή. Ανανεώστε τη σελίδα για να ενημερωθεί.

Οι άμεσες ενημερώσεις αλλάζουν μόνο προϊόντα που το Skroutz έχει ήδη από το XML feed σας. Τα νέα προϊόντα φτάνουν στο Skroutz μέσω του feed.

Ρυθμίσεις προϊόντος

Όταν είναι ενεργά τα Enable Price Override και Hide Individual Products, η καρτέλα General κάθε προϊόντος έχει πεδίο Skroutz Price και checkbox Hide from Skroutz. Συμπληρώστε το EAN στο GTIN, UPC, EAN, or ISBN (ή στο πεδίο που ορίσατε ως EAN Field).

Κάθε παραλλαγή έχει δικό της checkbox Hide from Skroutz και δική της Skroutz Price. Αν η τιμή της παραλλαγής μείνει κενή, χρησιμοποιείται η τιμή WooCommerce της παραλλαγής ή η τιμή Skroutz του γονικού προϊόντος.

Χρήση

Δηλώστε το XML feed στο Skroutz

1. Ανοίξτε μία φορά το Feed URL στον browser. Την πρώτη φορά εμφανίζει Please wait while the XML file is getting created for first time…. με το ποσοστό ολοκλήρωσης. Ανανεώστε μέχρι να εμφανιστεί το XML.
2. Αντιγράψτε το Feed URL στον λογαριασμό σας στο Skroutz Merchants. Το Skroutz το διαβάζει με το δικό του πρόγραμμα, και το plugin το ξαναχτίζει κάθε Generate XML Feed Every ώρες.

Ένα απλό προϊόν με EAN, τιμή Skroutz και δωρεάν αποστολή εμφανίζεται έτσι στο feed:

<product>
  <id><![CDATA[35]]></id>
  <mpn><![CDATA[SM-ANC-700]]></mpn>
  <ean>5201234567890</ean>
  <name><![CDATA[Ασύρματα Ακουστικά Bluetooth ANC]]></name>
  <price_with_vat>124.90</price_with_vat>
  <vat>24.00</vat>
  <instock>Y</instock>
  <availability>Παράδοση 1 - 3 Εργάσιμες</availability>
  <quantity><![CDATA[24]]></quantity>
  <weight><![CDATA[0.4kg]]></weight>
  <shipping><![CDATA[0]]></shipping>
  <manufacturer><![CDATA[SoundMax]]></manufacturer>
</product>

Ένα μεταβλητό προϊόν δείχνει κάθε μέγεθος σε ένα block <variations> με δικό του SKU, τιμή και ποσότητα. Με το Split Colour Variations ενεργό, η λευκή και η μαύρη εκδοχή ενός t-shirt γίνονται δύο προϊόντα (16.Λευκό και 16.Μαύρο):

<color><![CDATA[Λευκό]]></color>
<variations>
  <variation>
    <variationid>16.Λευκό.M</variationid>
    <availability>Παράδοση 1 - 3 Εργάσιμες</availability>
    <manufacturersku><![CDATA[TS-BASIC-WHITE-M]]></manufacturersku>
    <price_with_vat>19.90</price_with_vat>
    <size><![CDATA[M]]></size>
    <quantity>10</quantity>
  </variation>
</variations>

Με το Server Cron (URL) μπορείτε επίσης να ελέγξετε το feed από το Server Cron URL: προσθέστε &status για να δείτε την πρόοδο, &force για να το ξαναχτίσετε αμέσως ή &reset για να καθαρίσετε μια εκτέλεση που κόλλησε.

Αποδοχή ή απόρριψη παραγγελιών Skroutz

Κάθε παραγγελία Skroutz φτάνει στο WooCommerce > Orders με τον πελάτη, τα προϊόντα και την τιμή του Skroutz, στην κατάσταση που ορίσατε για τις νέες παραγγελίες. Το απόθεμα μειώνεται αμέσως. Η στήλη Skroutz δείχνει τον κωδικό παραγγελίας Skroutz (με link στην παραγγελία στο Skroutz Merchants), την κατάστασή της στο Skroutz, την courier και τον αριθμό αποστολής, καθώς και Gift Wrap ή Invoice Details όταν ο πελάτης τα ζήτησε.

1. Πατήστε Accept Order στη στήλη Skroutz.
2. Επιλέξτε το Pickup Location from και το Pickup Time που θα περάσει η courier. Εμφανίζονται μόνο μελλοντικά χρονικά διαστήματα.
3. Πατήστε Accept. Η παραγγελία περνά στην κατάσταση αποδοχής και το Skroutz εκδίδει το voucher της courier.

Για απόρριψη, πατήστε Reject Order, επιλέξτε Reject Reason για κάθε προϊόν και, όταν ο λόγος το απαιτεί, την Quantity που έχετε ακόμα. Πατήστε Reject. Τους λόγους τους δίνει το Skroutz, οπότε εμφανίζονται στη γλώσσα του λογαριασμού σας στο Skroutz.

Vouchers, αριθμός αποστολής και κατάσταση παραγγελίας

• Μετά την αποδοχή η στήλη δείχνει Voucher is not ready yet μέχρι να εκδώσει το Skroutz το voucher, και μετά το κουμπί Print Voucher.
• Το Skroutz ενημερώνει την παραγγελία: Accepted, Dispatched, Delivered, Cancelled, Rejected, Expired ή Returned. Μια παραγγελία που στάλθηκε (Dispatched) γίνεται Completed στο WooCommerce, και μια ακυρωμένη ή απορριφθείσα γίνεται Cancelled.
• Η αναζήτηση παραγγελιών βρίσκει μια παραγγελία με τον κωδικό Skroutz, την courier ή τον αριθμό αποστολής.
• Αν ένα προϊόν της παραγγελίας δεν αντιστοιχιστεί (για παράδειγμα επειδή άλλαξε το Unique ID), η παραγγελία δημιουργείται κανονικά και μια σημείωση παραγγελίας δείχνει τα προϊόντα που δεν προστέθηκαν.

Συχνές ερωτήσεις

Υποστηρίζει μεταβλητά προϊόντα;

Ναι. Επιλέξτε το Size Attribute και το Color Attribute στην ενότητα XML Feed. Τα μεγέθη μπαίνουν στο block <variations> κάθε προϊόντος. Για πολλά χρώματα, ενεργοποιήστε το Split Colour Variations ώστε κάθε χρώμα να είναι ξεχωριστό προϊόν στο Skroutz.

Γιατί λείπει ένα προϊόν από το feed;

Ελέγξτε τα Inclusions και Exclusions, το checkbox Hide from Skroutz, το Exclude Backorder Items, και αν η κατηγορία του είναι στο Product Categories require EAN χωρίς να έχει EAN. Οι αλλαγές φαίνονται μετά το επόμενο χτίσιμο του feed.

Το feed δεν ενημερώνεται. Τι κάνω;

Το WordPress Cron τρέχει μόνο όταν το site έχει επισκέψεις. Αλλάξτε το Feed Cron Method σε Server Cron (URL) και καλέστε το Server Cron URL από τον πίνακα ελέγχου της φιλοξενίας σας κάθε λίγα λεπτά.

Χρειάζομαι δύο διαφορετικά tokens του Skroutz;

Ναι, αν χρησιμοποιείτε και τις δύο λειτουργίες. Το API Token στα Smart Cart Settings είναι για τις παραγγελίες του Marketplace. Το Products API Token δημιουργείται στο Skroutz Merchants > Products > Feed Updates και χρησιμοποιείται μόνο για τις άμεσες ενημερώσεις. Το ίδιο το XML feed δεν χρειάζεται token.

Μπορούν οι παραγγελίες να γίνονται αποδεκτές αυτόματα;

Ναι. Τσεκάρετε το Automatic Order Acceptance στα Smart Cart Settings. Κάθε παραγγελία γίνεται αποδεκτή μόλις φτάσει, με το πρώτο σημείο και την πρώτη ώρα παραλαβής που προτείνει το Skroutz.

Είναι συμβατό με το WooCommerce HPOS;

Ναι. Το plugin υποστηρίζει το High-Performance Order Storage.