Οδηγός εγκατάστασης eMAG XML Feed για WooCommerce

Οδηγός εγκατάστασης eMAG XML Feed για WooCommerce

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

• Ενεργός λογαριασμός πωλητή στο eMAG Marketplace και επαφή με τον account manager σας.
• Έγκυρα EAN (GS1) αποθηκευμένα σε ένα πεδίο του WooCommerce (SKU, custom meta ή attribute).
• Brand ως attribute ή meta, κατηγορίες και εικόνες σε δημόσια HTTPS URLs.
• Φόροι WooCommerce ρυθμισμένοι σωστά, γιατί η τιμή εξάγεται χωρίς ΦΠΑ.
• Αρκετή μνήμη PHP: η σελίδα του plugin προτείνει τουλάχιστον 256M για μεγάλους καταλόγους.

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

1. Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση και επιλέξτε το ZIP του «OBS Emag.ro XML». Ενεργοποίηση. Αν το ZIP που κατεβάσατε είναι κενό, ζητήστε νέο αρχείο από την υποστήριξη.
2. Ανοίξτε WooCommerce → OBS Emagro XML.
3. Στο πλαίσιο «Activate OBS Emagro XML for Update» επικολλήστε το License key στο «Enter Validation Key» και πατήστε Activate. Ένα κλειδί αντιστοιχεί σε ένα domain.

Χάρτης ρυθμίσεων

• Required Setup: Update Frequency (Hourly / Twice a day / Daily), Mode (Bulk / Cron / Chunk), Default Page Size (για Cron/Chunk).
• Attributes: Color Attributes, Size Attributes (καθορίζουν πώς ομαδοποιούνται οι παραλλαγές), Brand Attribute, Default Brand.
• Filters: Include Categories, Exclude Categories, Include Brands, Exclude Brands, Skip Out-of-Stock Products, Skip Backordered Products.
• Overrides: Custom Meta field for EAN, for MPN, for Barcode, for Brand, for Product ID, for Weight, for Availability.
• Availability: Default In-Stock / Out-of-Stock / Backorder Availability και taxonomies διαθεσιμότητας.
• Άλλα: Product Description (ποια περιγραφή εξάγεται), Product Name Composer, Skip product meta.
• Advanced: Test Export Product Limit, Test Export SKU Filter.

Δοκιμή και validation

1. Βάλτε 5–10 SKU στο Test Export SKU Filter (παραλλαγές, προϊόν χωρίς stock management, προϊόν με έκπτωση) και πατήστε Quick test export.
2. Ελέγξτε ότι κάθε προϊόν έχει EAN, brand, κατηγορία, εικόνα και τιμή χωρίς ΦΠΑ.
3. Πατήστε Generate feed now. Τα αρχεία γράφονται στο wp-content/uploads/obs-xml-export/: emagro.xml και emagro_update.xml.
4. Ανοίξτε τα URLs σε browser εκτός του δικτύου σας. Πρέπει να επιστρέφουν HTTP 200 και έγκυρο XML.

Αυτόματη ανανέωση

Η σελίδα «Scheduling» εμφανίζει την εντολή server cron (php …/wp-content/plugins/obs-emagro-xml/cron.php). Σε καταστήματα με λίγη επισκεψιμότητα προτιμήστε server cron αντί για WP-Cron, ώστε το feed να ανανεώνεται στην ώρα του.

Go-live checklist

• License key ενεργό, feeds με ημερομηνία created_at σημερινή.
• Το eMAG έχει πρόσβαση στα URLs (χωρίς basic auth, firewall ή bot protection που μπλοκάρει ξένες IP).
• Δηλωμένο το πλήρες feed και το feed ενημέρωσης στο eMAG.
• Category mapping ολοκληρωμένο στην πλατφόρμα του eMAG.
• Cron ενεργό και δεύτερη παραγωγή επιτυχής μετά από αλλαγή τιμής/stock.

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

• Σύμπτωμα: Το eMAG δεν βλέπει EAN ή στο feed εμφανίζεται το SKU αντί για barcode.
  Αιτία: Το «Custom Meta field for EAN» δεν δείχνει στο πεδίο όπου είναι αποθηκευμένα τα barcodes, ή τα προϊόντα δεν έχουν EAN.
  Λύση: Βρείτε το ακριβές meta key ή attribute του barcode, ορίστε το στο πεδίο EAN, ξαναπαράγετε και ελέγξτε δείγμα. Προϊόντα χωρίς GS1 EAN χρειάζονται συμπλήρωση στο κατάστημα.
• Σύμπτωμα: Email «Feed blocked» από το eMAG ή σφάλμα ανάγνωσης.
  Αιτία: Το eMAG δεν μπόρεσε να διαβάσει το αρχείο: μπλοκάρισμα από firewall/CDN, κενό ή ημιτελές XML, ή αρχείο που γράφεται εκείνη τη στιγμή.
  Λύση: Ανοίξτε το URL από εξωτερικό δίκτυο, ελέγξτε ότι επιστρέφει HTTP 200 και έγκυρο XML, επιτρέψτε την πρόσβαση στο CDN/firewall και ξαναπαράγετε το feed.
• Σύμπτωμα: Το αρχείο περιέχει μόνο το κέλυφος «products» χωρίς προϊόντα.
  Αιτία: Τα φίλτρα (κατηγορίες, brands, stock) εξαιρούν όλα τα προϊόντα ή η παραγωγή διακόπηκε από όριο μνήμης/χρόνου.
  Λύση: Ελέγξτε Include/Exclude Categories και Skip Out-of-Stock, δείτε το WooCommerce log, αυξήστε τη μνήμη PHP ή γυρίστε σε Mode Chunk.
• Σύμπτωμα: Το eMAG ζητά τιμές χωρίς ΦΠΑ και αριθμητικό stock στο «short» feed.
  Αιτία: Δηλώθηκε μόνο το πλήρες feed.
  Λύση: Δηλώστε και το emagro_update.xml, που περιέχει id, EAN, τιμή χωρίς ΦΠΑ και stock.
• Σύμπτωμα: Το feed δεν ανανεώνεται καθημερινά.
  Αιτία: Το WP-Cron δεν τρέχει χωρίς επισκέψεις ή δεν έχει οριστεί server cron.
  Λύση: Προσθέστε την εντολή server cron που δείχνει η σελίδα «Scheduling» και ελέγξτε το «Last successful export».