Η διασύνδεση Skroutz Marketplace επιτρέπει στο Sebastien να λαμβάνει παραγγελίες που πραγματοποιούνται μέσω του Skroutz Smart Cart και να τις ενσωματώνει στην κανονική ροή παραγγελιών του e-shop και του ERP.

Όταν ένας πελάτης ολοκληρώνει μία αγορά μέσω του Smart Cart, η παραγγελία δημιουργείται αρχικά στο Skroutz. Μέσω webhook αποστέλλεται στο Sebastien, το οποίο αναλαμβάνει να επεξεργαστεί τα δεδομένα της και, ανάλογα με τις ρυθμίσεις της διασύνδεσης, να δημιουργήσει την αντίστοιχη παραγγελία στο e-shop.

Από εκεί μπορεί να ακολουθηθεί η συνήθης διαδικασία αποστολής της παραγγελίας προς το ERP.

Οι παραγγελίες που προέρχονται από το Skroutz είναι διαθέσιμες και στην ενότητα Skroutz του Sebastien, όπου μπορείτε να παρακολουθείτε την κατάστασή τους και τη σύνδεσή τους με την αντίστοιχη παραγγελία του e-shop και του ERP.

Smart Cart Webhook

Το Smart Cart Webhook είναι το endpoint μέσω του οποίου το Skroutz αποστέλλει στο Sebastien νέες παραγγελίες και ενημερώσεις υπαρχουσών παραγγελιών.

Webhook URL

Το Sebastien εμφανίζει το ακριβές Webhook URL που αντιστοιχεί στο συγκεκριμένο project.

Το URL αυτό πρέπει να καταχωρηθεί στις αντίστοιχες ρυθμίσεις του Skroutz Smart Cart. Με αυτόν τον τρόπο, όταν δημιουργείται ή ενημερώνεται μία παραγγελία στο Skroutz, η πλατφόρμα γνωρίζει σε ποιο endpoint του Sebastien πρέπει να αποστείλει τα δεδομένα.

Χρησιμοποιήστε το Webhook URL ακριβώς όπως εμφανίζεται στο Sebastien. Το URL περιλαμβάνει τα απαραίτητα στοιχεία για την αναγνώριση του project και δεν πρέπει να τροποποιείται.

Έλεγχος Webhook

Πριν ενεργοποιηθεί η διασύνδεση στο Skroutz, μπορείτε να χρησιμοποιήσετε το Check webhook για να ελέγξετε αν πληρούνται οι βασικές τεχνικές προϋποθέσεις λειτουργίας.

Ο έλεγχος πραγματοποιείται σε διαδοχικά στάδια, ώστε να είναι ευκολότερο να εντοπιστεί το σημείο στο οποίο υπάρχει πρόβλημα.

DNS A record και Server Alias

Για τη λειτουργία του webhook απαιτείται subdomain της μορφής:

sebastien.example.gr

Το subdomain πρέπει να διαθέτει DNS A record που να δείχνει στον server του Sebastien.

Ο έλεγχος μπορεί να επιστρέψει:

• ότι δεν υπάρχει A record,
• ότι υπάρχει αλλά δείχνει σε λανθασμένη IP,
• ή ότι έχει ρυθμιστεί σωστά.

Όταν υπάρχει πρόβλημα, το Sebastien εμφανίζει και την IP στην οποία πρέπει να δείχνει το A record.

Μετά από αλλαγή ενός DNS record μπορεί να απαιτηθεί χρόνος μέχρι να γίνει διαθέσιμη η νέα ρύθμιση. Επαναλάβετε τον έλεγχο αφού ολοκληρωθεί η ενημέρωση του DNS.

Αφού επιβεβαιωθεί το DNS, ελέγχεται ότι ο server μπορεί να εξυπηρετήσει σωστά το συγκεκριμένο subdomain και ότι υπάρχει έγκυρη HTTPS επικοινωνία.

Το επιτυχές DNS check δεν σημαίνει από μόνο του ότι το webhook είναι έτοιμο. Όλοι οι τεχνικοί έλεγχοι πρέπει να ολοκληρώνονται επιτυχώς πριν χρησιμοποιηθεί το URL στο Skroutz.

