> ## Documentation Index
> Fetch the complete documentation index at: https://tax-layer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect myDATA

> Getting your AADE API codes, entering them, and what the sync states mean

myDATA is what AADE holds on record for the business. Every VAT figure, income figure and Co-pilot check in TaxLayer starts from it. TaxLayer **only reads** myDATA. It never submits anything to AADE.

## What you need

Two codes, issued by AADE when you register the business for the myDATA REST API:

* **AADE user ID** — the *Όνομα Χρήστη* you choose at registration
* **Subscription key** — the *Κωδικός API* AADE generates for it

These are not your Taxisnet login. Registration takes about five minutes and is free.

## Getting the codes from AADE

**1. Open the registration page**

In a browser (not inside any accounting program), go to **aade.gr › Υπηρεσίες προς Επιχειρήσεις › myDATA – Ηλεκτρονικά Βιβλία ΑΑΔΕ › Εγγραφή στο myDATA REST API**, and sign in with Taxisnet codes.

* **Sole trader / freelancer:** sign in with your own personal Taxisnet codes.
* **Company (ΑΕ, ΙΚΕ, ΕΠΕ, ΟΕ, ΕΕ):** sign in with the Taxisnet codes of the **legal representative** or of the **authorised accountant** — a person, not the company's own codes. AADE recommends this over using the company's codes.

**2. Companies: choose which business you are acting for**

Click **Προφίλ Χρήστη** (top right, next to your name) › **Επιλογή Φορολογούμενου**. Choose **Εκπρόσωπος Νομικού Προσώπου** or **Λογιστής / Λογιστικό Γραφείο** to match the codes you signed in with, then pick the company's ΑΦΜ from the list.

The company appears in that list only if the authorisation already exists in Taxisnet. If it's missing, see *Authorising an accountant* below, then come back.

Check that the text at the top right now says you are representing that company.

**3. Create the user**

Open **Εγγραφή στο myDATA REST API** and fill in **Νέα Εγγραφή**:

* **Όνομα Χρήστη** — Latin letters and digits only. It must be unique across all of AADE's registrations, so something like `taxlayer-acme2026` is safer than `admin`. This becomes your **AADE user ID**.
* **Email** — where AADE sends notices about this registration.

Submit. The new user appears in the **Χρήστες** list.

**4. Copy the subscription key**

In the **Χρήστες** list, the **Κωδικός API** column is the **Subscription key**. Copy it exactly — it's long and case-sensitive.

You can come back to this list any time to see the codes again, or to **Διαγραφή** a user and create a fresh one.

**5. Enter them in TaxLayer**

* **Business:** Settings › **Organisation** › *Finance & Tax* › **AADE User ID** and **Subscription Key** › **Save changes**. Or use the **Connect your sources** window on your first visit.
* **Firm:** open the client › **Edit Client** › *Finance & Tax* › *myDATA Credentials*. Or **Add codes** next to the client in the Connect your sources window.

You'll see *myDATA connected* and, within a minute, *We're fetching your myDATA from AADE*.

![AADE User ID and Subscription Key fields on the Organisation settings page](https://mintcdn.com/tax-layer/5FZ-ER7B5DFgtUtK/images/connect-mydata-business.png?fit=max\&auto=format\&n=5FZ-ER7B5DFgtUtK\&q=85\&s=a001996661b0c6b8d51d34ba69abea14)

Business: Settings › Organisation › Finance & Tax

![myDATA Credentials fields on a client's Finance & Tax tab](https://mintcdn.com/tax-layer/hJXFtR1rvWaDjMkL/images/connect-mydata-firm.png?fit=max\&auto=format\&n=hJXFtR1rvWaDjMkL\&q=85\&s=b1ad698aa8ec655dff73745d972757fe)

Firm: Edit Client › Finance & Tax

> [!WARNING]
>
> Make sure you registered in the **production** environment (the route above). AADE also has a **Δοκιμαστικό περιβάλλον** with its own registration form; codes from there return no real data and show up in TaxLayer as *myDATA sync failing*.

> [!WARNING]
>
> TaxLayer does not check the codes against AADE when you save. Wrong codes only show up later as *myDATA sync failing* on the Home page. If you see that, go back to the **Χρήστες** list and re-copy them.

## Accounting firms: one registration per client

TaxLayer asks for a separate user ID and key for each client, registered while representing that client (step 2 above). Create them as you add clients; **Save & Add Another** on the Add Client window keeps the last codes typed so you can tell them apart.

AADE lets a firm act for every authorised client with the firm's own single key. TaxLayer doesn't use that route yet — enter each client's own codes.

## Authorising an accountant

For an accountant to register a company's API user, the company must first authorise them in Taxisnet: **aade.gr › myTAXISnet › Εξουσιοδοτήσεις**, for the subject **Διαχείριση Ηλεκτρονικών Βιβλίων**. Until that's done, the company won't appear under *Επιλογή Φορολογούμενου*.

A salaried in-house accountant (Λογιστής Μισθωτός) is authorised from the **Εκπρόσωπος** option instead.

## What syncs

* Every invoice the business **issued** that has been reported
* Every invoice the business **received** from Greek suppliers who reported it
* Income, expense and VAT figures

The first sync fetches 24 months of history. After that TaxLayer refreshes every 15 minutes. There is no manual "sync now" button.

## Sync states on the Home page

| Shown as | Meaning |
| - | - |
| myDATA synced today 09:12 | Up to date |
| myDATA first sync in progress | Still fetching history |
| myDATA sync failing | AADE is rejecting the codes — re-enter them |
| myDATA sync paused | Five failures in a row; re-saving the codes restarts it |
| myDATA not connected | No codes saved yet |

## Filing frequency and legal form

Two settings make the VAT and tax figures accurate:

* **VAT filing frequency** (Monthly or Quarterly) sets which period "VAT due" refers to and when the return is due.
* **Legal form** (AE, IKE, EPE, OE, EE, Sole trader, Freelancer) sets the rate the income-tax estimate uses.

Businesses set both under Settings › Organisation. Firms set them per client under Edit Client › Finance & Tax. Until they're set, the cards say *Set it*.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.