AADE Settings

What the service offers

The AADE service provides:

  • Tax Office (DOY): Code and name of the company's tax office
  • Tax office address: The official address registered with the tax office (usually different/shorter from what we have)
  • Activity: The company's main business activity
Usefulness: Primarily for issuing invoices - you need the tax office (DOY) and the official address of your client.

Why you need your own AADE credentials

We cannot provide shared credentials for the following reason:

Every request to AADE is logged and the company you're looking up can see the caller's VAT number. If we used shared credentials, the company would see our VAT number instead of yours.

With your own credentials:

  • The company sees your VAT number
  • You are responsible for your own requests
  • Data protection regulations are respected

How to get AADE credentials

You need special access codes (not your regular TAXISnet credentials).

1

Activate the service (as a company)

2

Create special codes (as a natural person)

  • Log in with your personal TAXISnet credentials
  • Select the role "Legal Entity Administrator" and your company
  • Through the "Special Codes Management" application, create new codes
  • These codes (username/password) are different from your TAXISnet credentials
3

AADE Documentation

More information: aade.gr

How to add them to the application

  1. Log in to bizlist.gr
  2. Go to Account
  3. Select the AADE tab
  4. Fill in:
    • Username: Your AADE special codes username
    • Password: Your AADE special codes password
    • Caller VAT: The VAT number that will appear in requests
  5. Click Save
  6. (Optional) Click Test Connection to verify

Important Information

Request Logging

Every request to AADE is logged and the company you're looking up can see your VAT number.

Manual Retrieval

Data is not automatically retrieved when you visit a company profile. You need to click the "Fetch from AADE" button.

Shared Data

Retrieved data is stored in our database and displayed to all users. If someone else has already fetched the data, no new request is needed.

How to use it

From a company profile (Web UI)

  1. Open a Greek company's profile
  2. If there's no tax office data and you have AADE credentials: click "Fetch from AADE"
  3. Click the button - the data is retrieved and displayed
  4. If data already exists: it's displayed + a "Refresh" button to update

Via the API

# Fetch company with AADE data (country + registry number)
GET /api/v1/companies/gr/170285706000?include_aade=true

# Fetch company with AADE data (by VAT)
GET /api/v1/companies/by-vat/801234567?include_aade=true

# Retrieve AADE data (company VAT number)
POST /api/v1/aade/fetch/801234567