Οδηγός Χρήσης WooMyData Pro — Βήμα προς Βήμα

01

Εγκατάσταση Plugin

// wordpress admin → plugins → add new

1
Λάβετε το αρχείο woomydata-pro-x.x.x.zip από το email αγοράς σας.
2
WordPress Admin → Πρόσθετα → Προσθήκη νέου → Ανέβασμα Πρόσθετου.
3
Κάντε κλικ στο «Επιλογή αρχείου», επιλέξτε το zip, πατήστε «Εγκατάσταση τώρα».
4
Πατήστε «Ενεργοποίηση Πρόσθετου». Θα μεταβείτε αυτόματα στον Setup Wizard.

💡

Απαιτήσεις: WooCommerce ενεργό, PHP 7.4+, WordPress 6.0+.

// Εγκατάσταση μέσω WordPress Admin

02

Ενεργοποίηση Άδειας

// woomydata → settings → license

// License activation screen

1
Από το email αγοράς αντιγράψτε το License Key (XXXX-XXXX-XXXX-XXXX).
2
WooMyData → Ρυθμίσεις → Άδεια Χρήσης, επικολλήστε το key.
3
Επιλέξτε περιβάλλον: Sandbox για δοκιμές, Live για παραγωγή.
4
Πατήστε «Ενεργοποίηση», θα δείτε πλάνο, όριο παραστατικών και ημερομηνία λήξης.

Basic 1.000/έτος Pro 10.000/έτος Business 50.000/έτος Enterprise 250.000/έτος

03

Setup Wizard

// οδηγός εγκατάστασης 5 βημάτων

// Setup Wizard — 6 βήματα

Βήμα 1 — Άδεια & Νομικές Προϋποθέσεις

1
Εισάγετε το License Key και επιλέξτε περιβάλλον.
2
Επιβεβαιώστε εξουσιοδότηση Taxisnet και σύμβαση παρόχου — απαραίτητο για νόμιμη λειτουργία.

// Βήμα 1: Άδεια & Νομικές Προϋποθέσεις

// Βήμα 2: Στοιχεία Εταιρείας

Βήμα 2 — Στοιχεία Εταιρείας

1
Εισάγετε ΑΦΜ — αυτόματη ανάκτηση στοιχείων από ΑΑΔΕ.
2
Ελέγξτε: Επωνυμία, ΔΟΥ, Διεύθυνση, Ταχ. Κώδικας, Δραστηριότητα, GEMI.

Βήμα 3 — Τύποι Παραστατικών & Ταξινόμηση

1
Ενεργοποιήστε τύπους: Αποδείξεις, Τιμολόγια, Ενδοκοινοτικά, Τρίτες Χώρες.
2
Ορίστε σειρές: π.χ. ΤΙΜ, ΑΛΠ, INTRA, WORLD.
3
Επιλέξτε κωδικό Ε3 ανά τύπο παραστατικού (αγαθά / υπηρεσίες).
4
Ταξινόμηση Μεταφορικών σε Αποδείξεις: E3_562/category1_5 (προεπιλογή) ή E3_561_003.
5
Ταξινόμηση Χρεώσεων (Αντικαταβολή κλπ.): E3_562 ή E3_561_007. Συντελεστής ΦΠΑ fallback για χρεώσεις.
6
Αντιστοίχιση Τρόπων Πληρωμής: ορίστε ποιος τρόπος πληρωμής αντιστοιχεί σε ποιον κωδικό ΑΑΔΕ (1–7). Προαιρετικό — χρησιμοποιήστε μόνο αν η αυτόματη ανίχνευση δεν είναι σωστή.

// Βήμα 3: Τύποι & Σειρές

// Βήμα 4: Εμφάνιση & Checkout

Βήμα 4 — Εμφάνιση & Checkout

1
Ανεβάστε λογότυπο εταιρείας για τα PDF.
2
Επιλέξτε format PDF: A4 ή Θερμικό 80mm.
3
Ρυθμίστε χρώματα κουμπιών και θέση του selector στο checkout.
4
Ενεργοποιήστε αυτόματο Πιστωτικό/Επιστροφή κατά refund αν θέλετε.

04

Ρυθμίσεις

// woomydata → ρυθμίσεις

