Το Interop API επιτρέπει σε συστήματα τρίτων να αντλούν στοιχεία της πλατφόρμας Δημοτικών Τελών (ΔΑΕ, dae.govapp.gr), όπως στατιστικά ανά Δήμο και μήνα, περιοδικές δηλώσεις και το οφειλόμενο τέλος από την ΑΑΔΕ. Η πρόσβαση γίνεται με token από το GovHub.
| Base path | /api/interop |
| Μέθοδος | POST με JSON body σε όλα τα endpoints |
| Μορφή | Content-Type: application/json (το endpoint 19 επιστρέφει αρχείο Excel) |
| Αυθεντικοποίηση | OAuth 2.0 Client Credentials → JWT Bearer token |
| Scope | GovApp.AkatharistaEsoda.Interop |
| Endpoints | 9 (αριθμημένα 11–19) |
| Περιβάλλον | Base URL | Token URL |
|---|---|---|
| Test | https://dae-test.govapp.gr |
https://auth-test.govhub.gr/connect/token |
| Production | https://dae.govapp.gr |
https://auth.govhub.gr/connect/token |
Τα client_id και client_secret δίνονται ξεχωριστά για κάθε περιβάλλον από τον φορέα. Δεν περιλαμβάνονται στην τεκμηρίωση ούτε στα αρχεία Postman.
Για δοκιμές στο Test περιβάλλον χρησιμοποιήστε τις παρακάτω τιμές. Είναι οι ίδιες που υπάρχουν στο Postman environment του Test και αυτές που φαίνονται στα παραδείγματα της σελίδας. Ο ΑΦΜ Δήμου και ο ΚΑΕ ανήκουν στον ίδιο Δήμο (Δήμος Ρόδου). Για να μην πάρετε 403, ο δοκιμαστικός σας client πρέπει να είναι του ίδιου Δήμου (Εμβέλεια δεδομένων).
| Τιμή | Χρήση |
|---|---|
ΑΦΜ Δήμου 997561152 |
Endpoints 11–15 και 17 (afm) |
ΑΦΜ επιχείρησης 988030447 |
Endpoints 16, 18, 19 (afm) |
ΚΑΕ Δήμου 64466 |
Endpoints 16, 18, 19 (kae) |
grant_type=client_credentialsscope=GovApp.AkatharistaEsoda.Interopclient_id / client_secret σας (στο Postman στέλνονται ως Basic Auth header)Authorization: Bearer <access_token>
Content-Type: application/json
Παράδειγμα λήψης token:
curl -X POST https://auth-test.govhub.gr/connect/token \
-u "<client_id>:<client_secret>" \
-d "grant_type=client_credentials" \
-d "scope=GovApp.AkatharistaEsoda.Interop"
GovApp.AkatharistaEsoda.Interop.401. Με token χωρίς το scope επιστρέφει 403.Κάθε client ανήκει σε έναν οργανισμό, αυτόν για τον οποίο εκδόθηκαν τα client_id / client_secret. Ο Δήμος κάθε κλήσης βγαίνει από τον client, όχι από το request.
| Client | Τι βλέπει |
|---|---|
| Δήμος | Μόνο τα δεδομένα του δικού του Δήμου. |
| Κεντρικός φορέας (ΚΕΔΕ, ΥΠΕΣ) | Όλους τους Δήμους. |
| Οργανισμός που δεν είναι Δήμος της πλατφόρμας | Τίποτα· κάθε κλήση επιστρέφει 403. |
Client Δήμου:
afm (ΑΦΜ Δήμου, endpoints 11–15 και 17) και kae (ΚΑΕ Δήμου, endpoints 16, 18, 19) μπορούν να λείπουν. Τότε χρησιμοποιούνται ο ΑΦΜ και ο ΚΑΕ του δικού σας Δήμου.403.afm υποχρεωτικό, οπότε στέλνετε τον ΑΦΜ του Δήμου σας.Κεντρικός φορέας:
afm: όλοι οι Δήμοι.kae είναι υποχρεωτικός.Το 403 λόγω εμβέλειας έχει σώμα:
{
"message": "Το ΑΦΜ Δήμου του αιτήματος δεν αντιστοιχεί στον Δήμο του client.",
"messageCode": 0,
"httpStatusCode": 403,
"errors": []
}
Request body: όλα τα endpoints απαιτούν JSON body. Αν δεν θέλετε φίλτρα, στείλτε {}. Κενό ή άκυρο body επιστρέφει 400.
| # | Endpoint | Τι επιστρέφει |
|---|---|---|
| 11 | POST /api/interop/veveomena-posa |
Βεβαιωμένα ποσά ανά Δήμο και μήνα |
| 12 | POST /api/interop/eisprakseis |
Εισπράξεις ανά Δήμο και μήνα |
| 13 | POST /api/interop/prosafxiseis |
Προσαυξήσεις ανά Δήμο και μήνα |
| 14 | POST /api/interop/plithos-epixeiriseon |
Πλήθος επιχειρήσεων με δήλωση, ανά Δήμο και μήνα |
| 15 | POST /api/interop/plithos-diloseon |
Πλήθος δηλώσεων ανά Δήμο και μήνα |
| 16 | POST /api/interop/aade-historic-data |
Υποβολή και οφειλόμενο τέλος από την ΑΑΔΕ για μία επιχείρηση και έναν μήνα |
| 17 | POST /api/interop/periodikes-diloseis |
Επιχειρήσεις και περιοδικές δηλώσεις ενός Δήμου (από το 2021), με σελιδοποίηση |
| 18 | POST /api/interop/eispraxeis-ana-afm |
Οφειλόμενο τέλος από την ΑΑΔΕ, για όλες τις περιόδους ενός έτους μιας επιχείρησης |
| 19 | POST /api/interop/eispraxeis-ana-afm/excel |
Τα δεδομένα του 18 σε αρχείο Excel |
Τα πέντε endpoints δέχονται το ίδιο request. Η απάντηση έχει την ίδια μορφή· αλλάζει μόνο το πεδίο της τιμής.
| Πεδίο | Τύπος | Υποχρεωτικό | Περιγραφή |
|---|---|---|---|
afm |
string | Όχι | ΑΦΜ Δήμου (9 ψηφία). Client Δήμου: αν λείπει, ο δικός σας Δήμος· αν δοθεί, πρέπει να είναι ο δικός σας (αλλιώς 403). Κεντρικός φορέας: αν λείπει, όλοι οι Δήμοι. |
year |
integer | Όχι | Έτος. Προεπιλογή: το τρέχον έτος. |
month |
integer (1–12) | Όχι | Μήνας. Αν λείπει, επιστρέφονται όλοι οι μήνες. |
// Τρέχον έτος, όλοι οι μήνες· ο Δήμος του client (κεντρικός φορέας: όλοι οι Δήμοι)
{}
// Ένας Δήμος, τρέχον έτος
{ "afm": "997561152" }
// Ένας Δήμος, συγκεκριμένος μήνας
{ "afm": "997561152", "year": 2024, "month": 12 }
{
"data": [
{
"beveomenaPosa": 15420.50,
"afm": "997561152",
"perigafiDimou": "ΔΗΜΟΣ ΡΟΔΟΥ",
"year": 2024,
"month": 12
}
]
}
Κοινά πεδία κάθε στοιχείου του data[]:
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
afm |
string | ΑΦΜ Δήμου |
perigafiDimou |
string | Όνομα Δήμου |
year |
integer | Έτος |
month |
integer | Μήνας καταχώρισης (1–12). Δεν είναι η φορολογική περίοδος· βλ. παρακάτω. |
Πεδίο τιμής ανά endpoint:
| # | Πεδίο | Τύπος | Περιγραφή |
|---|---|---|---|
| 11 | beveomenaPosa |
decimal | Συνολικά βεβαιωμένα ποσά |
| 12 | eisprakseis |
decimal | Συνολικές εισπράξεις (κεφάλαιο + προσαυξήσεις) |
| 13 | prosafxiseis |
decimal | Συνολικές προσαυξήσεις |
| 14 | plithosEpixeiriseon |
integer | Πλήθος διαφορετικών επιχειρήσεων που υπέβαλαν δήλωση |
| 15 | plithosDiloseon |
integer | Πλήθος δηλώσεων (βεβαιωμένες, μηδενικές, αυτόματες μηδενικές) |
year/month είναι ο μήνας καταχώρισης στην πλατφόρμα, όχι η φορολογική περίοδος της δήλωσης.
POST /api/interop/aade-historic-data
Ελέγχει live στην ΑΑΔΕ αν μια επιχείρηση έχει υποβάλει δήλωση για συγκεκριμένο μήνα, έτος και ΚΑΕ Δήμου. Επιστρέφει το οφειλόμενο τέλος προς τον Δήμο.
| Πεδίο | Τύπος | Υποχρεωτικό | Περιγραφή |
|---|---|---|---|
afm |
string (9 ψηφία) | Ναι | ΑΦΜ επιχείρησης |
month |
integer (1–12) | Ναι | Μήνας δήλωσης |
year |
integer | Ναι | Έτος δήλωσης |
kae |
string | Client Δήμου: όχι · Κεντρικός φορέας: ναι | ΚΑΕ Δήμου, όπως τον γνωρίζει η ΑΑΔΕ. Client Δήμου: αν λείπει, ο ΚΑΕ του δικού σας Δήμου· αν δοθεί, πρέπει να είναι αυτός (αλλιώς 403). |
Πέρα από τον έλεγχο του ΚΑΕ έναντι του client, οι τιμές δεν ελέγχονται από την πλατφόρμα· στέλνονται όπως είναι στην ΑΑΔΕ. Μια άκυρη τιμή επιστρέφει το σφάλμα της ΑΑΔΕ με HTTP 200 (βλ. παρακάτω).
{ "afm": "988030447", "month": 1, "year": 2023, "kae": "64466" }
// Επιτυχία
{
"submissionFlag": 1,
"taxes": 450.00,
"periodType": 1,
"errorCode": null,
"errorDescr": null
}
// Σφάλμα επικοινωνίας με την ΑΑΔΕ
{
"submissionFlag": 0,
"taxes": 0,
"periodType": 0,
"errorCode": "GEN_COMMUNICATION_ERROR",
"errorDescr": "The remote endpoint could not be found..."
}
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
submissionFlag |
integer | 1 = έχει υποβληθεί, 0 = δεν υπάρχει υποβολή |
taxes |
decimal | Οφειλόμενο τέλος προς τον Δήμο για την περίοδο (όχι είσπραξη) |
periodType |
integer | Συχνότητα δήλωσης: 1 μηνιαία, 3 τριμηνιαία, 12 ετήσια, 0 όταν δεν υπάρχει απάντηση |
errorCode |
string | null | Κωδικός σφάλματος· null σε επιτυχία |
errorDescr |
string | null | Περιγραφή σφάλματος· null σε επιτυχία |
Σημαντικό: τα σφάλματα αυτού του endpoint επιστρέφονται με HTTP 200, οπότε ελέγχετε πάντα το
errorCode.
- Αν η ΑΑΔΕ δεν απαντήσει ή λήξει το χρονικό όριο:
errorCode: "GEN_COMMUNICATION_ERROR".- Αν η ΑΑΔΕ επιστρέψει δικό της σφάλμα: ο κωδικός και η περιγραφή της, αυτούσια.
Όταν υπάρχει σφάλμα, τα
submissionFlag,taxesκαιperiodTypeείναι0. Αυτό δεν σημαίνει ότι δεν υπάρχει υποβολή.
POST /api/interop/periodikes-diloseis
Επιστρέφει τις επιχειρήσεις των περιοδικών δηλώσεων ενός Δήμου για ένα έτος, από το 2021 και μετά. Καλύπτει τόσο το τέλος επί των ακαθάριστων εσόδων όσο και το τέλος διαμονής παρεπιδημούντων.
Προσωπικά δεδομένα: τα στοιχεία περιλαμβάνουν προσωπικά δεδομένα φυσικών προσώπων (ονοματεπώνυμο, πατρώνυμο, διεύθυνση, τηλέφωνο). Η χρήση και η αποθήκευσή τους από το σύστημά σας πρέπει να συμμορφώνεται με τον GDPR.
| Πεδίο | Τύπος | Υποχρεωτικό | Περιγραφή |
|---|---|---|---|
afm |
string (9 ψηφία) | Ναι | ΑΦΜ Δήμου. Client Δήμου: ο δικός σας Δήμος (αλλιώς 403). Κεντρικός φορέας: οποιοσδήποτε Δήμος. |
year |
integer (2021–2100) | Ναι | Έτος αναζήτησης |
page |
integer (≥ 1) | Όχι | Αριθμός σελίδας. Προεπιλογή: 1 |
pageSize |
integer (1–500) | Όχι | Εγγραφές ανά σελίδα. Προεπιλογή: 50, μέγιστο: 500 |
// Πρώτη σελίδα
{ "afm": "997561152", "year": 2024 }
// Δεύτερη σελίδα
{ "afm": "997561152", "year": 2024, "page": 2 }
// Μεγαλύτερη σελίδα
{ "afm": "997561152", "year": 2024, "pageSize": 100 }
{
"data": [
{
"afm": "987654321",
"eponimia": "ΕΤΑΙΡΕΙΑ Α",
"diakritikosTitlos": "ΕΤΑΙΡΕΙΑ Α",
"...": "...",
"ypokatastimata": [ ],
"kad": [ ],
"periodikesDiloseis": [ ]
}
],
"pagination": {
"currentPage": 1,
"pageSize": 50,
"totalCount": 312,
"totalPages": 7,
"hasPrevious": false,
"hasNext": true
}
}
data[]Όλα τα πεδία μπορεί να είναι null. Τα πεδία με * δεν τα δίνει η ΑΑΔΕ και συνήθως είναι κενά.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
afm |
string | ΑΦΜ επιχείρησης |
doyKodikos / doyPerigrafi* |
string | Κωδικός / περιγραφή ΔΟΥ |
katigoriaEpixeirisisGiaDimo |
integer | 1 = έδρα και υποκαταστήματα στον Δήμο, μόνο με ΚΑΔ δημοτικών τελών · 2 = έδρα στον Δήμο χωρίς υποκαταστήματα, με και άλλες δραστηριότητες · 3 = λοιπές |
typosEpitideumatia* |
string | Τύπος επιτηδευματία |
imerominiaEnarxis / imerominiaLixis |
datetime | Έναρξη / λήξη εργασιών |
eponimia, onoma, patronimo |
string | Επωνυμία ή επώνυμο, όνομα, πατρώνυμο |
fusikoNomikoProsopo |
integer | 1 = φυσικό, 2 = νομικό πρόσωπο |
diakritikosTitlos* |
string | Διακριτικός τίτλος |
nomikiMorfiKodikos* / nomikiMorfiPerigrafi |
integer / string | Νομική μορφή |
legalPurposePerigrafi |
string | Σκοπός |
vivliaKodikos* / vivliaPerigrafi* |
integer / string | Κατηγορία βιβλίων |
address, addressNo, zipCode, perioxi, tilefono |
string | Τρέχουσα διεύθυνση και τηλέφωνο |
etosAnaforas_DoyKodikos, etosAnaforas_Address, etosAnaforas_AddressNo, etosAnaforas_ZipCode, etosAnaforas_Perioxi |
string | ΔΟΥ και διεύθυνση στο τέλος του έτους αναφοράς |
ypokatastimata[] |
array | Υποκαταστήματα: startDate, endDate, aa, doyKodikos, address, addressNo, zipCode, perioxi, τα αντίστοιχα etosAnaforas_* και kad[] |
kad[] |
array | Δραστηριότητες (ΚΑΔ): kodikos (integer), perigrafi, startDate, changeDate, endDate, eidosDrastiriotitas, eidosDrastiriotitasPerigrafi, palaiotita |
periodikesDiloseis[] |
array | Περιοδικές δηλώσεις ΦΠΑ: poso (decimal), imerominiaYpovolis, periodikiDilosiApo, periodikiDilosiEos, periodikiDilosiEidos (integer) |
pagination| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
currentPage |
integer | Τρέχουσα σελίδα |
pageSize |
integer | Εγγραφές ανά σελίδα |
totalCount |
integer | Συνολικός αριθμός επιχειρήσεων |
totalPages |
integer | Συνολικές σελίδες |
hasPrevious |
boolean | Υπάρχει προηγούμενη σελίδα |
hasNext |
boolean | Υπάρχει επόμενη σελίδα |
Αν το page ξεπερνά το πλήθος των σελίδων, επιστρέφεται η τελευταία σελίδα. Ποια σελίδα επιστράφηκε το δείχνει το pagination.currentPage. Για να τις διαβάσετε όλες, συνεχίστε όσο το hasNext είναι true.
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"Afm": ["Το ΑΦΜ πρέπει να έχει 9 ψηφία"],
"Year": ["Το έτος πρέπει να είναι από 2021 και μετά"]
},
"traceId": "00-..."
}
POST /api/interop/eispraxeis-ana-afm
Δίνετε μία επιχείρηση, έναν ΚΑΕ Δήμου και ένα έτος. Το endpoint επιστρέφει μία εγγραφή ανά περίοδο δήλωσης του έτους, με ένδειξη υποβολής, το οφειλόμενο τέλος από τη δήλωση (όχι πραγματική είσπραξη) και το σύνολο του έτους. Τα στοιχεία αντλούνται live από την ΑΑΔΕ, με μία κλήση για κάθε μήνα του έτους. Στην ουσία είναι το endpoint 16 για όλους τους μήνες μαζί.
| Πεδίο | Τύπος | Υποχρεωτικό | Περιγραφή |
|---|---|---|---|
afm |
string (9 ψηφία) | Ναι | ΑΦΜ επιχείρησης (όχι Δήμου) |
kae |
string | Client Δήμου: όχι · Κεντρικός φορέας: ναι | ΚΑΕ Δήμου, όπως τον γνωρίζει η ΑΑΔΕ. Client Δήμου: αν λείπει, ο ΚΑΕ του δικού σας Δήμου· αν δοθεί, πρέπει να είναι αυτός (αλλιώς 403). |
etos |
integer (2022–2025) | Ναι | Έτος |
{ "afm": "988030447", "kae": "64466", "etos": 2023 }
{
"afm": "988030447",
"etos": 2023,
"kae": "64466",
"municipalityName": "ΔΗΜΟΣ ΡΟΔΟΥ",
"exeiIpovoli": true,
"synoloTaxes": 1800.00,
"periodoi": [
{ "periodosLabel": "Α΄ τρίμηνο 2023", "periodType": 3, "submissionFlag": 1, "taxes": 450.00 },
{ "periodosLabel": "Β΄ τρίμηνο 2023", "periodType": 3, "submissionFlag": 1, "taxes": 450.00 }
],
"sfalmata": []
}
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
afm, etos, kae |
string / integer / string | Τα στοιχεία του request |
municipalityName |
string | Όνομα Δήμου βάσει του ΚΑΕ, ενδεικτικό. Κενό αν ο ΚΑΕ δεν αντιστοιχεί σε Δήμο της πλατφόρμας. |
exeiIpovoli |
boolean | Υπάρχει τουλάχιστον μία περίοδος του έτους με υποβολή |
synoloTaxes |
decimal | Άθροισμα του οφειλόμενου τέλους όλων των περιόδων (κάθε περίοδος μετράει μία φορά) |
periodoi[].periodosLabel |
string | Π.χ. «Μάρτιος 2023», «Β΄ τρίμηνο 2023», «Έτος 2023» |
periodoi[].periodType |
integer | 1 μηνιαία, 3 τριμηνιαία, 12 ετήσια δήλωση |
periodoi[].submissionFlag |
integer | 1 = υποβλήθηκε, 0 = δεν υποβλήθηκε |
periodoi[].taxes |
decimal | Οφειλόμενο τέλος της περιόδου από τη δήλωση (0 για περίοδο χωρίς υποβολή) |
sfalmata[] |
array | Μήνες για τους οποίους απέτυχε η κλήση στην ΑΑΔΕ: minas (integer), errorCode (string), errorDescr (string) |
Επιστρέφονται όλες οι περίοδοι του έτους, με ή χωρίς υποβολή. Οι περίοδοι χωρίς υποβολή έχουν submissionFlag: 0 και taxes: 0.
Η συχνότητα (μηνιαία/τριμηνιαία) βγαίνει από τις υποβολές για κάθε τρίμηνο χωριστά. Έτσι αλλαγή συχνότητας μέσα στο έτος εμφανίζεται σωστά. Με ετήσια δήλωση επιστρέφεται μία μόνο περίοδος.
Αν δεν υπάρχει καμία υποβολή στο έτος, το periodoi είναι κενό και το exeiIpovoli είναι false.
Η ΑΑΔΕ καλύπτει τις περιόδους 01/2022 – 02/2025. Για το 2025 επιστρέφονται μόνο οι περίοδοι Ιανουαρίου–Φεβρουαρίου.
Μερική αποτυχία: αν αποτύχει η κλήση στην ΑΑΔΕ για κάποιους μήνες:
sfalmata[]·Ελέγχετε πάντα αν το sfalmata είναι κενό πριν θεωρήσετε το αποτέλεσμα πλήρες.
Ένα αποτέλεσμα χωρίς σφάλματα κρατιέται για 1 ώρα ανά ΚΑΕ/ΑΦΜ/έτος. Επαναλαμβανόμενες κλήσεις μέσα στην ώρα επιστρέφουν το ίδιο αποτέλεσμα, χωρίς νέα κλήση στην ΑΑΔΕ.
Επιστρέφονται για μη έγκυρο ΑΦΜ (όχι 9 ψηφία), για έτος εκτός 2022–2025 και για κενό ΚΑΕ από κεντρικό φορέα:
{
"message": "Μη έγκυρο ΑΦΜ (πρέπει να είναι 9 ψηφία).",
"messageCode": 0,
"httpStatusCode": 400,
"errors": []
}
POST /api/interop/eispraxeis-ana-afm/excel
Έχει το ίδιο request και επιστρέφει τα ίδια δεδομένα με το endpoint 18, σε αρχείο .xlsx. Αν το καλέσετε μέσα σε μία ώρα από μια επιτυχημένη κλήση του 18 με τα ίδια στοιχεία, δεν γίνεται νέα κλήση στην ΑΑΔΕ.
{ "afm": "988030447", "kae": "64466", "etos": 2023 }
| Στοιχείο | Τιμή |
|---|---|
| Content-Type | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
Όνομα αρχείου (Content-Disposition) |
DAE_Eispraxeis_{afm}_{etos}_{yyyyMMdd_HHmm}.xlsx |
| Φύλλο «ΕΙΣΠΡΑΞΕΙΣ» | Κεφαλίδα (ΑΦΜ, Έτος, ΚΑΕ, Δήμος), πίνακας περιόδων και γραμμή «Σύνολο» |
| Φύλλο «ΣΦΑΛΜΑΤΑ» | Υπάρχει μόνο αν απέτυχε η κλήση για κάποιους μήνες |
Τα σφάλματα επικύρωσης (400) είναι ίδια με του endpoint 18 και επιστρέφονται ως JSON, όχι ως αρχείο.
| HTTP | Πότε | Μορφή σώματος |
|---|---|---|
200 |
Επιτυχία | Κανονική απάντηση |
200 με errorCode |
Endpoint 16: σφάλμα ΑΑΔΕ (GEN_COMMUNICATION_ERROR ή κωδικός της ΑΑΔΕ) |
Βλ. endpoint 16 |
400 |
Endpoint 17: λάθος ή υποχρεωτικά πεδία που λείπουν · Όλα τα endpoints: κενό ή άκυρο JSON body | ProblemDetails (type, title, status, errors, traceId) |
400 |
Endpoints 18, 19: μη έγκυρο ΑΦΜ, έτος ή κενός ΚΑΕ από κεντρικό φορέα | { message, messageCode, httpStatusCode, errors } |
401 |
Δεν στάλθηκε token ή έχει λήξει | — |
403 |
Το token δεν έχει το scope GovApp.AkatharistaEsoda.Interop |
— |
403 |
Όλα τα endpoints: το afm Δήμου ή ο kae δεν είναι του Δήμου του client, ή ο client δεν είναι Δήμος της πλατφόρμας (Εμβέλεια δεδομένων) |
{ message, messageCode, httpStatusCode, errors } |
500 |
Εσωτερικό σφάλμα της εφαρμογής | { "message": "Παρουσιάστηκε εσωτερικό σφάλμα της εφαρμογής", "messageCode": 0, "httpStatusCode": 500, "errors": [] } |
Μαζί με την τεκμηρίωση παρέχονται τρία αρχεία για λήψη:
| Αρχείο | Περιεχόμενο |
|---|---|
| Postman_InteropAPI.json | Collection με έτοιμα requests για κάθε endpoint (11–19), μαζί με παραδείγματα σφαλμάτων επικύρωσης για τα 17 και 18 |
| Postman_InteropAPI_Environment_Test.json | Environment για το Test |
| Postman_InteropAPI_Environment_Production.json | Environment για το Production |
Βήματα:
client_id και client_secret.GovApp.AkatharistaEsoda.Interop. Στην καρτέλα Authorization της collection πατήστε Get New Access Token και μετά Use Token. Όλα τα requests κληρονομούν το token.403. Τα requests «Όλοι Δήμοι» των endpoints 11–15 δεν στέλνουν afm: επιστρέφουν όλους τους Δήμους μόνο για κεντρικό φορέα, ενώ για client Δήμου επιστρέφουν τον δικό του Δήμο.| Μεταβλητή | Χρήση |
|---|---|
base_url |
Base URL του περιβάλλοντος |
auth_token_url |
Token URL του περιβάλλοντος |
client_id, client_secret |
Τα διαπιστευτήριά σας (δεν παρέχονται) |
test_municipality_afm |
ΑΦΜ Δήμου (endpoints 11–15) · Test: 997561152 |
test_year, test_month |
Έτος / μήνας |
test_epixirisi_afm |
ΑΦΜ επιχείρησης (endpoints 16, 18, 19) · Test: 988030447 |
test_kae |
ΚΑΕ Δήμου (endpoints 16, 18, 19) · Test και Production: 64466 (Δήμος Ρόδου) |
Τα requests του endpoint 17 έχουν ΑΦΜ Δήμου 997561152, τον Δήμο δοκιμής του Test. Για άλλο περιβάλλον ή Δήμο, αντικαταστήστε τον με τον ΑΦΜ του Δήμου του client σας.