Αν ο έλεγχος αποτύχει σε αυτό το στάδιο, απαιτείται έλεγχος της ρύθμισης του server από την τεχνική ομάδα που διαχειρίζεται το περιβάλλον.

Test Order

Η δοκιμή προσομοιώνει τη λήψη μιας παραγγελίας Skroutz και ελέγχει την επεξεργασία της από το Sebastien και τη συνέχεια της ροής προς το e-shop (και το ERP εφόσον υπάρχει σύνδεση), χωρίς να απαιτείται πραγματικό webhook από το Skroutz.

Η επιλογή Create test order ανοίγει μία φόρμα όπου μπορεί να δημιουργηθεί μία ελεγχόμενη δοκιμαστική παραγγελία, ώστε να επιβεβαιωθεί ότι ολόκληρη η ροή λειτουργεί σωστά.

Για να περάσει η δοκιμαστική παραγγελία στο e-shop απαιτείται η χρήση ενός πραγματικού SKU.

Η δοκιμή επιτρέπει να ελεγχθεί ότι:

1. το Sebastien μπορεί να λάβει και να επεξεργαστεί μία Smart Cart παραγγελία,
2. εφαρμόζονται οι ρυθμίσεις και τα mappings της διασύνδεσης,
3. μπορεί να δημιουργηθεί η αντίστοιχη παραγγελία στο e-shop,
4. η παραγγελία μπορεί να συνεχίσει στην προβλεπόμενη ροή προς το ERP.

Το Check webhook και το Create test order εξυπηρετούν διαφορετικό σκοπό. Το πρώτο ελέγχει τις τεχνικές προϋποθέσεις επικοινωνίας, ενώ το δεύτερο ελέγχει τη λειτουργία της πραγματικής ροής μιας παραγγελίας.

Skroutz Smart Cart

Η ενότητα Skroutz Smart Cart καθορίζει τον τρόπο με τον οποίο οι παραγγελίες του Skroutz θα δημιουργούνται στο e-shop.

Enabled

Ενεργοποιεί ή απενεργοποιεί τη δημιουργία Smart Cart παραγγελιών στο e-shop.

Η επιλογή θα πρέπει να ενεργοποιείται αφού ολοκληρωθεί το setup και έχουν επιβεβαιωθεί οι απαραίτητοι έλεγχοι.

Email και Telephone

Καθορίζουν τις προεπιλεγμένες τιμές επικοινωνίας που μπορούν να χρησιμοποιηθούν κατά τη δημιουργία της παραγγελίας.

Στη συνέχεια υπάρχουν και οι επιλογές Random email και Random telephone, οι οποίες επιτρέπουν τη χρήση διαφορετικής τιμής ανά παραγγελία αντί της σταθερής προεπιλεγμένης τιμής.

Payment Method Code

Καθορίζει το payment method code που θα χρησιμοποιείται στο e-shop για τις παραγγελίες που προέρχονται από το Skroutz.

Για παράδειγμα μπορεί να χρησιμοποιηθεί ένα ειδικό payment method όπως:

skroutz_payment

Έτσι οι παραγγελίες Skroutz μπορούν να αναγνωρίζονται και να διαχειρίζονται ανεξάρτητα από τους υπόλοιπους τρόπους πληρωμής του e-shop.

Default Address

Καθορίζει τη διεύθυνση που θα χρησιμοποιείται όταν μία παραγγελία δεν διαθέτει τα απαραίτητα στοιχεία billing ή shipping address.

Μπορούν να οριστούν:

• Street address
• Postal code
• City
• Region
• Country

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

State

Η επιλογή State καθορίζει ποια Skroutz Smart Cart orders θα δημιουργούνται στο e-shop.

Από το UI προκύπτουν δύο βασικές επιλογές:

Open

Οι παραγγελίες εισάγονται στο e-shop όσο βρίσκονται σε κατάσταση Open.