↗
Γενικές: Αυτόματη έκδοση, trigger status παραγγελίας, mode (Τιμολόγιο/Απόδειξη/Αμφότερα).
↗
Πάροχος: Party ID & API Key από SimpleInvoicing. Περιβάλλον Sandbox ή Live.
↗
ΑΑΔΕ: VIES validation για ενδοκοινοτικά, κατάσταση ΦΠΑ για GR εταιρείες.
↗
Checkout Fields: Εμφάνιση/απόκρυψη πεδίων, custom ετικέτες, θέση στη φόρμα.
↗
Recurring & Refund: Αυτόματα παραστατικά για Subscriptions και Refunds.

💡

Sandbox vs Live: Sandbox για δοκιμές. Τα MARKs Sandbox γίνονται reset περιοδικά, χρησιμοποιήστε Live για πραγματικά παραστατικά.

// Settings — Γενικές Ρυθμίσεις

05

Checkout — Επιλογή Παραστατικού

// τι βλέπει ο πελάτης κατά την ολοκλήρωση

// Checkout — επιλογή Τιμολογίου / Απόδειξης

Στο checkout (Classic & Blocks) εμφανίζονται δύο κουμπιά: Απόδειξη και Τιμολόγιο. Ανάλογα με χώρα και επιλογή:

🧾
Απόδειξη: Χωρίς πρόσθετα πεδία.
📋
Τιμολόγιο GR: ΑΦΜ, Επωνυμία, ΔΟΥ, Δραστηριότητα, αυτόματη συμπλήρωση από ΑΑΔΕ.
🇪🇺
Ενδοκοινοτικό: ΑΦΜ ΕΕ (π.χ. DE123456789), VIES validation real-time.
🌍
Τρίτη Χώρα: Tax ID προαιρετικό, χωρίς VIES.

06

Σελίδα Παραστατικών

// woomydata → παραστατικά

1
WooMyData → Παραστατικά — πλήρης λίστα με φίλτρα ανά τύπο, κατάσταση, ημερομηνία.
2
Κάθε γραμμή: Προβολή PDF, Λήψη, Αποστολή Email, Ακύρωση.
3
Αποτυχημένα (🔴) → κουμπί «Αποστολή στο myDATA» για επανααποστολή.
4
Export Excel/CSV — Καθαρή Αξία, ΦΠΑ, Σύνολο, Νόμισμα.

// Documents Page — λίστα παραστατικών

07

Πιστωτικά & Επιστροφές

// credit note (5.1) · return receipt (11.5)

// Credit Note από Documents Page ή Order Metabox

1
Από Documents Page ή Order metabox → «Πιστωτικό Τιμολόγιο» ή «Απόδειξη Επιστροφής».
2
Ελάχιστη αναμονή 10 λεπτών μετά το αρχικό παραστατικό (myDATA indexing).
3
Τιμολόγιο → Πιστωτικό 5.1 | Απόδειξη → Απόδειξη Επιστροφής 11.5.

⚠️ Sandbox: Τα MARKs γίνονται reset καθημερινά. Σφάλμα 301 «not found» = το Sandbox έχει κάνει reset. Δοκιμάστε στο Live.

08

Email Παραστατικών

// woocommerce → settings → emails

1
Αποστολή μέσω WooCommerce email: WooCommerce → Ρυθμίσεις → Emails → Invoice / Receipt (WooMyData Pro).
2
Γλώσσα: Ελληνικά για GR, Αγγλικά για ΕΕ/Τρίτες αυτόματα βάσει χώρας.
3
Χειροκίνητη αποστολή: Documents Page ή Order metabox → «Αποστολή Email».

// WooCommerce Emails — Invoice/Receipt

09

PDF Παραστατικών

// a4 · thermal 80mm · qr code · mark

// PDF A4 — MARK, QR Code, ανάλυση ΦΠΑ

1
Κάθε παραστατικό εκδίδεται αυτόματα ως PDF με λογότυπο, MARK και QR Code myDATA.
2
Formats: A4 (τυπικό) ή Θερμικό 80mm (POS). Ρυθμίζεται ανά τύπο.
3
Ανάλυση ΦΠΑ: Συντελεστής / Καθαρή Αξία / ΦΠΑ / Αξία ανά κατηγορία, συμπεριλαμβάνει μεταφορικά και χρεώσεις (π.χ. Αντικαταβολή).
4
Γλώσσα: Ελληνικά (GR) — Αγγλικά (Διεθνείς) αυτόματα.

