To παρόν άρθρο έχει σαν σκοπό να περιγράψει την δομή και την λειτουργικότητα που πρέπει να έχει το XML που παρέχει ένα ηλεκτρονικό κατάστημα στο Psarema.gr - Myeshop.

Η δομή του XML δεν χρειάζεται να είναι συγκεκριμένη αρκεί να περιέχονται τουλάχιστον τα απαραίτητα πεδία όπως αυτά περιγράφονται στην αντίστοιχη ενότητα.

ΠΙΝΑΚΑΣ ΠΕΡΙΕΧΟΜΕΝΩΝ

  • Απαιτήσεις
  • Τεχνικά Χαρακτηριστικά
  • XML Declaration
  • Πεδία
  • Παράδειγμα XML

Απαιτήσεις

Σε γενικές γραμμές το XML αρχείο είναι απαραίτητο να πληροί τις εξής προδιαγραφές:

Να παρέχει πληροφορία την ώρα που δημιουργήθηκε.
Να μην επαναλαμβάνει τα ίδια προϊόντα.
Να περιλαμβάνει τον νόμιμο Φ.Π.Α στις τιμές.

Τεχνικά Χαρακτηριστικά

Για να μπορεί να γίνει δεκτό το Data Feed θα πρέπει να περιέχει όλα τα υποχρεωτικά πεδία που πληρούν τις προδιαγραφές όπως αυτές ορίζονται παρακάτω.

XML Declaration
Το XML θα πρέπει να περιλαμβάνει οπωσδήποτε το encoding του αρχείου και την ημερομηνία δημιουργίας.

Η ημερομηνία δημιουργίας χρησιμοποιείται για να εξακριβώσουμε αν κάποιο αρχείο περιέχει ενημερωμένα δεδομένα ή όχι.

ΠΑΡΑΔΕΙΓΜΑ

<storename="Psarema">

<date>2015-07-10 09:26:01</date>

</store>

ΣΗΜΕΙΩΣΗ: Αν τα αρχεία δεν παράγονται σε πραγματικό χρόνο, θα πρέπει να φροντίσετε η διαδικασία αυτή να γίνεται τουλάχιστον μία φορά την ημέρα και σε ώρα την οποία θα μας γνωστοποιήσετε.

Απαραίτητα πεδία XML feed
Στον παρακάτω πίνακα μπορείτε να δείτε περιληπτικά τα απολύτως απαραίτητα πεδία που αναγνωρίζονται από το Psarema.gr - Myeshop:

<storename="Psarema">

<date>2015-07-10 09:26:01</date>

<product>

<productId>815</productId> 

