Shopify webhooks

Shopify webhooks

Γενικά

Τα Shopify Webhooks αποτελούν ενέργειες που μπορούν να οριστούν στο Shopify, ώστε όταν συμβαίνει ένα συγκεκριμένο γεγονός (πχ. εκπλήρωση παραγγελίας), να εκτελείται η αντίστοιχη εντολή για έκδοση παραστατικού που έχει οριστεί στο Workadu.

Προϋποθέσεις

Για να ενεργοποιήσετε τα Shopify Webhooks θα χρειαστείτε τα παρακάτω:

  • ένα λογαριασμό Workadu - πραγματοποιήστε Δωρεάν εγγραφή εδώ
  • ένα λογαριασμό Shopify
  • κωδικούς διασύνδεσης με ΑΑΔΕ MyData - Δείτε τις οδηγίες εδώ
  • Διασύνδεση και ενεργό πλάνο τιμολόγησης με πάροχο (δεν απαιτείται για τις δοκιμές) - Μιλήστε με το τμήμα υποστήριξης μέσω του Chat Sytem, στο κάτω δεξιά μέρος, στο διαχεριστικό περιβάλλον της πλατφόρμας μας

Υλοποίηση διασύνδεσης

1. Στο Shopify λογαριασμό σας, πάτε 

  1. Από το διαχειριστικό του Shopify, επιλέγετε κάτω αριστερά Settings > Notifications.
  2. Πάτε στην συνέχεια στην ενότητα Webhooks .
  3. Αντιγράψετε τη συμβολοσειρά που βρίσκεται κάτω από το λεκτικό "All your webhooks will be signed with", ώστε να την επικολλήσετε στο Workadu.

2. Στη συνέχεια, θα μεταβείτε στο app του Workadu και θα επιλέξετε το εικονίδιο με το κομμάτι παζλ που βρίσκεται κάτω αριστερά στην οθόνη. Από εκεί, θα μπείτε στην ενότητα «Εφαρμογές».


Έπειτα, θα επιλέξετε τη σελίδα «Αυτοματισμοί» και θα μεταβείτε στην επιλογή «Shopify Webhooks». 

3. Μέσα στη διασύνδεση θα δείτε 6 πεδία τα οποία αναφέρονται στις ρυθμίσεις  δεδομένων στο Shopify–Workadu


a. Στο πεδίο "Shopify signed hashed code", κάνετε επικόλληση της συμβολοσειράς που έχετε αντιγράψει.

b. Το πεδίο "Send email to client" δέχεται τις τιμές "true" ή "false", ή μπορεί να παραμείνει κενό.

c. Το πεδίο "Suppress customer data" δέχεται τις τιμές "true", "false", ή μπορεί να παραμείνει κενό.

d. Το πεδίο "Bypass Shopify shipping tax policy" δέχεται τις τιμές "true" ή "false", ή μπορεί να παραμείνει κενό.

e. Το πεδίο "Respect true 0% VAT from Shopify" δέχεται τις τιμές "true" ή "false", ή μπορεί να παραμείνει κενό.

f. Το πεδίο "Λειτουργία whitelist tags – επεξεργασία μόνο παραγγελιών με tag 'receipts'" δέχεται τις τιμές "true" ή "false", ή μπορεί να παραμείνει κενό. 

*για περισσότερες πληροφορίες αναφορικά με τα παραπάνω πεδία πατήστε εδώ

Πρόσθετες Ρυθμίσεις Shopify

Send Email

Αν το πεδίο παραμείνει κενό, τα παραστατικά θα αποστέλλονται αυτόματα στη διεύθυνση email του πελάτη, όπως αυτή είναι καταχωρημένη στο Shopify.

Suppress Customer Data

Η επιλογή Suppress Customer Data χρησιμοποιείται για την προστασία των προσωπικών δεδομένων των πελατών.

Όταν είναι ενεργοποιημένη (True):

  • Το Workadu δεν αποθηκεύει τα προσωπικά στοιχεία του πελάτη.
  • Διατηρείται μόνο η χώρα.
  • Στη θέση του ονόματος του πελάτη καταχωρείται μία τυχαία συμβολοσειρά, ώστε να μην είναι δυνατή η ταυτοποίησή του.

Η ρύθμιση αυτή προορίζεται κυρίως για Αποδείξεις Λιανικής Πώλησης και δεν συνιστάται για παραστατικά όπου απαιτούνται πλήρη στοιχεία πελάτη, όπως οι Αποδείξεις Παροχής Υπηρεσιών.

Bypass Shopify Shipping Tax Policy

Από προεπιλογή, το Workadu υπολογίζει τον ΦΠΑ των μεταφορικών (Shipping) με βάση τον μεγαλύτερο συντελεστή ΦΠΑ που υπάρχει στα προϊόντα της παραγγελίας.

Όταν η επιλογή Bypass Shopify Shipping Tax Policy είναι:

  • False (απενεργοποιημένη): εφαρμόζεται η προεπιλεγμένη συμπεριφορά του Workadu.
  • True (ενεργοποιημένη): το Workadu αγνοεί την πολιτική υπολογισμού του Shopify για τον ΦΠΑ των μεταφορικών και εφαρμόζει τον συντελεστή ΦΠΑ που έχει οριστεί στα Στοιχεία Λογαριασμού του πελάτη στο Workadu.

Respect 0%