10

Διεθνής Τιμολόγηση

// intra-eu (1.2) · third-country (1.3) · vies

GR → myDATA 1.1 ΕΕ + VIES → myDATA 1.2 Εκτός ΕΕ → myDATA 1.3

1.2
Ενδοκοινοτικό: 0% ΦΠΑ, σειρά INTRA. Αγαθά: E3_561_005/category1_1, εξαίρεση 1 (Άρθ.28). Υπηρεσίες/Μεταφορικά: E3_561_005/category1_1, εξαίρεση 14. Απαιτεί VIES validation.
1.3
Τρίτη Χώρα: 0% ΦΠΑ, σειρά WORLD. Αγαθά: E3_561_006/category1_1, εξαίρεση 2 (Άρθ.24). Υπηρεσίες/Μεταφορικά: E3_561_006/category1_1, εξαίρεση 14. Χωρίς VIES.
⚡
Ο σωστός τύπος επιλέγεται αυτόματα βάσει χώρας και ΑΦΜ ΕΕ πελάτη.

// VIES validation & Intra-EU invoice

11

Μαζική Έκδοση Παραστατικών

// woocommerce → orders → bulk actions

// Bulk generation με live progress bar

1
WooCommerce → Παραγγελίες — επιλέξτε παραγγελίες με checkbox.
2
Bulk Actions → «Generate Documents (WooMyData)» → Εφαρμογή.
3
Ανοίγει modal με live progress bar — batches 5 παραγγελιών.
4
Αποτελέσματα: ✓ Επιτυχία · ⚠ Χωρίς myDATA · ✗ Σφάλμα · — Υπάρχει ήδη.

💡

Παραγγελίες με ήδη υπάρχον παραστατικό παραλείπονται αυτόματα.

12

Συνδρομές & Αυτόματες Επιστροφές

// woocommerce subscriptions · refund automation

Επαναλαμβανόμενα (WooCommerce Subscriptions)

1
Απαιτεί το plugin WooCommerce Subscriptions.
2
Ρυθμίσεις → Recurring Invoices → Ενεργοποίηση.
3
Κάθε ανανέωση → αυτόματο παραστατικό + email στον πελάτη.

Αυτόματο Πιστωτικό κατά Refund

1
Ρυθμίσεις → Refund Automation → Auto-issue on Refund.
2
Παραγγελία «Επιστράφηκε» → αυτόματο Πιστωτικό 5.1 ή Απόδειξη Επιστροφής 11.5.
3
Αν το αρχικό παρ. είναι <10 λεπτών, καθυστέρηση 15 λεπτών αυτόματα.

// Recurring & Refund Automation settings

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

// εγκατάσταση 5 λεπτά — αυτόματη τιμολόγηση myDATA

Αγορά Τώρα → ./Demo

13

FAQ & Αντιμετώπιση Προβλημάτων

// συχνές ερωτήσεις · λύσεις · σφάλματα api

🔧 Εγκατάσταση & Ενεργοποίηση

Εγκατέστησα το plugin αλλά δεν βλέπω το μενού WooMyData στον πίνακα ελέγχου. ▼

1
Βεβαιωθείτε ότι το WooCommerce είναι ενεργό, το WooMyData Pro απαιτεί WooCommerce.
2
Ελέγξτε ότι έχετε ενεργοποιήσει το plugin από Πρόσθετα → Εγκατεστημένα Πρόσθετα.
3
PHP 7.4+ και WordPress 6.0+ είναι απαραίτητα. Ελέγξτε Εργαλεία → Υγεία Ιστοτόπου.

Πατώ «Ενεργοποίηση» για το license αλλά λαμβάνω σφάλμα σύνδεσης. ▼

Συνήθης αιτία: ο server δεν μπορεί να επικοινωνήσει με τον εξωτερικό server αδειών. Ελέγξτε:

