FlexyΤεκμηρίωση API

Παραδείγματα

Παραδείγματα ανά τύπο παραστατικού

Έτοιμα αιτήματα για κάθε τύπο παραστατικού, από τα αυτόματα tests της Flexy.

Για κάθε τύπο παραστατικού θα βρείτε ένα ή περισσότερα έτοιμα αιτήματα, τα ίδια που στέλνουν τα αυτόματα tests της Flexy στο δοκιμαστικό περιβάλλον της ΑΑΔΕ. Εξαίρεση είναι το 8.6, που το Flexy δεν μπορεί ακόμη να στείλει.

Στείλτε κάθε αίτημα με POST στο /api/v1/documents/ όπως στο βήμα 2, αφού βάλετε στη θέση του <ΑΦΜ> τον ΑΦΜ του εκδότη.

Πριν στείλετε

  • Η σελίδα συμπληρώνει τα aa και date με την τρέχουσα ώρα Ελλάδας, ίδια για όλα τα παραδείγματα της σελίδας· κάθε παράδειγμα έχει δικό του series, οπότε μπορείτε να τα στείλετε όλα το ένα μετά το άλλο (όσα έχουν <ΜΑΡΚ> αφού το συμπληρώσετε). Για νέα αποστολή, ανανεώστε τη σελίδα.
  • Το custom_id είναι προαιρετικό: δική σας αναφορά για το παραστατικό, βάλτε το μόνο αν το χρειάζεστε.
  • Το <ΜΑΡΚ> είναι το ΜΑΡΚ ενός παραστατικού που εκδώσατε νωρίτερα και στο οποίο αναφέρεται το παράδειγμα.
  • Ένα παραστατικό που μόλις εκδόσατε μπορεί να μην είναι ακόμη διαθέσιμο για αναφορά στο ΜΑΡΚ του· αν η απάντηση λέει Invoice with ΜΑΡΚ … not found, ξαναστείλτε λίγο αργότερα.

Τύποι παραστατικών

ΤύποςΠαραστατικόΠαραδείγματα
1.1Τιμολόγιο Πώλησης13
1.2Τιμολόγιο Πώλησης / Ενδοκοινοτικές Παραδόσεις1
1.3Τιμολόγιο Πώλησης / Παραδόσεις Τρίτων Χωρών2
1.4Τιμολόγιο Πώλησης / Πώληση για Λογαριασμό Τρίτων1
1.5Τιμολόγιο Πώλησης / Εκκαθάριση Πωλήσεων Τρίτων - Αμοιβή από Πωλήσεις Τρίτων1
1.6Τιμολόγιο Πώλησης / Συμπληρωματικό Παραστατικό1
2.1Τιμολόγιο Παροχής1
2.2Τιμολόγιο Παροχής / Ενδοκοινοτική Παροχή Υπηρεσιών1
2.3Τιμολόγιο Παροχής / Παροχή Υπηρεσιών σε λήπτη Τρίτης Χώρας2
2.4Τιμολόγιο Παροχής / Συμπληρωματικό Παραστατικό1
3.1Τίτλος Κτήσης (μη υπόχρεος Εκδότης)1
3.2Τίτλος Κτήσης (άρνηση έκδοσης από υπόχρεο Εκδότη)1
5.1Πιστωτικό Τιμολόγιο / Συσχετιζόμενο1
5.2Πιστωτικό Τιμολόγιο / Μη Συσχετιζόμενο1
6.1Στοιχείο Αυτοπαράδοσης1
6.2Στοιχείο Ιδιοχρησιμοποίησης1
7.1Συμβόλαιο - Έσοδο1
8.1Ενοίκια - Έσοδο1
8.2Τέλος ανθεκτικότητας κλιματικής κρίσης1
8.4Απόδειξη Είσπραξης POS1
8.5Απόδειξη Επιστροφής POS1
8.6Δελτίο Παραγγελίας Εστίασης1
9.1Δελτίο Αποστολής Συσχετιζόμενο1
9.2Συγκεντρωτικό Δελτίο Αποστολής2
9.3Παραστατικό Διακίνησης Μη Συσχετιζόμενο5
10.1Δελτίο Ποσοτικής Παραλαβής Συσχετιζόμενο1
10.2Δελτίο Ποσοτικής Παραλαβής Μη Συσχετιζόμενο1
11.1ΑΛΠ (Απόδειξη Λιανικής Πώλησης)1
11.2ΑΠΥ (Απόδειξη Παροχής Υπηρεσιών)1
11.3Απλοποιημένο Τιμολόγιο1
11.4Πιστωτικό Στοιχείο Λιανικής1
11.5ΑΛΠ / Πώληση για Λογαριασμό Τρίτων1

Η απάντηση

Όταν η ΑΑΔΕ δεχτεί το παραστατικό, το API απαντά με HTTP 201, όπως στο βήμα 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": "<ΑΦΜ>",
    "counterpart_vat_number": "159107845",
    "total_gross_value": "124.00"
    // … και τα υπόλοιπα στοιχεία του παραστατικού
  }
}