Οδηγός εγκατάστασης Public Marketplace XML Feed για WooCommerce
Product feed για Public Marketplace με σωστά πεδία, τιμές, εικόνες και availability.
Οδηγός εγκατάστασης Public Marketplace XML Feed για WooCommerce
Προαπαιτούμενα
- Λογαριασμός πωλητή στο Public Marketplace και τα προϊόντα σας καταχωρισμένα στο Public (π.χ. από αρχείο CSV: Προϊόντα → Εξαγωγή του WooCommerce).
- EAN ή σταθερό SKU σε κάθε προϊόν, σε πεδίο του WooCommerce.
- Οι ημέρες που χρειάζεστε για να στείλετε μια παραγγελία.
- Σωστοί φόροι στο WooCommerce, γιατί ο ΦΠΑ κάθε προϊόντος στέλνεται στο offervat.
Εγκατάσταση και License key
- Εγκαταστήστε και ενεργοποιήστε πρώτα το «OBS Woo Export» και μετά το «OBS Feed Public» (Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου). Χωρίς το OBS Woo Export, το OBS Feed Public απενεργοποιείται με το μήνυμα «Sorry, but this plugin requires OBS Woo Export».
- Ανοίξτε WooCommerce → OBS Woo Export και τις ρυθμίσεις του Public.
- Στο πλαίσιο «Activate Public for Update» επικολλήστε το License key στο «Enter Validation Key» και πατήστε Activate.
Χάρτης ρυθμίσεων του Public
- Product ID: Shop Sku (προεπιλογή), Woocommerce Product ID, EAN ή ISBN.
- Product ID - meta: το meta πεδίο ή attribute (
pa_…) από όπου διαβάζεται ο κωδικός, π.χ._skuγια το SKU. - Product ID Label: μόνο για Woocommerce Product ID, ο τύπος κωδικού που θα δηλωθεί.
- Auto EAN/SHOP_SKU: ενεργό από προεπιλογή· 12 ή 13 ψηφία → EAN, αλλιώς SHOP_SKU.
- Default Shipping Class: Small (προεπιλογή), Medium, Large ή Free.
- Shipping Class Product Meta: meta πεδίο με κλάση αποστολής ανά προϊόν.
- Shipping VAT: ΦΠΑ μεταφορικών (προεπιλογή 24).
- Availability in stock / (out of stock) / (backorder): οι ημέρες αποστολής που γράφονται στο leadtime-to-ship. Βάλτε μόνο αριθμό, π.χ. 2.
Δημιουργία και έλεγχος
- Στην καρτέλα «Exports» του OBS Woo Export ενεργοποιήστε την εξαγωγή του Public και πατήστε Generate. Μην κλείσετε τη σελίδα μέχρι να ολοκληρωθεί.
- Ανοίξτε το link που εμφανίζεται και ελέγξτε σε μερικά offers: product-id, product-id-type, price, discount-price, quantity, leadtime-to-ship και offervat.
- Δηλώστε το link στον εταιρικό λογαριασμό σας στο Public και τρέξτε τον έλεγχο του αρχείου από εκεί.
Αυτόματη ανανέωση
Προσθέστε εργασία cron στον server για το wp-content/plugins/obs-woo-export/cron.php, π.χ. μία φορά την ημέρα. Η OBS προτείνει επίσης define('DISABLE_WP_CRON', true); στο wp-config.php μαζί με server cron. Σε πολλά προϊόντα η χειροκίνητη δημιουργία μπορεί να λήξει (timeout), οπότε ο server cron είναι απαραίτητος.
Go-live checklist
- Ενεργά και τα δύο πρόσθετα, License key ενεργό.
- product-id και product-id-type όπως τα ζητά το Public για τον λογαριασμό σας.
- leadtime-to-ship με ακέραιο αριθμό ημερών σε όλα τα offers.
- Διαχείριση αποθέματος ενεργή στα προϊόντα που δεν θέλετε να στέλνονται με ποσότητα 10.
- Το link ανοίγει από εξωτερικό δίκτυο και ο server cron τρέχει.
Αντιμετώπιση προβλημάτων
- Σύμπτωμα: Το Public απορρίπτει το αρχείο με σφάλμα στο leadtime-to-ship ή δείχνει παράδοση την ίδια μέρα.
Αιτία: Τα πεδία διαθεσιμότητας περιέχουν κείμενο (π.χ. «Άμεσα διαθέσιμο»), είναι κενά ή 0. Το Public δέχεται μόνο ακέραιο αριθμό ημερών.
Λύση: Γράψτε μόνο αριθμό ημερών στα Availability in stock, Availability (out of stock) και Availability (backorder) και ξαναπαράγετε το αρχείο. - Σύμπτωμα: Το Public δεν αναγνωρίζει τα προϊόντα ή αναγνωρίζει όλο και λιγότερα.
Αιτία: Το product-id δεν ταιριάζει με τον κωδικό των προϊόντων στο Public (π.χ. στέλνεται SKU ενώ ο κατάλογος είναι με EAN), ή άλλαξε ο τύπος κωδικού.
Λύση: Ορίστε στο Product ID και στο Product ID - meta τον ίδιο κωδικό με τον κατάλογο του Public και ελέγξτε το product-id-type. - Σύμπτωμα: Στο product-id βγαίνει το εσωτερικό ID αντί για το SKU ή το EAN.
Αιτία: Έχει επιλεγεί Woocommerce Product ID ή το Product ID - meta είναι κενό.
Λύση: Επιλέξτε Shop Sku ή EAN και συμπληρώστε το Product ID - meta (π.χ. _sku ή το meta key του barcode). - Σύμπτωμα: Μήνυμα «Sorry, but this plugin requires OBS Woo Export» και το πρόσθετο απενεργοποιείται.
Αιτία: Το OBS Feed Public είναι πρόσθετο του OBS Woo Export και δεν λειτουργεί χωρίς αυτό.
Λύση: Εγκαταστήστε και ενεργοποιήστε πρώτα το OBS Woo Export. Αν δεν το έχετε στις λήψεις σας, ζητήστε το από την OBS. - Σύμπτωμα: Το αρχείο δεν ανανεώνεται αυτόματα.
Αιτία: Δεν υπάρχει εργασία cron στον server ή το WP-Cron δεν τρέχει.
Λύση: Προσθέστε server cron για το wp-content/plugins/obs-woo-export/cron.php και ελέγξτε την ώρα της τελευταίας εξαγωγής. - Σύμπτωμα: Ο έλεγχος του Public αναφέρει ότι λείπει η κεφαλίδα «Τελευταία τροποποίηση».
Αιτία: Ο server ή το CDN δεν στέλνει την κεφαλίδα HTTP Last-Modified για το αρχείο XML.
Λύση: Ζητήστε από τη φιλοξενία να στέλνει Last-Modified για το XML και εξαιρέστε το αρχείο από cache που την αφαιρεί. - Σύμπτωμα: Προϊόντα που έχουν εξαντληθεί εμφανίζονται διαθέσιμα στο Public.
Αιτία: Δεν έχουν διαχείριση αποθέματος: διαθέσιμα προϊόντα χωρίς ποσότητα στέλνονται με 10 και το αρχείο ανανεώνεται αραιά.
Λύση: Ενεργοποιήστε διαχείριση αποθέματος στα προϊόντα και βάλτε server cron για συχνότερη ανανέωση. - Σύμπτωμα: Η χειροκίνητη δημιουργία σταματά ή βγάζει timeout.
Αιτία: Πολλά προϊόντα για ένα αίτημα του browser.
Λύση: Χρησιμοποιήστε server cron και αυξήστε τη μνήμη PHP σε 256M ή περισσότερο.
Βήματα εγκατάστασης
-
Βήμα 1
Plugin activation
Εγκατάσταση, άδεια και ενεργό feed endpoint.
-
Βήμα 2
Product sample
Έλεγχος προϊόντων με διαφορετικές κατηγορίες, τιμές και stock.
-
Βήμα 3
Final feed URL
Παράδοση URL και σημειώσεις για submit στο marketplace.
Συχνές ερωτήσεις
Μπορεί να προσαρμοστεί το feed;
Ναι, όπου χρειάζεται mapping ή exclusions ανά κανόνα.
Γιατί χρειάζεται sample check;
Για να εντοπιστούν missing fields πριν τα δει το marketplace.