1
Firewall/proxy που μπλοκάρει εξερχόμενα αιτήματα HTTPS.
2
Εργαλεία → Υγεία Ιστοτόπου → Πληροφορίες, ελέγξτε cURL και OpenSSL.
3
Επικοινωνήστε με τον hosting σας για whitelist του API endpoint.

🛒 Checkout & Πεδία Τιμολογίου

Τα κουμπιά Απόδειξη/Τιμολόγιο δεν εμφανίζονται στο checkout. ▼

1
Ελέγξτε WooMyData → Ρυθμίσεις → Checkout, βεβαιωθείτε ότι είναι ενεργοποιημένες οι «Αποδείξεις» ή/και «Τιμολόγια».
2
Αν χρησιμοποιείτε Blocks Checkout (νέο WooCommerce theme): τα κουμπιά εισάγονται μέσω JavaScript. Βεβαιωθείτε ότι δεν υπάρχει JavaScript error στο browser console.
3
Δοκιμάστε να αλλάξετε τη θέση selector από τις ρυθμίσεις (π.χ. «Πριν τη διεύθυνση» ή «Μετά τη διεύθυνση»).
4
Cache plugin; κάντε purge cache και δοκιμάστε σε incognito.

«Παρουσιάστηκε σφάλμα κατά την επεξεργασία της παραγγελίας» όταν επιλέγω Τιμολόγιο. ▼

Αυτό συμβαίνει όταν η επικύρωση των πεδίων αποτυγχάνει. Συνήθεις αιτίες:

1
ΑΦΜ κενό: Για GR τιμολόγιο το ΑΦΜ είναι υποχρεωτικό (9 ψηφία). Η αυτόματη αναζήτηση ΑΑΔΕ πρέπει να βρει αποτέλεσμα.
2
Blocks Checkout: Βεβαιωθείτε ότι τα πεδία συμπληρώνονται πριν πατήσετε «Αποστολή παραγγελίας». Η αναζήτηση ΑΑΔΕ πρέπει να ολοκληρωθεί.
3
Χώρα ≠ GR: Για ΕΕ/Τρίτες χώρες τα πεδία ΔΟΥ και Δραστηριότητα δεν απαιτούνται.

Η αυτόματη αναζήτηση ΑΑΔΕ δεν λειτουργεί ή δεν συμπληρώνει τα πεδία. ▼

1
Ελέγξτε WooMyData → Ρυθμίσεις → ΑΑΔΕ — βεβαιωθείτε ότι είναι ενεργοποιημένη η «Αυτόματη Αναζήτηση».
2
Το ΑΦΜ πρέπει να είναι ακριβώς 9 ψηφία για να ξεκινήσει η αναζήτηση.
3
Βεβαιωθείτε ότι το site έχει πρόσβαση στο API της ΑΑΔΕ (δεν μπλοκάρεται από firewall).
4
Το ΑΦΜ πρέπει να είναι ενεργό στο μητρώο ΑΑΔΕ, ανενεργά ή ανύπαρκτα ΑΦΜ επιστρέφουν σφάλμα.

📄 Παραστατικά & Σφάλματα myDATA API

Το παραστατικό εκδόθηκε σε «offline mode» — τι σημαίνει; ▼

Offline mode σημαίνει ότι το παραστατικό αποθηκεύτηκε τοπικά αλλά δεν στάλθηκε στο myDATA λόγω σφάλματος API.

1
Ανοίξτε WooMyData → Παραστατικά, τα αποτυχημένα εμφανίζονται με 🔴.
2
Κάντε κλικ στο κουμπί «Αποστολή στο myDATA» για επανααποστολή.
3
Ελέγξτε WooMyData → Logs για το συγκεκριμένο σφάλμα API.

💡

Το παραστατικό είναι νόμιμο ακόμα και σε offline mode, αρκεί να αποσταλεί εντός της προθεσμίας που ορίζει η ΑΑΔΕ.

Σφάλμα API:6 — «Ο τύπος παραστατικού δεν επιτρέπει κατηγορία X με Ε3 Y» ▼

Σφάλμα ταξινόμησης myDATA. Το plugin χρησιμοποιεί τους σωστούς κωδικούς αυτόματα:

