FlexyAPI documentation

Examples

Examples by document type

Ready-to-send requests for every document type, from Flexy's automated tests.

For every document type you will find one or more ready-to-send requests, the same ones Flexy's automated tests send to AADE's test environment. The exception is 8.6, which Flexy cannot issue yet.

Send each request with POST to /api/v1/documents/ as in step 2, after replacing <VAT NUMBER> with the issuer's VAT number.

Before you send

  • The page fills aa and date with the current Greek time, the same for every example on the page; each example has its own series, so you can send them all one after another (those with <MARK> once you have filled it in). To send them again, reload the page.
  • custom_id is optional: your own reference for the document; set it only if you need it.
  • <MARK> is the MARK of a document you issued earlier that the example refers to.
  • A document you have just issued may not yet be available for references to its MARK; if the response says Invoice with ΜΑΡΚ … not found, send again a little later.

Document types

TypeDocumentExamples
1.1Sales Invoice13
1.2Sales Invoice / Intra-community Supplies1
1.3Sales Invoice / Third Country Supplies2
1.4Sales Invoice / Sale on Behalf of Third Parties1
1.5Sales Invoice / Clearance of Sales on Behalf of Third Parties – Fees from Sales on Behalf of Third Parties1
1.6Sales Invoice / Supplemental Accounting Source Document1
2.1Service Rendered Invoice1
2.2Intra-community Service Rendered Invoice1
2.3Third Country Service Rendered Invoice2
2.4Service Rendered Invoice / Supplemental Accounting Source Document1
3.1Proof of Expenditure (non-liable Issuer)1
3.2Proof of Expenditure (denial of issuance by liable Issuer)1
5.1Credit Invoice / Associated1
5.2Credit Invoice / Non-Associated1
6.1Self-Delivery Record1
6.2Self-Supply Record1
7.1Contract – Income1
8.1Rents – Income1
8.2Climate Crisis Resilience Fee1
8.4POS Receipt1
8.5POS Return Receipt1
8.6Catering Order Slip1
9.1Associated Delivery Note1
9.2Consolidated Delivery Note2
9.3Delivery Note5
10.1Associated Quantity Receipt Note1
10.2Non-Associated Quantity Receipt Note1
11.1Retail Sales Receipt1
11.2Service Rendered Receipt1
11.3Simplified Invoice1
11.4Retail Sales Credit Note1
11.5Retail Sales Receipt on Behalf of Third Parties1

The response

When AADE accepts the document, the API answers with HTTP 201, as in step 2:

{
  "document": {
    "aa": "20261004200424",
    "series": "A",
    "issue_date": "2026-10-04",
    "id": "632b2de6-01c6-40f3-bb4c-a3ffacfb43dc",
    "provider": "flexy",
    "status": "success",
    "mydata_mark": 400001972106993,
    "mydata_uid": "C007ED1925D0C9DC51BAAD907EB96A02DB27601E",
    "qr_code_url": "https://mydataapidev.aade.gr/TimologioQR/QRInfo?q=…",
    "issuer_vat_number": "<VAT NUMBER>",
    "counterpart_vat_number": "159107845",
    "total_gross_value": "124.00"
    // … and the rest of the document
  }
}