Kaleidoscope
Shopify webhooks
Γενικά
Τα Shopify Webhooks αποτελούν ενέργειες που μπορούν να οριστούν στο Shopify, ώστε όταν συμβαίνει ένα συγκεκριμένο γεγονός (πχ. εκπλήρωση παραγγελίας), να εκτελείται η αντίστοιχη εντολή για έκδοση παραστατικού που έχει οριστεί στο Workadu.
Προϋποθέσεις
Για να ενεργοποιήσετε τα Shopify Webhooks θα χρειαστείτε τα παρακάτω:
- ένα λογαριασμό Workadu - πραγματοποιήστε Δωρεάν εγγραφή εδώ
- ένα λογαριασμό Shopify
- κωδικούς διασύνδεσης με ΑΑΔΕ MyData - Δείτε τις οδηγίες εδώ
- Διασύνδεση και ενεργό πλάνο τιμολόγησης με πάροχο (δεν απαιτείται για τις δοκιμές) - Μιλήστε με το τμήμα υποστήριξης μέσω του Chat Sytem, στο κάτω δεξιά μέρος, στο διαχεριστικό περιβάλλον της πλατφόρμας μας
Υλοποίηση διασύνδεσης
1. Στο Shopify λογαριασμό σας, πάτε
- Από το διαχειριστικό του Shopify, επιλέγετε κάτω αριστερά Settings > Notifications.
- Πάτε στην συνέχεια στην ενότητα Webhooks .
- Αντιγράψετε τη συμβολοσειρά που βρίσκεται κάτω από το λεκτικό "All your webhooks will be signed with", ώστε να την επικολλήσετε στο Workadu.
2. Στη συνέχεια θα πάτε στο app του Workadu. Θα πατήσετε στις 3 τελίτσες στη μέση-αριστερά της οθόνης όπου βρίσκεται η ενότητα "Περισσότερα" και θα πατήσετε την επιλογή "Συνδέσεις". Έπειτα, θα κατεβείτε προς τα κάτω μέχρι να βρείτε την επιλογή Shopify Webhooks και θα πατήσετε το κουμπί "Διασύνδεση".
3. Μέσα στη διασύνδεση θα δείτε 4 πεδία τα οποία πρέπει να συμπληρώσετε
- Το πεδίο "Send email to client", παίρνει τιμές "true" ή "false".
- Στο πεδίο "Shopify signed hased code", κάνετε επικόλληση της συμβολοσειράς που έχετε αντιγράψει από το Shopify στο Βήμα 2.
- Το πεδίο "Suppress customer data", παίρνει τιμές "true", "false" ή το αφήνετε κενό.
- Το πεδίο "Bypass shopify shipping tax policy", παίρνει τιμές "true" ή "false"
- Μόλις συμπληρώσετε τα πεδία πατήστε "Αποθήκευση και σύνδεση".
4. Στη συνέχεια, επιλέξτε τον τύπο παραστατικού που θέλετε να εκδίδετε, αντιγράφοντας έναν από τους 3 προτεινόμενους τύπους παραστατικών που εμφανίζονται. Εάν ο τύπος παραστατικού που θέλετε δεν εμφανίζεται σε αυτού παρακαλώ επικοινωνήστε με την υποστήριξη της πλατφόρμας μας.
5. Μόλις ολοκληρώσετε τη δημιουργία στο Workadu, οδηγηθείτε πάλι στο Shopify και πηγαίνετε στο ίδιο σημείο που αντιγράψατε τη συμβολοσειρά στο Βήμα 1 :
- Πατήστε το κουμπί Create webhook.
- Κατεβείτε προς τα κάτω στη λίστα των events, και επιλέξτε το "Order fulfilment" μόλις το βρείτε.
- Στο πεδίο URL επικολλήστε τον τύπο παραστατικού που αντιγράψατε στο παραπάνω βήμα.
- Στο πεδίο Webhook API version, βάζεδτε πάντα αυτό που έχει στην παρένθεση (Latest) και πατάτε "Save".
6. Tέλος, για να ελέγξετε αν έχετε κάνει σωστά τη διασύνδεση, πατήστε το κουμπί "Send test" κάτω από την επεξαργασία και θα μπορείτε να δείτε το παραστατικό που δημιουργήθηκε στην ενότητα Οικονομικά > Παραστατικά στο Workadu.
- Η διασύνδεση Shopify Webhooks λειτουργεί μόνο με έναν τύπο παραστατικού, δηλαδή δεν υπάρχει δυνατότητα για διαχωρισμός των τύπων παραστατικών που θέλετε να εκδίδετε αυτόματα. Σε περίπτωση που χρειάζεστε παραπάνω από έναν τύπο, σας παρέχουμε αναλυτική εκπαίδευση για τον τρόπο που μπορείτε να μετασχηματίσετε τα παραστατικά σας μέσα από το app του Workadu.
- Σε περίπτωση που επιθυμείτε την αυτόματη έκδοση τιμολογίου, θα πρέπει στο metadata της παραγγελίας να υπάρχει το πεδίο
tax_id: EL1234567890, ώστε το σύστημα να μπορεί να διαβάσει το ΑΦΜ και να εκδώσει τον αντίστοιχο τύπο παραστατικού. - Σε περίπτωση που στο παραστατικό σας δεν είναι σωστή η προβολή του ΦΠΑ για την εκάστοτε χώρα, παρακαλώ ελέγξτε ότι έχετε ρυθμίσει σωστά τα "Markets" μέσα από τις ρυθμίσεις "Taxes and duties" του Shopify, είναι πολύ σημαντικό το πεδίο "Include sales tax in product price and shipping rate" να είναι τεσκαρισμένο πάντα, ώστε μπορούν να επιβληθούν φόροι στα προϊόντα σας.
Go live
Αφού πραγματοποιηθούν τα παραπάνω βήματα, και σιγουρευτείτε πως η διαβίβαση παραστατικών είναι σωστή, μέσω της αποστολής του "test" θα πρέπει να προχωρήσετε μέσω της υποστήριξης μας σε διασύνδεση με την ΑΑΔΕ MyData. Στην περίπτωση διασύνδεσης με πάροχο ηλεκτρονικής τιμολόγησης θα πρέπει να γίνουν επιπλέον βήματα. Παρακάτω θα βρείτε την διαδικασία μετά την ενεργοποίηση των webhooks ώστε να γίνει η πιστοποίηση από δικό μας τεχνικό σύμβουλο.
- Ενεργοποίηση συνδρομητικού πλάνου στο Workadu
- Ολοκλήρωση της διαδικασίας έκδοσης παραστατικών μέσω παρόχου (Αποδείξεις Λιανικής). Δείτε οδηγίες εδώ
- Έκδοση δοκιμαστικής παραγγελίας στο eshop. Είσοδος στο workadu και έλεγχος του παραστατικού που έχει εκδοθεί.
- Αίτημα προς την υποστήριξη μας (9:00-17:00) μέσω chat σύστημα εντός του Workadu
