API ΠΛΑΤΦΟΡΜΑ ΔΗΛΩΣΗΣ ΔΙΟΡΘΩΣΗΣ Τ.Μ. ΑΚΙΝΗΤΩΝ ΠΡΟΣ ΤΟΥΣ ΟΤΑ -- tetragonika.govapp.gr

Η πλατφόρμα Δήλωσης Διόρθωσης τ.μ. Ακινήτων προς τους ΟΤΑ ή αλλιώς ΠΔΔΤΜΑ, παρέχει api για σύνδεση με τρίτες εφαρμογές.

• Δοκιμαστικό περιβάλλον
• Παραγωγικό περιβάλλον

Για να κάνουμε δημιουργία εφαρμογής στο GovHub, θα κάνουμε τα παρακάτω βήματα.

1. Εισαγωγή στην ιστοσελίδα http://auth.govhub.gr με τους κωδικούς του διαχειριστή του φορέα.
2. Δημιουργία εφαρμογής με δικαίωμα GovApp.Tetragonika.Basic.

Για να καλέσουμε τα api του ΠΔΔΤΜΑ πρώτα πρέπει έχουμε κάνει authenticate σαν εφαρμογή και να πάρουμε ένα JWT Token.

Για το παραγωγικό περιβάλλον στο πεδίο scope συμπληρώνουμε GovApp.Tetragonika.Basic για το Δοκιμαστικό περιβάλλον στο πεδίο scope συμπληρώνουμε GovApp.Tetragonika.Test.

Οδηγίες για λήψη JTW token από τον auth Server

Αφού λάβουμε το JWT Token σύμφωνα με το Auth 2.0 πρότυπο θα πρέπει να κάνετε Bearer Authentication. Εκτός από τον header Authorization θα πρέπει να δηλώσετε και το Header GovHub-UserName με ένα username το χρήστη που θα κάνει το Request. Ο χρήστης θα πρέπει να είναι χρήστης του auth.govhub.gr και να έχει το ρόλο “Χρήστης Πλατφόρμας Δήλωσης Διόρθωσης τ.μ. Ακινήτων προς τους ΟΤΑ (tetragonika.govapp.gr)”.

Authorization: Bearer <token>
GovHub-UserName: {username}

Αφού ρυθμίσετε τους παραπάνω headers μπορείτε να κάνετε κλήσεις σύμφωνα με τις οδηγίες του OpenApi(παράγραφος 1 docs).

Στην κλήση “api/EmployeesStatements/GetPropertiesStatements” το json πρέπει να είναι της μορφής.

{
    "Start" : 0,
    "Length" : 10,
    "SearchColumns" : [
        //SearchColumnT
        {
            "ColumnName" = "powerSupplyNumber",
            "Value" = "07206367"
        }
    ],
    "orders" : [
        {
            "columnName" : "id", //column name
            "dir" : "asc"  // asc ή desc
        }
    ]
}

Φίλτρα υποστηρίζουμε στα παρακάτω πεδία

• id
• statementState
• sentOnFrm
• sentOnTo
• ownerTin
• ownerFullName
• powerSupplyNumber
• atak
• totalProperties
• hasPowerSupply

AuthServerUrl = "https://auth.govhub.gr"
ClientId = "demo-client-govhub-tetragonika"
ClientSecret = "επικοινωνήστε με email"

GovHub-UserName = "admine9"