myDATA AADE for WooCommerce — ΑΛΠ / ΑΠΥ receipts to myDATA for businesses exempt from the ΦΗΜ

For businesses exempt from the fiscal device (ΦΗΜ) under ΠΟΛ.1002/2014 — liberal professions and services (developers, consultants, designers, translators, teachers and online courses, lawyers, engineers, accountants), accommodation and hotels, beauty salons and gyms, travel agencies, sole traders exempt from ΦΠΑ.

myDATA AADE for WooCommerce is a plugin for such businesses in Greece that sell their services through WooCommerce. Businesses exempt from the ΦΗΜ issue receipts from their own software and send each one to myDATA — the electronic books of the AADE tax authority — through the ERP channel within 5 days. The plugin does this from your orders: it builds an 11.1 ΑΛΠ or 11.2 ΑΠΥ receipt following the official AADE schema, sends it through the myDATA REST API for ERP users, stores the ΜΑΡΚ on the order and shows the customer the ΜΑΡΚ and a QR code.

Who this plugin is not for

Selling goods to consumers? The law (ν.4308/2014 art. 12) requires a ΦΗΜ fiscal device or a licensed provider — this plugin is not for you. ΠΟΛ.1002/2014 has no exemption for online shops selling goods, and AADE itself says in the myDATA FAQ that an ERP does not replace a ΦΗΜ. From 2027 invoices to Greek businesses are issued through a licensed provider or timologio (AADE).

The plugin is not a ΦΗΜ and not a licensed provider; your accountant confirms your ground of exemption. The plugin does not decide whether your business may issue receipts this way: that depends on ΠΟΛ.1002/2014 and is up to you and your accountant.

Honestly about testing. The plugin was tested on a local WooCommerce 11.1 shop (PHP 8.2, legacy orders and HPOS; the document engine also on PHP 7.4) against a myDATA API test double built from the official AADE documentation «myDATA REST API — ERP users» v2.0.2. Every XML sent to the test double passed the official InvoicesDoc XSD schemas v2.0.1 and v2.0.2. The plugin has not worked with the real myDATA yet: an AADE test account is issued only for a Greek ΑΦΜ. Start in the test environment with your own account — if myDATA answers differently from the documentation, we will fix it promptly.

What the admin gets

• WooCommerce → myDATA: Step 1 (ground of exemption), status, connection to myDATA, your business, documents and numbering, payment types, ΦΠΑ, E3 classification, what the customer sees, Pro licence.
• The «myDATA (AADE)» box on every order: environment, document type, series and number, ΜΑΡΚ, links to the QR in myDATA and to the customer copy, log. Actions — «Send to myDATA», «Check and send again», «Cancel in myDATA», «Issue a new document», «Preview XML», «XML sent».
• Order notes record every step: document registered with its ΜΑΡΚ, cancelled, check failed.
• A myDATA column in the orders list; with Pro — the bulk action «Send to myDATA» and a CSV export of the documents of a period for your accountant.

What the customer sees

Once the receipt is registered in myDATA, the customer sees the «Receipt in myDATA (AADE)» block on the thank-you page, in My account and in the order e-mail: document type, series and number, date, ΜΑΡΚ, QR code and a «View / print the document» link. The QR code is generated in your shop and points to the document in myDATA.

The customer copy is a printable page with the seller’s details (name, address, ΑΦΜ, ΔΟΥ), the customer’s name and address, the items, totals per ΦΠΑ rate, the payment method, ΜΑΡΚ, UID and QR code. For the grounds of art. 1 par. 1 (α) and (ε)–(θ) of ΠΟΛ.1002/2014 the law requires the customer’s name and address on the receipt (art. 1 par. 2) — the plugin prints them on the copy and does not send a receipt without them. The link to the copy is protected by a token: with a different token the page does not open.

How it works — step by step