1.1 (Τιμολόγιο GR): category1_1 / E3_561_001
11.1 (Απόδειξη): category1_1 / E3_561_003
1.2 (Ενδοκοινοτικό): category1_1 / E3_561_005 (0% ΦΠΑ)
1.3 (Τρίτες Χώρες): category1_1 / E3_561_006 (0% ΦΠΑ)

Αν εξακολουθείτε να λαμβάνετε αυτό το σφάλμα, ελέγξτε την προεπιλεγμένη κατηγορία στο WooMyData → Ρυθμίσεις → Ταξινόμηση, πρέπει να είναι category1_1 για φυσικά αγαθά.

Σφάλμα API:8 — «vatExemptionCategory is mandatory» (κωδικός 217) ▼

Εμφανίζεται όταν μια γραμμή έχει vatCategory=7 (0% ΦΠΑ) χωρίς κωδικό εξαίρεσης. Συνήθεις αιτίες:

1
Χρέωση Αντικαταβολής (COD): Ορίστε τον Συντελεστή ΦΠΑ fallback στο 24% από Ρυθμίσεις → Ταξινόμηση.
2
Προϊόν με 0% ΦΠΑ: Στη σελίδα του προϊόντος, tab WooMyData, ορίστε τον κωδικό εξαίρεσης (π.χ. 27 για γενική απαλλαγή, 26 για Άρθρο 39α).

Σφάλμα 301 — «Original document not found» κατά έκδοση Πιστωτικού. ▼

1
Sandbox: Τα MARKs γίνονται reset καθημερινά. Εκδώστε νέο αρχικό παραστατικό και μετά το Πιστωτικό ή δοκιμάστε στο Live.
2
Live: Αναμείνετε τουλάχιστον 10 λεπτά μετά την έκδοση του αρχικού παραστατικού πριν εκδώσετε Πιστωτικό.
3
Βεβαιωθείτε ότι το αρχικό παραστατικό έχει MARK (έχει σταλεί επιτυχώς στο myDATA).

Το παραστατικό λέει «Απόδειξη» αλλά ο πελάτης ζήτησε «Τιμολόγιο» (ή αντίστροφα). ▼

1
Από το Order metabox (σελίδα παραγγελίας), κάντε κλικ στο σωστό κουμπί (Τιμολόγιο/Απόδειξη). Θα εμφανιστεί μήνυμα επιβεβαίωσης αναντιστοιχίας.
2
Επιβεβαιώστε για να εκδοθεί το σωστό παραστατικό.
3
Αν έχει ήδη εκδοθεί λάθος παραστατικό: εκδώστε Πιστωτικό για ακύρωση, μετά εκδώστε το σωστό.

🖨️ PDF & Email

Το PDF δεν εμφανίζεται ή το κουμπί «Προβολή PDF» λείπει από το modal. ▼

1
Το PDF δημιουργείται μόνο αν το παραστατικό έχει σταλεί επιτυχώς ή αποθηκευτεί (ακόμα και σε offline mode).
2
Ελέγξτε ότι ο φάκελος wp-content/uploads/woomydata/ έχει δικαιώματα εγγραφής (755 ή 775).
3
PHP extension mbstring απαιτείται για το PDF rendering — ελέγξτε Εργαλεία → Υγεία Ιστοτόπου.
4
Αν χρησιμοποιείτε CDN ή object cache, βεβαιωθείτε ότι τα αρχεία PDF δεν cache-άρονται.

Το email με το παραστατικό δεν φτάνει στον πελάτη. ▼

1
Ελέγξτε WooCommerce → Ρυθμίσεις → Emails → Invoice/Receipt (WooMyData) — βεβαιωθείτε ότι είναι ενεργοποιημένο.
2
Χρησιμοποιήστε SMTP plugin (π.χ. WP Mail SMTP) για αξιόπιστη αποστολή email.
3
Ελέγξτε το spam folder του πελάτη, τα email με PDF συχνά φιλτράρονται.
4
Χειροκίνητη αποστολή: Documents Page → «Αποστολή Email».

🌍 Διεθνής Τιμολόγηση

Η παραγγελία από χώρα ΕΕ αναγνωρίζεται ως «Εσωτερικό» αντί «Ενδοκοινοτικό». ▼