Η ρύθμιση Respect 0% καθορίζει τον τρόπο διαχείρισης προϊόντων ή χρεώσεων που έχουν συντελεστή ΦΠΑ 0%.

  • True (ενεργοποιημένη): το Workadu διατηρεί τον συντελεστή 0% και δεν τον αντικαθιστά.
  • False (απενεργοποιημένη): οποιαδήποτε τιμή 0% αντικαθίσταται από τον προεπιλεγμένο συντελεστή ΦΠΑ 24%.

Whitelist Tags

Η ρύθμιση Whitelist Tags επιτρέπει την έκδοση παραστατικών μόνο για παραγγελίες που περιέχουν συγκεκριμένα tags.

Για παράδειγμα, αν οριστεί το tag Receipts, τότε το Workadu θα εκδίδει παραστατικά μόνο για παραγγελίες που διαθέτουν το συγκεκριμένο tag. Όλες οι υπόλοιπες παραγγελίες θα αγνοούνται.

4. Στη συνέχεια, πηγαινετε στη επιλογή σειράς και επιλέξτε τον τύπο παραστατικού που επιθυμείτε να εκδίδετε, επιλέγοντας έναν από τους διαθέσιμους τύπους παραστατικών που εμφανίζονται. Εάν ο επιθυμητός τύπος παραστατικού δεν εμφανίζεται, παρακαλούμε επικοινωνήστε με την υποστήριξη της πλατφόρμας μας. Τελος ενεργοποιηση.

5.Μόλις ολοκληρώσετε τη δημιουργία του webhook στο Workadu, αντιγράψτε τη νέα συμβολοσειρά (URL) και μεταβείτε στο Shopify. Στη συνέχεια:

a.Πατήστε το κουμπί Create webhook.

b.Κατεβείτε προς τα κάτω στη λίστα των events, και επιλέξτε το "Order fulfilment" μόλις το βρείτε.

c.Στο πεδίο URL, επικολλήστε τη συμβολοσειρά που αντιγράψατε από το Workadu.

d.Στο πεδίο Webhook API version, επιλέξτε πάντα την έκδοση που αναγράφει (Latest).

e.Τέλος, πατήστε Save για να αποθηκεύσετε το webhook.

6. Tέλος, για να ελέγξετε αν έχετε κάνει σωστά τη διασύνδεση,  (Μπορείτε να μεταβείτε στο στρογγυλό λογότυπο κάτω αριστερά, να επιλέξετε Στοιχεία λογαριασμού και να αφαιρέσετε το τελευταίο ψηφίο του ΑΦΜ σας. Έτσι, θα μπορείτε να διαγράψετε πιο εύκολα το δοκιμαστικό παραστατικό και στη συνέχεια να προσθέσετε ξανά το σωστό ΑΦΜ.) πατήστε το κουμπί "Send test" κάτω από την επεξαργασία και θα μπορείτε να δείτε το παραστατικό που δημιουργήθηκε στην ενότητα Παραστατικά στο Workadu.:pushpin: Επισήμανση: Μετά την έκδοση του πρώτου παραστατικού, παρακαλούμε να το προωθήσετε στον λογιστή σας, ώστε να επιβεβαιωθεί ότι οι χαρακτηρισμοί και ο ΦΠΑ έχουν καταχωρηθεί σωστά. Έτσι, θα διασφαλιστεί η ορθή παραμετροποίηση πριν την έκδοση των επόμενων παραστατικών.

  1. Η διασύνδεση Shopify Webhooks λειτουργεί μόνο με έναν τύπο παραστατικού, δηλαδή δεν υπάρχει δυνατότητα για διαχωρισμός των τύπων παραστατικών που θέλετε να εκδίδετε αυτόματα. Σε περίπτωση που χρειάζεστε παραπάνω από έναν τύπο, σας παρέχουμε αναλυτική εκπαίδευση για τον τρόπο που μπορείτε να μετασχηματίσετε τα παραστατικά σας μέσα από το app του Workadu
  2. Σε περίπτωση που επιθυμείτε την αυτόματη έκδοση τιμολογίου, θα πρέπει στο metadata της παραγγελίας να υπάρχει το πεδίο tax_id: EL1234567890, ώστε το σύστημα να μπορεί να διαβάσει το ΑΦΜ και να εκδώσει τον αντίστοιχο τύπο παραστατικού. 
  3. Μεταφορέας (Transporter); Στο πεδίο Transporter μπορείτε να ορίσετε τον μεταφορέα που θα χρησιμοποιείται στα παραστατικά διακίνησης. Παράδειγμα • ΒΟX NOW; Εφόσον το παραστατικό περιλαμβάνει διακίνηση, το σύστημα θα συμπληρώσει αυτόματα τον συγκεκριμένο μεταφορέα. Προϋπόθεση είναι ο μεταφορέας να έχει ήδη καταχωρηθεί ως Επαφή (Contact) στο Workadu. ΠΡΟΣΟΧΗ! Για παραστατικά που εκδίδονται προς τρίτες χώρες (εκτός Ευρωπαϊκής Ένωσης), η προεπιλεγμένη συμπεριφορά του συστήματος είναι η εφαρμογή συντελεστή ΦΠΑ 0%.

    Εάν η επιχείρησή σας απαιτεί διαφορετική φορολογική αντιμετώπιση για τις συγκεκριμένες συναλλαγές, παρακαλούμε επικοινωνήστε με την ομάδα υποστήριξής μας, ώστε να πραγματοποιηθεί η κατάλληλη παραμετροποίηση σύμφωνα με τις ανάγκες σας.

    4.Σε περίπτωση που στο παραστατικό σας δεν είναι σωστή η προβολή του ΦΠΑ για την εκάστοτε χώρα, παρακαλώ ελέγξτε ότι έχετε ρυθμίσει σωστά τα "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