1. Step 1: ground of exemption. On the settings page you choose the case of ΠΟΛ.1002/2014, art. 1 that applies to your business — 1(α), 1(γ), 1(δ), 1(ε), 1(στ), 1(ζ), 1(η), 1(θ), 1(ιβ), 5(β), 5(γ) or «another case» with a required description — and tick the confirmation of responsibility. Without a ground and the confirmation — only the myDATA test environment: saving production switches back to test, and sending to production does not take a number. The plugin stores who confirmed and when.
2. Connection. The myDATA REST API user name and subscription key (for the test environment from mydata-dev-register.azurewebsites.net, for production in myDATA via TAXISnet), and the «Test the connection» button.
3. Business and numbering. ΑΦΜ (with the check digit verified), branch, name, ΔΟΥ for the receipt copy; series for ΑΛΠ and ΑΠΥ, for example with {YYYY} — a new series from 1 every year.
4. ΦΠΑ and classification. Every WooCommerce rate becomes a myDATA ΦΠΑ category; for 0% you choose the εξαίρεση reason (per shop or per product). The E3 income classification comes from the official table of allowed combinations: E3_561_003 for customers in Greece, E3_561_005 inside the EU, E3_561_006 outside it.
5. The document. In the order — «Send to myDATA». The plugin checks the data, only then takes the next number of the series under a database lock, builds the XML and sends it to myDATA. An order of services only (virtual products or products marked as services) becomes 11.2 ΑΠΥ, the rest 11.1 ΑΛΠ.
6. The answer. myDATA returns the ΜΑΡΚ, UID and QR link — they are stored on the order and appear for the customer right away. A myDATA error is shown in the order box with its code and text.
7. The connection dropped. The document keeps its number and date. The next attempt first asks myDATA whether the document arrived and sends it again only if it is not there — flagged as «loss of connection» (transmissionFailure 3). No duplicates.
8. Cancellation. «Cancel in myDATA» cancels the document (CancelInvoice), «Issue a new document» issues a new one with a new number; the old one stays in the order history.

Payment types. Every WooCommerce gateway gets its myDATA payment type: cash on delivery — 3 (cash), bank transfer — 1. Card and wallet gateways are sent as type 1 by default (payment account in Greece), not 7 (POS / e-POS): a type 7 payment sent from an ERP must carry the ECRToken — the signature of a registered ΦΗΜ (myDATA REST API v2.0.2, §5.2), which a business without a ΦΗΜ does not have. You can change the type by hand — the checks will then show a warning. Agree the types with your accountant.

B2B (Pro). The customer ticks «I need a τιμολόγιο» at checkout and enters the ΑΦΜ or VAT number and ΔΟΥ. Invoices are not sent by default — only when you allow it. Invoices 1.1 / 2.1 / 1.3 / 2.3 only in the transition period until 31.12.2026, for the 2nd group with a filed declaration (A.1128/2025, A.1129/2025); a document dated from 1.1.2027 is not sent, and the plugin explains why. From 2027 only 1.2 / 2.2 (businesses in other EU countries) — check with your accountant. So B2B is an extra in this plugin, not its main feature.

Refunds (Pro). A WooCommerce refund — from items or by amount — gives a credit document: 11.4 for a receipt, 5.1 for an invoice, referring to its ΜΑΡΚ.

Under the hood

• myDATA REST API for ERP v2.0.x: SendInvoices, CancelInvoice, RequestTransmittedDocs; production mydatapi.aade.gr and test mydataapidev.aade.gr.
• XML following the official InvoicesDoc schema — validated against the official AADE XSD files v2.0.1 and v2.0.2.
• Checks before the number: ΑΦΜ check digit, amounts and rounding, 0% without an εξαίρεση reason, forbidden E3 combinations, currency. A document that fails does not get a number.
• Numbering with a lock in MySQL: two orders in the same second never get the same number; retries keep the series, number and date.
• The QR code is generated by our own code on your server (PNG for e-mail, SVG for pages) — no external services.
• The myDATA subscription key is stored encrypted (AES-256 with the site keys).
• Data goes only to myDATA (test or production). With Pro the licence key is also checked against catcode.com.ua.
• Deleting the plugin removes the settings with the key; the document records on the orders (series, number, ΜΑΡΚ) and the counters stay — the law requires keeping them, and a reinstall must not start the series again.

How to install

1. Plugins → Add New → Upload Plugin: choose catcode-mydata-aade-for-woocommerce-free-1.0.0.zip and activate it (WooCommerce must be active).
2. WooCommerce → myDATA → Step 1: choose the ground of exemption from the ΦΗΜ agreed with your accountant and confirm it.
3. Connection: environment «test», user name and subscription key of your myDATA test account, «Test the connection».
4. Your business (ΑΦΜ, branch, name, ΔΟΥ), document series, ΦΠΑ rates and εξαίρεση reasons, payment types for your gateways.
5. Send a test order with «Send to myDATA» and check the ΜΑΡΚ and QR on the thank-you page and on the receipt copy.
6. Show the settings to your accountant, then switch the environment to production with the key of your production account.
7. For Pro: paste the licence key from the e-mail after payment, or start the 7-day trial.