API documentation
Flexy Provider API
Documentation for the systems (ERP, POS) that transmit documents to myDATA through Flexy.
The Flexy Provider API accepts documents from our customers' systems, stores them, transmits them to AADE's myDATA and keeps you informed of their status.
Onboarding
To connect your ERP to our APIs:
- Register as a partner at portal.flexy.gr/register-erp with your details, your company's VAT number (ΑΦΜ), email and phone.
- Get your staging credentials straight away. After registering you land on your partner page. It shows your staging token, the staging base URL, and an email and password for the staging portal, where you can see the documents your tests issue.
- Production access. Flexy activates production access for your account; until then your partner page shows it as pending. Once it is active, the page also shows your production token.
Environments
You send the same requests to both environments; only the base URL and the token change:
| Item | Staging (tests) | Production |
|---|---|---|
| Base URL | https://provider-staging.flexy.gr/api/v1/ | https://provider-api.flexy.gr/api/v1/ |
| Token | starts with staging_ | starts with production_ |
| Authentication | Header Authorization: Bearer <token> | Header Authorization: Bearer <token> |
| Data format | JSON | JSON |
On staging your sandbox company can issue documents straight away. In production a document is accepted only for a company that has completed Flexy's onboarding.
Tokens issued before the staging_ / production_ prefixes were introduced start with
sk_live_ and keep working.
Once you have registered and have your staging token, you are ready to start with step 1.
For ready-to-send requests for every document type see the Examples.