( To πεδίο αυτό είναι το μοναδικό αναγνωριστικό του προϊόντος στο κατάστημά σας. Η τιμή του πεδίου αυτού είναι υποχρεωτικό να παραμείνει ίδια καθ' όλη τη διάρκεια "ζωής" του προϊόντος.)

<product_parent_id>0</product_parent_id>

( To πεδίο αυτό είναι το μοναδικό αναγνωριστικό του γονικού προϊόντος στο κατάστημά σας. Η τιμή του πεδίου αυτού είναι υποχρεωτικό να παραμείνει ίδια καθ' όλη τη διάρκεια "ζωής" του προϊόντος.)

<title>

<![CDATA[ Βεντούζα ξεπλύματος μηχανής ]]>

</title>

(Ο τίτλος του προϊόντος. Στον τίτλο είναι απαραίτητο να υπάρχει σωστή καταχώριση του προϊόντος. Όσο πιο ακριβής είναι ο τίτλος του προϊόντος, τόσο πιο ακριβή θα είναι το αποτέλεσμα της αναζήτησης.)

<prices>

<basePriceWithTax>4.80</basePriceWithTax>

<salesPrice>4.80</salesPrice>

</prices>

(Οι τιμές του προϊόντος. )

<imagesURL>

<img1>

<![CDATA[

http://www.rizoulis.gr/images/stories/virtuemart/product/_________________499c0da4405f4.jpg

]]>

</img1>

<img2>

<![CDATA[

http://www.rizoulis.gr/images/stories/virtuemart/product/_________________499c0da4405f4.jpg

]]>

</img2>

<img3>

<![CDATA[

http://www.rizoulis.gr/images/stories/virtuemart/product/_________________499c0da4405f4.jpg

]]>

</img3>

</imagesURL>

(Οι εικόνες του προϊόντος. Μπορείτε να στέλνετε έως 3 εικόνες ανά προϊόν )

<url>

<![CDATA[

http://www.rizoulis.gr/eshop/naftiliaka/eksoplismos-skafous/ventoyza-kseplymatos-mixanis-detail

]]>

</url>

(Το URL ( link ) του προϊόντος στο κατάστημά σας. O σύνδεσμος αυτός είναι απαραίτητο να οδηγεί σε σελίδα προϊόντος και όχι σε κατηγορία ή συλλογή προϊόντων.)

<category_name>

<![CDATA[ Ναυτιλιακά->Εξοπλισμός Σκάφους ]]>

</category_name>

(Το όνομα της κατηγορίας ή το path της με μορφή Κατηγορία -> Υποκατηγορία )

<sku>EV-2942</sku>

( Ο κωδικός του προϊόντος SKU )

<brand>

<![CDATA[ EVAL ]]>

</brand>

( Το όνομα του προμηθευτή του προϊόντος )

<product_in_stock>11</product_in_stock>

( Το stock του προϊόντος σε τεμάχια )

<availability>Σε απόθεμα</availability>

( Περιγραφή διαθεσιμότητας )

<product_weight>0.3800</product_weight>

( Το βάρος του προϊόντος σε μονάδα όπως αυτή περιγράφετε στην ιδιότηταproduct_weight_uom )

<product_weight_uom>KG</product_weight_uom>

( Μονάδα μέτρηση βάρους του προϊόντος )

<description>

<![CDATA[

<ul><li><span style="color: #000000;">Βεντούζα ξεπλύματος εξωλέμβιας μηχανής</span></li><li><span style="color: #000000;">Τετράγωνη</span></li></ul>

]]>

</description>

( Η περιγραφή που θέλετε να βλέπουν οι επισκέπτες )

</product>

</store>

Παράδειγμα ενός πλήρες και σωστό XML

Το παρακάτω είναι ένα τμήμα ενός ενδεικτικού XML ( 1 προϊόν ) όπως αναγνωρίζεται από το Myeshop

<storename="Psarema">

<date>2015-07-10 09:26:01</date>

<product>

<productId>815</productId>

<product_parent_id>0</product_parent_id>

<title>

<![CDATA[ Βεντούζα ξεπλύματος μηχανής ]]>

</title>

<prices>

<costPrice>3.90</costPrice>

<basePrice>3.90</basePrice>

<basePriceVariant>3.90</basePriceVariant>

<basePriceWithTax>4.80</basePriceWithTax>

<discountedPriceWithoutTax>3.90</discountedPriceWithoutTax>

<priceBeforeTax>3.90</priceBeforeTax>

<salesPrice>4.80</salesPrice>

<taxAmount>0.90</taxAmount>

<salesPriceWithDiscount>0.00</salesPriceWithDiscount>

<salesPriceTemp>4.80</salesPriceTemp>

<unitPrice>0.00</unitPrice>

<priceWithoutTax>3.90</priceWithoutTax>

<discountAmount>0.00</discountAmount>

<variantModification>0.00</variantModification>

</prices>

<imagesURL>

<img1>

<![CDATA[

http://www.rizoulis.gr/images/stories/virtuemart/product/_________________499c0da4405f4.jpg

]]>

</img1>

</imagesURL>

<url>

<![CDATA[

http://www.rizoulis.gr/eshop/naftiliaka/eksoplismos-skafous/ventoyza-kseplymatos-mixanis-detail

]]>

</url>

<category_id>175</category_id>

<category_name>

<![CDATA[ Ναυτιλιακά->Εξοπλισμός Σκάφους ]]>

</category_name>

<sku>EV-2942</sku>

<brand>

<![CDATA[ EVAL ]]>

</brand>

<instock>Y</instock>

<product_in_stock>11</product_in_stock>

<product_available_date>2015-05-01 00:00:00</product_available_date>

<availability>Σε απόθεμα</availability>

<availability_key>instock</availability_key>

<product_weight>0.3800</product_weight>

<product_weight_uom>KG</product_weight_uom>

<product_lwh_uom>M</product_lwh_uom>

<product_unit>KG</product_unit>

<created_on>2009-02-18 13:31:16</created_on>

<modified_on>2015-07-03 09:39:16</modified_on>

<product_s_desc>

<![CDATA[ Βεντούζα ξεπλύματος εξωλέμβιας μηχανής... ]]>

</product_s_desc>

<description>

<![CDATA[

<ul><li><span style="color: #000000;">Βεντούζα ξεπλύματος εξωλέμβιας μηχανής</span></li><li><span style="color: #000000;">Τετράγωνη</span></li></ul>

]]>

</description>

</product>

</store>

Για να δοκιμάσετε το XML σας παρακαλώ επικοινωνήστε μαζί μας ΕΔΩ