Για συνεργαζόμενα e-shops

Οδηγός δημιουργίας XML feed

Αυτός ο οδηγός εξηγεί πώς να φτιάξει ο τεχνικός σας ένα αρχείο XML με τα προϊόντα του καταστήματός σας, ώστε να εμφανίζονται αυτόματα στο GoldenMall. Μπορείτε να τον στείλετε αυτούσιο στον developer σας.

Γίνε συνεργάτης → Δείτε παράδειγμα XML Έλεγχος XML

Η πιο σημαντική αρχή

Το XML δεν είναι στατικό αρχείο που ανεβάζετε μία φορά. Πρέπει να βρίσκεται σε ένα δημόσιο URL και κάθε φορά που το καλεί το GoldenMall να δημιουργείται εκείνη τη στιγμή με τις τρέχουσες τιμές, διαθεσιμότητες και νέα προϊόντα.

Το GoldenMall κατεβάζει το feed περιοδικά (κάθε 6 ώρες) και κατά χειροκίνητη εισαγωγή από το panel. Αν αλλάξει μια τιμή στο e-shop σας, πρέπει να φαίνεται αμέσως στο επόμενο XML — χωρίς χειροκίνητη παρέμβαση.

Βήμα 1

Δημιουργία URL

Ο τεχνικός φτιάχνει endpoint που παράγει XML live από τη βάση του e-shop.

Βήμα 2

Δοκιμή

Ανοίγετε το URL στον browser — πρέπει να βλέπετε έγκυρο XML με όλα τα προϊόντα.

Βήμα 3

Καταχώρηση

Δίνετε το URL στο GoldenMall (κατά την εγγραφή ή από το partner panel).

Τεχνικές απαιτήσεις

Τι πρέπει να ισχύει για το URL και το αρχείο.

Απαίτηση	Λεπτομέρεια
URL	Δημόσιο HTTPS link, προσβάσιμο χωρίς login (π.χ. `https://shop.gr/feeds/goldenmall.xml`)
Δυναμική παραγωγή	Το XML δημιουργείται on-the-fly από τη βάση — όχι cached αρχείο που ενημερώνεται χειροκίνητα
Κωδικοποίηση	UTF-8
Μορφή	XML (`STOREITEMS`) — δείτε παρακάτω
Συμπίεση (προαιρετικά)	Υποστηρίζονται επίσης gzip (.gz) και zip που περιέχει .xml
Timeout	Το server σας πρέπει να απαντά εντός 180 δευτερολέπτων

Πεδία κάθε προϊόντος

Τα tags μέσα στο στοιχείο <product>.

Tag	Υποχρεωτικό	Περιγραφή
<id>	Ναι	Μοναδικό ID προϊόντος στο e-shop σας (SKU ή product ID). Δεν αλλάζει ποτέ.
<name>	Ναι	Πλήρης τίτλος προϊόντος.
<link>	Ναι	Άμεσος σύνδεσμος στη σελίδα του προϊόντος. Εναλλακτικά μπορεί να χρησιμοποιηθεί `<url>`.
<image>	Συνιστάται	URL κύριας εικόνας. Χωρίς εικόνα το προϊόν δεν εμφανίζεται στο GoldenMall.
<category>	Συνιστάται	Διαδρομή κατηγορίας με `>` ως διαχωριστή, π.χ. Σπίτι > Κουζίνα > Σκεύη
<price>	Συνιστάται	Τελική τιμή με ΦΠΑ, δεκαδικό με τελεία (π.χ. `49.90`). Εναλλακτικά: `<price_with_vat>` ή `<price_incl_vat>`
<instock>	Συνιστάται	`Y` ή `N`. Αν λείπει, θεωρείται διαθέσιμο (`Y`).
<availability>	Προαιρετικό	Κείμενο διαθεσιμότητας, π.χ. «Άμεσα Διαθέσιμο», «1–3 ημέρες».
<quantity>	Προαιρετικό	Αριθμός αποθέματος. Αν > 0, θεωρείται διαθέσιμο.
<manufacturer>	Προαιρετικό	Μάρκα / κατασκευαστής.
<description>	Προαιρετικό	Περιγραφή προϊόντος (plain text ή HTML).
<ean> / <mpn>	Προαιρετικό	Barcode (EAN) και κωδικός κατασκευαστή (MPN).
<sku>	Προαιρετικό	Κωδικός SKU (αν διαφέρει από το id).
<vat>	Προαιρετικό	Ποσοστό ΦΠΑ (π.χ. `24`).
<size>	Προαιρετικό	Μέγεθος (για ρούχα, παπούτσια κ.λπ.).
<additional_imageurl>	Προαιρετικό	Επιπλέον εικόνες — μπορεί να επαναληφθεί πολλές φορές.

Παράδειγμα XML

Η βασική δομή που αναμένει το GoldenMall.