Στη συνέχεια, η εξέλιξη της παραγγελίας στο Skroutz ενημερώνει και την αντίστοιχη παραγγελία στο e-shop. Για παράδειγμα, όταν η παραγγελία γίνει accepted, rejected ή canceled, θα αλλάξει αντίστοιχα και η κατάσταση της παραγγελίας στο e-shop.

Accepted

Η παραγγελία δημιουργείται στο e-shop μόνο αφού γίνει Accepted στο Skroutz.

Αν στη συνέχεια γίνει rejected ή canceled, η αντίστοιχη παραγγελία θα ακυρωθεί και στο e-shop.

Η επιλογή μεταξύ Open και Accepted καθορίζει ουσιαστικά σε ποιο στάδιο του κύκλου ζωής της Skroutz παραγγελίας θέλετε να δημιουργείται η παραγγελία στο e-shop.

Store Code

Καθορίζει το store του e-shop στο οποίο θα δημιουργούνται οι παραγγελίες Skroutz.

Η ρύθμιση είναι ιδιαίτερα σημαντική σε multi-store εγκαταστάσεις.

Shipping Methods

Η ενότητα Shipping Methods αντιστοιχίζει τους τρόπους αποστολής του Skroutz με τους αντίστοιχους τρόπους αποστολής του e-shop.

Για κάθε courier ή μέθοδο παράδοσης του Skroutz μπορούν να οριστούν:

• Courier
• Shipping Carrier Code
• Shipping Method Code

Για παράδειγμα, διαφορετικό mapping μπορεί να υπάρχει για:

• ACS
• Skroutz Last Mile
• Store Pickup
• Courier Center
• ELTA
• DHL

Η αντιστοίχιση είναι απαραίτητη ώστε η παραγγελία να δημιουργηθεί στο e-shop με έγκυρο τρόπο αποστολής.

Τα carrier και method codes πρέπει να αντιστοιχούν σε διαθέσιμους τρόπους αποστολής του e-shop. Λανθασμένο mapping μπορεί να εμποδίσει τη σωστή δημιουργία της παραγγελίας.

Extension Attributes

Τα Extension Attributes επιτρέπουν τη μεταφορά επιπλέον δεδομένων της παραγγελίας Skroutz σε αντίστοιχα πεδία του e-shop.

Για κάθε mapping επιλέγεται:

Extension Attribute → Skroutz Field

Ενδεικτικά mappings:

Extension Attribute	Skroutz Field
vat_number	Invoice details → VAT number
company_name	Invoice details → Company name
company_occupation	Invoice details → Company profession
tax_address	Invoice details → Company public economic service
skroutz_customer_id	Customer details → Unique customer ID
order_comments	Order → Comments

Η δυνατότητα αυτή χρησιμοποιείται όταν η βασική δομή μιας παραγγελίας δεν επαρκεί για όλα τα δεδομένα που πρέπει να αποθηκευτούν ή να σταλούν αργότερα στο ERP.

Το αντίστοιχο extension attribute πρέπει να υπάρχει και να είναι διαθέσιμο στο e-shop ώστε το Sebastien να μπορεί να αποθηκεύσει την τιμή.

Προτεινόμενη διαδικασία αρχικού setup

1. Ρυθμίστε το απαιτούμενο sebastien.* subdomain.
2. Εκτελέστε Check webhook.
3. Διορθώστε DNS ή Server Alias/HTTPS προβλήματα μέχρι όλοι οι έλεγχοι να είναι επιτυχείς.
4. Ρυθμίστε Magento integration, State, Store Code και τα υπόλοιπα βασικά στοιχεία.
5. Αντιστοιχίστε τα Shipping Methods.
6. Αντιστοιχίστε τα απαραίτητα Extension Attributes.
7. Εκτελέστε Create test order και επιβεβαιώστε την end-to-end δημιουργία της παραγγελίας.
8. Καταχωρήστε το Webhook URL στο Skroutz Smart Cart.
9. Ενεργοποιήστε τη διασύνδεση.
10. Επιβεβαιώστε την πρώτη πραγματική παραγγελία από την ενότητα Skroutz.