Metadata-Version: 2.4
Name: aade-publicity-search
Version: 1.0.2
Summary: AADE Public AFM lookup (VAT info) via SOAP
Author: Giorgos Iliopoulos
Project-URL: Homepage, https://github.com/gioiliop7/aade-publicity-search
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: httpx
Requires-Dist: xmltodict
Dynamic: license-file


# aade-publicity-search

Python client for the **AADE Public AFM (VAT) lookup service**, using the official SOAP API.
It allows you to retrieve publicly available company / professional information by AFM
and returns the result as a Python dictionary (JSON-ready).

---

## Features

- 🔎 AFM (VAT) public lookup
- 🇬🇷 Official AADE SOAP service
- ⚡ Async / `httpx` based
- 🧼 Clean JSON output (dict)
- 🚫 No FastAPI dependency
- 🐍 Python 3.10+

---

## Installation

```bash
pip install aade-publicity-search

import asyncio
from aade_publicity_search import AadeClient

async def main():
    client = AadeClient(
        username="AADE_USERNAME",
        password="AADE_PASSWORD"
    )

    data = await client.get_vat_info("123456789")
    print(data)

asyncio.run(main())
```

## Returned data structure

The client returns a dictionary similar to:

`{  "success":  true,  "error":  {  "code":  null,  "description":  null  },  "basic":  {  "afm":  "123456789",  "name":  "COMPANY NAME",  "doy":  "ΔΟΥ ΑΘΗΝΩΝ",  "legal_status":  "ΑΤΟΜΙΚΗ ΕΠΙΧΕΙΡΗΣΗ"  },  "firm_activities":  [  {  "activity_code":  "62010000",  "activity_descr":  "Computer programming activities"  }  ]  }` 

----------

## AFM validation

AFM numbers are validated locally before calling the AADE service.  
If the AFM is invalid, a `ValueError` is raised.

----------

## Error handling

-   HTTP errors raise `httpx.HTTPStatusError`
    
-   Invalid AFM raises `ValueError`
    
-   AADE service errors are returned in the `error` field of the response
    

Always check:

`if  not data["success"]: print(data["error"])` 

----------

## Requirements

-   Python 3.10+
    
-   Valid AADE SOAP credentials
    
-   Internet access to AADE services
----------

## Disclaimer

This library uses the **official AADE public SOAP service**.  
It is not affiliated with or endorsed by AADE.

Use responsibly and according to AADE terms of service.