<?xml version="1.0" encoding="UTF-8"?>
<STOREITEMS>
  <created_at>2026-10-09 23:17</created_at>
  <products>
    <product>
      <id>12345</id>
      <sku><![CDATA[SKU-001]]></sku>
      <name><![CDATA[Φαγητοδοχείο Stitch με μαχαιροπίρουνα 21x14x6εκ.]]></name>
      <link><![CDATA[https://www.example.gr/product/12345]]></link>
      <image><![CDATA[https://www.example.gr/images/product-12345.jpg]]></image>
      <additional_imageurl><![CDATA[https://www.example.gr/images/product-12345-2.jpg]]></additional_imageurl>
      <category><![CDATA[Σπίτι > Κουζίνα > Φαγητοδοχεία]]></category>
      <description><![CDATA[Περιγραφή προϊόντος…]]></description>
      <price>12.90</price>
      <quantity>25</quantity>
      <vat>24</vat>
      <ean><![CDATA[5200000000000]]></ean>
      <mpn><![CDATA[MPN-001]]></mpn>
      <manufacturer><![CDATA[Disney]]></manufacturer>
      <size><![CDATA[21x14x6εκ.]]></size>
      <instock>Y</instock>
      <availability><![CDATA[Άμεσα Διαθέσιμο]]></availability>
    </product>
    <!-- …επαναλάβετε <product> για κάθε προϊόν… -->
  </products>
</STOREITEMS>

Χρησιμοποιήστε <![CDATA[…]]> για κείμενα με ειδικούς χαρακτήρες (&, <, ελληνικά κ.λπ.). Το πεδίο <created_at> είναι προαιρετικό — δείχνει πότε δημιουργήθηκε το feed.

Παραλλαγές (variations)

Για προϊόντα με πολλαπλά μεγέθη ή χρώματα — προαιρετικό.

<variations>
  <variation>
    <variantionid><![CDATA[var-42]]></variantionid>
    <size><![CDATA[42]]></size>
    <quantity>5</quantity>
    <link><![CDATA[https://www.example.gr/product/12345?size=42]]></link>
    <availability><![CDATA[Άμεσα Διαθέσιμο]]></availability>
  </variation>
</variations>

Πώς συγχρονίζεται το GoldenMall

Αυτόματος συγχρονισμός

Κάθε 6 ώρες το GoldenMall κατεβάζει το URL σας και ενημερώνει προϊόντα, τιμές και διαθεσιμότητες.

Νέα προϊόντα

Αν προσθέσετε νέο προϊόν στο e-shop και εμφανιστεί στο XML, θα εμφανιστεί αυτόματα στο GoldenMall στο επόμενο sync.

Αφαίρεση προϊόντων

Αν ένα προϊόν δεν υπάρχει πλέον στο XML, αφαιρείται αυτόματα από τον κατάλογο GoldenMall (εκτός αν έχει κλειδωθεί χειροκίνητα).

Χειροκίνητη εισαγωγή

Από το partner panel μπορείτε να τρέξετε «Έλεγχος» ή «Εισαγωγή» ανά πάσα στιγμή — το feed κατεβαίνει live από το URL.

Συμβουλές για τον τεχνικό

✓ Μην cache-άρετε το XML για ώρες — κάθε κλήση στο URL πρέπει να διαβάζει τρέχοντα δεδομένα.
✓ Οι εικόνες πρέπει να είναι δημόσιες (HTTPS) και υψηλής ποιότητας — χωρίς watermark.
✓ Δώστε όσο πιο συγκεκριμένη διαδρομή κατηγορίας γίνεται — βοηθά στη σωστή τοποθέτηση στο GoldenMall.
✓ Βεβαιωθείτε ότι το <id> παραμένει σταθερό — αν αλλάξει, θα δημιουργηθεί διπλότυπο προϊόν.
✓ Αν χρησιμοποιείτε firewall, επιτρέψτε πρόσβαση από user-agent GoldenMallFeedBot/1.0.

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

Έχω ήδη XML feed — δουλεύει;

Ναι. Αν το e-shop σας ήδη παράγει XML (STOREITEMS), μπορείτε να χρησιμοποιήσετε το ίδιο URL. Βεβαιωθείτε μόνο ότι περιλαμβάνει όλα τα προϊόντα που θέλετε να εμφανίζονται στο GoldenMall.

Μπορώ να στείλω CSV αντί για XML;

Το αυτόματο sync λειτουργεί με XML URL. Το CSV υποστηρίζεται για χειροκίνητη εισαγωγή από το partner panel. Για μόνιμη σύνδεση, προτείνουμε XML.

Πόσο γρήγορα εμφανίζονται αλλαγές;

Μέχρι 6 ώρες (αυτόματα) ή αμέσως αν τρέξετε χειροκίνητη εισαγωγή από το panel. Γι' αυτό το XML πρέπει να είναι πάντα ενημερωμένο live — όχι στατικό αρχείο.

Έτοιμοι να ξεκινήσετε;

Στείλτε αυτόν τον οδηγό στον τεχνικό σας, δημιουργήστε το XML URL και κάντε αίτηση συνεργασίας.

Γίνε συνεργάτης GoldenMall →