1
Βεβαιωθείτε ότι ο πελάτης έχει επιλέξει χώρα ΕΕ (π.χ. DE, FR, IT) στη διεύθυνση χρέωσης.
2
Για Blocks Checkout: ο κωδικός χώρας πρέπει να είναι ορατός στο WC Blocks store πριν την υποβολή.
3
Ελέγξτε WooMyData → Logs για το πεδίο billing_country στην καταγραφή της παραγγελίας.

Το VIES δεν επαληθεύει το ΑΦΜ ΕΕ του πελάτη. ▼

1
Βεβαιωθείτε ότι το VIES είναι ενεργοποιημένο στο WooMyData → Ρυθμίσεις → ΑΑΔΕ.
2
Η μορφή πρέπει να είναι CountryCode + αριθμός (π.χ. DE123456789) χωρίς κενά.
3
Το VIES service της ΕΕ έχει περιστασιακές διακοπές. Αν το ΑΦΜ είναι γνωστά έγκυρο, το παραστατικό μπορεί να εκδοθεί χωρίς VIES validation.
4
Ορισμένες χώρες ΕΕ (π.χ. Ισπανία) δεν επιστρέφουν επωνυμία μέσω VIES, αυτό είναι φυσιολογικό.

Το ΦΠΑ δεν εμφανίζεται ως 0% σε ενδοκοινοτική ή τρίτη χώρα παραγγελία. ▼

Αυτό είναι ρύθμιση WooCommerce, όχι WooMyData Pro. Για 0% ΦΠΑ σε ΕΕ/εξωτερικό:

1
WooCommerce → Ρυθμίσεις → Φόρος, δημιουργήστε ζώνη φόρου για ΕΕ/Εξωτερικό με 0% συντελεστή.
2
Εναλλακτικά, plugin όπως EU VAT Compliance ή WooCommerce Tax διαχειρίζονται αυτόματα τους φόρους ΕΕ.
3
Το WooMyData Pro μεταφέρει ό,τι υπολογίζει το WooCommerce, δεν τροποποιεί τα ποσά ΦΠΑ.

⚡ Απόδοση & Γενικά

Η αυτόματη έκδοση δεν εκκινεί μετά την παραγγελία. ▼

1
Ελέγξτε WooMyData → Ρυθμίσεις → Γενικές — η «Αυτόματη Έκδοση» πρέπει να είναι ενεργή.
2
Ελέγξτε το trigger status — π.χ. αν έχετε ορίσει «Completed» αλλά η παραγγελία μένει σε «Processing», δεν θα εκδοθεί αυτόματα.
3
WooCommerce cron (wp-cron) πρέπει να λειτουργεί. Σε επιβαρυμένα sites, αντικαταστήστε με server cron.

Πώς μεταβαίνω από Sandbox σε Live περιβάλλον; ▼

1
WooMyData → Ρυθμίσεις → Πάροχος — αλλάξτε Περιβάλλον από Sandbox σε Live.
2
Βεβαιωθείτε ότι έχετε ολοκληρώσει τη σύμβαση με τον πάροχο (SimpleInvoicing) για Live access.
3
Τα Sandbox παραστατικά δεν μεταφέρονται στο Live, ξεκινάτε από αρχή στο Live.
4
Εκδώστε ένα δοκιμαστικό παραστατικό στο Live για επιβεβαίωση πριν ανοίξετε σε πελάτες.

⚠️ Στο Live τα παραστατικά δεν μπορούν να διαγραφούν, μόνο να ακυρωθούν μέσω Πιστωτικού. Σιγουρευτείτε πριν τη μετάβαση.

Πλησιάζω το όριο παραστατικών του πλάνου μου — τι κάνω; ▼

1
Το plugin εμφανίζει προειδοποίηση στον admin panel όταν φτάσετε στο 80% του ορίου.
2
Αναβαθμίστε πλάνο από το woomydata.gr → Dashboard ή επικοινωνήστε μαζί μας.
3
Παραγγελίες που υπερβαίνουν το όριο αποθηκεύονται σε offline mode και αποστέλλονται αυτόματα μόλις αναβαθμίσετε.

WooMyData ProΒήμα προς Βήμα

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

WooMyData Pro
Βήμα προς Βήμα