Τεκμηρίωση API ΚΗΜΔΗΣ

Εισαγωγή

Το Κεντρικό Ηλεκτρονικό Μητρώο Δημοσίων Συμβάσεων (ΚΗΜΔΗΣ) διαθέτει δύο κατηγορίες διεπαφών προγραμματισμού εφαρμογής (Application Programming Interfaces - APIs):

Open Data API (Διεπαφή Ανοιχτών Δεδομένων)

Το Open Data API αφορά στην ελεύθερη άντληση στοιχείων των καταχωρισμένων στο ΚΗΜΔΗΣ πράξεων ή/και αποφάσεων των Αναθετουσών Αρχών. Τα δεδομένα διατίθενται στο κοινό ως ανοιχτά δεδομένα σύμφωνα με την Οδηγία (ΕΕ) 2019/1024 και δωρεάν με τους ειδικότερους όρους της Ελληνικής άδειας Creative Commons Αναφορά Προέλευσης (CC BY v.4.0), όπως προσδιορίζονται λεπτομερώς στη σχετική Άδεια Χρήσης.

API Καταχώρισης (Submission / Registry API)

Το API Καταχώρισης αφορά στην ανάρτηση καταχωριστέων και στην επικαιροποίηση καταχωρισμένων στοιχείων στο ΚΗΜΔΗΣ πράξεων ή/και αποφάσεων των Αναθετουσών Αρχών από πληροφοριακά συστήματα που ανήκουν σε εξουσιοδοτημένους φορείς, και απαιτείται:

  • η αυθεντικοποίηση γίνεται με διαπιστευτήρια πρόσβασης (username/password) του εξουσιοδοτημένου φορέα
  • οι κλήσεις να γίνονται με κατάλληλα διαμορφωμένα HTTP requests αρχιτεκτονικής REST

Για την εγγραφή και έκδοση διαπιστευτηρίων συμβουλευτείτε τις σχετικές πληροφορίες στην ενότητα Κέντρο Εξυπηρέτησης του διαδικτυακής πύλης του ΟΠΣ ΕΣΗΔΗΣ.

Η παρούσα τεκμηρίωση περιγράφει τόσο τις τεχνικές και επιχειρησιακές πτυχές του Open Data API όσο και του API Καταχώρισης του ΚΗΜΔΗΣ. Προς διευκόλυνση σας, για την πλοήγηση εντός της τεκμηρίωσης μπορείτε να χρησιμοποιήσετε τον πίνακα περιεχομένων της σελίδας που βρίσκεται αριστερά.

Για ζητήματα περαιτέρω υποστήριξης σχετικά με τα APIs ΚΗΜΔΗΣ, υποβάλλετε σχετικό ηλεκτρονικό ερώτημα (eTicket) στο Κέντρο Εξυπηρέτησης του ΟΠΣ ΕΣΗΔΗΣ εδώ.

Σημειώσεις

Στο παρόν κείμενο γίνεται αναφορά σε υποσύνολο λειτουργιών του ΚΗΜΔΗΣ που θα διατεθούν από το Opendata API και το API καταχώρησης που ακολουθούν τη λογική του REST. Για τη χρήση των παρεχόμενων λειτουργιών απαιτείται η αποστολή κατάλληλα διαμορφωμένων HTTP αιτημάτων. Στη συνέχεια του κειμένου, όπου γίνεται αναφορά σε REST resource, για να περιγράψουμε το αίτημα πρόσβασης σε έναν πόρο θα παραλείπουμε το σταθερό τμήμα των διευθύνσεων [API_BASE_URL] στις οποίες θα αποστέλλονται τα αιτήματα. Για παράδειγμα, το αίτημα λήψης των τύπων πράξεων: 

POST /khmdhs-opendata/request

θα σημαίνει την αποστολή ενός αιτήματος POST στη διεύθυνση [API_BASE_URL]/khmdhs-opendata/request. Το API_BASE_URL είναι το https://cerpp.eprocurement.gov.gr.


Υποστηριζόμενες μορφές μηνυμάτων

Το API υποστηρίζει JSON για κλήσεις. Για το format ορίστε Accept header ή τη σχετική κατάληξη στο URL (.json).

Παραδείγματα κλήσεων στις οποίες το format ορίζεται με header, με χρήση του cURL:

curl -k -H "Accept: application/json" https://cerpp.eprocurement.gov.gr/khmdhs-opendata/request

Παραδείγματα κλήσεων στις οποίες το format ορίζεται με σχετική κατάληξη στο URL, με χρήση του cURL:

curl -k https://cerpp.eprocurement.gov.gr/khmdhs-opendata/request

API client

Όλες οι κλήσεις που μπορεί να πραγματοποιήσει το Opendata API είναι διαθέσιμες στο ΚΗΜΔΗΣ-Opendata.

Όλες οι κλήσεις που μπορεί να πραγματοποιήσει το API καταχώρησης είναι διαθέσιμες στο ΚΗΜΔΗΣ-Submit.


Όρια χρήσης API

Για τη διασφάλιση της ποιότητας των υπηρεσιών και την αποφυγή κατάχρησης, το API ανάκτησης (opendata) εφαρμόζει περιορισμούς στον ρυθμό των αιτημάτων (rate limiting). Το τρέχον όριο είναι 350 αιτήματα ανά λεπτό. Σε περίπτωση υπέρβασης του ορίου, το API θα επιστρέψει τον κωδικό κατάστασης HTTP 429 Too Many Requests.


Ενημέρωση δεδομένων του Opendata API

Τα μεταδεδομένα και τα αρχεία των καταχωρημένων πράξεων του ΚΗΜΔΗΣ ενημερώνονται στο Opendata API με αυτόματη διαδικασία καθημερινά (κάθε 24h).


Εξέλιξη του API και ενημερώσεις

Σε όσες περιπτώσεις κρίνεται απολύτως απαραίτητο, θα πραγματοποιούνται αναβαθμίσεις στο API οι οποίες ενδέχεται να επηρεάσουν τη λειτουργία των συστημάτων που αλληλεπιδρούν με αυτό. Μερικά παραδείγματα τέτοιων αλλαγών είναι τα εξής:

  • Προσθήκες νέων ειδικών πεδίων στις προδιαγραφές των τύπων πράξεων.
  • Τροποποιήσεις πεδίων κλήσης.
  • Τροποποιήσεις στη δομή των πληροφοριών των απαντήσεων του API.

Αυθεντικοποίηση

Οδηγίες αυθεντικοποίησης

Για την καταχώρηση πράξεων, το API καταχώρησης του ΚΗΜΔΗΣ δίνει επί του παρόντος τη δυνατότητα χρήσης Basic Authentication. Ο τρόπος χρήσης του από τους client είναι ο εξής:

  1. Δημιουργείται ένα λεκτικό της μορφής username:password, το οποίο στη συνέχεια κωδικοποιείται σε Base64 (RFC 2045 variant).
  2. O client υποβάλλει το request του σε έναν Web Server, προσθέτοντας το header Authorization: Basic XYZ, όπου XYZ είναι η τιμή που έχει προκύψει από το προηγούμενο βήμα.

Για παράδειγμα, αν ο client θέλει να προσπελάσει έναν προστατευμένο πόρο ως ο χρήστης bob με το password bob, τότε θα πρέπει να αποστείλει ένα Web request στο οποίο θα πρέπει να υπάρχει το header:

Authorization: Basic Ym9iOmJvYg==

Ένας χρήστης του ΚΗΜΔΗΣ για να έχει εξουσιοδοτημένη πρόσβαση στο API καταχώρησης θα πρέπει κατά την εγκρισή του να έχει λάβει Δικαίωμα χρήσης API.

Μοντέλο Δεδομένων

Ανάκτηση Αιτημάτων

Κάθε ανάκτηση Αιτήματος αποτελείται από τα εξής μέρη:

  • Ένα σύνολο δεδομένων τα οποία περιγράφουν το Αίτημα και ανακτώνται με μια REST κλήση POST.
  • Το έγγραφο του Αιτήματος σε μορφή PDF το οποίο μπορεί να ανακτηθεί με μια REST κλήση GET και με τον αριθμό ΑΔΑΜ {referenceNumber} του Αιτήματος.

POST /khmdhs-opendata/request?page=0

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση σελιδοποιημένων αποτελεσμάτων των Αιτημάτων με βάση το request body της κλήσης.

Παράμετροι Κλήσης

  • page (integer, optional): Ο αριθμός σελίδας που θέλετε να ανακτήσετε, ξεκινώντας από το 0. Εάν δεν έχει καθοριστεί, τότε ορίζεται αυτόματα 0.

Request Body Κλήσης

Το request body της κλήσης θα πρέπει να είναι ένα αντικείμενο JSON που περιέχει τα παρακάτω πεδία:

                        
{
    "title": "string",
    "cpvItems": ["string"],
    "organizations": ["string"],
    "signer": "string",
    "referenceNumber": "string",
    "contractType": "string",
    "dateFrom": "2024-11-05",
    "dateTo": "2024-11-05",
    "totalCostFrom": 0,
    "totalCostTo": 0,
    "cancelDateFrom": "2024-11-05",
    "cancelDateTo": "2024-11-05",
    "isInitial": true,
    "isApproved": true,
    "isApproval": true
}
Παρατηρήσεις

  • Αν δεν οριστεί τιμή στο πεδίο dateTo, ενώ έχει οριστεί dateFrom, τότε το σύστημα αυτομάτως θα εισάγει ως τιμή την dateFrom συν 180 μέρες.
  • Αν δεν έχει οριστεί τιμή στο πεδίο dateFrom ενώ έχει οριστεί dateTo, τότε το σύστημα αυτομάτως θα εισάγει την ημερομηνία του dateTo μείον 180 μέρες.
  • Αν δεν έχει οριστεί ούτε dateFrom ούτε dateTo, τότε το σύστημα θα εισάγει ως dateTo την τρέχουσα ημερομηνία και dateFrom την τρέχουσα ημερομηνία μείον 180 μέρες.
  • Αν έχει οριστεί dateFrom και dateTo, αλλά έχουν διαφορά μεγαλύτερη των 180 ημερών, τότε το σύστημα θα εισάγει dateFrom την dateTo μείον 180 μέρες.
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί ούτε cancelDateFrom ούτε cancelDateTo τότε δεν θα υπολογίζεται η Ημερομηνία Ματαίωσης κατά την αναζήτηση. Σε περίπτωση που έχει οριστεί μόνο cancelDateFrom ή μόνο cancelDateΤο η και οι 2 τότε θα ισχύει ο κανόνας τον 180 ημερών όπως περιγράφεται για τα πεδία dateFrom και dateTo
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί το εύρος των cancelDateFrom και cancelDateΤο το σύστημα επιστρέφει και τις Ματαιώσεις με βάση τα υπόλοιπα καθορισμένα κριτήρια αναζήτησης. Αν καθοριστούν τα cancelDateFrom και cancelDateΤο τότε το σύστημα επιστρέφει μόνο πράξεις που έχουν ματαιωθεί.
  • Όσον αφορά τα πεδία isInitial, isApproved και isApproval εαν δεν συμπληρωθούν θεωρούνται σαν true. Οπότε για παράδειγμα, για να γίνει ανάκτηση μόνο των Πρωτογενών Αιτημάτων θα πρέπει να οριστούν τα isApproved και isApproval με τιμή false.


Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
cpvItems Array[string] Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
πχ. "34327200-7" για Άξονες και κιβώτια,
"34711500-9" για Ελικόπτερα
organizations Array[string] Αναθέτουσα Αρχή/Αναθέτων Φορέας.
Συμπληρώστε τον κωδικό του Φορέα.
πχ. "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ,
"72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
referenceNumber string Μοναδικός Κωδικός - ΑΔΑΜ.
signer string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
πχ. "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
dateFrom string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Από (YYYY-MM-DD).
dateTo string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Έως (YYYY-MM-DD).
totalCostFrom integer Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Από.
totalCostTo integer Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Έως.
cancelDateFrom string Ματαιώσεις Από (YYYY-MM-DD).
cancelDateTo string Ματαιώσεις Έως (YYYY-MM-DD).
isInitial boolean Πρωτογενή Αιτήματα (true/false). Εάν δεν συμπληρωθεί θεωρείται true.
isApproved boolean Αρχείο Αιτημάτων (true/false). Εάν δεν συμπληρωθεί θεωρείται true.
isApproval boolean Εγκρίσεις Πρωτογενών Αιτημάτων (true/false). Εάν δεν συμπληρωθεί θεωρείται true.

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Το πεδίο Τίτλος (title) θα πρέπει να έχει μέχρι 100 χαρακτήρες. Όχι
cpvItems Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενός. Όχι
organizations Το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
referenceNumber Το πεδίο ΑΔΑΜ (referenceNumber) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενό. Όχι
signer Το πεδίο Αποφαινόμενο όργανο (signer) θα πρέπει να είναι ένας θετικός αριθμός ή κενό.
Εάν το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) έχει περισσότερες απο μια τιμή, το Αποφαινόμενο όργανο (signer) πρέπει να είναι κενό.		 Όχι
contractType Το πεδίο Κύριος χαρακτήρας σύμβασης (contractType) θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
dateFrom / dateTo Η Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
totalCostFrom / totalCostTo Τα πεδία Συνολική αξία χωρίς ΦΠΑ (totalCostFrom) και (totalCostTo) θα πρέπει να είναι ίσα ή μεγαλύτερα από 0. Όχι
cancelDateFrom / cancelDateTo Η Ημερομηνία Ματαίωσης θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
isInitial Πρέπει να είναι true ή false. Όχι
isApproved Πρέπει να είναι true ή false. Όχι
isApproval Πρέπει να είναι true ή false. Όχι

Παράδειγμα απάντησης σε περίπτωση λανθασμένης τιμής στα πεδία referenceNumber και cpvItems κατά την κλήση:

{
	"errors": {
		"referenceNumber": "Το πεδίο ΑΔΑΜ (referenceNumber) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενό.",
                "cpvItems": "Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενός."
	}
}

Παράδειγμα κλήσης

POST /khmdhs-opendata/request?page=0
Content-Type: application/json

{
    "title": "Αίτηση έκδοσης",
    "cpvItems": ["79822500-7", "34711500-9"],
    "referenceNumber": "25REQ016180898",
    "organizations": ["100015981"],
    "signer": "113314",
    "contractType": "10",
    "dateFrom": "2025-01-01",
    "dateTo": "2025-01-20",
    "totalCostFrom": "1000",
    "totalCostTo": "5000",
    "cancelDateFrom": "2025-01-01",
    "cancelDateTo": "2025-02-01",
    "isInitial": true,
    "isApproved": true,
    "isApproval": false
}

Παράδειγμα απάντησης


{
  "content": [
    {
      "title": "Αίτηση έκδοσης",
      "referenceNumber": "25REQ016180898",
      "previousRequestReferenceNumber": null,
      "signedDate": "2024-02-05",
      "lastUpdateDate": null,
      "submissionDate": "2025-01-20T16:19:55.859959",
      "procurementDeliveryDate": "2024-02-05",
      "cancellationDate": null,
      "cancelled": false,
      "cancellationReason": null,
      "cancellationADA": null,
      "cancellationType": null,
      "protocolNumber": "32323",
      "approvalCommitmentCode": null,
      "procedureType": null,
      "approvalADA": null,
      "authorEmail": null,
      "greekOrganizationVatNumber": false,
      "organizationVatNumber": "132377396",
      "budget": null,
      "commitmentNo": null,
      "preApproval": false,
      "approved": false,
      "organization": {
        "key": "100015981",
        "value": "ΥΠΟΥΡΓΕΙΟ ΑΓΡΟΤΙΚΗΣ ΑΝΑΠΤΥΞΗΣ ΚΑΙ ΤΡΟΦΙΜΩΝ"
      },
      "nutsCode": {
        "key": "FRF",
        "value": "ALSACE-CHAMPAGNE-ARDENNE-LORRAINE"
      },
      "typeOfContractingAuthority": {
        "key": "12",
        "value": "Κεντρική Διοίκηση"
      },
      "classificationOfPublicLawOrganization": {
        "key": "1",
        "value": "Κεντρική Κυβέρνηση"
      },
      "contractTypes": [],
      "aaht": "5663453",
      "contractingData": {
        "unitsOperator": {
          "key": "100047202",
          "value": "ΑΝΑΠΤΥΞΙΑΚΗ ΔΥΤΙΚΗΣ ΜΑΚΕΔΟΝΙΑΣ ΑΕ ΟΤΑ"
        },
        "signers": {
          "key": "100082827",
          "value": "ΑΘΑΝΑΣΙΑ ΑΓΓΕΛΑΚΗ - Διευθυντής"
        }
      },
      "totalCostWithVAT": 5615.2,
      "totalCostWithoutVAT": 5092.0,
      "objectDetails": [
        {
          "quantity": 1,
          "type": {
            "key": "KGM",
            "value": "Kg"
          },
          "costWithoutVAT": 860,
          "vat": "0",
          "currency": {
            "key": "EUR",
            "value": "Ευρώ"
          },
          "shortDescription": "test 3",
          "cpvs": [
            {
              "key": "79822500-7",
              "value": "Υπηρεσίες γραφικού σχεδιασμού"
            }
          ]
        },
        {
          "quantity": 5,
          "type": {
            "key": "KGM",
            "value": "Kg"
          },
          "costWithoutVAT": 3232,
          "vat": "10",
          "currency": {
            "key": "EUR",
            "value": "Ευρώ"
          },
          "shortDescription": "test 1",
          "cpvs": [
            {
              "key": "33131600-3",
              "value": "Όργανο σφραγίσματος δοντιών"
            }
          ]
        },
        {
          "quantity": 2,
          "type": {
            "key": "KGM",
            "value": "Kg"
          },
          "costWithoutVAT": 1000,
          "vat": "20",
          "currency": {
            "key": "EUR",
            "value": "Ευρώ"
          },
          "shortDescription": "test 2",
          "cpvs": [
            {
              "key": "33131600-3",
              "value": "Όργανο σφραγίσματος δοντιών"
            }
          ]
        }
      ],
      "additionalContractTypes": null,
      "mixedContract": null,
      "approvalRefNo": [],
      "noticeRefNo": [
          "25PROC009223057",
          "25PROC009223000",
          "25PROC009222919"
      ],
      "contractRefNo": [],
      "paymentRefNo": [],
      "auctionRefNo": []
    }
  ],
  "pageable": {
    "sort": {
      "empty": true,
      "sorted": false,
      "unsorted": true
    },
    "offset": 0,
    "pageNumber": 0,
    "pageSize": 50,
    "paged": true,
    "unpaged": false
  },
  "last": true,
  "totalPages": 1,
  "totalElements": 1,
  "number": 0,
  "size": 50,
  "sort": {
    "empty": true,
    "sorted": false,
    "unsorted": true
  },
  "first": true,
  "numberOfElements": 1,
  "empty": false
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
content Array Λίστα απο αντικείμενα Αιτημάτων.
content[].title String Τίτλος.
content[].referenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ.
content[].previousRequestReferenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ προηγούμενου αιτήματος.
content[].signedDate Date Ημερομηνία Πρωτοκόλλου (έκδοσης).
content[].lastUpdateDate DateTime Τελευταία ανανέωση.
content[].submissionDate DateTime Ημερομηνία υποβολής.
content[].procurementDeliveryDate Date Εκτιμώμενη ημερομηνία χρήσης προμήθειας αγαθού/παροχής υπηρεσίας/εκτέλεσης έργου.
content[].cancellationDate DateTime Ημερομηνία ματαίωσης.
content[].cancelled Boolean Υποδεικνύει εάν το αίτημα ακυρώθηκε.
content[].cancellationReason String Λόγος Ματαίωσης.
content[].cancellationADA String ΑΔΑ απόφασης Ακύρωσης/Ματαίωσης.
content[].cancellationType String Τύπος Ακύρωσης/Ματαίωσης.
content[].protocolNumber String Αριθμός Πρωτοκόλλου.
content[].approvalCommitmentCode String Αριθμός Ανάληψης Υποχρέωσης.
content[].procedureType String Διαδικασία Ανάθεσης.
content[].approvalADA String ΑΔΑ απόφασης έγκρισης - Διαύγεια.
content[].authorEmail String Email Συντάκτη.
content[].greekOrganizationVatNumber Boolean Ελληνικό ΑΦΜ.
content[].organizationVatNumber String ΑΦΜ Φορέα.
content[].budget Decimal Εγκεκριμένη Δαπάνη.
content[].commitmentNo String Αριθμός Ανάληψης Υποχρέωσης.
content[].preApproval Boolean Υποδεικνύει εάν το αίτημα έχει λάβει Πολυετής έγκριση.
content[].approved Boolean Υποδεικνύει εάν το αίτημα έχει εγκριθεί.
content[].organization Object Αναθέτουσα Αρχή/Αναθέτων Φορέας.
content[].nutsCode Object Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
content[].typeOfContractingAuthority Array Είδος Αναθέτουσας Αρχής
content[].classificationOfPublicLawOrganization Array Ταξινόμηση Οργανισμού Δημοσίου Δικαίου.
content[].contractTypes Array Λίστα με τιμές του πεδίου Κύριος χαρακτήρας σύμβασης.
content[].aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
content[].contractingData Object Στοιχεία συμβαλλομένων φορέων.
content[].contractingData.unitsOperator String Οργανική Μονάδα.
content[].contractingData.signers String Αποφαινόμενο όργανο.
content[].totalCostWithVAT Decimal Συνολικό κόστος με ΦΠΑ.
content[].totalCostWithoutVAT Decimal Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ.
content[].objectDetails Array Λίστα στοιχείων Αντικειμένου.
content[].objectDetails[].quantity Integer Η ποσότητα του Αντικειμένου.
content[].objectDetails[].costWithoutVAT Decimal Η Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
content[].objectDetails[].type.value String Μονάδες Μέτρησης.
content[].objectDetails[].vat String Το ΦΠΑ του αντικειμένου.
content[].objectDetails[].currency String Νόμισμα
content[].objectDetails[].shortDescription String Περιληπτική περιγραφή του Αντικειμένου.
content[].objectDetails[].cpvs[] String Περιγραφή με όρους CPVS.
content[].additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης.
content[].mixedContract Boolean Μικτή σύμβαση.
content[].approvalRefNo Array Λίστα με ΑΔΑΜ αιτημάτων που έχουν εγκρίνει ή προεγκρίνει το αίτημα.
content[].noticeRefNo Array Λίστα με ΑΔΑΜ προκηρύξεων με τα οποία συνδέεται το αίτημα.
content[].contractRefNo Array Λίστα με ΑΔΑΜ συμβάσεων με τα οποία συνδέεται το αίτημα.
content[].paymentRefNo Array Λίστα με ΑΔΑΜ εντολών πληρωμών με τα οποία συνδέεται το αίτημα.
content[].auctionRefNo Array Λίστα με ΑΔΑΜ αναθέσεων με τα οποία συνδέεται το αίτημα.
pageable Object Πληροφορίες Σελιδοποίησης της απάντησης.
last Boolean Υποδεικνύει εάν είναι η τελευταία σελίδα της απάντησης.
totalPages Integer Ο Συνολικός αριθμός τως Σελίδων.
totalElements Integer Ο Συνολικός αριθμός των αποτελεσμάτων με βάση τα κρητήρια αναζήτησης.
first Boolean Υποδεικνύει εάν είναι η πρώτη Σελίδα αποτελεσμάτων.
numberOfElements Integer Ο αριθμός των αποτελεσμάτων για την τρέχουσα σελίδα.
size Integer Ο προκαθορισμένος αριθμός αποτελεσμάτων ανα σελίδα.
number Integer Ο τρέχον αριθμός σελίδας.
sort Object Πληροφορίες ταξινόμησης που εφαρμόστηκε.
empty Boolean True μόνο εάν δεν υπάρχουν αποτελέσματα. False αν υπαρχουν αποτελέσματα.

Ανάκτηση αρχείου Αιτήματος

GET /khmdhs-opendata/request/attachment/{referenceNumber}

Περιγραφή

Ανακτά ένα έγγραφο PDF που αφορά ένα συγκεκριμένο Αίτημα, που προσδιορίζεται από τον κωδικό ΑΔΑΜ {referenceNumber}.

Παράμετρος

  • referenceNumber (string): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του συνημμένου αρχείου του Αιτήματος για ανάκτηση.

Παράδειγμα Κλήσης

GET [API_BASE_URL]/khmdhs-opendata/request/attachment/24REQ009216002

Απάντηση

Επιστρέφει ένα PDF αρχείο:

  • Content-Type: application/pdf
  • Body: Δυαδικό περιεχόμενο byte[] του αρχείου PDF.

Παράδειγμα cURL Εντολής

curl -o attachment.pdf  [API_BASE_URL]/khmdhs-opendata/request/attachment/24REQ009216002

Καταχώρηση Πρωτογενών & Εγκεκριμένων Αιτημάτων

Η λειτουργικότητα της υποβολής αιτημάτων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Αιτήματος μέσω REST κλήσης POST, με επισύναψη PDF αρχείου.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

POST /khmdhs-api/request

Περιγραφή

Η κλήση επιτρέπει την καταχώρηση ενός Αιτήματος και τη μεταφόρτωση σχετικού αρχείου PDF.

Παράμετροι Κλήσης

  • file (MultipartFile, required): Το PDF αρχείο που συνοδεύει το αίτημα. Το αρχείο πρέπει να είναι έγκυρο και σε μορφή PDF.
  • request (String, required): Ένα αντικείμενο JSON που περιέχει τα δεδομένα του Αιτήματος.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και ν περιέχει τα εξής πεδία:

{
  "title": "ΤΕΣΤ",
  "approved": false,
  "aaht": "5663453",
  "signedDate": "2024-02-05",
  "procurementDeliveryDate": "2024-02-05",
  "protocolNumber": "32323",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "132377396",
  "contractType": "12",
  "additionalContractTypes": ["1"],
  "nutsCode": "FRF",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "typeOfContractingAuthority": "10",
  "classificationOfPublicLawOrganization": "1",
  "objectDetailsList": [
    {
      "quantity": 5,
      "costWithoutVAT": 3232,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "test 1",
      "cpvs": [
        "33131600-3"
      ]
    },
    {
      "quantity": 2,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "20",
      "currency": "EUR",
      "shortDescription": "test 2",
      "cpvs": [
        "33131600-3"
      ]
    },
    {
      "quantity": 1,
      "costWithoutVAT": 860,
      "type": "KGM",
      "vat": "0",
      "currency": "EUR",
      "shortDescription": "test 3",
      "cpvs": [
        "33131600-3"
      ]
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
approved Boolean Έγκριση.
prevRequestRefNo string ΑΔΑΜ Αιτήματος προς Έγκριση.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
procurementDeliveryDate string Εκτιμώμενη ημερομηνία χρήσης προμήθειας αγαθού/παροχής υπηρεσίας/εκτέλεσης έργου.
protocolNumber string Αριθμός Πρωτοκόλλου.
greekOrganizationVatNumber boolean Εάν το ΑΦΜ είναι ελληνικό.
organizationVatNumber string ΑΦΜ Φορέα.
contractType String Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes string Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
contractingData Object Δεδομένα αναθέτουσας αρχής.
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε τον κωδικό της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"8" για ΕΚΑΑ ή ΚΑΑ,
"9" για ΝΠΔΔ,
"10" για ΝΠΙΔ,
"12" για Κεντρική Διοίκηση,
"13" για Ανεξάρτητη αρχή (με νομική προσωπικότητα)
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT Decimal Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ.
Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array[] String Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε έναν τίτλο (title).
Ο τίτλος (title) πρέπει να είναι το πολύ 100 χαρακτήρες.		 Ναι
approved true/false. Όχι
prevRequestRefNo Ο ΑΔΑΜ (prevRequestRefNo) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενός. Όχι
aaht Το πεδίο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) θα πρέπει να έχει μέχρι 30 χαρακτήρες. Όχι
procurementDeliveryDate Παρακαλώ δώστε την Εκτιμώμενη ημερομηνία χρήσης προμήθειας αγαθού/παροχής υπηρεσίας/εκτέλεσης έργου (procurementDeliveryDate). Ναι
signedDate Παρακαλώ δώστε την ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate).
Η ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate) πρέπει να είναι προγενέστερη ή ίση της σημερινής		 Ναι
protocolNumber Παρακαλώ δώστε έναν αριθμό πρωτοκόλλου (protocolNumber).
Ο αριθμός πρωτοκόλλου (protocolNumber) πρέπει να είναι θετικός αριθμός.
Ο αριθμός πρωτοκόλλου (protocolNumber) πρέπει να είναι το πολύ 30 χαρακτήρες. 		Ναι
organizationVatNumber Παρακαλώ δώστε έναν ΑΦΜ οργανισμού (organizationVatNumber).
Ο ΑΦΜ του οργανισμού (organizationVatNumber) πρέπει να περιέχει αριθμούς.
Ο ΑΦΜ του οργανισμού (organizationVatNumber) πρέπει να είναι το πολύ 30 χαρακτήρες.		 Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ του οργανισμού είναι ελληνικός (greekOrganizationVatNumber). Ναι
nutsCode Παρακαλώ δώστε την Γεωγραφική Περιοχή Αναθέτουσας Αρχής NUTS (nutsCode). Ναι
typeOfContractingAuthority Παρακαλώ δώστε κωδικό είδους αναθέτουσας αρχής (typeOfContractingAuthority).
Το είδος της αναθέτουσας αρχής (typeOfContractingAuthority) πρέπει να είναι θετικός αριθμός.		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε κωδικό ταξινόμησης οργανισμού δημοσίου δικαίου (classificationOfPublicLawOrganization).
Η ταξινόμηση του οργανισμού δημοσίου δικαίου (classificationOfPublicLawOrganization) πρέπει να είναι θετικός αριθμός		 Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβασης (contractType). Ναι
additionalContractTypes Παρακαλώ δώστε τον Πρόσθετο χαρακτήρα σύμβασης (additionalContractTypes). Όχι
contractingData Παρακαλώ δώστε δεδομένα αναθέτουσας αρχής (contractingData). Ναι
contractingData.unitsOperator Παρακαλώ συμπληρώστε τον κωδικό της Οργανικής Μονάδας (unitsOperator).
Ο κωδικός Οργανικής Μονάδας (unitsOperator) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
contractingData.signers Παρακαλώ συμπληρώστε το Αποφαινόμενο όργανο (signers)
Ο κωδικός Αποφαινόμενο όργανο (signers) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
objectDetailsList Παρακαλώ συμπληρώστε τα Στοιχεία αντικειμένου (objectDetailsList). Ναι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα (quantity) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε την Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Η Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 400 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι

Παράδειγμα Κλήσης

POST /khmdhs-api/request
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: multipart/form-data;

 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="file"; filename="document.pdf"
Content-Type: application/pdf

<binary file content>
 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="request"

{
  "title": "ΤΕΣΤ",
  "approved": false,
  "prevRequestRefNo": "",
  "aaht": "5663453",
  "signedDate": "2024-02-05",
  "procurementDeliveryDate": "2024-02-05",
  "protocolNumber": "32323",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "132377396",
  "contractType": "12",
  "additionalContractTypes": ["1"],
  "nutsCode": "FRF",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "typeOfContractingAuthority": "10",
  "classificationOfPublicLawOrganization": "1",
  "objectDetailsList": [
    {
      "quantity": 5,
      "costWithoutVAT": 3232,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "test 1",
      "cpvs": [
        "33131600-3"
      ]
    },
    {
      "quantity": 2,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "20",
      "currency": "EUR",
      "shortDescription": "test 2",
      "cpvs": [
        "33131600-3"
      ]
    },
    {
      "quantity": 1,
      "costWithoutVAT": 860,
      "type": "KGM",
      "vat": "0",
      "currency": "EUR",
      "shortDescription": "test 3",
      "cpvs": [
        "33131600-3"
      ]
    }
  ]
}
 -----------------------------boundary-----------------------------

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης

{
        "referenceNumber": "24REQ009216531"
}
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.
  • Η παράμετρος file πρέπει να περιέχει έγκυρο PDF αρχείο.

Επεξεργασία Πρωτογενών & Εγκεκριμένων Αιτημάτων

Η λειτουργικότητα της επεξεργασίας αιτημάτων αποτελείται από τα εξής μέρη:

  • Επεξεργασία δεδομένων Επεξεργασίας Αιτήματος μέσω REST κλήσης PUT.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PUT /khmdhs-api/request/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την επεξεργασία ενός Αιτήματος.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του Αιτήματος προς επεξεργασία.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

{
  "title": "ΤΕΣΤ",
  "signedDate": "2024-02-05",
  "aaht": "765453",
  "procurementDeliveryDate": "2024-02-05",
  "protocolNumber": "32323",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "132377396",
  "contractType": "12",
  "nutsCode": "FRF",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "typeOfContractingAuthority": "10",
  "classificationOfPublicLawOrganization": "1",
  "objectDetailsList": [
    {
      "quantity": 5,
      "costWithoutVAT": 3232,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "test 1",
      "cpvs": [
        "33131600-3"
      ]
    },
    {
      "quantity": 2,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "20",
      "currency": "EUR",
      "shortDescription": "test 2",
      "cpvs": [
        "33131600-3"
      ]
    },
    {
      "quantity": 1,
      "costWithoutVAT": 860,
      "type": "KGM",
      "vat": "0",
      "currency": "EUR",
      "shortDescription": "test 3",
      "cpvs": [
        "33131600-3"
      ]
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
procurementDeliveryDate string Εκτιμώμενη ημερομηνία χρήσης προμήθειας αγαθού/παροχής υπηρεσίας/εκτέλεσης έργου.
protocolNumber string Αριθμός Πρωτοκόλλου.
greekOrganizationVatNumber boolean Εάν το ΑΦΜ είναι ελληνικό.
organizationVatNumber string ΑΦΜ Φορέα.
contractType String Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes string Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
contractingData Object Δεδομένα αναθέτουσας αρχής.
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε τον κωδικό της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"1" για ΕΚΑΑ ή ΚΑΑ,
"2" για Κεντρική Διοίκηση,
"3" για ΝΠΔΔ,
"4" για ΝΠΙΔ,
"5" για Ανεξάρτητη αρχή
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT Decimal Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ.
Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array[] String Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε έναν τίτλο (title).
Ο τίτλος (title) πρέπει να είναι το πολύ 100 χαρακτήρες.		 Ναι
procurementDeliveryDate Παρακαλώ δώστε την Εκτιμώμενη ημερομηνία χρήσης προμήθειας αγαθού/παροχής υπηρεσίας/εκτέλεσης έργου (procurementDeliveryDate). Ναι
aaht Το πεδίο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) θα πρέπει να έχει μέχρι 30 χαρακτήρες. Όχι
signedDate Παρακαλώ δώστε την ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate).
Η ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate) πρέπει να είναι προγενέστερη ή ίση της σημερινής		 Ναι
protocolNumber Παρακαλώ δώστε έναν αριθμό πρωτοκόλλου (protocolNumber).
Ο αριθμός πρωτοκόλλου (protocolNumber) πρέπει να είναι θετικός αριθμός.
Ο αριθμός πρωτοκόλλου (protocolNumber) πρέπει να είναι το πολύ 30 χαρακτήρες. 		Ναι
organizationVatNumber Παρακαλώ δώστε έναν ΑΦΜ οργανισμού (organizationVatNumber).
Ο ΑΦΜ του οργανισμού (organizationVatNumber) πρέπει να περιέχει αριθμούς.
Ο ΑΦΜ του οργανισμού (organizationVatNumber) πρέπει να είναι το πολύ 30 χαρακτήρες.		 Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ του οργανισμού είναι ελληνικός (greekOrganizationVatNumber). Ναι
nutsCode Παρακαλώ δώστε την Γεωγραφική Περιοχή Αναθέτουσας Αρχής NUTS (nutsCode). Ναι
typeOfContractingAuthority Παρακαλώ δώστε κωδικό είδους αναθέτουσας αρχής (typeOfContractingAuthority).
Το είδος της αναθέτουσας αρχής (typeOfContractingAuthority) πρέπει να είναι θετικός αριθμός.		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε κωδικό ταξινόμησης οργανισμού δημοσίου δικαίου (classificationOfPublicLawOrganization).
Η ταξινόμηση του οργανισμού δημοσίου δικαίου (classificationOfPublicLawOrganization) πρέπει να είναι θετικός αριθμός		 Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβασης (contractType). Ναι
additionalContractTypes Παρακαλώ δώστε τον Πρόσθετο χαρακτήρα σύμβασης (additionalContractTypes). Όχι
contractingData Παρακαλώ δώστε δεδομένα αναθέτουσας αρχής (contractingData). Ναι
contractingData.unitsOperator Παρακαλώ συμπληρώστε τον κωδικό της Οργανικής Μονάδας (unitsOperator).
Ο κωδικός Οργανικής Μονάδας (unitsOperator) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
contractingData.signers Παρακαλώ συμπληρώστε το Αποφαινόμενο όργανο (signers)
Ο κωδικός Αποφαινόμενο όργανο (signers) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
objectDetailsList Παρακαλώ συμπληρώστε τα Στοιχεία αντικειμένου (objectDetailsList). Ναι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα (quantity) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε την Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Η Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 400 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι

Παράδειγμα Κλήσης

                    
    PUT /khmdhs-api/request/{referenceNumber}
    Host: example.com
    Authorization: Basic <base64_credentials>
    Content-Type: application/json

    {
      "title": "ΤΕΣΤ",
      "signedDate": "2024-02-05",
      "aaht": "5663453",
      "procurementDeliveryDate": "2024-02-05",
      "protocolNumber": "32323",
      "greekOrganizationVatNumber": false,
      "organizationVatNumber": "132377396",
      "contractType": "12",
      "nutsCode": "FRF",
      "contractingData": {
          "unitsOperator": "100029237",
          "signers": "100059416"
      },
      "typeOfContractingAuthority": "10",
      "classificationOfPublicLawOrganization": "1",
      "objectDetailsList": [
        {
          "quantity": 5,
          "costWithoutVAT": 3232,
          "type": "KGM",
          "vat": "10",
          "currency": "EUR",
          "shortDescription": "test 1",
          "cpvs": [
            "33131600-3"
          ]
        },
        {
          "quantity": 2,
          "costWithoutVAT": 1000,
          "type": "KGM",
          "vat": "20",
          "currency": "EUR",
          "shortDescription": "test 2",
          "cpvs": [
            "33131600-3"
          ]
        },
        {
          "quantity": 1,
          "costWithoutVAT": 860,
          "type": "KGM",
          "vat": "0",
          "currency": "EUR",
          "shortDescription": "test 3",
          "cpvs": [
            "33131600-3"
          ]
        }
      ]
    }

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
message String Μήνυμα επιβεβαίωσης ακύρωσης.

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 24REQ009216531 ενημερώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ακύρωση Αιτημάτων

Η λειτουργικότητα της ακύρωσης αιτημάτων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Ακύρωσης Αιτήματος μέσω REST κλήσης PATCH.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PATCH /khmdhs-api/request/cancel/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την ακύρωση ενός Αιτήματος.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του Αιτήματος προς ακύρωση.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

                        {
                            "type": "3",
                            "reason": "Test",
                            "cancellationADA": "rt45234"
                        }

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
type string Είδος ακύρωσης. Συμπληρώστε:
"3" για Ακύρωση λόγω λανθασμένης καταχώρησης,
"4" για Ανάκληση
reason string Περιγραφή.
cancellationADA string ΑΔΑ απόφασης Ανάκλησης.

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
type Παρακαλώ δώστε το Είδος ακύρωσης (type). Ναι
reason Παρακαλώ δώστε την Περιγραφή (reason). Ναι
cancellationADA - Όχι

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 24REQ009216531 ακυρώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ανάκτηση Προσκλήσεων-Προκηρύξεων-Διακηρύξεων

Κάθε Πρόσκληση-Προκήρυξη-Διακήρυξη που ανακτάται αποτελείται από τα εξής μέρη:

  • Ένα σύνολο δεδομένων τα οποία περιγράφουν την Πρόσκληση-Προκήρυξη-Διακήρυξη και ανακτώνται με μια REST κλήση POST.
  • Το έγγραφο της Πρόσκλησης-Προκήρυξης-Διακήρυξης σε μορφή PDF το οποίο μπορεί να ανακτηθεί με μια REST κλήση GET και με τον αριθμό ΑΔΑΜ {referenceNumber} της Πρόσκλησης-Προκήρυξης-Διακήρυξης.

POST /khmdhs-opendata/notice?page=0

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση σελιδοποιημένων αποτελεσμάτων Προσκλήσεων-Προκηρύξεων-Διακηρύξεων με βάση το request body της κλήσης.

Παράμετροι Κλήσης

  • page (integer, optional): Ο αριθμός σελίδας που θέλετε να ανακτήσετε, ξεκινώντας από το 0. Εάν δεν έχει καθοριστεί, ορίζεται αυτόματα ως προεπιλογή το 0 .

Request Body Κλήσης

Το request body της κλήσης θα πρέπει να είναι ένα αντικείμενο JSON που περιέχει τα παρακάτω πεδία:

                        
{
    "title": "string",
    "cpvItems": ["string"],
    "organizations": ["string"],
    "signer": "string",
    "contractType": "string",
    "dateFrom": "2024-11-14",
    "dateTo": "2024-11-14",
    "totalCostFrom": 0,
    "totalCostTo": 0,
    "cancelDateFrom": "2024-11-14",
    "cancelDateTo": "2024-11-14",
    "referenceNumber": "string",
    "procedureType": "string",
    "finalDateFrom": "2024-11-14 10:00",
    "finalDateTo": "2024-11-15 10:30",
    "aaht": "string",
    "publicFundingRefNum": "string",
    "isModified": true
}
Παρατηρήσεις

  • Αν δεν οριστεί τιμή στο πεδίο dateTo, ενώ έχει οριστεί dateFrom, τότε το σύστημα αυτομάτως θα εισάγει ως τιμή την dateFrom συν 180 μέρες.
  • Αν δεν έχει οριστεί τιμή στο πεδίο dateFrom ενώ έχει οριστεί dateTo, τότε το σύστημα αυτομάτως θα εισάγει την ημερομηνία του dateTo μείον 180 μέρες.
  • Αν δεν έχει οριστεί ούτε dateFrom ούτε dateTo, τότε το σύστημα θα εισάγει ως dateTo την τρέχουσα ημερομηνία και dateFrom την τρέχουσα ημερομηνία μείον 180 μέρες.
  • Αν έχει οριστεί dateFrom και dateTo, αλλά έχουν διαφορά μεγαλύτερη των 180 ημερών, τότε το σύστημα θα εισάγει dateFrom την dateTo μείον 180 μέρες.
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί ούτε cancelDateFrom ούτε cancelDateTo τότε δεν θα υπολογίζεται η Ημερομηνία Ματαίωσης κατά την αναζήτηση. Σε περίπτωση που έχει οριστεί μόνο cancelDateFrom ή μόνο cancelDateΤο η και οι 2 τότε θα ισχύει ο κανόνας τον 180 ημερών όπως περιγράφεται για τα πεδία dateFrom και dateTo.
  • Αν στα κριτήρια αναζήτησης η Καταληκτική Η/νία Υποβολής Προσφορών δεν έχει οριστεί ούτε finalDateFrom ούτε finalDateTo, τότε δεν θα υπολογίζεται στην αναζήτηση η Καταληκτική Η/νία. Σε περίπτωση που έχει οριστεί μόνο finalDateFrom ή μόνο finalDateTo η και οι 2 τότε θα ισχύει ο κανόνας τον 180 ημερών όπως περιγράφεται για τα πεδία dateFrom και dateTo
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί το εύρος των cancelDateFrom και cancelDateΤο το σύστημα επιστρέφει και τις Ματαιώσεις με βάση τα υπόλοιπα καθορισμένα κριτήρια αναζήτησης. Αν καθοριστούν τα cancelDateFrom και cancelDateΤο τότε το σύστημα επιστρέφει μόνο πράξεις που έχουν ματαιωθεί.
  • Αν στα κριτήρια αναζήτησης το πεδίο isModified είναι false το σύστημα επιστρέφει όλες τις πράξεις ανεξάρτητα από το αν αφορά τροποποίηση ή όχι. Στην περίπτωση που το πεδίο isModified είναι true τότε επιστρέφει μόνο τροποποιήσεις.


Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
cpvItems Array[string] Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
πχ. "34327200-7" για Άξονες και κιβώτια,
"34711500-9" για Ελικόπτερα
organization Array[string] Αναθέτουσα Αρχή/Αναθέτων Φορέας.
Συμπληρώστε τον κωδικό του Φορέα.
πχ. "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ,
"72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
signer string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
πχ. "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής
referenceNumber string Μοναδικός Κωδικός - ΑΔΑΜ.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
dateFrom string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Από (YYYY-MM-DD).
dateTo string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Έως (YYYY-MM-DD).
totalCostFrom integer Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ Από.
totalCostTo integer Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ Έως.
cancelDateFrom string Ματαιώσεις Από (YYYY-MM-DD).
cancelDateTo string Ματαιώσεις Έως (YYYY-MM-DD).
procedureType string Διαδικασία ανάθεσης.
finalDateFrom string Καταληκτική Η/νία Υποβολής Προσφορών Από.
finalDateTo string Καταληκτική Η/νία Υποβολής Προσφορών Έως.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
publicFundingRefNum string Ενάριθμος ΠΔΕ.
isModified boolean Τροποποιήσεις (true/false).

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Το πεδίο Τίτλος (title) θα πρέπει να έχει μέχρι 100 χαρακτήρες. Όχι
cpvItems Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενός. Όχι
referenceNumber Το πεδίο ΑΔΑΜ (referenceNumber) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενό. Όχι
organization Το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
signer Το πεδίο Αποφαινόμενο όργανο (signer) θα πρέπει να είναι ένας θετικός αριθμός ή κενό.
Εάν το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) έχει περισσότερες απο μια τιμή, το Αποφαινόμενο όργανο (signer) πρέπει να είναι κενό.		 Όχι
contractType Το πεδίο Κύριος χαρακτήρας σύμβασης (contractType) θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
dateFrom / dateTo Η Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
totalCostFrom / totalCostTo Τα πεδία Συνολική αξία χωρίς ΦΠΑ (totalCostFrom) και (totalCostTo) θα πρέπει να είναι ίσα ή μεγαλύτερα από 0. Όχι
cancelDateFrom / cancelDateTo Η Ημερομηνία Ματαίωσης θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
procedureType Το πεδίο Διαδικασία ανάθεσης πρέπει να είναι θετικός αριθμός ή κενό. Όχι
finalDateFrom / finalDateTo Η Καταληκτική Η/νία Υποβολής Προσφορών θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
aaht Το πεδίο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) θα πρέπει να έχει μέχρι 30 χαρακτήρες. Όχι
publicFundingRefNum Το πεδίο Ενάριθμος ΠΔΕ (publicFundingRefNum) θα πρέπει να έχει μέχρι 30 χαρακτήρες. Όχι

Παράδειγμα απάντησης σε περίπτωση λανθασμένης τιμής στα πεδία referenceNumber και cpvItems κατά την κλήση:

{
         "errors": {
		"referenceNumber": "Το πεδίο ΑΔΑΜ (referenceNumber) θα πρέπει να έχει σωστή μορφή (##PROC#########) ή να είναι κενό.",
                "cpvItems": "Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενός."
	}
}

Παράδειγμα κλήσης

POST /khmdhs-opendata/notice?page=0
Content-Type: application/json

{
    "title": "Νέα Πρόσκληση",
    "cpvItems": ["79822500-7", "34711500-9"],
    "organizations": ["51634"],
    "signer": "113314",
    "referenceNumber": "25PROC009217262",
    "contractType": "10",
    "dateFrom": "2024-09-01",
    "dateTo": "2024-11-10",
    "totalCostFrom": "1000",
    "totalCostTo": "5000",
    "cancelDateFrom": "",
    "cancelDateTo": "2024-11-10",
    "procedureType": "1",
    "finalDateFrom": "2025-01-22 09:27",
    "finalDateTo": "2025-01-22 12:30",
    "aaht": "test",
    "publicFundingRefNum": "348384723",
    "isModified": false,
}

Παράδειγμα απάντησης


{
	"content": [
		{
			"title": "GRANDFA",
			"referenceNumber": "25PROC009217262",
			"signedDate": null,
			"publishedDate": null,
			"finalSubmissionDate": "2024-09-10T00:00:00",
			"submissionDate": "2025-01-21T11:21:09.222823",
			"lastUpdateDate": null,
			"cancelled": false,
			"cancellationDate": null,
			"cancellationType": null,
			"cancellationReason": null,
			"cancellationADA": null,
			"amendPreviousNotice": true,
			"amendedNoticeADAM": "24PROC009216112",
			"frameworkAgreementNoticeADAM": null,
			"protocolNumber": null,
			"authorEmail": null,
			"aaht": "4523424",
            "biddingWebsite": "https://nepps.eprocurement.gov.gr/",
			"organizationVatNumber": null,
			"greekOrganizationVatNumber": null,
			"budget": 234,
			"commitmentNo": null,
			"relatedNoticeADAM": null,
			"numberOfSections": 3,
			"nutsCode": {
				"key": "100015981",
				"value": "Ain"
			},
			"nutsCity": null,
			"nutsPostalCode": null,
			"nutsCountry": null,
			"assignedContract": {
				"key": "2",
				"value": "Όχι"
			},
			"socialContract": {
				"key": "2",
				"value": "Όχι"
			},
			"centralGovernmentAuthority": {
				"key": "1",
				"value": "Ναι"
			},
			"contractingData": {
				"unitsOperator": {
					"key": "100047200",
					"value": "ΑΝΑΠΤΥΞΙΑΚΗ ΗΠΕΙΡΟΥ ΑΕ ΟΤΑ"
				},
				"signers": {
					"key": "100010086",
					"value": "ΑΘΑΝΑΣΙΑ ΣΤΟΥΡΝΑΡΑ - Προϊστάμενος Τμήματος"
				}
			},
			"fundingDetails": {
				"publicFundingRef": null,
				"publicFundingRefNum": null,
				"publicFundingRefOps": "123",
				"cofundProgramRef": "354345",
				"selfFundProgramRef": null,
				"espaFundProgramRef": null,
				"regularBudgetFundedProgramRef": null
			},
			"systemicNumbers": [
				{
					"systemicNumber": "140149"
				}
			],
			"approvedRequests": [],
			"contractingAuthorities": [
				{
					"contractingAuthority": {
						"key": "1",
						"value": "ΕΚΑΑ ή ΚΑΑ"
					}
				}
			],
			"nutsCodes": [
				{
					"nutsCode": {
						"key": "FRK",
						"value": "AUVERGNE-RHÔNE-ALPES"
					}
				}
			],
			"organization": {
				"key": "100015981",
				"value": "ΥΠΟΥΡΓΕΙΟ ΑΓΡΟΤΙΚΗΣ ΑΝΑΠΤΥΞΗΣ ΚΑΙ ΤΡΟΦΙΜΩΝ"
			},
			"typeOfProcedure": {
				"key": "5",
				"value": "Διαδικασία άρθρου 128 του ν.4412/16"
			},
			"contractType": {
				"key": "12",
				"value": "Μελέτες"
			},
			"awardProcedure": null,
			"centralizedMarkets": [
				{
					"centralizedMarket": {
						"key": "1",
						"value": "Συμφωνία-πλαίσιο"
					}
				}
			],
			"legalContext": {
				"key": "5",
				"value": "Βιβλίο Ι – κάτω των ορίων"
			},
			"conductingProceedings": {
				"key": "1",
				"value": "Ηλεκτρονική Διαδικασία"
			},
			"digitalPlatform": {
				"key": "3",
				"value": "ΕΣΗΔΗΣ Π&Υ"
			},
			"criteriaCode": {
				"key": "3",
				"value": "Βάσει κόστους – κοστολόγηση κύκλου ζωής"
			},
			"classificationOfPublicLawOrganization": {
				"key": "1",
				"value": "Κεντρική Κυβέρνηση"
			},
			"noticeType": {
				"key": "2",
				"value": "Προκήρυξη"
			},
			"contractingAuthorityActivity": null,
			"contractDuration": "2",
            "contractDurationUnitOfMeasure": {
                "key": "2",
                "value": "Εβδομάδες"
            },
			"totalCostWithVAT": 3934.12,
			"totalCostWithoutVAT": 3334.00,
			"objectDetails": [
				{
					"quantity": 3,
					"type": {
						"key": "mL",
						"value": "mL"
					},
					"costWithoutVAT": 3334,
					"vat": "18",
					"currency": {
						"key": "EUR",
						"value": "Ευρώ"
					},
					"shortDescription": "45yt5",
					"cpvs": [
						{
							"key": "33131600-3",
							"value": "Όργανο σφραγίσματος δοντιών"
						}
					],
					"greenContracts": {
						"key": "3",
						"value": "Εμπίπτει  στο ΕΣΔ  - Δεν  έχουν υιοθετηθεί  τα ΠΚ"
					},
					"goodServices": {
						"key": "110",
						"value": "Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς)"
					},
					"budgetCode": null
				}
			],
            "additionalContractTypes": [
                {
                  "additionalContractType": {
                    "key": "1",
                    "value": "Έργα"
                  }
                }
            ],
			"mixedContract": true,
			"offersValidTime": 3,
            "offersValidTimeUnitOfMeasure": {
                "key": "4",
                "value": "Έτη"
            },
			"maxNumberOfContractors": null,
			"optionRight": {
				"key": "1",
				"value": "Ναι"
			},
			"optionRightDescription": "test",
			"abortReason": {
				"key": "AQ",
				"value": null
			},
			"auctionRefNo": [
			    "25AWRD009223038",
			    "25AWRD009222920"
			],
			"amendsNoticeRefNo": [
			    "25PROC009223037"
			]
		}
	],
	"pageable": {
		"pageNumber": 0,
		"pageSize": 50,
		"sort": {
			"sorted": false,
			"unsorted": true,
			"empty": true
		},
		"offset": 0,
		"unpaged": false,
		"paged": true
	},
	"last": true,
	"totalPages": 1,
	"totalElements": 1,
	"numberOfElements": 1,
	"first": true,
	"size": 50,
	"number": 0,
	"sort": {
		"sorted": false,
		"unsorted": true,
		"empty": true
	},
	"empty": false
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
content Array Λίστα αντικειμένων.
content[].title String Τίτλος.
content[].referenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ.
content[].signedDate Date Ημερομηνία Πρωτοκόλλου (έκδοσης).
content[].publishedDate Date Ημερομηνία αποστολής στην Ευρωπαϊκή Ένωση.
content[].finalSubmissionDate DateTime Καταληκτική Ημερομηνία Υποβολής Προσφορών.
content[].submissionDate DateTime Ημερομηνία υποβολής.
content[].lastUpdateDate DateTime Τελευταία ημερομηνία ανανέωσης.
content[].cancelled Boolean Υποδεικνύει εάν το αίτημα ακυρώθηκε.
content[].cancellationDate DateTime Ημερομηνία ματαίωσης.
content[].cancellationReason String Λόγος Ματαίωσης.
content[].cancellationADA String ΑΔΑ απόφασης Ακύρωσης/Ματαίωσης.
content[].amendPreviousNotice Boolean Υποδεικνύει αν τροποποιείται προηγούμενη πρόσκληση.
content[].amendedNoticeADAM String ΑΔΑΜ της τροποποιούμενης πρόσκλησης.
content[].frameworkAgreementNoticeADAM String Διακήρυξη συμφωνίας πλαίσιο (ΑΔΑΜ)
content[].protocolNumber String Αριθμός πρωτοκόλλου.
content[].authorEmail String Email συντάκτη.
content[].aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
content[].organizationVatNumber String ΑΦΜ Φορέα.
content[].budget Decimal Συνολική εκτιμώμενη αξία σύμβασης.
content[].commitmentNo String Αριθμός Ανάληψης Υποχρέωσης.
content[].relatedNoticeADAM String ΑΔΑΜ της προηγούμενης ανάρτησης
content[].numberOfSections Long Αριθμός τμημάτων.
content[].nutsCode String Περιγραφή γεωγραφικής περιοχής (NUTS).
content[].assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα.
content[].socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες.
content[].centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή.
content[].contractingData Object Στοιχεία συμβαλλομένων φορέων.
content[].contractingData.unitsOperator String Οργανική Μονάδα.
content[].contractingData.signers.value String Αποφαινόμενο όργανο.
content[].fundingDetails.publicFundingRef String Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
content[].fundingDetails.publicFundingRefNum String Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
content[].fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
content[].fundingDetails.cofundProgramRef String Συγχρηματοδοτούμενο Πρόγραμμα - Δηλώστε το σχετικό Κωδικό ΟΠΣ.
content[].fundingDetails.selfFundProgramRef String Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
content[].fundingDetails.espaFundProgramRef String Πρόγραμμα Χρηματοδοτούμενο Από το ΕΣΠΑ - Δηλώστε το σχετικό Κωδικό ΕΣΠΑ.
content[].fundingDetails.regularBudgetFundedProgramRef String Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
content[].systemicNumbers[].systemicNumber String Αριθμός ηλεκτρονικού διαγωνισμού ή
Αριθμός/ID ηλεκτρονικής διαγωνιστικής διαδικασίας.
content[].approvedRequests Array Λίστα εγκεκριμένων αιτημάτων.
content[].contractingAuthorities[].contractingAuthority.value String Είδος Αναθέτουσας Αρχής.
content[].nutsCodes[].nutsCode String Περιγραφή γεωγραφικής περιοχής (NUTS).
content[].nutsCity String Πόλη.
content[].nutsPostalCode String Ταχυδρομικός Κώδικας.
content[].nutsCountry String Χώρα Αναθέτουσας Αρχής.
content[].organization String Περιγραφή φορέα.
content[].typeOfProcedure String Διαδικασία Ανάθεσης.
content[].contractType String Κύριος χαρακτήρας σύμβασης.
content[].awardProcedure String Αιτιολόγηση διαδικασίας ανάθεσης.
content[].centralizedMarkets[] Array Χρήση Τεχνικών – Εργαλείων ανάθεσης.
content[].centralizedMarkets[].centralizedMarket String Χρήση Τεχνικών – Εργαλείων ανάθεσης.
content[].maxNumberOfContractors String Μέγιστος αριθμός αναδόχων σε συμφωνία – πλαίσιο.
content[].legalContext String Περιγραφή Νομικό πλαίσιο.
content[].conductingProceedings String Τρόπος Διεξαγωγής Διαδικασίας.
content[].digitalPlatform String Ψηφιακή πλατφόρμα.
content[].biddingWebsite String Ιστότοπος υποβολής προσφορών.
content[].criteriaCode String Κριτήριο ανάθεσης.
content[].classificationOfPublicLawOrganization String Ταξινόμηση Οργανισμού Δημοσίου Δικαίου.
content[].noticeType String Τύπος δημοσίευσης.
content[].mixedContract Boolean Μικτή σύμβαση.
content[].additionalContractTypes String Πρόσθετος χαρακτήρας σύμβασης.
contractDuration string Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης
content[].offersValidTime String Χρόνος Ισχύος Προσφορών.
offersValidTimeUnitOfMeasure string Μονάδα μέτρησης χρόνου ισχύος προσφορών
content[].optionRight String Δικαίωμα προαίρεσης.
content[].optionRightDescription String Περιγραφή δικαιώματος προαίρεσης.
content[].abortReason String Λόγος Ματαίωσης.
content[].totalCostWithVAT Decimal Συνολικό κόστος με ΦΠΑ.
content[].totalCostWithoutVAT Decimal Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ.
content[].objectDetails Array Λίστα στοιχείων Αντικειμένου.
content[].objectDetails[].quantity Integer Η ποσότητα του αντικειμένου.
content[].objectDetails[].costWithoutVAT Decimal Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
content[].objectDetails[].type String Μονάδα μέτρησης.
content[].objectDetails[].vat String Συντελεστής ΦΠΑ.
content[].objectDetails[].currency String Νόμισμα.
content[].objectDetails[].shortDescription String Περιληπτική περιγραφή αντικειμένου.
content[].objectDetails[].cpvs[] String Περιγραφή με όρους CPVS.
content[].objectDetails[].greenContracts String Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
content[].objectDetails[].goodServices String Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ.
content[].auctionRefNo Array Λίστα ΑΔΑΜ αναθέσεων που συνδέονται με την προκήρυξη.
content[].amendsNoticeRefNo Array Λίστα ΑΔΑΜ προκηρύξεων που έχουν τροποποιήσει την προκήρυξη.
pageable Object Πληροφορίες Σελιδοποίησης της απάντησης.
last Boolean Υποδεικνύει εάν είναι η τελευταία σελίδα της απάντησης.
totalPages Integer Ο Συνολικός αριθμός τως Σελίδων.
totalElements Integer Ο Συνολικός αριθμός των αποτελεσμάτων με βάση τα κρητήρια αναζήτησης.
first Boolean Υποδεικνύει εάν είναι η πρώτη Σελίδα αποτελεσμάτων.
numberOfElements Integer Ο αριθμός των αποτελεσμάτων για την τρέχουσα σελίδα.
size Integer Ο προκαθορισμένος αριθμός αποτελεσμάτων ανα σελίδα.
number Integer Ο τρέχον αριθμός σελίδας.
sort Object Πληροφορίες ταξινόμησης που εφαρμόστηκε.
empty Boolean True μόνο εάν δεν υπάρχουν αποτελέσματα. False αν υπαρχουν αποτελέσματα.

Ανάκτηση αρχείου Προσκλήσης-Προκηρύξης-Διακηρύξης

GET /khmdhs-opendata/notice/attachment/{referenceNumber}

Περιγραφή

Ανακτά ένα έγγραφο PDF που αφορά μια συγκεκριμένη Προσκλήση-Προκηρύξη-Διακηρύξη, που προσδιορίζεται από τον κωδικό ΑΔΑΜ {referenceNumber}.

Παράμετρος

  • referenceNumber (string): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του συνημμένου αρχείου Προσκλήσης-Προκηρύξης-Διακηρύξης.

Παράδειγμα Κλήσης

GET [API_BASE_URL]/khmdhs-opendata/notice/attachment/24PROC009215982

Απάντηση

Επιστρέφει ένα PDF αρχείο:

  • Content-Type: application/pdf
  • Body: Δυαδικό περιεχόμενο byte[] του αρχείου PDF.

Παράδειγμα cURL Εντολής

curl -o attachment.pdf [API_BASE_URL]/khmdhs-opendata/notice/attachment/24PROC009215982

Καταχώρηση Προσκλήσεων-Προκηρύξεων-Διακηρύξεων

Η λειτουργικότητα της υποβολής Προσκλήσεων-Προκηρύξεων-Διακηρύξεων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Πρόσκλησης-Προκήρυξης-Διακήρυξης μέσω REST κλήσης POST, με επισύναψη PDF αρχείου.
  • Προστασία μέσω Basic Authentication για διασφάλιση πρόσβασης μόνο σε εξουσιοδοτημένους χρήστες.

POST /khmdhs-api/notice

Περιγραφή

Η κλήση επιτρέπει την καταχώρηση μιας Πρόσκλησης-Προκήρυξης-Διακήρυξης και τη μεταφόρτωση σχετικού αρχείου PDF.

Παράμετροι Κλήσης

  • file (MultipartFile, required): Το PDF αρχείο που συνοδεύει την Πρόσκληση-Προκήρυξη-Διακήρυξη. Το αρχείο πρέπει να είναι έγκυρο και σε μορφή PDF.
  • request (String, required): Ένα αντικείμενο JSON που περιέχει τα δεδομένα της Πρόσκλησης-Προκήρυξης-Διακήρυξης.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:


 {
  "title": "hgyrt",
  "requestItems": [],
  "signedDate": "2024-01-01",
  "publishedDate": null,
  "finalSubmissionDate": "2024-09-10 10:10",
  "amendPreviousNotice": true,
  "amendedNoticeADAM": "26PROC009215622",
  "aaht": "45234assigned24",
  "biddingWebsite": "",
  "numberOfSections": 2,
  "nutsCode": "FRK21",
  "nutsCity": "Athens",
  "nutsPostalCode": "153645",
  "nutsCountry": "AS",
  "offersValidTime": "2",
"offersValidTimeUnitOfMeasure":"1",
  "socialContract": "1",
  "assignedContract": "1",
  "centralGovernmentAuthority": "1",
  "optionRightDescription": "test",
  "procedureType": "1",
  "contractType": "12",
  "additionalContractTypes": ["2"],
  "awardProcedure": null,
  "centralizedMarkets": ["1"],
  "maxNumberOfContractors": "2",
  "legalContext": "5",
  "conductingProceedings": "2",
  "digitalPlatform": "",
  "criteriaCode": "3",
  "classificationOfPublicLawOrganization": "1",
  "contractingAuthority": "9",
  "noticeType": "2",
  "contractDuration": 2,
"contractDurationUnitOfMeasure": "1",
  "contractingAuthorityActivity": "8",
  "contractingData": {
    "unitsOperator": "90593",
    "signers": "128986"
  },
  "fundingDetails": {
    "publicFundingRef": 213131,
    "publicFundingRefNum": 3131,
    "publicFundingRefOps": "1213213",
    "selfFundProgramRef": null,
    "regularBudgetFundedProgramRef": null
  },
  "nutsCodes": ["FR"],
  "objectDetailsList": [
    {
      "quantity": 3,
      "costWithoutVAT": 3334,
      "type": "mL",
      "vat": "18",
      "currency": "EUR",
      "shortDescription": "45yt5",
      "cpvs": [
        "33131600-3"
      ],
      "greenContracts": "3",
      "goodServices": "110"
    },
    {
      "quantity": 6,
      "costWithoutVAT": 11255,
      "type": "mL",
      "vat": "18",
      "currency": "EUR",
      "shortDescription": "jfvievejr",
      "cpvs": [
        "33131600-3"
      ],
      "greenContracts": "3",
      "goodServices": "110"
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
requestItems[] Array ΑΔΑΜ Eγκεκριμένων Αιτημάτων που σχετίζονται με την Πρόσκληση-Προκήρυξη-Διακήρυξη.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
publishedDate string Ημερομηνία αποστολής στην Ευρωπαϊκή Ένωση.
finalSubmissionDate string Καταληκτική Ημερομηνία Υποβολής Προσφορών.
amendPreviousNotice Boolean Εάν τροποποιείται προηγούμενη ειδοποίηση.
amendedNoticeADAM string ΑΔΑΜ τροποποιημένης πράξης.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
biddingWebsite string Ιστότοπος υποβολής προσφορών.
numberOfSections BigDecimal Αριθμός τμημάτων.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
nutsCity string Πόλη.
nutsPostalCode string Ταχυδρομικός Κώδικας.
nutsCountry string Χώρα Αναθέτουσας Αρχής.
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
offersValidTime Long Χρόνος Ισχύος Προσφορών.
offersValidTimeUnitOfMeasure string Μονάδα μέτρησης χρόνου ισχύος προσφορών:
"1" Ημέρες,
"2" Εβδομάδες,
"3" Μήνες,
"4" Έτη
assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
optionRightDescription Boolean Περιγραφή δικαιώματος προαίρεσης.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"2" για Κλειστή διαδικασία,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"11" για Σύμπραξη καινοτομίας,
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"18" για Διαδικασία άρθρου 128 του ν.4412/16
awardProcedure string Αιτιολόγηση διαδικασίας ανάθεσης. Συμπληρώστε:
Για Διαδικασία ανάθεσης "2" ή "3":
"51" για Οι ανάγκες δεν μπορούν να ικανοποιηθούν χωρίς προσαρμογή των άμεσα διαθέσιμων λύσεων,
"52" για Το αντικείμενο της σύμβασης περιλαμβάνει σχεδιασμό ή καινοτόμες λύσεις,
"53" για Συντρέχουν ειδικές περιστάσεις σχετικά με το αντικείμενο της σύμβασης,
"54" για Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια,
"55" για Άγονη διαδικασία ανάθεσης σύμβασης,

Για Διαδικασία ανάθεσης "7":
"56" για Άγονη διαδικασία ανάθεσης σύμβασης,
"57" για Μοναδικό έργο τέχνης ή καλλιτεχνική εκδήλωση,
"58" για Απουσία ανταγωνισμού για τεχνικούς λόγους,
"59" για Προστασία αποκλειστικών δικαιωμάτων,
"60" για Κατεπείγουσα ανάγκη οφειλόμενη σε γεγονότα απρόβλεπτα για την αναθέτουσα αρχή
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"3" για Ηλεκτρονικός Κατάλογος,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"8" για Δεν χρησιμοποιείται
maxNumberOfContractors Long Μέγιστος αριθμός αναδόχων σε συμφωνία – πλαίσιο.
legalContext string Νομικό πλαίσιο. Συμπληρώστε:
"4" για ν.4412/2016 - Βιβλίο Ι - άνω των ορίων,
"5" για ν.4412/2016 - Βιβλίο Ι - κάτω των ορίων,
"6" για ν.4412/2016 - Βιβλίο ΙΙ - άνω των ορίων,
"7" για ν.4412/2016 - Βιβλίο ΙΙ - κάτω των ορίων,
"10" ν.4413/2016 - Παραχωρήσεις
conductingProceedings string Τρόπος Διεξαγωγής Διαδικασίας. Συμπληρώστε:
"1" για Ηλεκτρονική Διαδικασία
"2" για Μη ηλεκτρονική διαδικασία
digitalPlatform string Ψηφιακή πλατφόρμα.Συμπληρώστε:
"3" για ΕΣΗΔΗΣ Π&Υ
"4" για ΕΣΗΔΗΣ ΔΕ
"5" για CosmoOne
"6" για iSupplies
"7" για Άλλη
criteriaCode string Κριτήριο ανάθεσης.
"1" για Βάσει κόστους - βέλτιστη σχέση ποιότητας τιμής
"2" για Βάσει τιμής "3" για Βάσει κόστους - κοστολόγηση κύκλου ζωής "4" για Βάσει τιμής - άλλο
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
contractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"8" για ΕΚΑΑ ή ΚΑΑ,
"9" για ΝΠΔΔ,
"10" για ΝΠΙΔ,
"12" για Κεντρική Διοίκηση,
"13" για Ανεξάρτητη αρχή (με νομική προσωπικότητα)
noticeType string Τύπος δημοσίευσης. Συμπληρώστε:
"2" για Προκήρυξη,
"3" για Διακήρυξη,
"4" για Πρόσκληση
contractDuration BigDecimal Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης:
"1" Ημέρες,
"2" Εβδομάδες,
"3" Μήνες,
"4" Έτη
contractingAuthorityActivity string Δραστηριότητα αναθέτουσας αρχής. Συμπληρώστε:
"1" για Γενικές δημόσιες υπηρεσίες,
"2" για Άμυνα,
"3" για Δημόσια τάξη και ασφάλεια,
"4" για Περιβάλλον,
"5" για Οικονομικές και δημοσιονομικές υποθέσεις,
"6" για Υγεία,
"7" για Στέγαση και υποδομές κοινής ωφέλειας,
"8" για Κοινωνική προστασία,
"9" για Αναψυχή,
"10" για Πολιτισμός και θρησκεία,
"11" για Εκπαίδευση,
"12" για Τυχόν άλλη δραστηριότητα,
"13" Αναζήτηση ή εξόρυξη άνθρακα και άλλων στερεών καυσίμων,
"14" Δραστηριότητες που αφορούν την ηλεκτροδότηση,
"15" Δραστηριότητες που αφορούν την ύδρευση,

"16" Δραστηριότητες που αφορούν τους αερολιμένες,
"17" Δραστηριότητες που αφορούν τους λιμένες,
"18" Εξόρυξη φυσικού αερίου ή πετρελαίου,
"19" Μεταφορές με αστικό σιδηρόδρομο, τραμ, τρόλεϊ ή λεωφορείο,
"20" Παραγωγή, μεταφορά ή διανομή αερίου ή θερμότητας,
"21" Σιδηροδρομικές υπηρεσίες,
"22" Ταχυδρομικές υπηρεσίες
contractingData Object Δεδομένα αναθέτουσας αρχής.
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε τον κωδικό της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
fundingDetails Object Πηγή χρηματοδότησης.
fundingDetails.publicFundingRef string Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
fundingDetails.publicFundingRefNum string Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
fundingDetails.selfFundProgramRef string Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
fundingDetails.regularBudgetFundedProgramRef string Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
systemicNumbers Array Αριθμός ηλεκτρονικού διαγωνισμού (όταν ο Τρόπος Διεξαγωγής Διαδικασίας είναι Μη Ηλεκτρονική Διαδικασία)
Αριθμός/ID ηλεκτρονικής διαγωνιστικής διαδικασίας (όταν ο Τρόπος Διεξαγωγής Διαδικασίας είναι Ηλεκτρονική Διαδικασία).
nutsCodes Array Γεωγραφική περιοχή του τόπου εκτέλεσης σύμβασης. Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική εκτιμώμενη αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.greenContracts string Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
Συμπληρώστε:
"1" για Δεν εμπίπτει στο ΕΣΔ
"2" για Εμπίπτει στο ΕΣΔ - Δεν έχουν υιοθετηθεί τα ΠΚ
"3" για Εμπίπτει στο ΕΣΔ - Έχουν υιοθετηθεί τα ΠΚ
objectDetailsList.goodServices string Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ. Συμπληρώστε:
"101" για Χαρτί́ από́ ανακτημένες ίνες,
"102" για Χαρτί από παρθένες ίνες αειφόρου συγκομιδής,
"103" για Ηλεκτρονικοί υπολογιστές,
"104" για Οθόνες,
"105" για "Εξοπλισμός απεικόνισης (εκτυπωτές, σαρωτές, πολυμηχανήματα φωτοαντιγραφής, εκτύπωσης και σάρωσης)",
"106" για Εσωτερικός φωτισμός - Λαμπτήρες LED,
"107" για Κλιματιστικά́ μηχανήματα,
"108" για Λιπαντικά́ Αναγεννημένα,
"109" για Λιπαντικά Βιοαποικοδομήσιμα,
"110" για Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς),
"111" για Οδοφωτισμός και σηματοδότες κυκλοφορίας (αφορά́ οδούς αρμοδιότητας Δήμων και Περιφερειών),
"112" για Έπιπλα,
"113" για Προϊόντα κλωστοϋφαντουργίας,
"114" για "Προϊόντα και υπηρεσίες συντήρησης εξωτερικών δημόσιων χώρων (Καθαρισμός, κηπουρική́)",
"115" για Υποδομές διαχείρισης λυμάτων,
"116" για Ηλεκτρικός και ηλεκτρονικός εξοπλισμός χρησιμοποιούμενος στον τομέα της υγειονομικής περίθαλψης (Υγειονομικός ΗΗΕ),
"117" για "Σχεδιασμός οδοποιίας, κατασκευή́ και συντήρηση",
"118" για "Σχεδιασμός κτιρίων γραφείων, κατασκευή́ και διαχείριση"


Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε τον Τίτλο (title).
Ο Τίτλος (title) θα πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
requestItems Τα Αιτήματα θα πρέπει να υπάρχουν και να είναι εγκεκριμένα.
Τα Εγκεκριμένα Αιτήματα θα πρέπει να μην έχουν ακυρωθεί
Όχι
publishedDate - Όχι
finalSubmissionDate Παρακαλώ δώστε την Καταληκτική Ημερομηνία και Ώρα Υποβολής (final submission date) Ναι
amendPreviousNotice Παρακαλώ δηλώστε αν τροποποιεί Προηγούμενη Πρόσκληση-Προκήρυξη-Διακήρυξη (amendPreviousNotice) Ναι
amendedNoticeADAM Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##PROC#########) ή να είναι κενός. Όχι
aaht Παρακαλώ δώστε τον Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht)
Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
numberOfSections Παρακαλώ δώστε τον Αριθμό Τμημάτων (numberOfSections)
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να είναι θετικός αριθμός
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να έχει έως 30 ψηφία συνολικά		 Ναι
nutsCode Παρακαλώ δώστε τον Κωδικό NUTS (nuts code) Ναι
nutsCity Παρακαλώ δώστε την πόλη Αναθέτουσας Αρχής (nutsCity) Ναι
nutsPostalCode Παρακαλώ δώστε τον ΤΚ Αναθέτουσας Αρχής (nutsPostalCOde) Ναι
nutsCountry Παρακαλώ δώστε την Χώρα Αναθέτουσας Αρχής (nutsCountry) Ναι
offersValidTime Παρακαλώ δώστε Χρόνος Ισχύος Προσφορών (offers validity time)
Ο Χρόνος Ισχύος Προσφορών (offers validity time) πρέπει να είναι μη αρνητικός αριθμός		 Ναι
offersValidTimeUnitOfMeasure Παρακαλώ δώστε την Μονάδα Μέτρησης του Χρόνου Ισχύος Προσφορών (offersValidTimeUnitOfMeasure)
Η Μονάδα Μέτρησης του Χρόνου Ισχύος Προσφορών (offersValidTimeUnitOfMeasure) πρέπει να είναι θετικός αριθμός		 Ναι
assignedContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract).
Η Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assigned contract) πρέπει να είναι θετικός αριθμός		 Ναι
socialContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract).
Η Σύμβαση για κοινωνικές και άλλες υπηρεσίες (social contract) πρέπει να είναι θετικός αριθμός		 Ναι
centralGovernmentAuthority Παρακαλώ δηλώστε αν πρόκειται για Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority).
Η Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
contractingData Παρακαλώ δώστε Δεδομένα Αναθέτουσας Αρχής (contracting data) Ναι
optionRightDescription - Όχι
procedureType Παρακαλώ δώστε την Διαδικασία ανάθεσης (procedure type)
Η Διαδικασία ανάθεσης (procedure type) πρέπει να είναι θετικός αριθμός		 Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβαση (contract type)
Ο Κύριος χαρακτήρας σύμβασης (contract type) πρέπει να είναι θετικός αριθμός		 Ναι
awardProcedure Η Αιτιολόγηση διαδικασίας ανάθεσης (award procedure) πρέπει να είναι θετικός αριθμός Ναι
centralizedMarkets Παρακαλώ δώστε τον Κωδικό Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralized market) Ναι
maxNumberOfContractors - Όχι
legalContext Παρακαλώ δώστε τον Κωδικό Νομικού Πλαισίου (legal context)
Το Νομικό Πλαίσιο (legal context) πρέπει να είναι θετικός αριθμός		 Ναι
conductingProceedings Παρακαλώ δώστε τον Τρόπο Διεξαγωγής Διαδικασίας (conducting proceedings) Ναι
digitalPlatform Η Ψηφιακή Πλατφόρμα (digital platform) πρέπει να είναι θετικός αριθμός Όχι
biddingWebsite Ο Ιστότοπος Υποβολής Προσφορών (bidding website) πρέπει να είναι έγκυρο URL. Όχι
criteriaCode Παρακαλώ δώστε τον Κωδικό για το Κριτήριο ανάθεσης (criteria code).
Το Κριτήριο ανάθεσης (criteria code) πρέπει να είναι θετικός αριθμός		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classification of public law organization).
Η Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classification of public law organization) πρέπει να είναι θετικός αριθμός		 Ναι
noticeType Παρακαλώ δώστε τον Τύπο δημοσίευσης (notice type).
Ο Τύπος δημοσίευσης (notice type) πρέπει να είναι θετικός αριθμός		 Ναι
contractDuration Παρακαλώ δώστε τη Διάρκεια Σύμβασης (contractDuration)
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να είναι θετικός αριθμός.
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να έχει έως 30 ψηφία συνολικά		 Ναι
contractDurationUnitOfMeasure Παρακαλώ δώστε τη Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure)
Η Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure) πρέπει να είναι θετικός αριθμός		 Ναι
contractingAuthorityActivity Παρακαλώ δώστε την Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity).
Η Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity) πρέπει να είναι θετικός αριθμός		 Ναι
contractingData.unitsOperator Παρακαλώ συμπληρώστε τον κωδικό της Οργανικής Μονάδας (unitsOperator).
Ο κωδικός της Οργανικής Μονάδας (unitsOperator) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
contractingData.signers Παρακαλώ συμπληρώστε το Αποφαινόμενο όργανο (signers).
Ο κωδικός Αποφαινόμενο όργανο (signers) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
fundingDetails.publicFundingRef Παρακαλώ συμπληρώστε την Πηγή Χρηματοδότησης (fundingDetails) Ναι
systemicNumbers - Όχι
contractingAuthorities Παρακαλώ δώστε Είδος Αναθέτουσας Αρχής (contractingAuthorities) Ναι
nutsCodes Παρακαλώ δώστε τον Τόπο εκτέλεσης σύμβασης (nutsCodes) Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένου Αντικειμένων (objectDetailsList) Ναι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε το κόστος χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Το κόστος χωρίς ΦΠΑ στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 400 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.greenContracts Παρακαλώ δώστε τον Κωδικό για την Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (green contracts)
Η Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (green contracts) πρέπει να είναι θετικός αριθμός		 Ναι
objectDetailsList.goodServices Οι Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ (good services) πρέπει να είναι θετικός αριθμός Όχι αν δεν εμπίπτουν στο ΕΣΔ οι Πράσινες Δημόσιες Συμβάσεις

Παράδειγμα Κλήσης

POST /khmdhs-api/notice
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: multipart/form-data;

 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="file"; filename="document.pdf"
Content-Type: application/pdf

<binary file content>
 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="notice"

{
  "title": "hgyrt",
  "requestItems": [],
  "signedDate": "2024-01-01",
  "publishedDate": null,
  "finalSubmissionDate": "2024-09-10 10:10",
  "amendPreviousNotice": true,
  "amendedNoticeADAM": "26PROC009215622",
  "aaht": "45234assigned24",
  "biddingWebsite": "",
  "numberOfSections": 2,
  "nutsCode": "FRK21",
  "nutsCity": "Athens",
  "nutsPostalCode": "153645",
  "nutsCountry": "AS",
  "offersValidTime": "2",
"offersValidTimeUnitOfMeasure":"1",
  "socialContract": "1",
  "assignedContract": "1",
  "centralGovernmentAuthority": "1",
  "optionRightDescription": "test",
  "procedureType": "1",
  "contractType": "12",
  "additionalContractTypes": ["2"],
  "awardProcedure": null,
  "centralizedMarkets": ["1"],
  "maxNumberOfContractors": "2",
  "legalContext": "5",
  "conductingProceedings": "2",
  "digitalPlatform": "",
  "criteriaCode": "3",
  "classificationOfPublicLawOrganization": "1",
  "contractingAuthority": "9",
  "noticeType": "2",
  "contractDuration": 2,
"contractDurationUnitOfMeasure": "1",
  "contractingAuthorityActivity": "8",
  "contractingData": {
    "unitsOperator": "90593",
    "signers": "128986"
  },
  "fundingDetails": {
    "publicFundingRef": 213131,
    "publicFundingRefNum": 3131,
    "publicFundingRefOps": "1213213",
    "selfFundProgramRef": null,
    "regularBudgetFundedProgramRef": null
  },
  "nutsCodes": ["FR"],
  "objectDetailsList": [
    {
      "quantity": 3,
      "costWithoutVAT": 3334,
      "type": "mL",
      "vat": "18",
      "currency": "EUR",
      "shortDescription": "45yt5",
      "cpvs": [
        "33131600-3"
      ],
      "greenContracts": "3",
      "goodServices": "110"
    },
    {
      "quantity": 6,
      "costWithoutVAT": 11255,
      "type": "mL",
      "vat": "18",
      "currency": "EUR",
      "shortDescription": "jfvievejr",
      "cpvs": [
        "33131600-3"
      ],
      "greenContracts": "3",
      "goodServices": "110"
    }
  ]
}
 -----------------------------boundary-----------------------------

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης

{
        "referenceNumber": "24PROC009216531"
}
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.
  • Η παράμετρος file πρέπει να περιέχει έγκυρο PDF αρχείο.

Επεξεργασία Προσκλήσεων-Προκηρύξεων-Διακηρύξεων

Η λειτουργικότητα της επεξεργασίας αιτημάτων αποτελείται από τα εξής μέρη:

  • Επεξεργασία δεδομένων Επεξεργασίας Προσκλήσεων-Προκηρύξεων-Διακηρύξεων μέσω REST κλήσης PUT.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PUT /khmdhs-api/notice/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την επεξεργασία μιας Πρόσκλησης-Προκήρυξης-Διακήρυξης.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Πρόσκλησης-Προκήρυξης-Διακήρυξης προς επεξεργασία.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

                    
{
    "amendPreviousNotice": true,
    "amendedNoticeADAM": "26PROC009215622",
    "title": "dtrgerv upd",
    "signedDate": "2025-08-30",
    "publishedDate": null,
    "contractDurationUnitOfMeasure": "1",
    "offersValidTimeUnitOfMeasure": "1",
    "finalSubmissionDate": "2025-08-26 00:00",
    "aaht": "4523424",
    "biddingWebsite": "http://www.google.gr",
    "budget": 2454,
    "commitmentNo": null,
    "numberOfSections": 3,
    "contractingData": {
        "unitsOperator": "90593",
        "signers": "128986"
    },
      "fundingDetails": {
        "publicFundingRef": 213131,
        "publicFundingRefNum": 3131,
        "publicFundingRefOps": "1213213",
        "selfFundProgramRef": null,
        "regularBudgetFundedProgramRef": null
      },
    "contractDuration": 2,
    "contractingAuthorityActivity": "9",
    "socialContract": "1",
    "assignedContract": "1",
    "systemicNumbers": [
        "140149"
    ],
    "contractingAuthority": "9",
    "nutsCodes": [
        "FRK"
    ],
    "organization": "100015981",
    "procedureType": "4",
    "contractType": "12",
    "awardProcedure": 53,
    "centralizedMarkets": ["1"],
    "legalContext": "5",
    "conductingProceedings": "1",
    "digitalPlatform": "3",
    "criteriaCode": "3",
    "classificationOfPublicLawOrganization": "2",
    "noticeType": "2",
    "objectDetailsList": [
        {
            "quantity": 3,
            "costWithoutVAT": 3334,
            "type": "mL",
            "vat": "18",
            "currency": "EUR",
            "shortDescription": "45yt5",
            "cpvs": [
                "33131600-3"
            ],
            "greenContracts": "3",
            "goodServices": "110"
        }
    ],
    "additionalContractTypes": ["2", "3"],
    "offersValidTime":1,
    "maxNumberOfContractors": 2,
    "optionRightDescription": "lorem ipsum",
    "centralGovernmentAuthority": "2",
    "nutsCode": "FRI",
    "nutsCity": "Athens",
    "nutsPostalCode": "153645",
    "nutsCountry": "GR"
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
amendPreviousNotice Boolean Εάν τροποποιείται προηγούμενη ειδοποίηση.
amendedNoticeADAM string ΑΔΑΜ τροποποιημένης πράξης.
title string Τίτλος.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
publishedDate string Ημερομηνία αποστολής στην Ευρωπαϊκή Ένωση.
finalSubmissionDate string Καταληκτική Ημερομηνία Υποβολής Προσφορών.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
biddingWebsite string Ιστότοπος υποβολής προσφορών.
numberOfSections BigDecimal Αριθμός τμημάτων.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
nutsCity string Πόλη.
nutsPostalCode string Ταχυδρομικός Κώδικας.
nutsCountry string Χώρα Αναθέτουσας Αρχής.
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης.
offersValidTime Long Χρόνος Ισχύος Προσφορών.
offersValidTimeUnitOfMeasure string Μονάδα μέτρησης χρόνου ισχύος προσφορών:
"1" Ημέρες,
"2" Εβδομάδες,
"3" Μήνες,
"4" Έτη
assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
optionRightDescription Boolean Περιγραφή δικαιώματος προαίρεσης.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"18" για Διαδικασία άρθρου 128 του ν.4412/16,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"2" για Κλειστή διαδικασία,
"11" για Σύμπραξη καινοτομίας
awardProcedure string Αιτιολόγηση διαδικασίας ανάθεσης. Συμπληρώστε:
Για Διαδικασία ανάθεσης "2" ή "3":
"51" για Οι ανάγκες δεν μπορούν να ικανοποιηθούν χωρίς προσαρμογή των άμεσα διαθέσιμων λύσεων,
"52" για Το αντικείμενο της σύμβασης περιλαμβάνει σχεδιασμό ή καινοτόμες λύσεις,
"53" για Συντρέχουν ειδικές περιστάσεις σχετικά με το αντικείμενο της σύμβασης,
"54" για Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια,
"55" για Άγονη διαδικασία ανάθεσης σύμβασης,

Για Διαδικασία ανάθεσης "7":
"56" για Άγονη διαδικασία ανάθεσης σύμβασης,
"57" για Μοναδικό έργο τέχνης ή καλλιτεχνική εκδήλωση,
"58" για Απουσία ανταγωνισμού για τεχνικούς λόγους,
"59" για Προστασία αποκλειστικών δικαιωμάτων,
"60" για Κατεπείγουσα ανάγκη οφειλόμενη σε γεγονότα απρόβλεπτα για την αναθέτουσα αρχή
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"8" για Δεν χρησιμοποιείται,
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"3" για Ηλεκτρονικός Κατάλογος
maxNumberOfContractors Long Μέγιστος αριθμός αναδόχων σε συμφωνία – πλαίσιο.
legalContext string Νομικό πλαίσιο. Συμπληρώστε:
"4" για ν.4412/2016 - Βιβλίο Ι - άνω των ορίων,
"5" για ν.4412/2016 - Βιβλίο Ι - κάτω των ορίων,
"6" για ν.4412/2016 - Βιβλίο ΙΙ - άνω των ορίων,
"7" για ν.4412/2016 - Βιβλίο ΙΙ - κάτω των ορίων,
"10" ν.4413/2016 - Παραχωρήσεις
conductingProceedings string Τρόπος Διεξαγωγής Διαδικασίας. Συμπληρώστε:
"1" για Ηλεκτρονική Διαδικασία
"2" για Μη ηλεκτρονική διαδικασία
digitalPlatform string Ψηφιακή πλατφόρμα.Συμπληρώστε:
"3" για ΕΣΗΔΗΣ Π&Υ
"4" για ΕΣΗΔΗΣ ΔΕ
"5" για CosmoOne
"6" για iSupplies
"7" για Άλλη
criteriaCode string Κριτήριο ανάθεσης.
"1" για Βάσει κόστους - βέλτιστη σχέση ποιότητας τιμής
"2" για Βάσει τιμής "3" για Βάσει κόστους - κοστολόγηση κύκλου ζωής "4" για Βάσει τιμής - άλλο
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
contractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"1" για ΕΚΑΑ ή ΚΑΑ,
"2" για Κεντρική Διοίκηση,
"3" για ΝΠΔΔ,
"4" για ΝΠΙΔ,
"5" για Ανεξάρτητη αρχή
noticeType string Τύπος δημοσίευσης. Συμπληρώστε:
"2" για Προκήρυξη,
"3" για Διακήρυξη,
"4" για Πρόσκληση
contractDuration BigDecimal Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης:
"1" Ημέρες,
"2" Εβδομάδες,
"3" Μήνες,
"4" Έτη
contractingAuthorityActivity string Δραστηριότητα αναθέτουσας αρχής. Συμπληρώστε:
"1" για Γενικές δημόσιες υπηρεσίες,
"2" για Άμυνα,
"3" για Δημόσια τάξη και ασφάλεια,
"4" για Περιβάλλον,
"5" για Οικονομικές και δημοσιονομικές υποθέσεις,
"6" για Υγεία,
"7" για Στέγαση και υποδομές κοινής ωφέλειας,
"8" για Κοινωνική προστασία,
"9" για Αναψυχή,
"10" για Πολιτισμός και θρησκεία,
"11" για Εκπαίδευση,
"12" για Τυχόν άλλη δραστηριότητα,
"13" Αναζήτηση ή εξόρυξη άνθρακα και άλλων στερεών καυσίμων,
"14" Δραστηριότητες που αφορούν την ηλεκτροδότηση,
"15" Δραστηριότητες που αφορούν την ύδρευση,

"16" Δραστηριότητες που αφορούν τους αερολιμένες,
"17" Δραστηριότητες που αφορούν τους λιμένες,
"18" Εξόρυξη φυσικού αερίου ή πετρελαίου,
"19" Μεταφορές με αστικό σιδηρόδρομο, τραμ, τρόλεϊ ή λεωφορείο,
"20" Παραγωγή, μεταφορά ή διανομή αερίου ή θερμότητας,
"21" Σιδηροδρομικές υπηρεσίες,
"22" Ταχυδρομικές υπηρεσίες
contractingData Object Δεδομένα αναθέτουσας αρχής.
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε τον κωδικό της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
fundingDetails Object Πηγή χρηματοδότησης.
fundingDetails.publicFundingRef string Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
fundingDetails.publicFundingRefNum string Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
fundingDetails.selfFundProgramRef string Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
fundingDetails.espaFundProgramRef string Πρόγραμμα Χρηματοδοτούμενο Από το ΕΣΠΑ - Δηλώστε το σχετικό Κωδικό ΕΣΠΑ.
fundingDetails.regularBudgetFundedProgramRef string Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
systemicNumbers Array Αριθμός ηλεκτρονικού διαγωνισμού (όταν ο Τρόπος Διεξαγωγής Διαδικασίας είναι Μη Ηλεκτρονική Διαδικασία)
Αριθμός/ID ηλεκτρονικής διαγωνιστικής διαδικασίας (όταν ο Τρόπος Διεξαγωγής Διαδικασίας είναι Ηλεκτρονική Διαδικασία).
nutsCodes Array Γεωγραφική περιοχή του τόπου εκτέλεσης σύμβασης. Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.greenContracts string Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
Συμπληρώστε:
"1" για Δεν εμπίπτει στο ΕΣΔ
"2" για Εμπίπτει στο ΕΣΔ - Δεν έχουν υιοθετηθεί τα ΠΚ
"3" για Εμπίπτει στο ΕΣΔ - Έχουν υιοθετηθεί τα ΠΚ
objectDetailsList.goodServices string Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ. Συμπληρώστε:
"101" για Χαρτί́ από́ ανακτημένες ίνες,
"102" για Χαρτί από παρθένες ίνες αειφόρου συγκομιδής,
"103" για Ηλεκτρονικοί υπολογιστές,
"104" για Οθόνες,
"105" για "Εξοπλισμός απεικόνισης (εκτυπωτές, σαρωτές, πολυμηχανήματα φωτοαντιγραφής, εκτύπωσης και σάρωσης)",
"106" για Εσωτερικός φωτισμός - Λαμπτήρες LED,
"107" για Κλιματιστικά́ μηχανήματα,
"108" για Λιπαντικά́ Αναγεννημένα,
"109" για Λιπαντικά Βιοαποικοδομήσιμα,
"110" για Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς),
"111" για Οδοφωτισμός και σηματοδότες κυκλοφορίας (αφορά́ οδούς αρμοδιότητας Δήμων και Περιφερειών),
"112" για Έπιπλα,
"113" για Προϊόντα κλωστοϋφαντουργίας,
"114" για "Προϊόντα και υπηρεσίες συντήρησης εξωτερικών δημόσιων χώρων (Καθαρισμός, κηπουρική́)",
"115" για Υποδομές διαχείρισης λυμάτων,
"116" για Ηλεκτρικός και ηλεκτρονικός εξοπλισμός χρησιμοποιούμενος στον τομέα της υγειονομικής περίθαλψης (Υγειονομικός ΗΗΕ),
"117" για "Σχεδιασμός οδοποιίας, κατασκευή́ και συντήρηση",
"118" για "Σχεδιασμός κτιρίων γραφείων, κατασκευή́ και διαχείριση"


Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
amendPreviousNotice Παρακαλώ δηλώστε αν τροποποιεί Προηγούμενη Πρόσκληση-Προκήρυξη-Διακήρυξη (amendPreviousNotice) Ναι
amendedNoticeADAM Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##PROC#########) ή να είναι κενός. Όχι
title Παρακαλώ δώστε τον Τίτλο (title).
Ο Τίτλος (title) θα πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
publishedDate - Όχι
finalSubmissionDate Παρακαλώ δώστε την Καταληκτική Ημερομηνία και Ώρα Υποβολής (final submission date) Ναι
aaht Παρακαλώ δώστε τον Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht)
Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
numberOfSections Παρακαλώ δώστε τον Αριθμό Τμημάτων (numberOfSections)
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να είναι θετικός αριθμός
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να έχει έως 30 ψηφία συνολικά		 Ναι
nutsCode Παρακαλώ δώστε τον Κωδικό NUTS (nuts code) Ναι
nutsCity Παρακαλώ δώστε την πόλη Αναθέτουσας Αρχής (nutsCity) Ναι
nutsPostalCode Παρακαλώ δώστε τον ΤΚ Αναθέτουσας Αρχής (nutsPostalCOde) Ναι
nutsCountry Παρακαλώ δώστε την Χώρα Αναθέτουσας Αρχής (nutsCountry) Ναι
offersValidTime Παρακαλώ δώστε Χρόνος Ισχύος Προσφορών (offers validity time)
Ο Χρόνος Ισχύος Προσφορών (offers validity time) πρέπει να είναι μη αρνητικός αριθμός		 Ναι
offersValidTimeUnitOfMeasure Παρακαλώ δώστε την Μονάδα Μέτρησης του Χρόνου Ισχύος Προσφορών (offersValidTimeUnitOfMeasure)
Η Μονάδα Μέτρησης του Χρόνου Ισχύος Προσφορών (offersValidTimeUnitOfMeasure) πρέπει να είναι θετικός αριθμός		 Ναι
assignedContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract).
Η Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assigned contract) πρέπει να είναι θετικός αριθμός		 Ναι
socialContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract).
Η Σύμβαση για κοινωνικές και άλλες υπηρεσίες (social contract) πρέπει να είναι θετικός αριθμός		 Ναι
centralGovernmentAuthority Παρακαλώ δηλώστε αν πρόκειται για Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority).
Η Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
contractingData Παρακαλώ δώστε Δεδομένα Αναθέτουσας Αρχής (contracting data) Ναι
optionRightDescription - Όχι
procedureType Παρακαλώ δώστε την Διαδικασία ανάθεσης (procedure type)
Η Διαδικασία ανάθεσης (procedure type) πρέπει να είναι θετικός αριθμός		 Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβαση (contract type)
Ο Κύριος χαρακτήρας σύμβασης (contract type) πρέπει να είναι θετικός αριθμός		 Ναι
awardProcedure Η Αιτιολόγηση διαδικασίας ανάθεσης (award procedure) πρέπει να είναι θετικός αριθμός Ναι
centralizedMarkets Παρακαλώ δώστε τον Κωδικό Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralized market) Ναι
maxNumberOfContractors - Όχι
legalContext Παρακαλώ δώστε τον Κωδικό Νομικού Πλαισίου (legal context)
Το Νομικό Πλαίσιο (legal context) πρέπει να είναι θετικός αριθμός		 Ναι
conductingProceedings Παρακαλώ δώστε τον Τρόπο Διεξαγωγής Διαδικασίας (conducting proceedings) Ναι
digitalPlatform Η Ψηφιακή Πλατφόρμα (digital platform) πρέπει να είναι θετικός αριθμός Όχι
biddingWebsite Ο Ιστότοπος Υποβολής Προσφορών (bidding website) πρέπει να είναι έγκυρο URL. Όχι
criteriaCode Παρακαλώ δώστε τον Κωδικό για το Κριτήριο ανάθεσης (criteria code).
Το Κριτήριο ανάθεσης (criteria code) πρέπει να είναι θετικός αριθμός		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classification of public law organization).
Η Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classification of public law organization) πρέπει να είναι θετικός αριθμός		 Ναι
noticeType Παρακαλώ δώστε τον Τύπο δημοσίευσης (notice type).
Ο Τύπος δημοσίευσης (notice type) πρέπει να είναι θετικός αριθμός		 Ναι
contractDuration Παρακαλώ δώστε τη Διάρκεια Σύμβασης (contractDuration)
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να είναι θετικός αριθμός.
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να έχει έως 30 ψηφία συνολικά		 Ναι
contractDurationUnitOfMeasure Παρακαλώ δώστε τη Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure)
Η Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure) πρέπει να είναι θετικός αριθμός		 Ναι
contractingAuthorityActivity Παρακαλώ δώστε την Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity).
Η Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity) πρέπει να είναι θετικός αριθμός		 Ναι
contractingData.unitsOperator Παρακαλώ συμπληρώστε τον κωδικό της Οργανικής Μονάδας (unitsOperator).
Ο κωδικός της Οργανικής Μονάδας (unitsOperator) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
contractingData.signers Παρακαλώ συμπληρώστε το Αποφαινόμενο όργανο (signers).
Ο κωδικός Αποφαινόμενο όργανο (signers) θα πρέπει να είναι ένας θετικός αριθμός.		 Ναι
fundingDetails Παρακαλώ συμπληρώστε την Πηγή Χρηματοδότησης (fundingDetails) Ναι
systemicNumbers - Όχι
contractingAuthorities Παρακαλώ δώστε Είδος Αναθέτουσας Αρχής (contractingAuthorities) Ναι
nutsCodes Παρακαλώ δώστε τον Τόπο εκτέλεσης σύμβασης (nutsCodes) Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένου Αντικειμένων (objectDetailsList) Ναι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε το κόστος χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Το κόστος χωρίς ΦΠΑ στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 400 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.greenContracts Παρακαλώ δώστε τον Κωδικό για την Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (green contracts)
Η Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (green contracts) πρέπει να είναι θετικός αριθμός		 Ναι
objectDetailsList.goodServices Οι Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ (good services) πρέπει να είναι θετικός αριθμός Όχι αν δεν εμπίπτουν στο ΕΣΔ οι Πράσινες Δημόσιες Συμβάσεις

Παράδειγμα Κλήσης

                    
    PUT /khmdhs-api/notice/{referenceNumber}
    Host: example.com
    Authorization: Basic <base64_credentials>
    Content-Type: application/json

{
    "amendPreviousNotice": false,
    "amendedNoticeADAM": "",
    "title": "dtrgerv upd",
    "signedDate": "2025-08-30",
    "publishedDate": null,
    "contractDurationUnitOfMeasure": "1",
    "offersValidTimeUnitOfMeasure": "1",
    "finalSubmissionDate": "2025-08-26 00:00",
    "aaht": "4523424",
    "biddingWebsite": "http://www.google.gr",
    "budget": 2454,
    "commitmentNo": null,
    "numberOfSections": 3,
    "contractingData": {
        "unitsOperator": "100047200",
        "signers": "100010086"
    },
    "contractDuration": 2,
    "contractingAuthorityActivity": "9",
    "socialContract": "1",
    "assignedContract": "1",
    "fundingDetails": {
        "publicFundingRef": null,
        "publicFundingRefNum": null,
        "selfFundProgramRef": null,
        "regularBudgetFundedProgramRef": null
    },
    "systemicNumbers": [
        "140149"
    ],
    "contractingAuthority": "9",
    "nutsCodes": [
        "FRK"
    ],
    "organization": "100015981",
    "procedureType": "4",
    "contractType": "12",
    "awardProcedure": 53,
    "centralizedMarkets": ["1"],
    "legalContext": "5",
    "conductingProceedings": "1",
    "digitalPlatform": "3",
    "criteriaCode": "3",
    "classificationOfPublicLawOrganization": "2",
    "noticeType": "2",
    "objectDetailsList": [
        {
            "quantity": 3,
            "costWithoutVAT": 3334,
            "type": "mL",
            "vat": "18",
            "currency": "EUR",
            "shortDescription": "45yt5",
            "cpvs": [
                "33131600-3"
            ],
            "greenContracts": "3",
            "goodServices": "110"
        }
    ],
    "additionalContractTypes": ["2", "3"],
    "offersValidTime":1,
    "maxNumberOfContractors": 2,
    "optionRightDescription": "lorem ipsum",
    "centralGovernmentAuthority": "2",
    "nutsCode": "FRI",
    "nutsCity": "Athens",
    "nutsPostalCode": "153645",
    "nutsCountry": "GR"
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
message String Μήνυμα επιβεβαίωσης ακύρωσης.

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 25PROC009223819 ενημερώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ακύρωση Προσκλήσεων-Προκηρύξεων-Διακηρύξεων

Η λειτουργικότητα της ακύρωσης Προσκλήσεων-Προκηρύξεων-Διακηρύξεων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Ακύρωσης μέσω REST κλήσης PATCH.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PATCH /khmdhs-api/notice/cancel/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την ακύρωση μιας Πρόσκλησης-Προκήρυξης-Διακήρυξης.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Πρόσκλησης προς ακύρωση.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

                        {
                            "type": "5",
                            "reason": "Test",
                            "cancellationADA": "rt45234",
                            "abortReason": "1"
                        }

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
type string Είδος ακύρωσης. Συμπληρώστε:
"3" για Ακύρωση λόγω λανθασμένης καταχώρησης,
"5" για Ματαίωση
reason string Περιγραφή.
cancellationADA string ΑΔΑ απόφασης Ματαίωσης.
abortReason string Λόγος ματαίωσης.Συμπληρώστε:
"1" για Άγονη διαδικασία ανάθεσης σύμβασης
"2" για Παράτυπη διεξαγωγή διαδικασία ανάθεσης
"3" για Το αντικείμενο της σύμβασης δεν ενδιαφέρει πλέον
"4" για Ανωτέρα βία
"5" για Μη συμφέρουσα από οικονομική άποψη προσφορά
"6" για Λήξη χρόνου ισχύος προσφορών
"7" για Επιτακτικοί λόγοι δημοσίου συμφέροντος

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
type Παρακαλώ δώστε το Είδος ακύρωσης (type). Ναι
reason Παρακαλώ δώστε την Περιγραφή (reason). Ναι
cancellationADA - Όχι
abortReason Παρακαλώ δώστε τιμή για το πεδίο Λόγος ματαίωσης (abortReason) Μόνο αν το πεδίο Περιγραφή (reason) έχει την τιμή 5

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 24PROC009216531 ακυρώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ανάκτηση Αναθέσεων

Κάθε Ανάθεση αποτελείται από τα εξής μέρη:

  • Ένα σύνολο δεδομένων τα οποία περιγράφουν την Ανάθεση και ανακτώνται με μια REST κλήση POST.
  • Το έγγραφο της Ανάθεσης σε μορφή PDF το οποίο μπορεί να ανακτηθεί με μια REST κλήση GET και με τον αριθμό ΑΔΑΜ {referenceNumber} της Ανάθεσης.

POST /khmdhs-opendata/auction?page=0

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση σελιδοποιημένων αποτελεσμάτων των Αναθέσεων με βάση το request body της κλήσης.

Παράμετροι Κλήσης

  • page (integer, optional): Ο αριθμός σελίδας που θέλετε να ανακτήσετε, ξεκινώντας από το 0. Εάν δεν έχει καθοριστεί, ορίζεται αυτόματα ως προεπιλογή το 0.

Request Body Κλήσης

Το request body της κλήσης θα πρέπει να είναι ένα αντικείμενο JSON που περιέχει τα παρακάτω πεδία:

                        
{
    "title": "string",
    "cpvItems": ["string"],
    "organizations": ["string"],
    "signer": "string",
    "referenceNumber": "string",
    "contractType": "string",
    "dateFrom": "2024-11-22",
    "dateTo": "2024-11-22",
    "totalCostFrom": 0,
    "totalCostTo": 1000000000000,
    "cancelDateFrom": "2024-11-22",
    "cancelDateTo": "2024-11-22",
    "procedureType": "string",
    "vatNumber": "string",
    "contractorName": "string",
    "aaht": "string",
    "estTotalCostFrom": 0,
    "estTotalCostTo": 1000000000000,
    "isModified": false
}
Παρατηρήσεις

  • Αν δεν οριστεί τιμή στο πεδίο dateTo, ενώ έχει οριστεί dateFrom, τότε το σύστημα αυτομάτως θα εισάγει ως τιμή την dateFrom συν 180 μέρες.
  • Αν δεν έχει οριστεί τιμή στο πεδίο dateFrom ενώ έχει οριστεί dateTo, τότε το σύστημα αυτομάτως θα εισάγει την ημερομηνία του dateTo μείον 180 μέρες.
  • Αν δεν έχει οριστεί ούτε dateFrom ούτε dateTo, τότε το σύστημα θα εισάγει ως dateTo την τρέχουσα ημερομηνία και dateFrom την τρέχουσα ημερομηνία μείον 180 μέρες.
  • Αν έχει οριστεί dateFrom και dateTo, αλλά έχουν διαφορά μεγαλύτερη των 180 ημερών, τότε το σύστημα θα εισάγει dateFrom την dateTo μείον 180 μέρες.
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί ούτε cancelDateFrom ούτε cancelDateTo τότε δεν θα υπολογίζεται η Ημερομηνία Ματαίωσης κατά την αναζήτηση. Σε περίπτωση που έχει οριστεί μόνο cancelDateFrom ή μόνο cancelDateΤο η και οι 2 τότε θα ισχύει ο κανόνας τον 180 ημερών όπως περιγράφεται για τα πεδία dateFrom και dateTo
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί το εύρος των cancelDateFrom και cancelDateΤο το σύστημα επιστρέφει και τις Ματαιώσεις με βάση τα υπόλοιπα καθορισμένα κριτήρια αναζήτησης. Αν καθοριστούν τα cancelDateFrom και cancelDateΤο τότε το σύστημα επιστρέφει μόνο πράξεις που έχουν ματαιωθεί.
  • Αν στα κριτήρια αναζήτησης το πεδίο isModified είναι false το σύστημα επιστρέφει όλες τις πράξεις ανεξάρτητα από το αν αφορά τροποποίηση ή όχι. Στην περίπτωση που το πεδίο isModified είναι true τότε επιστρέφει μόνο τροποποιήσεις.


Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
cpvItems Array[String] Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
πχ. "34327200-7" για Άξονες και κιβώτια,
"34711500-9" για Ελικόπτερα
organizations Array[String] Αναθέτουσα Αρχή/Αναθέτων Φορέας.
Συμπληρώστε τον κωδικό του Φορέα.
πχ. "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ,
"72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
signer string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
πχ. "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής
referenceNumber string Μοναδικός Κωδικός - ΑΔΑΜ.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
dateFrom string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Από (YYYY-MM-DD).
dateTo string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Έως (YYYY-MM-DD).
totalCostFrom integer Συνολική αξία σύμβασης χωρίς ΦΠΑ Από.
totalCostTo integer Συνολική αξία σύμβασης χωρίς ΦΠΑ Έως.
cancelDateFrom string Ματαιώσεις Από (YYYY-MM-DD).
cancelDateTo string Ματαιώσεις Έως (YYYY-MM-DD).
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"2" για Κλειστή διαδικασία,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"11" για Σύμπραξη καινοτομίας,
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"18" για Διαδικασία άρθρου 128 του ν.4412/16
vatNumber string ΑΦΜ Αναδόχου.
contractorName string Επωνυμία Αναδόχου.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
estTotalCostFrom string Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Από.
estTotalCostTo string Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Έως.
isModified boolean Τροποποιήσεις (true/false).

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Το πεδίο Τίτλος (title) θα πρέπει να έχει μέχρι 100 χαρακτήρες. Όχι
cpvItems Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενός. Όχι
organizations Το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
signer Το πεδίο Αποφαινόμενο όργανο (signer) θα πρέπει να είναι ένας θετικός αριθμός ή κενό.
Εάν το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) έχει περισσότερες απο μια τιμή, το Αποφαινόμενο όργανο (signer) πρέπει να είναι κενό.>		 Όχι
referenceNumber Το πεδίο ΑΔΑΜ (referenceNumber) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενό. Όχι
contractType Το πεδίο Κύριος χαρακτήρας σύμβασης (contractType) θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
dateFrom / dateTo Η Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
totalCostFrom / totalCostTo Τα πεδία Συνολική αξία χωρίς ΦΠΑ (totalCostFrom) και (totalCostTo) θα πρέπει να είναι ίσα ή μεγαλύτερα από 0. Όχι
cancelDateFrom / cancelDateTo Η Ημερομηνία Ματαίωσης θα πρέπει να έχει μια απο τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, and YYYY-MM-D). Όχι
referenceNumber Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενό. Όχι
procedureType Το πεδίο Διαδικασία ανάθεσης πρέπει να είναι θετικός αριθμός ή κενό. Όχι
vatNumber Το ΑΦΜ Αναδόχου πρέπει να είναι θετικός αριθμός ή κενό. Όχι
contractorName Η Επωνυμία Αναδόχου πρέπει να είναι μέχρι 30 χαρακτήρες. Όχι
aaht Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής πρέπει να είναι μέχρι 30 χαρακτήρες. Όχι
estTotalCostFrom Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Από θα πρέπει να είναι ίσο ή μεγαλύτερο από 0.
Συνολική εκτιμώμενη αξία χωρίς ΦΠΑ Από θα πρέπει να είναι μικρότερο ή ίσο από 1000000000000.		 Όχι
estTotalCostTo Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ έως θα πρέπει να είναι ίσο ή μεγαλύτερο από 0.
Συνολική εκτιμώμενη αξία χωρίς ΦΠΑ Από θα πρέπει να είναι μικρότερο ή ίσο από 1000000000000.		 Όχι

Παράδειγμα απάντησης σε περίπτωση λανθασμένης τιμής στα πεδία referenceNumber και cpvItems κατά την κλήση:

{
	"errors": {
		"referenceNumber": "Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενό.",
                "cpvItems": "Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενό."
	}
}

Παράδειγμα κλήσης

POST /khmdhs-opendata/auction?page=0
Content-Type: application/json

{
    "title": "ΠΕΡΙΛΗΨΗΣ ΔΙΑΚΗΡΥΞΗΣ",
    "cpvItems": ["79822500-7", "34711500-9"],
    "organizations": "[99221938]",
    "signer": "100070768",
    "referenceNumber": "24AWRD009215539",
    "contractType": "1",
    "dateFrom": "2024-01-01",
    "dateTo": "2024-01-10",
    "totalCostFrom": 0,
    "totalCostTo": 1000,
    "cancelDateFrom": "",
    "cancelDateTo": "",
    "procedureType": "19",
    "vatNumber": "",
    "contractorName": "",
    "aaht": "string",
    "estTotalCostFrom": 0,
    "estTotalCostTo": 1000000000000,
    "isModified": false
}

Παράδειγμα απάντησης


{
	"content": [
		{
			"title": "ΠΕΡΙΛΗΨΗΣ ΔΙΑΚΗΡΥΞΗΣ",
			"referenceNumber": "24AWRD009215539",
			"submissionDate": "2025-01-22T10:45:02.938443",
			"lastUpdateDate": null,
			"signedDate": null,
			"cancelled": false,
			"cancellationDate": null,
			"cancellationType": null,
			"cancellationReason": null,
			"cancellationADA": null,
			"protocolNumber": null,
			"aaht": "1234",
			"authorEmail": null,
			"organizationVatNumber": "123",
			"greekOrganizationVatNumber": false,
			"budget": 2000,
			"auctionAmount": null,
			"commitmentNo": null,
			"amendedAuctionADAM": "",
			"amendPreviousAuction": false,
			"numberOfSections": 2,
			"assignedContract": {
				"key": "2",
				"value": "Όχι"
			},
			"socialContract": {
				"key": "2",
				"value": "Όχι"
			},
			"centralGovernmentAuthority": {
				"key": "1",
				"value": "Ναι"
			},
			"contractingData": {
				"unitsOperator": {
					"key": "100047202",
					"value": "ΑΝΑΠΤΥΞΙΑΚΗ ΔΥΤΙΚΗΣ ΜΑΚΕΔΟΝΙΑΣ ΑΕ ΟΤΑ"
				},
				"signers": {
					"key": "100082827",
					"value": "ΑΘΑΝΑΣΙΑ ΑΓΓΕΛΑΚΗ - Διευθυντής"
				}
			},
			"procedureType": {
				"key": "1",
				"value": "Ανοιχτή διαδικασία"
			},
			"organization": {
				"key": "100015981",
				"value": "ΥΠΟΥΡΓΕΙΟ ΑΓΡΟΤΙΚΗΣ ΑΝΑΠΤΥΞΗΣ ΚΑΙ ΤΡΟΦΙΜΩΝ"
			},
			"contractType": {
				"key": "10",
				"value": "Έργα"
			},
			"criteriaCode": {
				"key": "4",
				"value": "Βάσει κόστους – άλλο"
			},
			"awardProcedure": null,
			"nutsCode": {
				"key": "FRI",
				"value": "AQUITAINE-LIMOUSIN-POITOU-CHARENTES"
			},
			"nutsCity": "Athens",
			"nutsPostalCode": "153645",
			"nutsCountry": {
				"key": "GR",
				"value": "Ελλάδα"
			},
			"centralizedMarkets": [
				{
					"centralizedMarket": {
						"key": "8",
						"value": "Δεν χρησιμοποιείται"
					}
				}
			],
			"legalContext": {
				"key": "4",
				"value": "Βιβλίο Ι – άνω των ορίων"
			},
			"centralizedTypes": null,
			"classificationOfPublicLawOrganization": {
				"key": "1",
				"value": "Κεντρική Κυβέρνηση"
			},
			"typeOfContractingAuthority": {
				"key": "13",
				"value": "Ανεξάρτητη αρχή (με νομική προσωπικότητα)"
			},
			"contractingAuthorityActivity": {
				"key": "8",
				"value": "Κοινωνική προστασία"
			},
            "additionalContractTypes": null,
			"mixedContract": false,
			"contractDuration": "2",
            "contractDurationUnitOfMeasure": {
                "key": "2",
                "value": "Εβδομάδες"
            },
			"contractingDataDetails": {
            "contractingMembersDataList": [
                {
                    "vatNumber": "123",
                    "greekVatNumber": false,
                    "name": "string",
                    "nutsCode": null,
                    "installationCountry": {
                        "key": "AS",
                        "value": "American Samoa"
                    }
                }
            ]
			},
			"totalCostWithVAT": 1100.00,
			"totalCostWithoutVAT": 1000.00,
			"objectDetailsList": [
				{
					"quantity": 10,
					"type": {
						"key": "KGM",
						"value": "Kg"
					},
					"costWithoutVAT": 1000,
					"vat": "10",
					"currency": {
						"key": "EUR",
						"value": "Ευρώ"
					},
					"shortDescription": "Test",
					"cpvs": [
						{
							"key": "34144910-0",
							"value": "Ηλεκτρικά λεωφορεία"
						}
					],
					"greenContracts": {
						"key": "1",
						"value": "Δεν εμπίπτει στο ΕΣΔ"
					},
					"goodServices": null
				}
			],
			"approvedRequestsList": [],
			"noticeRefNo": "25PROC009222919",
			"amendsAuctionRefNo": [
			    "25AWRD009222921"
			],
			"contractRefNo": [
			    "25SYMV009223199",
			    "25SYMV009223198",
			    "25SYMV009223197",
			    "25SYMV009223039",
			    "25SYMV009222939",
			    "25SYMV009222923",
 			    "25SYMV009222922"
			],
			"paymentRefNo": []
		}
	],
	"pageable": {
		"pageNumber": 0,
		"pageSize": 50,
		"sort": {
			"sorted": false,
			"unsorted": true,
			"empty": true
		},
		"offset": 0,
		"unpaged": false,
		"paged": true
	},
	"last": true,
	"totalPages": 1,
	"totalElements": 1,
	"numberOfElements": 1,
	"first": true,
	"size": 50,
	"number": 0,
	"sort": {
		"sorted": false,
		"unsorted": true,
		"empty": true
	},
	"empty": false
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
content Array Λίστα αντικειμένων Αναθέσεων.
content[].title String Τίτλος Ανάθεσης.
content[].referenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ.
content[].submissionDate DateTime Ημερομηνία υποβολής.
content[].lastUpdateDate DateTime Τελευταία ανανέωση.
content[].signedDate DateTime Ημερομηνία Πρωτοκόλλου (έκδοσης).
content[].cancelled Boolean Υποδεικνύει αν η Ανάθεση ακυρώθηκε.
content[].cancellationDate DateTime Ημερομηνία ακύρωσης Ανάθεσης.
content[].cancellationType String Τύπος ακύρωσης Ανάθεσης.
content[].cancellationReason String Λόγος ακύρωσης Ανάθεσης.
content[].cancellationADA String ΑΔΑ απόφασης ακύρωσης.
content[].protocolNumber String Αριθμός πρωτοκόλλου.
content[].aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
content[].authorEmail String Email συντάκτη.
content[].organizationVatNumber String ΑΦΜ Φορέα.
content[].greekOrganizationVatNumber Boolean Υποδεικνύει αν το ΑΦΜ ανήκει σε ελληνικό φορέα.
content[].budget BigDecimal Συνολική Εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ.
content[].auctionAmount BigDecimal Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ.
content[].commitmentNo String ΑΔΑ Ανάληψης Υποχρέωσης.
content[].amendedAuctionADAM String ΑΔΑΜ τροποποιούμενης πράξης.
content[].amendPreviousAuction Boolean Υποδεικνύει αν υπάρχει ΑΔΑΜ τροποποιούμενης πράξης.
content[].numberOfSections Long Αριθμός τμημάτων.
content[].assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα.
content[].socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες.
content[].centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή.
content[].contractingData.unitsOperator String Οργανική Μονάδα.
content[].contractingData.signers.value String Αποφαινόμενο όργανο.
content[].procedureType String Διαδικασία ανάθεσης.
content[].organization String Φορέας.
content[].contractType String Κύριος χαρακτήρας σύμβασης.
content[].criteriaCode String Κριτήριο ανάθεσης.
content[].awardProcedure String Αιτιολόγηση διαδικασίας ανάθεσης.
content[].nutsCode String Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
content[].nutsCity String Πόλη
content[].nutsPostalCode String Ταχυδρομικός Κώδικας
content[].nutsCountry String Χώρα Αναθέτουσας Αρχής
content[].centralizedMarkets String Χρήση Τεχνικών – Εργαλείων ανάθεσης.
content[].centralizedTypes String Τύπος συγκεντρωτικής αγοράς.
content[].legalContext String Νομικό Πλαίσιο.
content[].classificationOfPublicLawOrganization String Ταξινόμηση Οργανισμού Δημοσίου Δικαίου.
content[].typeOfContractingAuthority String Είδος Αναθέτουσας Αρχής.
content[].contractDuration String Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης
content[].contractingAuthorityActivity String Δραστηριότητα αναθέτουσας αρχής.
content[].additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης.
content[].mixedContract String Μικτή σύμβαση.
content[].contractingDataDetails.contractingMembersDataList[].greekVatNumber String Ελληνικό ΑΦΜ Αναδόχου.
content[].contractingDataDetails.contractingMembersDataList[].vatNumber String ΑΦΜ Αναδόχου.
content[].contractingDataDetails.contractingMembersDataList[].name String Επωνυμία Αναδόχου.
content[].contractingDataDetails.contractingMembersDataList[].nutsCode String Γεωγραφική Περιοχή Έδρας Αναδόχου.
content[].contractingDataDetails.contractingMembersDataList[].installationCountry String Χώρα καταγωγής/εγκατάστασης του αναδόχου.
content[].totalCostWithVAT Decimal Συνολικό κόστος με ΦΠΑ.
content[].totalCostWithoutVAT Decimal Συνολική αξία σύμβασης χωρίς ΦΠΑ.
content[].objectDetailsList[].quantity Integer Ποσότητα αντικειμένου.
content[].objectDetailsList[].costWithoutVAT Decimal Συνολικό Κόστος χωρίς ΦΠΑ.
content[].objectDetailsList[].vat String ΦΠΑ.
content[].objectDetailsList[].type String Μονάδες Μέτρησης.
content[].objectDetailsList[].currency String Περιγραφή νομίσματος.
content[].objectDetailsList[].shortDescription String Περιληπτική περιγραφή αντικειμένου.
content[].objectDetailsList[].cpvs[] String Περιγραφή με όρους CPV.
content[].objectDetailsList[].greenContracts String Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
content[].objectDetailsList[].goodServices String Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ.
content[].noticeRefNo String Λίστα από ΑΔΑΜ προκηρύξεων με τις οποίες συνδέεται η ανάθεση.
content[].approvedRequestsList Object Λίστα εγκεκριμένων αιτημάτων.
content[].amendsAuctionRefNo String Λίστα από ΑΔΑΜ αναθέσεων οι οποίες τροποποιούν την ανάθεση.
content[].contractRefNo String Λίστα από ΑΔΑΜ συμβάσεων με τις οποίες συνδέεται η ανάθεση.
content[].paymentRefNo String Λίστα από ΑΔΑΜ εντολών πληρωμής με τις οποίες συνδέεται η ανάθεση.
pageable Object Πληροφορίες Σελιδοποίησης της απάντησης.
last Boolean Υποδεικνύει εάν είναι η τελευταία σελίδα της απάντησης.
totalPages Integer Ο Συνολικός αριθμός τως Σελίδων.
totalElements Integer Ο Συνολικός αριθμός των αποτελεσμάτων με βάση τα κρητήρια αναζήτησης.
first Boolean Υποδεικνύει εάν είναι η πρώτη Σελίδα αποτελεσμάτων.
numberOfElements Integer Ο αριθμός των αποτελεσμάτων για την τρέχουσα σελίδα.
size Integer Ο προκαθορισμένος αριθμός αποτελεσμάτων ανα σελίδα.
number Integer Ο τρέχον αριθμός σελίδας.
sort Object Πληροφορίες ταξινόμησης που εφαρμόστηκε.
empty Boolean True μόνο εάν δεν υπάρχουν αποτελέσματα. False αν υπάρχουν αποτελέσματα.

Ανάκτηση αρχείου Ανάθεσης

GET /khmdhs-opendata/auction/attachment/{referenceNumber}

Περιγραφή

Ανακτά ένα έγγραφο PDF που αφορά μια συγκεκριμένη Ανάθεση, που προσδιορίζεται από τον κωδικό ΑΔΑΜ {referenceNumber}.

Παράμετρος

  • referenceNumber (string): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του συνημμένου αρχείου Ανάθεσης.

Παράδειγμα Κλήσης

GET [API_BASE_URL]/khmdhs-opendata/auction/attachment/24AWRD009215205

Απάντηση

Επιστρέφει ένα PDF αρχείο:

  • Content-Type: application/pdf
  • Body: Δυαδικό περιεχόμενο byte[] του αρχείου PDF.

Παράδειγμα cURL Εντολής

curl -o attachment.pdf [API_BASE_URL]/khmdhs-opendata/auction/attachment/24AWRD009215205

Καταχώρηση Αναθέσεων

Η λειτουργικότητα της υποβολής Αναθέσεων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Ανάθεσης μέσω REST κλήσης POST, με επισύναψη PDF αρχείου.
  • Προστασία μέσω Basic Authentication για διασφάλιση πρόσβασης μόνο σε εξουσιοδοτημένους χρήστες.

POST /khmdhs-api/auction

Περιγραφή

Η κλήση επιτρέπει την καταχώρηση μιας Ανάθεσης και τη μεταφόρτωση σχετικού αρχείου PDF.

Παράμετροι Κλήσης

  • file (MultipartFile, required): Το PDF αρχείο που συνοδεύει την Ανάθεση. Το αρχείο πρέπει να είναι έγκυρο και σε μορφή PDF.
  • request (String, required): Ένα αντικείμενο JSON που περιέχει τα δεδομένα της Ανάθεσης.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:

{
  "amendPreviousAuction": false,
  "amendedAuctionADAM": "",
  "title": "TEST",
  "signedDate": "2025-09-23",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "contractType": "10",
  "additionalContractTypes": [
    "1"
  ],
  "centralizedMarkets": ["1"],
  "legalContext": "4",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "budget": 2000,
  "aaht": "1234",
  "procedureType": "1",
	"awardProcedure": null,
  "numberOfSections": "2",
  "criteriaCode": "4",
  "assignedContract": "1",
  "socialContract": "1",
	"centralGovernmentAuthority": "1",
	"contractDuration": 2,
    "contractDurationUnitOfMeasure": "2",
	"contractingAuthorityActivity": "8",
  "contractingMembersDataList": [
      {
        "vatNumber": "123",
        "greekVatNumber": false,
        "name": "string",
        "nutsCode": "FRK",
        "installationCountry": "AS"
      }
    ],
  "objectDetailsList": [
    {
      "quantity": 10,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "Test",
      "cpvs": [
        "34144910-0"
      ],
      "greenContracts": "1",
      "goodServices": "",
      "requestAdam": "",
      "noticeAdam": ""
    },
    {
      "quantity": 2,
      "costWithoutVAT": 5543,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "Test",
      "cpvs": [
        "34144910-0"
      ],
      "greenContracts": "1",
      "goodServices": "",
      "requestAdam": "",
      "noticeAdam": ""
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
greekOrganizationVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
organizationVatNumber string ΑΦΜ Φορέα.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
nutsCity string Πόλη.
nutsPostalCode string Ταχυδρομικός Κώδικας.
nutsCountry string Χώρα Αναθέτουσας Αρχής.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
contractingData Object Δεδομένα αναθέτουσας αρχής.
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε τον κωδικό της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
amendPreviousAuction Boolean Εάν τροποποιείται προηγούμενη ειδοποίηση.
amendedAuctionADAM string ΑΔΑΜ της τροποποιημένης πράξης.
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"3" για Ηλεκτρονικός Κατάλογος,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"8" για Δεν χρησιμοποιείται
legalContext string Νομικό πλαίσιο. Συμπληρώστε:
"4" για ν.4412/2016 - Βιβλίο Ι - άνω των ορίων,
"5" για ν.4412/2016 - Βιβλίο Ι - κάτω των ορίων,
"6" για ν.4412/2016 - Βιβλίο ΙΙ - άνω των ορίων,
"7" για ν.4412/2016 - Βιβλίο ΙΙ - κάτω των ορίων,
"10" ν.4413/2016 - Παραχωρήσεις
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"8" για ΕΚΑΑ ή ΚΑΑ,
"9" για ΝΠΔΔ,
"10" για ΝΠΙΔ,
"12" για Κεντρική Διοίκηση,
"13" για Ανεξάρτητη αρχή (με νομική προσωπικότητα)
budget BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"2" για Κλειστή διαδικασία,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"11" για Σύμπραξη καινοτομίας,
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"18" για Διαδικασία άρθρου 128 του ν.4412/16
awardProcedure string Αιτιολόγηση διαδικασίας ανάθεσης. Συμπληρώστε:
Για Διαδικασία ανάθεσης "2" ή "3":
"51" για Οι ανάγκες δεν μπορούν να ικανοποιηθούν χωρίς προσαρμογή των άμεσα διαθέσιμων λύσεων,
"52" για Το αντικείμενο της σύμβασης περιλαμβάνει σχεδιασμό ή καινοτόμες λύσεις,
"53" για Συντρέχουν ειδικές περιστάσεις σχετικά με το αντικείμενο της σύμβασης,
"54" για Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια,
"55" για Άγονη διαδικασία ανάθεσης σύμβασης,

Για Διαδικασία ανάθεσης "7":
"56" για Άγονη διαδικασία ανάθεσης σύμβασης,
"57" για Μοναδικό έργο τέχνης ή καλλιτεχνική εκδήλωση,
"58" για Απουσία ανταγωνισμού για τεχνικούς λόγους,
"59" για Προστασία αποκλειστικών δικαιωμάτων,
"60" για Κατεπείγουσα ανάγκη οφειλόμενη σε γεγονότα απρόβλεπτα για την αναθέτουσα αρχή
numberOfSections BigDecimal Αριθμός τμημάτων.
criteriaCode string Κριτήριο ανάθεσης.
"1" για Βάσει κόστους - βέλτιστη σχέση ποιότητας τιμής
"2" για Βάσει τιμής "3" για Βάσει κόστους - κοστολόγηση κύκλου ζωής "4" για Βάσει τιμής - άλλο
assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα.
socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες.
"1" για Ναι,
"2" για Όχι
centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή.
"1" για Ναι,
"2" για Όχι
contractDuration BigDecimal Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης:
"1" Ημέρες,
"2" Εβδομάδες,
"3" Μήνες,
"4" Έτη
contractingAuthorityActivity string Δραστηριότητα αναθέτουσας αρχής. Συμπληρώστε:
"1" για Γενικές δημόσιες υπηρεσίες,
"2" για Άμυνα,
"3" για Δημόσια τάξη και ασφάλεια,
"4" για Περιβάλλον,
"5" για Οικονομικές και δημοσιονομικές υποθέσεις,
"6" για Υγεία,
"7" για Στέγαση και υποδομές κοινής ωφέλειας,
"8" για Κοινωνική προστασία,
"9" για Αναψυχή,
"10" για Πολιτισμός και θρησκεία,
"11" για Εκπαίδευση,
"12" για Τυχόν άλλη δραστηριότητα,
"13" Αναζήτηση ή εξόρυξη άνθρακα και άλλων στερεών καυσίμων,
"14" Δραστηριότητες που αφορούν την ηλεκτροδότηση,
"15" Δραστηριότητες που αφορούν την ύδρευση,

"16" Δραστηριότητες που αφορούν τους αερολιμένες,
"17" Δραστηριότητες που αφορούν τους λιμένες,
"18" Εξόρυξη φυσικού αερίου ή πετρελαίου,
"19" Μεταφορές με αστικό σιδηρόδρομο, τραμ, τρόλεϊ ή λεωφορείο,
"20" Παραγωγή, μεταφορά ή διανομή αερίου ή θερμότητας,
"21" Σιδηροδρομικές υπηρεσίες,
"22" Ταχυδρομικές υπηρεσίες
contractingMembersDataList Array Στοιχεία Αναδόχου.
contractingMembersDataList.vatNumber string ΑΦΜ Αναδόχου.
contractingMembersDataList.greekVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
contractingMembersDataList.name string Επωνυμία Αναδόχου.
contractingMembersDataList.nutsCode string Γεωγραφική Περιοχή Έδρας Αναδόχου.
Συμπληρώστε την Γεωγραφική Περιοχή Έδρας Αναδόχου.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
contractingMembersDataList.installationCountry string Χώρα καταγωγής/εγκατάστασης του αναδόχου.
Συμπληρώστε την Χώρα καταγωγής/εγκατάστασης του αναδόχου.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.requestAdam String Μοναδικός Κωδικός - ΑΔΑΜ Εγκεκριμένου Αιτήματος που σχετίζεται με την Ανάθεση.
objectDetailsList.noticeAdam String Μοναδικός Κωδικός - ΑΔΑΜ Πρόσκλησης-Προκήρυξης-Διακήρυξης που σχετίζεται με την Ανάθεση.
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.greenContracts string Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
Συμπληρώστε:
"1" για Δεν εμπίπτει στο ΕΣΔ
"2" για Εμπίπτει στο ΕΣΔ - Δεν έχουν υιοθετηθεί τα ΠΚ
"3" για Εμπίπτει στο ΕΣΔ - Έχουν υιοθετηθεί τα ΠΚ
objectDetailsList.goodServices string Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ. Συμπληρώστε:
"101" για Χαρτί́ από́ ανακτημένες ίνες,
"102" για Χαρτί από παρθένες ίνες αειφόρου συγκομιδής,
"103" για Ηλεκτρονικοί υπολογιστές,
"104" για Οθόνες,
"105" για "Εξοπλισμός απεικόνισης (εκτυπωτές, σαρωτές, πολυμηχανήματα φωτοαντιγραφής, εκτύπωσης και σάρωσης)",
"106" για Εσωτερικός φωτισμός - Λαμπτήρες LED,
"107" για Κλιματιστικά́ μηχανήματα,
"108" για Λιπαντικά́ Αναγεννημένα,
"109" για Λιπαντικά Βιοαποικοδομήσιμα,
"110" για Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς),
"111" για Οδοφωτισμός και σηματοδότες κυκλοφορίας (αφορά́ οδούς αρμοδιότητας Δήμων και Περιφερειών),
"112" για Έπιπλα,
"113" για Προϊόντα κλωστοϋφαντουργίας,
"114" για "Προϊόντα και υπηρεσίες συντήρησης εξωτερικών δημόσιων χώρων (Καθαρισμός, κηπουρική́)",
"115" για Υποδομές διαχείρισης λυμάτων,
"116" για Ηλεκτρικός και ηλεκτρονικός εξοπλισμός χρησιμοποιούμενος στον τομέα της υγειονομικής περίθαλψης (Υγειονομικός ΗΗΕ),
"117" για "Σχεδιασμός οδοποιίας, κατασκευή́ και συντήρηση",
"118" για "Σχεδιασμός κτιρίων γραφείων, κατασκευή́ και διαχείριση"


Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε τον Τίτλο (title).
Ο Τίτλος (title) πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
signedDate Παρακαλώ δώστε την ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate).
Η ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate) πρέπει να είναι προγενέστερη ή ίση της σημερινής.		 Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ του οργανισμού (greekOrganizationVatNumber) είναι ελληνικός. Ναι
organizationVatNumber Ο ΑΦΜ του οργανισμού (organizationVatNumber) πρέπει να μην είναι κενός και να περιέχει αριθμούς.
Ο ΑΦΜ του οργανισμού (organization vat number) πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
nutsCode Παρακαλώ δώστε τον Κωδικό NUTS (nutsCode). Ναι
nutsCity Παρακαλώ δώστε την πόλη Αναθέτουσας Αρχής (nutsCity). Ναι
nutsPostalCode Παρακαλώ δώστε τον ΤΚ Αναθέτουσας Αρχής (nutsPostalCode). Ναι
nutsCountry Παρακαλώ δώστε την Χώρα Αναθέτουσας Αρχής (nutsCountry). Ναι
contractingData Παρακαλώ δώστε Δεδομένα Αναθέτουσας Αρχής (contractingData). Ναι
contractType Παρακαλώ δώστε τον Κύριο Χαρακτήρα Σύμβασης (contractType). Ναι
amendPreviousAuction Παρακαλώ δηλώστε αν πρόκειται για Τροποποίηση (amendPreviousAuction) Ναι
amendedAuctionADAM Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενός. Όχι
centralizedMarkets Παρακαλώ δώστε τον Κωδικό Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralizedMarkets). Ναι
legalContext Παρακαλώ δώστε τον Κωδικό Νομικού Πλαισίου (legalContext).
Το Νομικό Πλαίσιο (legalContext) πρέπει να είναι θετικός αριθμός που δεν είναι κενό		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization).
Η Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization) πρέπει να είναι θετικός αριθμός που δεν είναι κενό.		 Ναι
typeOfContractingAuthority Παρακαλώ δώστε τον Τύπο Αναθέτουσας Αρχής (typeOfContractingAuthority).
Ο Τύπος Αναθέτουσας Αρχής (typeOfContractingAuthority) πρέπει να είναι θετικός αριθμός που δεν είναι κενό.		 Ναι
budget Παρακαλώ δώστε την Συνολική Εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ (budget).
Η Συνολική Εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ (budget) πρέπει να έχει έως 30 ψηφία συνολικά με έως 2 δεκαδικά.		 Ναι
aaht Παρακαλώ δώστε τον Κωδικό Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht).
Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
procedureType Παρακαλώ δώστε τον Τύπο Διαδικασίας (procedureType).
Ο Τύπος Διαδικασίας (procedureType) πρέπει να είναι θετικός αριθμός που δεν είναι κενό.		 Ναι
awardProcedure H Αιτιολόγηση διαδικασίας ανάθεσης (awardProcedure) πρέπει να είναι θετικός αριθμός που δεν είναι κενό. Όχι
numberOfSections Παρακαλώ δώστε τον Αριθμό Τμημάτων (numberOfSections).
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να είναι θετικός αριθμός.
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να έχει έως 30 ψηφία συνολικά.		 Ναι
criteriaCode Παρακαλώ δώστε τον Κωδικό Κριτηρίων ανάθεσης (criteriaCode).
Ο Κωδικός Κριτηρίων ανάθεσης (criteriaCode) πρέπει να είναι θετικός αριθμός που δεν είναι κενός		 Ναι
contractDuration Παρακαλώ δώστε τη Διάρκεια Σύμβασης (contractDuration).
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να είναι θετικός αριθμός
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να έχει έως 30 ψηφία συνολικά		 Ναι
contractDurationUnitOfMeasure Παρακαλώ δώστε τη Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure).
Η Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure) πρέπει να είναι θετικός αριθμός		 Ναι
contractingAuthorityActivity Παρακαλώ δώστε την Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity).
Η Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity) πρέπει να είναι θετικός αριθμός.		 Ναι
assignedContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract).
Η Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract) πρέπει να είναι θετικός αριθμός		 Ναι
socialContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract).
Η Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract) πρέπει να είναι θετικός αριθμός		 Ναι
centralGovernmentAuthority Παρακαλώ δηλώστε αν πρόκειται για Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority).
Η Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
contractingMembersDataList Παρακαλώ δώστε τα Στοιχεία Αναδόχου (contractingMembersDataList). Ναι
contractingMembersDataList.vatNumber Παρακαλώ δώστε τον ΑΦΜ Αναδόχου (vatNumber).
Ο ΑΦΜ Αναδόχου (vatNumber) πρέπει να μην είναι κενός και να περιέχει αριθμούς.
Ο ΑΦΜ Αναδόχου (vatNumber) πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
contractingMembersDataList.greekVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Αναδόχου (greekVatNumber) είναι ελληνικός. Ναι
contractingMembersDataList.name Παρακαλώ δώστε η Επωνυμία Αναδόχου (name).
Η Επωνυμία Αναδόχου (name) πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
contractingMembersDataList.nutsCode Παρακαλώ δώστε την Γεωγραφική Περιοχή Έδρας Αναδόχου (nutsCode) Ναι
contractingMembersDataList.installationCountry Παρακαλώ δώστε τη Χώρα καταγωγής /εγκατάστασης του οικονομικού φορέα (installationCountry) Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένων (objectDetailsList). Ναι
objectDetailsList.requestAdam Ο ΑΔΑΜ (requestAdam) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενός.
Ο ΑΔΑΜ (requestAdam) θα πρέπει να υπάρχει και να μην έχει ακυρωθεί.		 Όχι
objectDetailsList.noticeAdam Ο ΑΔΑΜ (noticeAdam) θα πρέπει να έχει σωστή μορφή (##PROC#########) ή να είναι κενός.
Ο ΑΔΑΜ (noticeAdam) θα πρέπει να υπάρχει και να μην έχει ακυρωθεί.		 Όχι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα (quantity) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε η Συνολική αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Η Συνολική αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 1200 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.greenContracts Παρακαλώ δώστε τον Κωδικό για την Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (goodServices)
Η Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (goodServices) πρέπει να είναι θετικός αριθμός		 Ναι
objectDetailsList.goodServices Οι Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ (goodServices) πρέπει να είναι θετικός αριθμός Όχι αν δεν εμπίπτουν στο ΕΣΔ οι Πράσινες Δημόσιες Συμβάσεις

Παράδειγμα Κλήσης

POST /khmdhs-api/auction
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: multipart/form-data;

 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="file"; filename="document.pdf"
Content-Type: application/pdf

<binary file content>
 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="auction"

{
  "amendPreviousAuction": false,
  "amendedAuctionADAM": "",
  "title": "TEST",
  "signedDate": "2025-09-23",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "contractType": "10",
  "additionalContractTypes": [
    "1"
  ],
  "centralizedMarkets": ["1"],
  "legalContext": "4",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "budget": 2000,
  "aaht": "1234",
  "procedureType": "1",
  "awardProcedure": null,
  "numberOfSections": "2",
  "criteriaCode": "4",
  "assignedContract": "1",
  "socialContract": "1",
	"centralGovernmentAuthority": "1",
	"contractDuration": 2,
    "contractDurationUnitOfMeasure": "1",
	"contractingAuthorityActivity": "8",
  "contractingMembersDataList": [
      {
        "vatNumber": "123",
        "greekVatNumber": false,
        "name": "string",
        "nutsCode": "FRK",
        "installationCountry": "AS"
      }
    ],
  "objectDetailsList": [
    {
      "quantity": 10,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "Test",
      "cpvs": [
        "34144910-0"
      ],
      "greenContracts": "1",
      "goodServices": "",
      "requestAdam": "",
      "noticeAdam": ""
    },
    {
      "quantity": 2,
      "costWithoutVAT": 5543,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "Test",
      "cpvs": [
        "34144910-0"
      ],
      "greenContracts": "1",
      "goodServices": "",
      "requestAdam": "",
      "noticeAdam": ""
    }
  ]
}
 -----------------------------boundary-----------------------------

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης

{
        "referenceNumber": "24AWRD009216531"
}
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.
  • Η παράμετρος file πρέπει να περιέχει έγκυρο PDF αρχείο.

Επεξεργασία Αναθέσεων

Η λειτουργικότητα της επεξεργασίας Αναθέσεων αποτελείται από τα εξής μέρη:

  • Επεξεργασία δεδομένων Επεξεργασίας Αναθέσεων μέσω REST κλήσης PUT.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PUT /khmdhs-api/auction/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την επεξεργασία μιας Ανάθεσης.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Ανάθεσης προς επεξεργασία.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:

                    
{
  "amendPreviousAuction": false,
  "amendedAuctionADAM": "",
  "title": "TEST",
  "signedDate": "2025-09-23",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "contractType": "10",
  "additionalContractTypes": [
    "1"
  ],
  "centralizedMarkets": ["1"],
  "legalContext": "4",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "budget": 2000,
  "aaht": "1234",
  "procedureType": "1",
	"awardProcedure": null,
  "numberOfSections": "2",
  "criteriaCode": "4",
  "assignedContract": "1",
  "socialContract": "1",
  "centralGovernmentAuthority": "1",
  "contractDuration": 2,
  "contractDurationUnitOfMeasure": "2",
  "contractingAuthorityActivity": "8",
  "contractingMembersDataList": [
      {
        "vatNumber": "123",
        "greekVatNumber": false,
        "name": "string",
        "nutsCode": "FRK",
        "installationCountry": "AS"
      }
    ],
  "objectDetailsList": [
    {
      "quantity": 10,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "Test",
      "cpvs": [
        "34144910-0"
      ],
      "greenContracts": "1",
      "goodServices": ""
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
amendPreviousAuction Boolean Εάν τροποποιείται προηγούμενη ειδοποίηση.
amendedAuctionADAM string ΑΔΑΜ της τροποποιημένης πράξης.
title string Τίτλος.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
greekOrganizationVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
organizationVatNumber string ΑΦΜ φορέα.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
nutsCity string Πόλη.
nutsPostalCode string Ταχυδρομικός Κώδικας.
nutsCountry string Χώρα Αναθέτουσας Αρχής.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
additionalContractTypes string Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
contractingData Object Δεδομένα αναθέτουσας αρχής.
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε τον κωδικό της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"8" για Δεν χρησιμοποιείται,
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"3" για Ηλεκτρονικός Κατάλογος
legalContext string Νομικό πλαίσιο. Συμπληρώστε:
"4" για ν.4412/2016 - Βιβλίο Ι - άνω των ορίων,
"5" για ν.4412/2016 - Βιβλίο Ι - κάτω των ορίων,
"6" για ν.4412/2016 - Βιβλίο ΙΙ - άνω των ορίων,
"7" για ν.4412/2016 - Βιβλίο ΙΙ - κάτω των ορίων,
"10" ν.4413/2016 - Παραχωρήσεις
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"1" για ΕΚΑΑ ή ΚΑΑ,
"2" για Κεντρική Διοίκηση,
"3" για ΝΠΔΔ,
"4" για ΝΠΙΔ,
"5" για Ανεξάρτητη αρχή
budget BigDecimal Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"18" για Διαδικασία άρθρου 128 του ν.4412/16,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"2" για Κλειστή διαδικασία,
"11" για Σύμπραξη καινοτομίας
awardProcedure string Αιτιολόγηση διαδικασίας ανάθεσης. Συμπληρώστε:
Για Διαδικασία ανάθεσης "2" ή "3":
"51" για Οι ανάγκες δεν μπορούν να ικανοποιηθούν χωρίς προσαρμογή των άμεσα διαθέσιμων λύσεων,
"52" για Το αντικείμενο της σύμβασης περιλαμβάνει σχεδιασμό ή καινοτόμες λύσεις,
"53" για Συντρέχουν ειδικές περιστάσεις σχετικά με το αντικείμενο της σύμβασης,
"54" για Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια,
"55" για Άγονη διαδικασία ανάθεσης σύμβασης,

Για Διαδικασία ανάθεσης "7":
"56" για Άγονη διαδικασία ανάθεσης σύμβασης,
"57" για Μοναδικό έργο τέχνης ή καλλιτεχνική εκδήλωση,
"58" για Απουσία ανταγωνισμού για τεχνικούς λόγους,
"59" για Προστασία αποκλειστικών δικαιωμάτων,
"60" για Κατεπείγουσα ανάγκη οφειλόμενη σε γεγονότα απρόβλεπτα για την αναθέτουσα αρχή
numberOfSections BigDecimal Αριθμός τμημάτων.
criteriaCode string Κριτήριο ανάθεσης.
"1" για Βάσει κόστους - βέλτιστη σχέση ποιότητας τιμής
"2" για Βάσει τιμής "3" για Βάσει κόστους - κοστολόγηση κύκλου ζωής "4" για Βάσει τιμής - άλλο
assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα.
socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες.
"1" για Ναι,
"2" για Όχι
centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή.
"1" για Ναι,
"2" για Όχι
contractDuration BigDecimal Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης:
"1" Ημέρες,
"2" Εβδομάδες,
"3" Μήνες,
"4" Έτη
contractingAuthorityActivity string Δραστηριότητα αναθέτουσας αρχής. Συμπληρώστε:
"1" για Γενικές δημόσιες υπηρεσίες,
"2" για Άμυνα,
"3" για Δημόσια τάξη και ασφάλεια,
"4" για Περιβάλλον,
"5" για Οικονομικές και δημοσιονομικές υποθέσεις,
"6" για Υγεία,
"7" για Στέγαση και υποδομές κοινής ωφέλειας,
"8" για Κοινωνική προστασία,
"9" για Αναψυχή,
"10" για Πολιτισμός και θρησκεία,
"11" για Εκπαίδευση,
"12" για Τυχόν άλλη δραστηριότητα,
"13" Αναζήτηση ή εξόρυξη άνθρακα και άλλων στερεών καυσίμων,
"14" Δραστηριότητες που αφορούν την ηλεκτροδότηση,
"15" Δραστηριότητες που αφορούν την ύδρευση,

"16" Δραστηριότητες που αφορούν τους αερολιμένες,
"17" Δραστηριότητες που αφορούν τους λιμένες,
"18" Εξόρυξη φυσικού αερίου ή πετρελαίου,
"19" Μεταφορές με αστικό σιδηρόδρομο, τραμ, τρόλεϊ ή λεωφορείο,
"20" Παραγωγή, μεταφορά ή διανομή αερίου ή θερμότητας,
"21" Σιδηροδρομικές υπηρεσίες,
"22" Ταχυδρομικές υπηρεσίες
contractingMembersDataList Array Στοιχεία Αναδόχου.
contractingMembersDataList.vatNumber string ΑΦΜ Αναδόχου.
contractingMembersDataList.greekVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
contractingMembersDataList.name string Επωνυμία Αναδόχου.
contractingMembersDataList.nutsCode string Γεωγραφική Περιοχή Έδρας Αναδόχου.
Συμπληρώστε την Γεωγραφική Περιοχή Έδρας Αναδόχου.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
contractingMembersDataList.installationCountry string Χώρα καταγωγής/εγκατάστασης του αναδόχου.
Συμπληρώστε την Χώρα καταγωγής/εγκατάστασης του αναδόχου.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.greenContracts string Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
Συμπληρώστε:
"1" για Δεν εμπίπτει στο ΕΣΔ
"2" για Εμπίπτει στο ΕΣΔ - Δεν έχουν υιοθετηθεί τα ΠΚ
"3" για Εμπίπτει στο ΕΣΔ - Έχουν υιοθετηθεί τα ΠΚ
objectDetailsList.goodServices string Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ. Συμπληρώστε:
"101" για Χαρτί́ από́ ανακτημένες ίνες,
"102" για Χαρτί από παρθένες ίνες αειφόρου συγκομιδής,
"103" για Ηλεκτρονικοί υπολογιστές,
"104" για Οθόνες,
"105" για "Εξοπλισμός απεικόνισης (εκτυπωτές, σαρωτές, πολυμηχανήματα φωτοαντιγραφής, εκτύπωσης και σάρωσης)",
"106" για Εσωτερικός φωτισμός - Λαμπτήρες LED,
"107" για Κλιματιστικά́ μηχανήματα,
"108" για Λιπαντικά́ Αναγεννημένα,
"109" για Λιπαντικά Βιοαποικοδομήσιμα,
"110" για Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς),
"111" για Οδοφωτισμός και σηματοδότες κυκλοφορίας (αφορά́ οδούς αρμοδιότητας Δήμων και Περιφερειών),
"112" για Έπιπλα,
"113" για Προϊόντα κλωστοϋφαντουργίας,
"114" για "Προϊόντα και υπηρεσίες συντήρησης εξωτερικών δημόσιων χώρων (Καθαρισμός, κηπουρική́)",
"115" για Υποδομές διαχείρισης λυμάτων,
"116" για Ηλεκτρικός και ηλεκτρονικός εξοπλισμός χρησιμοποιούμενος στον τομέα της υγειονομικής περίθαλψης (Υγειονομικός ΗΗΕ),
"117" για "Σχεδιασμός οδοποιίας, κατασκευή́ και συντήρηση",
"118" για "Σχεδιασμός κτιρίων γραφείων, κατασκευή́ και διαχείριση"


Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
amendPreviousAuction Παρακαλώ δηλώστε αν πρόκειται για Τροποποίηση (amendPreviousAuction) Ναι
amendedAuctionADAM Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενός. Όχι
title Παρακαλώ δώστε τον Τίτλο (title).
Ο Τίτλος (title) πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
signedDate Παρακαλώ δώστε την ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate).
Η ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate) πρέπει να είναι προγενέστερη ή ίση της σημερινής.		 Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ του οργανισμού (greekOrganizationVatNumber) είναι ελληνικός. Ναι
organizationVatNumber Ο ΑΦΜ του οργανισμού (organizationVatNumber) πρέπει να μην είναι κενός και να περιέχει αριθμούς.
Ο ΑΦΜ του οργανισμού (organization vat number) πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
nutsCode Παρακαλώ δώστε τον Κωδικό NUTS (nutsCode). Ναι
nutsCity Παρακαλώ δώστε την πόλη Αναθέτουσας Αρχής (nutsCity). Ναι
nutsPostalCode Παρακαλώ δώστε τον ΤΚ Αναθέτουσας Αρχής (nutsPostalCode). Ναι
nutsCountry Παρακαλώ δώστε την Χώρα Αναθέτουσας Αρχής (nutsCountry). Ναι
contractingData Παρακαλώ δώστε Δεδομένα Αναθέτουσας Αρχής (contractingData). Ναι
contractType Παρακαλώ δώστε τον Κύριο Χαρακτήρα Σύμβασης (contractType). Ναι
centralizedMarkets Παρακαλώ δώστε τον Κωδικό Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralizedMarkets). Ναι
legalContext Παρακαλώ δώστε τον Κωδικό Νομικού Πλαισίου (legalContext).
Το Νομικό Πλαίσιο (legalContext) πρέπει να είναι θετικός αριθμός που δεν είναι κενό		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization).
Η Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization) πρέπει να είναι θετικός αριθμός που δεν είναι κενό.		 Ναι
typeOfContractingAuthority Παρακαλώ δώστε τον Τύπο Αναθέτουσας Αρχής (typeOfContractingAuthority).
Ο Τύπος Αναθέτουσας Αρχής (typeOfContractingAuthority) πρέπει να είναι θετικός αριθμός που δεν είναι κενό.		 Ναι
budget Παρακαλώ δώστε τον Προϋπολογισμό (budget).
Η Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ (budget) πρέπει να έχει έως 30 ψηφία συνολικά με έως 2 δεκαδικά.		 Ναι
aaht Παρακαλώ δώστε τον Κωδικό Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht).
Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
procedureType Παρακαλώ δώστε τον Τύπο Διαδικασίας (procedureType).
Ο Τύπος Διαδικασίας (procedureType) πρέπει να είναι θετικός αριθμός που δεν είναι κενό.		 Ναι
awardProcedure H Αιτιολόγηση διαδικασίας ανάθεσης (awardProcedure) πρέπει να είναι θετικός αριθμός που δεν είναι κενό. Όχι
numberOfSections Παρακαλώ δώστε τον Αριθμό Τμημάτων (numberOfSections).
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να είναι θετικός αριθμός.
Ο Αριθμός Τμημάτων (numberOfSections) πρέπει να έχει έως 30 ψηφία συνολικά.		 Ναι
criteriaCode Παρακαλώ δώστε τον Κωδικό Κριτηρίων ανάθεσης (criteriaCode).
Ο Κωδικός Κριτηρίων ανάθεσης (criteriaCode) πρέπει να είναι θετικός αριθμός που δεν είναι κενός		 Ναι
contractDuration Παρακαλώ δώστε τη Διάρκεια Σύμβασης (contractDuration).
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να είναι θετικός αριθμός
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να έχει έως 30 ψηφία συνολικά		 Ναι
contractDurationUnitOfMeasure Παρακαλώ δώστε τη Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure).
Η Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure) πρέπει να είναι θετικός αριθμός		 Ναι
contractingAuthorityActivity Παρακαλώ δώστε την Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity).
Η Δραστηριότητα αναθέτουσας αρχής (contractingAuthorityActivity) πρέπει να είναι θετικός αριθμός.		 Ναι
assignedContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract).
Η Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract) πρέπει να είναι θετικός αριθμός		 Ναι
socialContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract).
Η Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract) πρέπει να είναι θετικός αριθμός		 Ναι
centralGovernmentAuthority Παρακαλώ δηλώστε αν πρόκειται για Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority).
Η Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
contractingMembersDataList Παρακαλώ δώστε τα Στοιχεία Αναδόχου (contractingMembersDataList). Ναι
contractingMembersDataList.vatNumber Παρακαλώ δώστε τον ΑΦΜ Αναδόχου (vatNumber).
Ο ΑΦΜ Αναδόχου (vatNumber) πρέπει να μην είναι κενός και να περιέχει αριθμούς.
Ο ΑΦΜ Αναδόχου (vatNumber) πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
contractingMembersDataList.greekVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Αναδόχου (greekVatNumber) είναι ελληνικός. Ναι
contractingMembersDataList.name Παρακαλώ δώστε η Επωνυμία Αναδόχου (name).
Η Επωνυμία Αναδόχου (name) πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
contractingMembersDataList.nutsCode Παρακαλώ δώστε την Γεωγραφική Περιοχή Αναδόχου (nutsCode) Ναι
contractingMembersDataList.installationCountry Παρακαλώ δώστε τη Χώρα καταγωγής/εγκατάστασης του αναδόχου (installationCountry) Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένων (objectDetailsList). Ναι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα (quantity) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε η Συνολική αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Η Συνολική αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 1200 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.greenContracts Παρακαλώ δώστε τον Κωδικό για την Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (goodServices)
Η Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (goodServices) πρέπει να είναι θετικός αριθμός		 Ναι
objectDetailsList.goodServices Οι Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ (goodServices) πρέπει να είναι θετικός αριθμός Όχι αν δεν εμπίπτουν στο ΕΣΔ οι Πράσινες Δημόσιες Συμβάσεις

Παράδειγμα Κλήσης

                    
PUT /khmdhs-api/auction/{referenceNumber}
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: application/json


{
  "title": "TEST",
  "signedDate": "2025-09-23",
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
  "contractingData": {
      "unitsOperator": "100029237",
      "signers": "100059416"
  },
  "contractType": "10",
  "additionalContractTypes": [
    "1"
  ],
  "centralizedMarkets": ["1"],
  "legalContext": "4",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "budget": 2000,
  "aaht": "1234",
  "procedureType": "1",
	"awardProcedure": null,
  "numberOfSections": "2",
  "criteriaCode": "4",
  "assignedContract": "1",
  "socialContract": "1",
	"centralGovernmentAuthority": "1",
	"contractDuration": 2,
    "contractDurationUnitOfMeasure": "1",
	"contractingAuthorityActivity": "8",
  "contractingMembersDataList": [
      {
        "vatNumber": "123",
        "greekVatNumber": false,
        "name": "string",
        "nutsCode": "FRK",
        "installationCountry": "AS"
      }
    ],
  "objectDetailsList": [
    {
      "quantity": 10,
      "costWithoutVAT": 1000,
      "type": "KGM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "Test",
      "cpvs": [
        "34144910-0"
      ],
      "greenContracts": "1",
      "goodServices": ""
    }
  ]
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
message String Μήνυμα επιβεβαίωσης ακύρωσης.

Παράδειγμα Απάντησης

                    
    {
        "message": "Η πράξη με ΑΔΑΜ 25AWRD009223795 ενημερώθηκε με επιτυχία."
    }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ακύρωση Αναθέσεων

Η λειτουργικότητα της ακύρωσης ανάθεσης αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Ακύρωσης Ανάθεσης μέσω REST κλήσης PATCH.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PATCH /khmdhs-api/auction/cancel/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την ακύρωση μιας Ανάθεσης.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Ανάθεσης προς ακύρωση.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

                        {
                            "type": "3",
                            "reason": "Test",
                            "cancellationADA": "rt45234"
                        }

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
type string Είδος ακύρωσης. Συμπληρώστε:
"3" για Ακύρωση λόγω λανθασμένης καταχώρησης,
"4" για Ανάκληση
reason string Περιγραφή.
cancellationADA string ΑΔΑ απόφασης Ανάκλησης.

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
type Παρακαλώ δώστε το Είδος ακύρωσης (type). Ναι
reason Παρακαλώ δώστε την Περιγραφή (reason). Ναι
cancellationADA - Όχι

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 24AWRD009216531 ακυρώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ανάκτηση Συμβάσεων

Κάθε Σύμβαση αποτελείται από τα εξής μέρη:

  • Ένα σύνολο δεδομένων τα οποία περιγράφουν την Σύμβαση και ανακτώνται με μια REST κλήση POST.
  • Το έγγραφο της Σύμβασης σε μορφή PDF το οποίο μπορεί να ανακτηθεί με μια REST κλήση GET και με τον αριθμό ΑΔΑΜ {referenceNumber} της Σύμβασης.

POST /khmdhs-opendata/contract?page=0

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση σελιδοποιημένων αποτελεσμάτων Συμβάσεων με βάση το request body της κλήσης.

Παράμετροι Κλήσης

  • page (integer, optional): Ο αριθμός σελίδας που θέλετε να ανακτήσετε, ξεκινώντας από το 0. Εάν δεν έχει καθοριστεί, ορίζεται αυτόματα ως προεπιλογή το 0.

Request Body Κλήσης

Το request body της κλήσης θα πρέπει να είναι ένα αντικείμενο JSON που περιέχει τα παρακάτω πεδία:

                        
{
    "title": "string",
    "cpvItems": ["string"],
    "organizations": ["string"],
    "signer": "string",
    "referenceNumber": "string",
    "contractType": "string",
    "dateFrom": "2024-11-22",
    "dateTo": "2024-11-22",
    "totalCostFrom": 1000000000000,
    "totalCostTo": 1000000000000,
    "cancelDateFrom": "2024-11-22",
    "cancelDateTo": "2024-11-22",
    "procedureType": "string",
    "vatNumber": "string",
    "contractorName": "string",
    "aaht": "string",
    "publicFundingRefNum": "string",
    "estTotalCostFrom": 1000000000000,
    "estTotalCostTo": 1000000000000,
    "isModified": false
}
Παρατηρήσεις

  • Αν δεν οριστεί τιμή στο πεδίο dateTo, ενώ έχει οριστεί dateFrom, τότε το σύστημα αυτομάτως θα εισάγει ως τιμή την dateFrom συν 180 μέρες.
  • Αν δεν έχει οριστεί τιμή στο πεδίο dateFrom ενώ έχει οριστεί dateTo, τότε το σύστημα αυτομάτως θα εισάγει την ημερομηνία του dateTo μείον 180 μέρες.
  • Αν δεν έχει οριστεί ούτε dateFrom ούτε dateTo, τότε το σύστημα θα εισάγει ως dateTo την τρέχουσα ημερομηνία και dateFrom την τρέχουσα ημερομηνία μείον 180 μέρες.
  • Αν έχει οριστεί dateFrom και dateTo, αλλά έχουν διαφορά μεγαλύτερη των 180 ημερών, τότε το σύστημα θα εισάγει dateFrom την dateTo μείον 180 μέρες.
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί ούτε cancelDateFrom ούτε cancelDateTo τότε δεν θα υπολογίζεται η Ημερομηνία Ματαίωσης κατά την αναζήτηση. Σε περίπτωση που έχει οριστεί μόνο cancelDateFrom ή μόνο cancelDateΤο η και οι 2 τότε θα ισχύει ο κανόνας τον 180 ημερών όπως περιγράφεται για τα πεδία dateFrom και dateTo
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί το εύρος των cancelDateFrom και cancelDateΤο το σύστημα επιστρέφει και τις Ματαιώσεις με βάση τα υπόλοιπα καθορισμένα κριτήρια αναζήτησης. Αν καθοριστούν τα cancelDateFrom και cancelDateΤο τότε το σύστημα επιστρέφει μόνο πράξεις που έχουν ματαιωθεί.
  • Αν στα κριτήρια αναζήτησης το πεδίο isModified είναι false το σύστημα επιστρέφει όλες τις πράξεις ανεξάρτητα από το αν αφορά τροποποίηση ή όχι. Στην περίπτωση που το πεδίο isModified είναι true τότε επιστρέφει μόνο τροποποιήσεις.


Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
cpvItems Array[String] Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
πχ. "34327200-7" για Άξονες και κιβώτια,
"34711500-9" για Ελικόπτερα
organization Array[String] Αναθέτουσα Αρχή/Αναθέτων Φορέας.
Συμπληρώστε τον κωδικό του Φορέα.
πχ. "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ,
"72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
signer string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
πχ. "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής
referenceNumber string Μοναδικός Κωδικός - ΑΔΑΜ.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
dateFrom string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Από (YYYY-MM-DD).
dateTo string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Έως (YYYY-MM-DD).
cancelDateFrom string Ματαιώσεις Από (YYYY-MM-DD).
cancelDateTo string Ματαιώσεις Έως (YYYY-MM-DD).
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"2" για Κλειστή διαδικασία,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"11" για Σύμπραξη καινοτομίας,
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"18" για Διαδικασία άρθρου 128 του ν.4412/16
totalCostFrom string Συνολική αξία σύμβασης χωρίς ΦΠΑ Από.
totalCostΤο string Συνολική αξία σύμβασης χωρίς ΦΠΑ Έως.
vatNumber string ΑΦΜ Αναδόχου.
contractorName string Επωνυμία Αναδόχου.
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
publicFundingRefNum string Ενάριθμος ΠΔΕ.
estTotalCostFrom string Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Από.
estTotalCostTo string Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Έως.
isModified boolean Τροποποιήσεις (true/false).

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Ο Τίτλος θα πρέπει να έχει μέχρι 100 χαρακτήρες. Όχι
cpvItems Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενό. Όχι
organizations Το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
signer Το πεδίο Αποφαινόμενο όργανο θα πρέπει να είναι ένας θετικός αριθμός ή κενό.
Εάν το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) έχει περισσότερες απο μια τιμή, το Αποφαινόμενο όργανο (signer) πρέπει να είναι κενό.		 Όχι
contractType Το πεδίο Κύριος χαρακτήρας σύμβασης θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
dateFrom / dateTo Η Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ θα πρέπει να έχει μια από τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, YYYY-MM-D). Όχι
totalCostFrom / totalCostTo Συνολική αξία χωρίς ΦΠΑ Από θα πρέπει να είναι ίσο ή μεγαλύτερος από 0. Όχι
cancelDateFrom / cancelDateTo Η Ημερομηνία Ματαίωσης θα πρέπει να έχει μια από τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, YYYY-MM-D). Όχι
referenceNumber Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενό. Όχι
procedureType Το πεδίο Διαδικασία ανάθεσης πρέπει να είναι θετικός αριθμός ή κενό. Όχι
vatNumber Το ΑΦΜ Αναδόχου πρέπει να είναι θετικός αριθμός ή κενό. Όχι
contractorName Η Επωνυμία Αναδόχου πρέπει να είναι μέχρι 30 χαρακτήρες. Όχι
aaht Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής πρέπει να είναι μέχρι 30 χαρακτήρες. Όχι
publicFundingRefNum Ο Ενάριθμος ΠΔΕ πρέπει να είναι μέχρι 30 χαρακτήρες. Όχι
estTotalCostFrom Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ Από θα πρέπει να είναι ίσο ή μεγαλύτερο από 0.
Συνολική εκτιμώμενη αξία χωρίς ΦΠΑ Από θα πρέπει να είναι μικρότερο ή ίσο από 1000000000000.		 Όχι
estTotalCostTo Συνολική εκτιμώμενη αξία σύμβασης χωρίς ΦΠΑ έως θα πρέπει να είναι ίσο ή μεγαλύτερο από 0.
Συνολική εκτιμώμενη αξία χωρίς ΦΠΑ Από θα πρέπει να είναι μικρότερο ή ίσο από 1000000000000.		 Όχι

Παράδειγμα απάντησης σε περίπτωση λανθασμένης τιμής στα πεδία referenceNumber και cpvItems κατά την κλήση:

{
	"errors": {
		"referenceNumber": "Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##SYMV#########) ή να είναι κενό.",
                "cpvItems": "Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενός."
	}
}

Παράδειγμα κλήσης

POST /khmdhs-opendata/contract?page=0
Content-Type: application/json

{
    "title": "ΣΥΜΒΑΣΕΙΣ",
    "cpvItems": ["79822500-7", "34711500-9"],
    "organizations": ["99221938"],
    "referenceNumber": "24SYMV009215539",
    "signer": "100070768",
    "contractType": "1",
    "dateFrom": "2024-01-01",
    "dateTo": "2024-01-10",
    "totalCostFrom": 0,
    "totalCostTo": 1000,
    "cancelDateFrom": "",
    "cancelDateTo": "",
    "procedureType": "19",
    "vatNumber": "",
    "contractorName": "",
    "aaht": "",
    "publicFundingRefNum": "434232",
    "estTotalCostFrom": 0,
    "estTotalCostTo": 1000,
    "isModified": false
}

Παράδειγμα απάντησης


{
	"content": [
		{
			"title": "ΣΥΜΒΑΣΗ",
			"referenceNumber": "25SYMV009217374",
			"prevReferenceNo": null,
			"noticeReferenceNumber": null,
			"submissionDate": "2025-01-22T14:01:03.458",
			"lastUpdateDate": null,
			"contractSignedDate": "2025-01-15",
			"startDate": "2025-01-23",
			"noEndDate": true,
			"endDate": null,
			"cancelled": false,
			"cancellationDate": null,
			"cancellationType": null,
			"cancellationReason": null,
			"cancellationADA": null,
			"decisionRelatedAda": null,
			"contractNumber": "121212",
			"authorEmail": null,
			"organizationVatNumber": "212121",
			"greekOrganizationVatNumber": false,
			"commitmentNo": null,
			"diavgeiaADA": null,
			"aaht": "212",
			"budget": null,
			"contractBudget": 0.1,
			"bidsSubmitted": null,
			"maxbidsSubmitted": 2,
			"numberOfSections": 21,
			"assignedContract": {
				"key": "2",
				"value": "Όχι"
			},
			"socialContract": {
				"key": "2",
				"value": "Όχι"
			},
			"centralGovernmentAuthority": {
				"key": "1",
				"value": "Ναι"
			},
            "contractDuration": 2,
            "additionalContractTypes": null,
			"mixedContract": false,
			"nutsCodes": [
				{
					"nutsCode": {
						"key": "FRF",
						"value": "ALSACE-CHAMPAGNE-ARDENNE-LORRAINE"
					}
				}
			],
			"approvedRequestsList": [],
			"organization": {
				"key": "100015981",
				"value": "ΥΠΟΥΡΓΕΙΟ ΑΓΡΟΤΙΚΗΣ ΑΝΑΠΤΥΞΗΣ ΚΑΙ ΤΡΟΦΙΜΩΝ"
			},
			"procedureType": {
				"key": "7",
				"value": "Ανταγωνιστική διαδικασία με διαπραγμάτευση"
			},
			"awardProcedure": {
				"key": "54",
				"value": "Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια"
			},
			"nutsCode": {
				"key": "FRK21",
				"value": "Ain"
			},
			"nutsCity": "asasa",
			"nutsPostalCode": "2121",
			"nutsCountry": {
				"key": "AQ",
				"value": "Antarctica"
			},
			"centralizedMarkets": [
				{
					"centralizedMarket": {
						"key": "2",
						"value": "Δυναμικό σύστημα αγορών"
					}
				}
			],
			"legalContext": {
				"key": "5",
				"value": "Βιβλίο Ι – κάτω των ορίων"
			},
			"contractType": {
				"key": "12",
				"value": "Μελέτες"
			},
			"assignCriteria": {
				"key": "1",
				"value": "Βάσει κόστους – βέλτιστη σχέση ποιότητας – τιμής"
			},
			"classificationOfPublicLawOrganization": {
				"key": "4",
				"value": "Εκτός Γενικής Κυβέρνησης"
			},
			"typeOfContractingAuthority": {
				"key": "10",
				"value": "ΝΠΙΔ"
			},
			"contractingAuthorityActivity": {
				"key": "9",
				"value": "Αναψυχή"
			},
			"contractDuration": 21,
            "contractDurationUnitOfMeasure": {
                "key": "2",
                "value": "Εβδομάδες"
            },
			"contractRelatedADA": {
				"number1": null,
				"number2": null,
				"number3": "21"
			},
			"fundingDetails": {
				"publicFundingRef": null,
				"publicFundingRefNum": null,
				"publicFundingRefOps": "123",
				"cofundProgramRef": null,
				"selfFundProgramRef": "21",
				"espaFundProgramRef": null,
				"regularBudgetFundedProgramRef": null
			},
			"contractingDataDetails": {
				"unitsOperator": {
					"key": "100047135",
					"value": "ΑΚΟΜΜ ΨΗΛΟΡΕΙΤΗΣ Α.Ε. ΟΤΑ"
				},
				"signers": {
					"key": "100025627",
					"value": "Άννα ΒΟΥΔΟΥΡΗ - Αναπληρωτης Προϊστάμενος Τμήματος"
				},
				"contractingMembersDataList": [
					{
						"country": {
							"key": "CC",
							"value": "Cocos (Keeling) Islands"
						},
						"vatNumber": "2121",
						"greekVatNumber": false,
						"name": "sasasa"
					}
				]
			},
			"totalCostWithVAT": 23.10,
			"totalCostWithoutVAT": 21.00,
			"objectDetailsList": [
				{
					"quantity": 21,
					"type": {
						"key": "KGM",
						"value": "Kg"
					},
					"costWithoutVAT": 21,
					"vat": "10",
					"currency": {
						"key": "EUR",
						"value": "Ευρώ"
					},
					"shortDescription": "qwqwqwq",
					"cpvs": [
						{
							"key": "34321000-3",
							"value": "Άξονες και κιβώτια ταχυτήτων"
						}
					],
					"greenContracts": {
						"key": "1",
						"value": "Δεν εμπίπτει στο ΕΣΔ"
					},
					"goodServices": null,
					"cityOfConstruction": null,
					"countryOfDelivery": {
						"key": "CK",
						"value": "Cook Islands"
					},
					"addressForDelivery": null,
					"postalCode": null,
					"city": "Αθήνα",
					"streetNumber": null,
					"budgetCode": null,
					"requestRefNo": null
				}
			],
			"requestRefNo": null,
 			"nextRefNo": "25SYMV009222939",
			"nextExtended": false,
			"nextModified": true,
			"auctionRefNo": "25AWRD009222920",
			"paymentRefNo": [
			    "25PAY009223018"
			]
		}
	],
	"pageable": {
		"pageNumber": 0,
		"pageSize": 50,
		"sort": {
			"sorted": false,
			"unsorted": true,
			"empty": true
		},
		"offset": 0,
		"paged": true,
		"unpaged": false
	},
	"totalPages": 1,
	"totalElements": 1,
	"last": true,
	"first": true,
	"numberOfElements": 1,
	"size": 50,
	"number": 0,
	"sort": {
		"sorted": false,
		"unsorted": true,
		"empty": true
	},
	"empty": false
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
content Array Λίστα αντικειμένων Συμβάσεων.
content[].title String Τίτλος
content[].referenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ.
content[].prevReferenceNo String Μοναδικός Κωδικός - ΑΔΑΜ απο προηγούμενη πράξη.
content[].noticeReferenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ Πρόσκλησης-Προκήρυξης-Διακήρυξης.
content[].submissionDate DateTime Ημερομηνία υποβολής.
content[].lastUpdateDate DateTime Τελευταία ανανέωση.
content[].contractSignedDate DateTime Ημερομηνία υπογραφής.
content[].startDate DateTime Ημερομηνία έναρξης εκτέλεσης της σύμβασης.
content[].noEndDate Boolean Υποδεικνύει αν υπάρχει Ημερομηνία λήξης.
content[].endDate DateTime Ημερομηνία λήξης.
content[].cancelled Boolean Υποδεικνύει αν η Ανάθεση ακυρώθηκε.
content[].cancellationDate DateTime Ημερομηνία ακύρωσης Ανάθεσης.
content[].cancellationType String Τύπος ακύρωσης Ανάθεσης.
content[].cancellationReason String Λόγος ακύρωσης Ανάθεσης.
content[].cancellationADA String ΑΔΑ απόφασης ακύρωσης.
content[].decisionRelatedAda String ΑΔΑ απόφασης τροποποίησης.
content[].contractNumber String Αριθμός σύμβασης.
content[].authorEmail String Email συντάκτη.
content[].organizationVatNumber String ΑΦΜ Φορέα.
content[].greekOrganizationVatNumber Boolean Υποδεικνύει αν το ΑΦΜ ανήκει σε ελληνικό φορέα.
content[].commitmentNo String ΑΔΑ Ανάληψης Υποχρέωσης.
content[].diavgeiaADA String ΑΔΑ ανάληψης υποχρέωσης (Διαύγειας).
content[].aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
content[].budget Decimal Συνολική Εκτιμώμενη αξία σύμβασης.
content[].contractBudget Decimal Εκτιμώμενη Αξία σύμβασης χωρίς ΦΠΑ.
content[].bidsSubmitted String Αριθμός προσφορών που υποβλήθηκαν.
content[].maxBidsSubmitted String Μέγιστος αριθμός υποβληθεισών προσφορών (Ο μέγιστος αριθμός προσφορών που έχει υποβληθεί σε τμήμα της διαδικασίας).
content[].numberOfSections Long Αριθμός τμημάτων.
content[].assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα.
content[].socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες.
content[].centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή.
content[].nutsCodes[].nutsCode String Γεωγραφική περιοχή του τόπου εκτέλεσης σύμβασης.
content[].approvedRequestsList String Λίστα εγκεκριμένων αιτημάτων.
content[].organization String Φορέας.
content[].procedureType String Διαδικασία ανάθεσης.
content[].awardProcedure String Αιτιολόγηση διαδικασίας ανάθεσης.
content[].nutsCode String Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
content[].nutsCity String Πόλη.
content[].nutsPostalCode String Ταχυδρομικός Κώδικας.
content[].nutsCountry String Χώρα Αναθέτουσας Αρχής.
content[].centralizedMarkets String Χρήση Τεχνικών – Εργαλείων ανάθεσης.
content[].legalContext String Νομικό Πλαίσιο.
content[].contractType String Κύριος χαρακτήρας σύμβασης.
content[].mixedContract String Μικτή σύμβαση.
content[].additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης.
content[].contractDuration String Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure string Μονάδα μέτρησης διάρκειας σύμβασης
content[].contractingAuthorityActivity String Δραστηριότητα αναθέτουσας αρχής.
content[].assignCriteria String Κριτήριο Ανάθεσης.
content[].classificationOfPublicLawOrganization String Ταξινόμηση Οργανισμού Δημοσίου Δικαίου.
content[].typeOfContractingAuthority String Είδος Αναθέτουσας Αρχής.
content[].contractRelatedAda String ΑΔΑ ανάληψης υποχρέωσης Σύμβασης.
content[].contractRelatedAda.number1 String ΑΔΑ ανάληψης υποχρέωσης Κατακύρωσης.
content[].contractRelatedAda.number2 String ΑΔΑ ανάληψης υποχρέωσης Ανάθεσης.
content[].contractRelatedAda.number3 String ΑΔΑ ανάληψης υποχρέωσης.
content[].fundingDetails.publicFundingRef String Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
content[].fundingDetails.publicFundingRefNum String Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
content[].fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
content[].fundingDetails.cofundProgramRef String Συγχρηματοδοτούμενο Πρόγραμμα - Δηλώστε το σχετικό Κωδικό ΟΠΣ.
content[].fundingDetails.selfFundProgramRef String Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
content[].fundingDetails.espaFundProgramRef String Πρόγραμμα Χρηματοδοτούμενο Από το ΕΣΠΑ - Δηλώστε το σχετικό Κωδικό ΕΣΠΑ.
content[].fundingDetails.regularBudgetFundedProgramRef String Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
content[].contractingDataDetails.unitsOperator.value String Οργανική Μονάδα.
content[].contractingDataDetails.signers.value String Αποφαινόμενο όργανο.
content[].contractingDataDetails.contractingMembersDataList[].country String Χώρα καταγωγής /εγκατάστασης του αναδόχου.
content[].contractingDataDetails.contractingMembersDataList[].vatNumber String ΑΦΜ Αναδόχου.
content[].contractingDataDetails.contractingMembersDataList[].greekVatNumber Boolean Ελληνικό ΑΦΜ.
content[].contractingDataDetails.contractingMembersDataList[].name String Όνομα Αναδόχου.
content[].totalCostWithVAT Decimal Συνολικό κόστος με ΦΠΑ.
content[].totalCostWithoutVAT Decimal Συνολική αξία σύμβασης χωρίς ΦΠΑ.
content[].objectDetailsList[].quantity Integer Ποσότητα αντικειμένου.
content[].objectDetailsList[].costWithoutVAT Decimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
content[].objectDetailsList[].vat String ΦΠΑ.
content[].objectDetailsList[].type String Μονάδες Μέτρησης.
content[].objectDetailsList[].currency String Περιγραφή νομίσματος.
content[].objectDetailsList[].shortDescription String Περιληπτική περιγραφή αντικειμένου.
content[].objectDetailsList[].cpvs[] String Περιγραφή με όρους CPV.
content[].objectDetailsList[].greenContracts String Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
content[].objectDetailsList[].goodServices String Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ.
content[].objectDetailsList[].cityOfConstruction String Χώρα Κατασκευής.
content[].objectDetailsList[].countryOfDelivery String Μοναδικό αναγνωριστικό για την Χώρα Παράδοσης.
content[].objectDetailsList[].addressForDelivery. String Διεύθυνση Παράδοσης.
content[].objectDetailsList[].postalCode String ΤΚ.
content[].objectDetailsList[].city String Πόλη Παράδοσης.
content[].objectDetailsList[].streetNumber String Αριθμός.
content[].objectDetailsList[].budgetCode String Κωδικός Προϋπολογισμού Φορέα.
content[].requestRefNo String ΑΔΑΜ συνδεδεμένου αιτήματος.
content[].nextRefNo String ΑΔΑΜ τελευταίας σύμβασης, η οποία επεκτείνει ή τροποποιεί τη σύμβαση.
content[].nextExtended Boolean Αν η σύμβαση που αναφέρεται στο πεδίο content[].nextRefNo είναι επέκταση.
content[].nextModified Boolean Αν η σύμβαση που αναφέρεται στο πεδίο content[].nextRefNo είναι τροποποίηση.
content[].auctionRefNo String ΑΔΑΜ ανάθεσης με την οποία συνδέεται η σύμβαση.
content[].paymentRefNo Array Λίστα από ΑΔΑΜ εντολών πληρωμής με την οποία συνδέεται η σύμβαση.
pageable Object Πληροφορίες Σελιδοποίησης της απάντησης.
last Boolean Υποδεικνύει εάν είναι η τελευταία σελίδα της απάντησης.
totalPages Integer Ο Συνολικός αριθμός τως Σελίδων.
totalElements Integer Ο Συνολικός αριθμός των αποτελεσμάτων με βάση τα κρητήρια αναζήτησης.
first Boolean Υποδεικνύει εάν είναι η πρώτη Σελίδα αποτελεσμάτων.
numberOfElements Integer Ο αριθμός των αποτελεσμάτων για την τρέχουσα σελίδα.
size Integer Ο προκαθορισμένος αριθμός αποτελεσμάτων ανα σελίδα.
number Integer Ο τρέχον αριθμός σελίδας.
sort Object Πληροφορίες ταξινόμησης που εφαρμόστηκε.
empty Boolean True μόνο εάν δεν υπάρχουν αποτελέσματα. False αν υπάρχουν αποτελέσματα.

Ανάκτηση αρχείου Σύμβασης

GET /khmdhs-opendata/contract/attachment/{referenceNumber}

Περιγραφή

Ανακτά ένα έγγραφο PDF που αφορά μια συγκεκριμένη Σύμβαση, που προσδιορίζεται από τον κωδικό ΑΔΑΜ {referenceNumber}.

Παράμετρος

  • referenceNumber (string): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του συνημμένου αρχείου Σύμβασης.

Παράδειγμα Κλήσης

GET [API_BASE_URL]/khmdhs-opendata/contract/attachment/24SYMV014543954

Απάντηση

Επιστρέφει ένα PDF αρχείο:

  • Content-Type: application/pdf
  • Body: Δυαδικό περιεχόμενο byte[] του αρχείου PDF.

Παράδειγμα cURL Εντολής

curl -o attachment.pdf [API_BASE_URL]/khmdhs-opendata/contract/attachment/24SYMV014543954

Καταχώρηση Συμβάσεων

Η λειτουργικότητα της υποβολής Συμβάσεων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Σύμβασης μέσω REST κλήσης POST, με επισύναψη PDF αρχείου.
  • Προστασία μέσω Basic Authentication για διασφάλιση πρόσβασης μόνο σε εξουσιοδοτημένους χρήστες.

POST /khmdhs-api/contract

Περιγραφή

Η κλήση επιτρέπει την καταχώρηση μιας Σύμβασης και τη μεταφόρτωση σχετικού αρχείου PDF.

Παράμετροι Κλήσης

  • file (MultipartFile, required): Το PDF αρχείο που συνοδεύει την Σύμβαση. Το αρχείο πρέπει να είναι έγκυρο και σε μορφή PDF.
  • request (String, required): Ένα αντικείμενο JSON που περιέχει τα δεδομένα της Σύμβασης.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:

{
  "title": "TEST",
  "extended": false,
  "modified": false,
  "previousContract": "",
  "contractSignedDate": "2024-11-21",
  "startDate": "2024-11-21",
  "noEndDate": true,
  "endDate": "",
  "contractNumber": "string",
  "contractType": "12",
  "numberOfSections": 4,
  "assignCriteria": "1",
  "aaht": "string",
  "maxBidsSubmitted": 10
  "procedureType": "1",
  "awardProcedure": "",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "assignedContract": "1",
  "socialContract": "1",
	"centralGovernmentAuthority": "1",
	"contractDuration": 2,
    "contractDurationUnitOfMeasure": "2",
	"contractingAuthorityActivity": "7",
    "additionalContractTypes": ["1"],
  "diavgeiaADA": "string",

  "fundingDetails": {
    "publicFundingRef": 213131,
    "publicFundingRefNum": 3131,
    "publicFundingRefOps": "1213213",
    "selfFundProgramRef": null,
    "regularBudgetFundedProgramRef": null
  },
  "totalContractValue": 1000,
  "nutsCodes": ["FRI"],
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
    "unitsOperator": "90593",
    "signers": "128986"
  "contractRelatedADA": "string",
  "centralizedMarkets": ["1", "2", "3"],
  "legalContext": "4",
  "contractingMembersDataList": [
    {
      "greekVatNumber": false,
      "vatNumber": "123",
      "name": "string",
      "country": "AS"
    }
  ],
  "objectDetailsList": [
    {
      "quantity": 100,
      "costWithoutVAT": 100,
      "type": "KM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "string",
      "cpvs": [
        "34631400-3"
      ],
      "city": "string",
      "countryOfDelivery": "AS",
      "greenContracts": "1",
      "goodServices": "",
      "auctionAdam": ""
    },
    {
      "quantity": 8,
      "costWithoutVAT": 65432,
      "type": "KM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "string",
      "cpvs": [
        "34631400-3"
      ],
      "city": "string",
      "countryOfDelivery": "AS",
      "greenContracts": "1",
      "goodServices": "",
      "auctionAdam": ""
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
extended boolean Επέκταση.
modified boolean Τροποποίηση.
previousContract string Το ΑΔΑΜ της πράξης που θέλετε να επεκταθεί/τροποποιηθεί.
contractSignedDate string Ημερομηνία υπογραφής σύμβασης.
startDate string Ημερομηνία έναρξης εκτέλεσης της σύμβασης.
noEndDate Boolean Χωρίς ημερομηνία λήξης.
endDate string Ημερομηνία λήξης.
contractNumber string Αριθμός σύμβασης.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes string Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
numberOfSections BigDecimal Αριθμός τμημάτων.
assignCriteria string Κριτήριο ανάθεσης.
"1" για Βάσει κόστους - βέλτιστη σχέση ποιότητας τιμής
"2" για Βάσει τιμής "3" για Βάσει κόστους - κοστολόγηση κύκλου ζωής "4" για Βάσει τιμής - άλλο
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
maxBidsSubmitted BigDecimal Μέγιστος αριθμός υποβληθεισών προσφορών (Ο μέγιστος αριθμός προσφορών που έχει υποβληθεί σε τμήμα της διαδικασίας).
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"2" για Κλειστή διαδικασία,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"11" για Σύμπραξη καινοτομίας,
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"18" για Διαδικασία άρθρου 128 του ν.4412/16
awardProcedure string Αιτιολόγηση διαδικασίας ανάθεσης. Συμπληρώστε:
Για Διαδικασία ανάθεσης "2" ή "3":
"51" για Οι ανάγκες δεν μπορούν να ικανοποιηθούν χωρίς προσαρμογή των άμεσα διαθέσιμων λύσεων,
"52" για Το αντικείμενο της σύμβασης περιλαμβάνει σχεδιασμό ή καινοτόμες λύσεις,
"53" για Συντρέχουν ειδικές περιστάσεις σχετικά με το αντικείμενο της σύμβασης,
"54" για Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια,
"55" για Άγονη διαδικασία ανάθεσης σύμβασης,

Για Διαδικασία ανάθεσης "7":
"56" για Άγονη διαδικασία ανάθεσης σύμβασης,
"57" για Μοναδικό έργο τέχνης ή καλλιτεχνική εκδήλωση,
"58" για Απουσία ανταγωνισμού για τεχνικούς λόγους,
"59" για Προστασία αποκλειστικών δικαιωμάτων,
"60" για Κατεπείγουσα ανάγκη οφειλόμενη σε γεγονότα απρόβλεπτα για την αναθέτουσα αρχή
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"8" για ΕΚΑΑ ή ΚΑΑ,
"9" για ΝΠΔΔ,
"10" για ΝΠΙΔ,
"12" για Κεντρική Διοίκηση,
"13" για Ανεξάρτητη αρχή (με νομική προσωπικότητα)
assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
diavgeiaADA string ΑΔΑ ανάληψης υποχρέωσης.
contractDuration BigDecimal Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure String Μονάδα μέτρησης διάρκειας σύμβασης.
contractingAuthorityActivity string Δραστηριότητα αναθέτουσας αρχής. Συμπληρώστε:
"1" για Γενικές δημόσιες υπηρεσίες,
"2" για Άμυνα,
"3" για Δημόσια τάξη και ασφάλεια,
"4" για Περιβάλλον,
"5" για Οικονομικές και δημοσιονομικές υποθέσεις,
"6" για Υγεία,
"7" για Στέγαση και υποδομές κοινής ωφέλειας,
"8" για Κοινωνική προστασία,
"9" για Αναψυχή,
"10" για Πολιτισμός και θρησκεία,
"11" για Εκπαίδευση,
"12" για Τυχόν άλλη δραστηριότητα,
"13" Αναζήτηση ή εξόρυξη άνθρακα και άλλων στερεών καυσίμων,
"14" Δραστηριότητες που αφορούν την ηλεκτροδότηση,
"15" Δραστηριότητες που αφορούν την ύδρευση,

"16" Δραστηριότητες που αφορούν τους αερολιμένες,
"17" Δραστηριότητες που αφορούν τους λιμένες,
"18" Εξόρυξη φυσικού αερίου ή πετρελαίου,
"19" Μεταφορές με αστικό σιδηρόδρομο, τραμ, τρόλεϊ ή λεωφορείο,
"20" Παραγωγή, μεταφορά ή διανομή αερίου ή θερμότητας,
"21" Σιδηροδρομικές υπηρεσίες,
"22" Ταχυδρομικές υπηρεσίες
fundingDetails Object Πηγή χρηματοδότησης.
fundingDetails.publicFundingRef string Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
fundingDetails.publicFundingRefNum string Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
fundingDetails.selfFundProgramRef string Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
fundingDetails.regularBudgetFundedProgramRef string Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
totalContractValue Integer Εκτιμώμενη Αξία σύμβασης χωρίς ΦΠΑ.
nutsCodes Array Γεωγραφική περιοχή του τόπου εκτέλεσης σύμβασης. Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
greekOrganizationVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
organizationVatNumber string ΑΦΜ Φορέα.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
nutsCity string Πόλη.
nutsPostalCode string Ταχυδρομικός Κώδικας.
nutsCountry string Χώρα Αναθέτουσας Αρχής.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
contractRelatedADA string ΑΔΑ ανάληψης υποχρέωσης.
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"3" για Ηλεκτρονικός Κατάλογος,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"8" για Δεν χρησιμοποιείται
legalContext string Νομικό πλαίσιο. Συμπληρώστε:
"4" για ν.4412/2016 - Βιβλίο Ι - άνω των ορίων,
"5" για ν.4412/2016 - Βιβλίο Ι - κάτω των ορίων,
"6" για ν.4412/2016 - Βιβλίο ΙΙ - άνω των ορίων,
"7" για ν.4412/2016 - Βιβλίο ΙΙ - κάτω των ορίων,
"10" ν.4413/2016 - Παραχωρήσεις
contractingMembersDataList Array Στοιχεία Αναδόχου.
contractingMembersDataList.greekVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
contractingMembersDataList.vatNumber string ΑΦΜ Αναδόχου.
contractingMembersDataList.name string Επωνυμία Αναδόχου.
contractingMembersDataList.country string Χώρα καταγωγής /εγκατάστασης του αναδόχου. Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.auctionAdam String Μοναδικός Κωδικός - ΑΔΑΜ Ανάθεσης που σχετίζεται με την Σύμβαση.
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.city string Πόλη παράδοσης.
objectDetailsList.countryOfDelivery string Χώρα καταγωγής /εγκατάστασης του αναδόχου.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList.greenContracts string Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
Συμπληρώστε:
"1" για Δεν εμπίπτει στο ΕΣΔ
"2" για Εμπίπτει στο ΕΣΔ - Δεν έχουν υιοθετηθεί τα ΠΚ
"3" για Εμπίπτει στο ΕΣΔ - Έχουν υιοθετηθεί τα ΠΚ
objectDetailsList.goodServices string Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ. Συμπληρώστε:
"101" για Χαρτί́ από́ ανακτημένες ίνες,
"102" για Χαρτί από παρθένες ίνες αειφόρου συγκομιδής,
"103" για Ηλεκτρονικοί υπολογιστές,
"104" για Οθόνες,
"105" για "Εξοπλισμός απεικόνισης (εκτυπωτές, σαρωτές, πολυμηχανήματα φωτοαντιγραφής, εκτύπωσης και σάρωσης)",
"106" για Εσωτερικός φωτισμός - Λαμπτήρες LED,
"107" για Κλιματιστικά́ μηχανήματα,
"108" για Λιπαντικά́ Αναγεννημένα,
"109" για Λιπαντικά Βιοαποικοδομήσιμα,
"110" για Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς),
"111" για Οδοφωτισμός και σηματοδότες κυκλοφορίας (αφορά́ οδούς αρμοδιότητας Δήμων και Περιφερειών),
"112" για Έπιπλα,
"113" για Προϊόντα κλωστοϋφαντουργίας,
"114" για "Προϊόντα και υπηρεσίες συντήρησης εξωτερικών δημόσιων χώρων (Καθαρισμός, κηπουρική́)",
"115" για Υποδομές διαχείρισης λυμάτων,
"116" για Ηλεκτρικός και ηλεκτρονικός εξοπλισμός χρησιμοποιούμενος στον τομέα της υγειονομικής περίθαλψης (Υγειονομικός ΗΗΕ),
"117" για "Σχεδιασμός οδοποιίας, κατασκευή́ και συντήρηση",
"118" για "Σχεδιασμός κτιρίων γραφείων, κατασκευή́ και διαχείριση"

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε τον Τίτλο (title). Ο Τίτλος πρέπει να έχει έως 100 χαρακτήρες. Ναι
extended Παρακαλώ δηλώστε αν πρόκειται για επέκταση η όχι (extended). Ναι
modified Παρακαλώ δηλώστε αν πρόκειται για τροποποίηση η όχι (modified). Ναι
previousContract Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##SYMV#########) ή να είναι κενός.
Έχετε δηλώσει αριθμό ΑΔΑΜ επέκτασης/τροποποίησης (previousContract) αλλά δεν έχετε δηλώσει αν πρόκειται για επέκταση (extended) ή τροποποίηση (modified). 		Όχι
contractSignedDate Παρακαλώ δώστε την Ημερομηνία Υπογραφής Σύμβασης (contractSignedDate). Ναι
startDate Παρακαλώ δώστε την Ημερομηνία έναρξης εκτέλεσης της σύμβασης (startDate). Ναι
noEndDate Παρακαλώ δηλώστε αν η σύμβαση έχει Ημερομηνία Λήξης (noEndDate). Ναι
endDate Δεν υπάρχουν συγκεκριμένοι κανόνες επικύρωσης. Όχι
contractNumber Παρακαλώ δώστε τον Αριθμό Σύμβασης (contractNumber). Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβασης (contractType). Πρέπει να είναι θετικός αριθμός. Ναι
numberOfSections Παρακαλώ δώστε τον Αριθμό Τμημάτων (numberOfSections). Πρέπει να είναι μη αρνητικός αριθμός και έως 30 ψηφία. Ναι
assignCriteria Παρακαλώ δώστε τα Κριτήρια Ανάθεσης (assignCriteria). Πρέπει να είναι θετικός αριθμός. Ναι
aaht Παρακαλώ δώστε τον Κωδικό Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht). Ναι
maxBidsSubmitted Παρακαλώ δώστε τον Μέγιστο αριθμό υποβληθεισών προσφορών (maxBidsSubmitted). Μέγιστο 30 ψηφία με έως 2 δεκαδικά. Ναι
procedureType Παρακαλώ δώστε το Είδος Αναθέτουσας Αρχής (procedureType). Πρέπει να είναι θετικός αριθμός. Ναι
awardProcedure Η Αιτιολόγηση διαδικασίας ανάθεσης (awardProcedure) πρέπει να είναι θετικός αριθμός ή κενό. Όχι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization). Πρέπει να είναι θετικός αριθμός. Ναι
typeOfContractingAuthority Παρακαλώ δώστε το Είδος Αναθέτουσας Αρχής (typeOfContractingAuthority). Πρέπει να είναι θετικός αριθμός. Ναι
assignedContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract).
Η Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract) πρέπει να είναι θετικός αριθμός		 Ναι
socialContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract).
Η Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract) πρέπει να είναι θετικός αριθμός		 Ναι
centralGovernmentAuthority Παρακαλώ δηλώστε αν πρόκειται για Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority).
Η Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
diavgeiaADA Παρακαλώ δώστε τον ΑΔΑ ανάληψης υποχρέωσης (diavgeiaADA). Ναι
fundingDetails Παρακαλώ συμπληρώστε την Πηγή Χρηματοδότησης (fundingDetails). Ναι
totalContractValue Παρακαλώ δώστε τη Συνολική Αξία Σύμβασης (totalContractValue). Μέγιστο 30 ψηφία με έως 2 δεκαδικά. Ναι
nutsCodes Παρακαλώ δώστε τον Τόπο εκτέλεσης σύμβασης (nutsCodes). Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Φορέα (organizationVatNumber) είναι ελληνικός. Ναι
organizationVatNumber Παρακαλώ δώστε τον ΑΦΜ Φορέα (organizationVatNumber). Πρέπει να περιέχει μόνο αριθμούς και έως 30 χαρακτήρες. Ναι
contractingMembersDataList Παρακαλώ δώστε τα Στοιχεία Συμβαλλομένων Μελών (contractingMembersDataList). Ναι
contractDuration Παρακαλώ δώστε τη Διάρκεια Σύμβασης (contractDuration). Πρέπει να είναι θετικός αριθμός.
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να είναι θετικός αριθμός
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να έχει έως 30 ψηφία συνολικά.		 Ναι
contractDurationUnitOfMeasure Παρακαλώ δώστε τη Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure).
Η Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure) πρέπει να είναι θετικός αριθμός. 		Ναι
contractingAuthorityActivity Παρακαλώ δώστε τη Δραστηριότητα Αναθέτουσας Αρχής (contractingAuthorityActivity). Πρέπει να είναι θετικός αριθμός. Ναι
centralizedMarkets Παρακαλώ δώστε τον Κωδικό Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralizedMarkets). Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένων (objectDetailsList). Ναι
objectDetailsList.auctionAdam Ο ΑΔΑΜ (auctionAdam) θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενός.
O ΑΔΑΜ (auctionAdam) Ανάθεσης θα πρέπει να υπάρχει και να μην έχει ακυρωθεί.		 Όχι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα (quantity) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε την Συνολική αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Η Συνολική αξία αντικειμένου χωρίς ΦΠΑ στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 400 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.city Παρακαλώ δώστε την πόλη του αντικειμένου (city). Ναι
objectDetailsList.countryOfDelivery Παρακαλώ δώστε τη χώρα παράδοσης του αντικειμένου (countryOfDelivery). Ναι
objectDetailsList.greenContracts Παρακαλώ δώστε Κωδικό Σχέδιο Δράσης Πράσινων Δημόσιων Συμβάσεων (greenContracts). Πρέπει να είναι θετικός αριθμός. Ναι
objectDetailsList.goodServices Παρακαλώ δώστε Κατηγορία Αγαθών/Υπηρεσιών/Έργων (goodServices). Πρέπει να είναι θετικός αριθμός. Ναι
contractingMembersDataList.greekVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Αναδόχου (greekVatNumber) είναι ελληνικός. Ναι
contractingMembersDataList.vatNumber Παρακαλώ δώστε τον ΑΦΜ Αναδόχου (vatNumber). Πρέπει να περιέχει αριθμούς και έως 30 χαρακτήρες. Ναι
contractingMembersDataList.name Παρακαλώ δώστε την Επωνυμία Αναδόχου (name). Πρέπει να έχει έως 100 χαρακτήρες. Ναι
contractingMembersDataList.country Παρακαλώ δώστε τη Χώρα καταγωγής /εγκατάστασης του αναδόχου (country). Ναι

Παράδειγμα Κλήσης

POST /khmdhs-api/contract
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: multipart/form-data;

 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="file"; filename="document.pdf"
Content-Type: application/pdf

<binary file content>
 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="contract"

{
  "title": "TEST",
  "extended": false,
  "modified": false,
  "previousContract": "",
  "contractSignedDate": "2024-11-21",
  "startDate": "2024-11-21",
  "noEndDate": true,
  "endDate": "",
  "contractNumber": "string",
  "contractType": "12",
  "numberOfSections": 4,
  "assignCriteria": "1",
  "aaht": "1223",
  "maxBidsSubmitted": 10,
  "procedureType": "1",
  "awardProcedure": "",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "assignedContract": "1",
  "socialContract": "1",
	"centralGovernmentAuthority": "1",
	"contractDuration": 2,
    "contractDurationUnitOfMeasure": "2",
	"contractingAuthorityActivity": "7",
  "diavgeiaADA": "string",
  "fundingDetails": {
    "publicFundingRef": 213131,
    "publicFundingRefNum": 3131,
    "publicFundingRefOps": "1213213",
    "selfFundProgramRef": null,
    "regularBudgetFundedProgramRef": null
  },
  "totalContractValue": 1000,
  "nutsCodes": ["FRI"],
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
  "unitsOperator": "100029237",
  "signers": "100059416",
  "contractRelatedADA": "string",
  "centralizedMarkets": ["1", "2", "3"],
  "legalContext": "4",
  "contractingMembersDataList": [
    {
      "greekVatNumber": false,
      "vatNumber": "123",
      "name": "string",
      "country": "AS"
    }
  ],
  "objectDetailsList": [
    {
      "quantity": 100,
      "costWithoutVAT": 100,
      "type": "KM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "string",
      "cpvs": [
        "34631400-3"
      ],
      "city": "string",
      "countryOfDelivery": "AS",
      "greenContracts": "1",
      "goodServices": "",
      "auctionAdam": ""
    },
    {
      "quantity": 8,
      "costWithoutVAT": 65432,
      "type": "KM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "string",
      "cpvs": [
        "34631400-3"
      ],
      "city": "string",
      "countryOfDelivery": "AS",
      "greenContracts": "1",
      "goodServices": "",
      "auctionAdam": ""
    }
  ]
}
 -----------------------------boundary-----------------------------

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης

{
        "referenceNumber": "24SYMV009216531"
}
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.
  • Η παράμετρος file πρέπει να περιέχει έγκυρο PDF αρχείο.

Επεξεργασία Συμβάσεων

Η λειτουργικότητα της επεξεργασίας Συμβάσεων αποτελείται από τα εξής μέρη:

  • Επεξεργασία δεδομένων Επεξεργασίας Συμβάσεων μέσω REST κλήσης PUT.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PUT /khmdhs-api/contract/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την επεξεργασία μιας Σύμβασης.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Σύμβασης προς ακύρωση

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:

                    
{
  "title": "TEST",
  "contractSignedDate": "2024-11-21",
  "startDate": "2024-11-21",
  "noEndDate": true,
  "endDate": "",
  "contractNumber": "string",
  "contractType": "12",
  "numberOfSections": 4,
  "assignCriteria": "1",
  "aaht": "string",
  "maxBidsSubmitted": 10,
  "procedureType": "1",
  "awardProcedure": "",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "assignedContract": "1",
  "socialContract": "1",
  "centralGovernmentAuthority": "1",
  "contractDuration": 2,
  "contractDurationUnitOfMeasure": "2",
  "contractingAuthorityActivity": "7",
  "diavgeiaADA": "string",
  "fundingDetails": {
    "publicFundingRef": 213131,
    "publicFundingRefNum": 3131,
    "publicFundingRefOps": "1213213",
    "selfFundProgramRef": null,
    "regularBudgetFundedProgramRef": null
  },
  "totalContractValue": 1000,
  "nutsCodes": ["FRI"],
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
  "nutsCity": "Athens",
  "nutsPostalCode": "153645",
  "nutsCountry": "GR",
  "unitsOperator": "100029237",
  "signers": "100059416",
  "contractRelatedADA": "string",
  "centralizedMarkets": ["1", "2", "3"],
  "legalContext": "4",
  "contractingMembersDataList": [
    {
      "greekVatNumber": false,
      "vatNumber": "123",
      "name": "string",
      "country": "AS"
    }
  ],
  "objectDetailsList": [
    {
      "quantity": 100,
      "costWithoutVAT": 100,
      "type": "KM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "string",
      "cpvs": [
        "34631400-3"
      ],
      "city": "string",
      "countryOfDelivery": "AS",
      "greenContracts": "1",
      "goodServices": ""
    }
  ]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
contractSignedDate string Ημερομηνία υπογραφής.
startDate string Ημερομηνία έναρξης εκτέλεσης της σύμβασης.
noEndDate Boolean Χωρίς ημερομηνία λήξης.
endDate string Ημερομηνία λήξης.
contractNumber string Αριθμός σύμβασης.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes string Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
numberOfSections BigDecimal Αριθμός τμημάτων.
assignCriteria string Κριτήριο ανάθεσης.
"1" για Βάσει κόστους - βέλτιστη σχέση ποιότητας τιμής
"2" για Βάσει τιμής "3" για Βάσει κόστους - κοστολόγηση κύκλου ζωής "4" για Βάσει τιμής - άλλο
aaht string Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
maxBidsSubmitted BigDecimal Μέγιστος αριθμός υποβληθεισών προσφορών (Ο μέγιστος αριθμός προσφορών που έχει υποβληθεί σε τμήμα της διαδικασίας).
procedureType string Διαδικασία ανάθεσης. Συμπληρώστε:
"1" για Ανοιχτή διαδικασία,
"7" για Ανταγωνιστική διαδικασία με διαπραγμάτευση,
"4" για Ανταγωνιστικός διάλογος,
"6" για Απευθείας ανάθεση,
"18" για Διαδικασία άρθρου 128 του ν.4412/16,
"13" για Διαπραγμάτευση με προηγούμενη προκήρυξη διαγωνισμού (αρ.266),
"12" για Διαπραγμάτευση χωρίς προηγούμενη δημοσίευση,
"2" για Κλειστή διαδικασία,
"11" για Σύμπραξη καινοτομίας
awardProcedure string Αιτιολόγηση διαδικασίας ανάθεσης. Συμπληρώστε:
Για Διαδικασία ανάθεσης "2" ή "3":
"51" για Οι ανάγκες δεν μπορούν να ικανοποιηθούν χωρίς προσαρμογή των άμεσα διαθέσιμων λύσεων,
"52" για Το αντικείμενο της σύμβασης περιλαμβάνει σχεδιασμό ή καινοτόμες λύσεις,
"53" για Συντρέχουν ειδικές περιστάσεις σχετικά με το αντικείμενο της σύμβασης,
"54" για Οι τεχνικές προδιαγραφές δεν είναι δυνατόν να προκαθοριστούν με επαρκή ακρίβεια,
"55" για Άγονη διαδικασία ανάθεσης σύμβασης,

Για Διαδικασία ανάθεσης "7":
"56" για Άγονη διαδικασία ανάθεσης σύμβασης,
"57" για Μοναδικό έργο τέχνης ή καλλιτεχνική εκδήλωση,
"58" για Απουσία ανταγωνισμού για τεχνικούς λόγους,
"59" για Προστασία αποκλειστικών δικαιωμάτων,
"60" για Κατεπείγουσα ανάγκη οφειλόμενη σε γεγονότα απρόβλεπτα για την αναθέτουσα αρχή
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"1" για ΕΚΑΑ ή ΚΑΑ,
"2" για Κεντρική Διοίκηση,
"3" για ΝΠΔΔ,
"4" για ΝΠΙΔ,
"5" για Ανεξάρτητη αρχή
assignedContract String Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
socialContract String Σύμβαση για κοινωνικές και άλλες υπηρεσίες. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
centralGovernmentAuthority String Κεντρική Κυβερνητική Αρχή. Συμπληρώστε:
"1" για Ναι,
"2" για Όχι
contractingAuthorityActivity string Δραστηριότητα αναθέτουσας αρχής. Συμπληρώστε:
"1" για Γενικές δημόσιες υπηρεσίες,
"2" για Άμυνα,
"3" για Δημόσια τάξη και ασφάλεια,
"4" για Περιβάλλον,
"5" για Οικονομικές και δημοσιονομικές υποθέσεις,
"6" για Υγεία,
"7" για Στέγαση και υποδομές κοινής ωφέλειας,
"8" για Κοινωνική προστασία,
"9" για Αναψυχή,
"10" για Πολιτισμός και θρησκεία,
"11" για Εκπαίδευση,
"12" για Τυχόν άλλη δραστηριότητα,
"13" Αναζήτηση ή εξόρυξη άνθρακα και άλλων στερεών καυσίμων,
"14" Δραστηριότητες που αφορούν την ηλεκτροδότηση,
"15" Δραστηριότητες που αφορούν την ύδρευση,

"16" Δραστηριότητες που αφορούν τους αερολιμένες,
"17" Δραστηριότητες που αφορούν τους λιμένες,
"18" Εξόρυξη φυσικού αερίου ή πετρελαίου,
"19" Μεταφορές με αστικό σιδηρόδρομο, τραμ, τρόλεϊ ή λεωφορείο,
"20" Παραγωγή, μεταφορά ή διανομή αερίου ή θερμότητας,
"21" Σιδηροδρομικές υπηρεσίες,
"22" Ταχυδρομικές υπηρεσίες
diavgeiaADA string ΑΔΑ ανάληψης υποχρέωσης.
contractDuration BigDecimal Διάρκεια Σύμβασης.
contractDurationUnitOfMeasure String Μονάδα μέτρησης διάρκειας σύμβασης.
fundingDetails Object Πηγή χρηματοδότησης.
fundingDetails.publicFundingRef string Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
fundingDetails.publicFundingRefNum string Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
fundingDetails.publicFundingRefOps string Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
fundingDetails.selfFundProgramRef string Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
fundingDetails.regularBudgetFundedProgramRef string Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
totalContractValue Integer Εκτιμώμενη Αξία σύμβασης χωρίς ΦΠΑ.
nutsCodes Array Γεωγραφική περιοχή του τόπου εκτέλεσης σύμβασης. Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
greekOrganizationVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
organizationVatNumber string ΑΦΜ φορέα.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
nutsCity string Πόλη.
nutsPostalCode string Ταχυδρομικός Κώδικας.
nutsCountry string Χώρα Αναθέτουσας Αρχής.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
contractRelatedADA string ΑΔΑ σύμβασης.
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"8" για Δεν χρησιμοποιείται,
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"3" για Ηλεκτρονικός Κατάλογος
legalContext string Νομικό πλαίσιο. Συμπληρώστε:
"4" για ν.4412/2016 - Βιβλίο Ι - άνω των ορίων,
"5" για ν.4412/2016 - Βιβλίο Ι - κάτω των ορίων,
"6" για ν.4412/2016 - Βιβλίο ΙΙ - άνω των ορίων,
"7" για ν.4412/2016 - Βιβλίο ΙΙ - κάτω των ορίων,
"10" ν.4413/2016 - Παραχωρήσεις
contractingMembersDataList Array Στοιχεία Αναδόχου.
contractingMembersDataList.greekVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
contractingMembersDataList.vatNumber string ΑΦΜ Αναδόχου.
contractingMembersDataList.name string Επωνυμία Αναδόχου.
contractingMembersDataList.country string Χώρα καταγωγής /εγκατάστασης του αναδόχου. Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.city string Πόλη παράδοσης.
objectDetailsList.countryOfDelivery string Χώρα παράδοσης.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList.greenContracts string Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
Συμπληρώστε:
"1" για Δεν εμπίπτει στο ΕΣΔ
"2" για Εμπίπτει στο ΕΣΔ - Δεν έχουν υιοθετηθεί τα ΠΚ
"3" για Εμπίπτει στο ΕΣΔ - Έχουν υιοθετηθεί τα ΠΚ
objectDetailsList.goodServices string Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ. Συμπληρώστε:
"101" για Χαρτί́ από́ ανακτημένες ίνες,
"102" για Χαρτί από παρθένες ίνες αειφόρου συγκομιδής,
"103" για Ηλεκτρονικοί υπολογιστές,
"104" για Οθόνες,
"105" για "Εξοπλισμός απεικόνισης (εκτυπωτές, σαρωτές, πολυμηχανήματα φωτοαντιγραφής, εκτύπωσης και σάρωσης)",
"106" για Εσωτερικός φωτισμός - Λαμπτήρες LED,
"107" για Κλιματιστικά́ μηχανήματα,
"108" για Λιπαντικά́ Αναγεννημένα,
"109" για Λιπαντικά Βιοαποικοδομήσιμα,
"110" για Μεταφορικά́ μέσα (οχήματα και υπηρεσίες μεταφοράς),
"111" για Οδοφωτισμός και σηματοδότες κυκλοφορίας (αφορά́ οδούς αρμοδιότητας Δήμων και Περιφερειών),
"112" για Έπιπλα,
"113" για Προϊόντα κλωστοϋφαντουργίας,
"114" για "Προϊόντα και υπηρεσίες συντήρησης εξωτερικών δημόσιων χώρων (Καθαρισμός, κηπουρική́)",
"115" για Υποδομές διαχείρισης λυμάτων,
"116" για Ηλεκτρικός και ηλεκτρονικός εξοπλισμός χρησιμοποιούμενος στον τομέα της υγειονομικής περίθαλψης (Υγειονομικός ΗΗΕ),
"117" για "Σχεδιασμός οδοποιίας, κατασκευή́ και συντήρηση",
"118" για "Σχεδιασμός κτιρίων γραφείων, κατασκευή́ και διαχείριση"

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε τον Τίτλο (title). Ο Τίτλος πρέπει να έχει έως 100 χαρακτήρες. Ναι
contractSignedDate Παρακαλώ δώστε την Ημερομηνία Υπογραφής (contractSignedDate). Ναι
startDate Παρακαλώ δώστε την Ημερομηνία έναρξης εκτέλεσης της σύμβασης (startDate). Ναι
noEndDate Παρακαλώ δηλώστε αν η σύμβαση έχει Ημερομηνία Λήξης (noEndDate). Ναι
endDate Δεν υπάρχουν συγκεκριμένοι κανόνες επικύρωσης. Όχι
contractNumber Παρακαλώ δώστε τον Αριθμό Σύμβασης (contractNumber). Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβασης (contractType). Πρέπει να είναι θετικός αριθμός. Ναι
numberOfSections Παρακαλώ δώστε τον Αριθμό Τμημάτων (numberOfSections). Πρέπει να είναι μη αρνητικός αριθμός και έως 30 ψηφία. Ναι
assignCriteria Παρακαλώ δώστε τα Κριτήρια Ανάθεσης (assignCriteria). Πρέπει να είναι θετικός αριθμός. Ναι
aaht Παρακαλώ δώστε τον Κωδικό Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht). Ναι
maxBidsSubmitted Παρακαλώ δώστε τον Μέγιστο αριθμό υποβληθεισών προσφορών (maxBidsSubmitted). Μέγιστο 30 ψηφία με έως 2 δεκαδικά. Ναι
procedureType Παρακαλώ δώστε το Είδος Αναθέτουσας Αρχής (procedureType). Πρέπει να είναι θετικός αριθμός. Ναι
awardProcedure Η Αιτιολόγηση διαδικασίας ανάθεσης (awardProcedure) πρέπει να είναι θετικός αριθμός ή κενό. Όχι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization). Πρέπει να είναι θετικός αριθμός. Ναι
typeOfContractingAuthority Παρακαλώ δώστε το Είδος Αναθέτουσας Αρχής (typeOfContractingAuthority). Πρέπει να είναι θετικός αριθμός. Ναι
assignedContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assignedContract).
Η Σύμβαση ανατιθέμενη κατ’ αποκλειστικότητα (assigned contract) πρέπει να είναι θετικός αριθμός		 Ναι
socialContract Παρακαλώ δηλώστε αν πρόκειται για Σύμβαση για κοινωνικές και άλλες υπηρεσίες (socialContract).
Η Σύμβαση για κοινωνικές και άλλες υπηρεσίες (assignedContract) πρέπει να είναι θετικός αριθμός		 Ναι
centralGovernmentAuthority Παρακαλώ δηλώστε αν πρόκειται για Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority).
Η Κεντρική Κυβερνητική Αρχή (centralGovernmentAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
diavgeiaADA Παρακαλώ δώστε τον ΑΔΑ ανάληψης υποχρέωσης (diavgeiaADA). Ναι
fundingDetails Παρακαλώ συμπληρώστε την Πηγή Χρηματοδότησης (fundingDetails). Ναι
totalContractValue Παρακαλώ δώστε τη Εκτιμώμενη Αξία σύμβασης χωρίς ΦΠΑ (totalContractValue). Μέγιστο 30 ψηφία με έως 2 δεκαδικά. Ναι
nutsCodes Παρακαλώ δώστε τον Τόπο εκτέλεσης σύμβασης (nutsCodes). Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Φορέα (organizationVatNumber) είναι ελληνικός. Ναι
organizationVatNumber Παρακαλώ δώστε τον ΑΦΜ Φορέα (organizationVatNumber). Πρέπει να περιέχει μόνο αριθμούς και έως 30 χαρακτήρες. Ναι
contractingMembersDataList Παρακαλώ δώστε τα Στοιχεία Συμβαλλομένων Μελών (contractingMembersDataList). Ναι
contractDuration Παρακαλώ δώστε τη Διάρκεια Σύμβασης (contractDuration). Πρέπει να είναι θετικός αριθμός.
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να είναι θετικός αριθμός
Η Διάρκεια της σύμβασης (contractDuration) πρέπει να έχει έως 30 ψηφία συνολικά.		 Ναι
contractDurationUnitOfMeasure Παρακαλώ δώστε τη Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure).
Η Μονάδα Μέτρησης της Διάρκειας σύμβασης (contractDurationUnitOfMeasure) πρέπει να είναι θετικός αριθμός. 		Ναι
contractingAuthorityActivity Παρακαλώ δώστε τη Δραστηριότητα Αναθέτουσας Αρχής (contractingAuthorityActivity). Πρέπει να είναι θετικός αριθμός. Ναι
centralizedMarkets Παρακαλώ δώστε τον Κωδικό Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralizedMarkets). Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένων (objectDetailsList). Ναι
objectDetailsList.quantity Παρακαλώ δώστε την ποσότητα (quantity) στα Στοιχεία Αντικειμένου.
Η ποσότητα (quantity) στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.costWithoutVAT Παρακαλώ δώστε την Συνολική αξία αντικειμένου χωρίς ΦΠΑ (costWithoutVAT) στα Στοιχεία Αντικειμένου.
Η Συνολική αξία αντικειμένου χωρίς ΦΠΑ στα Στοιχεία Αντικειμένου πρέπει να έχει το πολύ 30 ψηφία συνολικά με έως 2 δεκαδικά ψηφία.		 Ναι
objectDetailsList.type Παρακαλώ δώστε Μονάδες Μέτρησης (type) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vat Παρακαλώ δώστε συντελεστή ΦΠΑ (vat) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.currency Παρακαλώ δώστε το νόμισμα (currency) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.shortDescription Παρακαλώ δώστε μια Περιληπτική περιγραφή (shortDescription) στα Στοιχεία Αντικειμένου.
Η Περιληπτική περιγραφή (shortDescription) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 400 χαρακτήρες.		 Ναι
objectDetailsList.cpvs Παρακαλώ δώστε τους κωδικούς CPV (cpvs) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.city Παρακαλώ δώστε την πόλη του αντικειμένου (city). Ναι
objectDetailsList.countryOfDelivery Παρακαλώ δώστε τη χώρα παράδοσης του αντικειμένου (countryOfDelivery). Ναι
objectDetailsList.greenContracts Παρακαλώ δώστε Κωδικό Σχέδιο Δράσης Πράσινων Δημόσιων Συμβάσεων (greenContracts). Πρέπει να είναι θετικός αριθμός. Ναι
objectDetailsList.goodServices Παρακαλώ δώστε Κατηγορία Αγαθών/Υπηρεσιών/Έργων (goodServices). Πρέπει να είναι θετικός αριθμός. Ναι
contractingMembersDataList.greekVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Αναδόχου (greekVatNumber) είναι ελληνικός. Ναι
contractingMembersDataList.vatNumber Παρακαλώ δώστε τον ΑΦΜ Αναδόχου (vatNumber). Πρέπει να περιέχει αριθμούς και έως 30 χαρακτήρες. Ναι
contractingMembersDataList.name Παρακαλώ δώστε την Επωνυμία Αναδόχου (name). Πρέπει να έχει έως 100 χαρακτήρες. Ναι
contractingMembersDataList.country Παρακαλώ δώστε τη Χώρα καταγωγής /εγκατάστασης του αναδόχου (country). Ναι

Παράδειγμα Κλήσης

                    
PUT /khmdhs-api/contract/{referenceNumber}
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: application/json

{
  "title": "TEST",
  "contractSignedDate": "2024-11-21",
  "startDate": "2024-11-21",
  "noEndDate": true,
  "endDate": "",
  "contractNumber": "string",
  "contractType": "12",
  "numberOfSections": 4,
  "assignCriteria": "1",
  "aaht": "1223",
  "maxBidsSubmitted": 10,
  "procedureType": "1",
  "awardProcedure": "",
  "classificationOfPublicLawOrganization": "1",
  "typeOfContractingAuthority": "10",
  "assignedContract": "1",
  "socialContract": "1",
	"centralGovernmentAuthority": "1",
	"contractDuration": "2",
    "contractDurationUnitOfMeasure": "2",
	"contractingAuthorityActivity": "7",
  "diavgeiaADA": "string",
  "fundingDetails": {
    "publicFundingRef": "string",
    "publicFundingRefNum": "string",
    "publicFundingRefOps": "string",
    "selfFundProgramRef": "string",
    "regularBudgetFundedProgramRef": "string"
  },
  "totalContractValue": 1000,
  "nutsCodes": ["FRI"],
  "greekOrganizationVatNumber": false,
  "organizationVatNumber": "123",
  "nutsCode": "FRI",
	"nutsCity": "Athens",
	"nutsPostalCode": "153645",
	"nutsCountry": "GR",
  "unitsOperator": "100029237",
  "signers": "100059416",
  "contractRelatedADA": "string",
  "centralizedMarkets": ["1", "2", "3"],
  "legalContext": "4",
  "contractingMembersDataList": [
    {
      "greekVatNumber": false,
      "vatNumber": "123",
      "name": "string",
      "country": "AS"
    }
  ],
  "objectDetailsList": [
    {
      "quantity": 100,
      "costWithoutVAT": 100,
      "type": "KM",
      "vat": "10",
      "currency": "EUR",
      "shortDescription": "string",
      "cpvs": [
        "34631400-3"
      ],
      "city": "string",
      "countryOfDelivery": "AS",
      "greenContracts": "1",
      "goodServices": ""
    }
  ]
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης


    {
        "message": "Η πράξη με ΑΔΑΜ 25SYMV009223796 ενημερώθηκε με επιτυχία."
    }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ακύρωση Συμβάσεων

Η λειτουργικότητα της ακύρωσης αιτημάτων αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Ακύρωσης Συμβάσεων μέσω REST κλήσης PATCH.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PATCH /khmdhs-api/contract/cancel/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την ακύρωση μιας Σύμβασης.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Σύμβασης προς ακύρωση.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

                        {
                            "type": "3",
                            "reason": "Test",
                            "cancellationADA": "rt45234"
                        }

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
type string Είδος ακύρωσης. Συμπληρώστε:
"3" για Ακύρωση λόγω λανθασμένης καταχώρησης,
"6" Λύση Σύμβασης
reason string Περιγραφή.
cancellationADA string ΑΔΑ απόφασης Λύσης.

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
type Παρακαλώ δώστε το Είδος ακύρωσης (type). Ναι
reason Παρακαλώ δώστε την Περιγραφή (reason). Ναι
cancellationADA - Όχι

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
message String Μήνυμα επιβεβαίωσης ακύρωσης.

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 25PROC009223819 ενημερώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ανάκτηση Εντολών Πληρωμής

Κάθε Εντολή Πληρωμής αποτελείται από τα εξής μέρη:

  • Ένα σύνολο δεδομένων τα οποία περιγράφουν μια Εντολή Πληρωμής και ανακτώνται με μια REST κλήση POST.
  • Το έγγραφο μιας Εντολής Πληρωμής σε μορφή PDF το οποίο μπορεί να ανακτηθεί με μια REST κλήση GET και με τον αριθμό ΑΔΑΜ {referenceNumber} της Εντολής Πληρωμής.

POST /khmdhs-opendata/payment?page=0

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση σελιδοποιημένων αποτελεσμάτων Εντωλών Πληρωμής με βάση το request body της κλήσης.

Παράμετροι Κλήσης

  • page (integer, optional): Ο αριθμός σελίδας που θέλετε να ανακτήσετε, ξεκινώντας από το 0. Εάν δεν έχει καθοριστεί, ορίζεται αυτόματα ως προεπιλογή το 0 .

Request Body Κλήσης

Το request body της κλήσης θα πρέπει να είναι ένα αντικείμενο JSON που περιέχει τα παρακάτω πεδία:

                        
{
  "title": "string",
  "cpvItems": ["string"],
  "organizations": ["string"],
  "signer": "2926834455886",
  "organization": "",
  "contractType": "",
  "dateFrom": "2025-01-23",
  "dateTo": "2025-01-23",
  "totalCostFrom": 1000000000000,
  "totalCostTo": 1000000000000,
  "cancelDateFrom": "2025-01-23",
  "cancelDateTo": "2025-01-23",
  "referenceNumber": "",
  "vatNumber": "9367467901801",
  "contractorName": "string",
  "publicFundingRefNum": "string"
}
Παρατηρήσεις

  • Αν δεν οριστεί τιμή στο πεδίο dateTo, ενώ έχει οριστεί dateFrom, τότε το σύστημα αυτομάτως θα εισάγει ως τιμή την dateFrom συν 180 μέρες.
  • Αν δεν έχει οριστεί τιμή στο πεδίο dateFrom ενώ έχει οριστεί dateTo, τότε το σύστημα αυτομάτως θα εισάγει την ημερομηνία του dateTo μείον 180 μέρες.
  • Αν δεν έχει οριστεί ούτε dateFrom ούτε dateTo, τότε το σύστημα θα εισάγει ως dateTo την τρέχουσα ημερομηνία και dateFrom την τρέχουσα ημερομηνία μείον 180 μέρες.
  • Αν έχει οριστεί dateFrom και dateTo, αλλά έχουν διαφορά μεγαλύτερη των 180 ημερών, τότε το σύστημα θα εισάγει dateFrom την dateTo μείον 180 μέρες.
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί ούτε cancelDateFrom ούτε cancelDateTo τότε δεν θα υπολογίζεται η Ημερομηνία Ματαίωσης κατά την αναζήτηση. Σε περίπτωση που έχει οριστεί μόνο cancelDateFrom ή μόνο cancelDateΤο η και οι 2 τότε θα ισχύει ο κανόνας τον 180 ημερών όπως περιγράφεται για τα πεδία dateFrom και dateTo
  • Αν στα κριτήρια αναζήτησης δεν έχει οριστεί το εύρος των cancelDateFrom και cancelDateΤο το σύστημα επιστρέφει και τις Ματαιώσεις με βάση τα υπόλοιπα καθορισμένα κριτήρια αναζήτησης. Αν καθοριστούν τα cancelDateFrom και cancelDateΤο τότε το σύστημα επιστρέφει μόνο πράξεις που έχουν ματαιωθεί.


Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
cpvItems Array[String] Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
πχ. "34327200-7" για Άξονες και κιβώτια,
"34711500-9" για Ελικόπτερα
organization Array[String] Αναθέτουσα Αρχή/Αναθέτων Φορέας.
Συμπληρώστε τον κωδικό του Φορέα.
πχ. "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ,
"72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
signer string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
πχ. "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής
referenceNumber string Μοναδικός Κωδικός - ΑΔΑΜ.
contractType string Κύριος χαρακτήρας σύμβασης. Συμπληρώστε:
"9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
dateFrom string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Από (YYYY-MM-DD).
dateTo string Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ Έως (YYYY-MM-DD).
totalCostFrom integer Συνολική αξία σύμβασης χωρίς ΦΠΑ Από.
totalCostTo integer Συνολική αξία σύμβασης χωρίς ΦΠΑ Έως.
cancelDateFrom string Ματαιώσεις Από (YYYY-MM-DD).
cancelDateTo string Ματαιώσεις Έως (YYYY-MM-DD).
vatNumber string ΑΦΜ Αναδόχου.
contractorName string Επωνυμία Αναδόχου.
publicFundingRefNum string Ενάριθμος ΠΔΕ.

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Ο Τίτλος θα πρέπει να έχει μέχρι 100 χαρακτήρες. Όχι
cpvItems Ο κωδικός CPV θα πρέπει να έχει σωστή μορφή (########-#) ή να είναι κενό. Όχι
organizations Το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
signer Το πεδίο Υπογράφων θα πρέπει να είναι ένας θετικός αριθμός ή κενό.
Εάν το πεδίο Αναθέτουσα Αρχή/Αναθέτων Φορέας (organizations) έχει περισσότερες απο μια τιμή, το Αποφαινόμενο όργανο (signer) πρέπει να είναι κενό.		 Όχι
contractType Το πεδίο Κύριος χαρακτήρας σύμβασης θα πρέπει να είναι ένας θετικός αριθμός ή κενό. Όχι
dateFrom / dateTo Η Ημερομηνία καταχώρισης της πράξης στο ΚΗΜΔΗΣ θα πρέπει να έχει μια από τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, YYYY-MM-D). Όχι
totalCostFrom / totalCostTo Συνολική αξία χωρίς ΦΠΑ θα πρέπει να είναι ίσο ή μεγαλύτερο από 0. Όχι
cancelDateFrom / cancelDateTo Η Ημερομηνία Ματαίωσης θα πρέπει να έχει μια από τις μορφές (YYYY-MM-DD, YYYY-M-DD, YYYY-M-D, YYYY-MM-D). Όχι
referenceNumber Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενό. Όχι
vatNumber Το ΑΦΜ Αναδόχου πρέπει να είναι θετικός αριθμός ή κενό. Όχι
contractorName Η Επωνυμία Αναδόχου πρέπει να είναι μέχρι 30 χαρακτήρες. Όχι
publicFundingRefNum Ο Ενάριθμος ΠΔΕ να είναι μέχρι 30 χαρακτήρες. Όχι

Παράδειγμα απάντησης σε περίπτωση λανθασμένης τιμής στο πεδίο referenceNumber κατά την κλήση:

{
	"errors": {
		"referenceNumber": "Ο ΑΔΑΜ θα πρέπει να έχει σωστή μορφή (##PAY#########) ή να είναι κενό."
	}
}

Παράδειγμα κλήσης

POST /khmdhs-opendata/payment?page=0
Content-Type: application/json

{
    "title": "ΠΛΗΡΩΜΗ",
    "cpvItems": ["79822500-7", "34711500-9"],
    "organizations": ["99221938"],
    "referenceNumber": "24PAY009215539",
    "signer": "100070768",
    "contractType": "1",
    "dateFrom": "2024-01-01",
    "dateTo": "2024-01-10",
    "totalCostFrom": 0,
    "totalCostTo": 1000,
    "cancelDateFrom": "",
    "cancelDateTo": "",
    "vatNumber": "",
    "contractorName": "",
    "publicFundingRefNum": ""
}

Παράδειγμα απάντησης


{
	"content": [
		{
			"title": "test",
			"referenceNumber": "25PAY009217368",
			"auctionReferenceNumber": null,
			"signedDate": null,
			"submissionDate": "2025-01-22T10:45:55.333564",
			"lastUpdateDate": null,
			"cancellationDate": null,
			"cancellationType": null,
			"cancellationReason": null,
			"cancellationADA": null,
			"cancelled": false,
			"credit": false,
			"paymentRelatedAda": null,
			"protocolNumber": null,
			"authorEmail": null,
            "aaht": "31323",
			"paymentCommitmentCode": "123",
			"contractRefNo": null,
			"requestRefNo": null,
			"organizationVatNumber": "35345",
			"greekOrganizationVatNumber": false,
			"commitmentNo": null,
			"organization": {
				"key": "100015981",
				"value": "ΥΠΟΥΡΓΕΙΟ ΑΓΡΟΤΙΚΗΣ ΑΝΑΠΤΥΞΗΣ ΚΑΙ ΤΡΟΦΙΜΩΝ"
			},
			"nutsCode": {
				"key": "FRI",
				"value": "AQUITAINE-LIMOUSIN-POITOU-CHARENTES"
			},
			"centralizedMarkets": [
				{
					"centralizedMarket": {
						"key": "2",
						"value": "Δυναμικό σύστημα αγορών"
					}
				},
				{
					"centralizedMarket": {
						"key": "5",
						"value": "Ηλεκτρονικός Κατάλογος"
					}
				},
				{
					"centralizedMarket": {
						"key": "4",
						"value": "Ηλεκτρονικός Πλειστηριασμός"
					}
				}
			],
			"legalContext": null,
			"contractType": {
				"key": "14",
				"value": "Τεχνικές ή λοιπές συναφείς υπηρεσίες"
			},
			"classificationOfPublicLawOrganization": {
				"key": "3",
				"value": "ΟΚΑ"
			},
			"typeOfContractingAuthority": {
				"key": "4",
				"value": "ΝΠΙΔ"
			},
			"contractingData": {
				"unitsOperator": {
					"key": "100047202",
					"value": "ΑΝΑΠΤΥΞΙΑΚΗ ΔΥΤΙΚΗΣ ΜΑΚΕΔΟΝΙΑΣ ΑΕ ΟΤΑ"
				},
				"signers": {
					"key": "100025627",
					"value": "Άννα ΒΟΥΔΟΥΡΗ - Αναπληρωτης Προϊστάμενος Τμήματος"
				}
			},
			"fundingDetails": {
				"publicFundingRef": null,
				"publicFundingRefNum": null,
				"publicFundingRefOps": "123",
				"cofundProgramRef": "653423",
				"selfFundProgramRef": null,
				"espaFundProgramRef": null,
				"regularBudgetFundedProgramRef": null
			},
			"nutsCodes": [],
			"totalCostWithVAT": 40053.78,
			"totalCostWithoutVAT": 34234.00,
			"objectDetails": [
				{
					"quantity": 3,
					"type": {
						"key": "MTK",
						"value": "m 2"
					},
					"costWithoutVAT": 34234,
					"vat": "17",
					"currency": {
						"key": "EUR",
						"value": "Ευρώ"
					},
					"shortDescription": "evgera",
					"cpvs": [
						{
							"key": "33141120-7",
							"value": "Αγκτήρες"
						}
					],
					"addressForDelivery": null,
					"streetNumber": null,
					"postalCode": null,
					"city": "egrverf",
					"cityOfConstruction": null,
					"countryOfDelivery": "CC",
					"vatNo": "32423423",
					"greekVatNo": false,
					"name": "trgvefr",
					"country": "CK",
					"invoiceNo": null,
					"commitmentCode": null,
					"budgetCode": null
				}
			],
			"additionalContractTypes": null,
			"mixedContract": false,
			"requestRefNo": null,
			"auctionRefNo": null,
			"contractRefNo": "25SYMV009222922"
		}
	],
	"pageable": {
		"pageNumber": 0,
		"pageSize": 50,
		"sort": {
			"sorted": false,
			"unsorted": true,
			"empty": true
		},
		"offset": 0,
		"paged": true,
		"unpaged": false
	},
	"totalPages": 1,
	"totalElements": 1,
	"last": true,
	"first": true,
	"numberOfElements": 1,
	"size": 50,
	"number": 0,
	"sort": {
		"sorted": false,
		"unsorted": true,
		"empty": true
	},
	"empty": false
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
content Array Λίστα αντικειμένων Συμβάσεων.
content[].title String Τίτλος Σύμβασης.
content[].referenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ.
content[].auctionReferenceNumber String Μοναδικός Κωδικός - ΑΔΑΜ απο Ανάθεση.
content[].signedDate DateTime Ημερομηνία Πρωτοκόλλου (έκδοσης).
content[].submissionDate DateTime Ημερομηνία υποβολής.
content[].lastUpdateDate DateTime Τελευταία ανανέωση.
content[].cancelled Boolean Υποδεικνύει αν η Πληρωμή ακυρώθηκε.
content[].cancellationDate DateTime Ημερομηνία ακύρωσης Πληρωμής.
content[].cancellationType String Τύπος ακύρωσης Πληρωμής.
content[].cancellationReason String Λόγος ακύρωσης Πληρωμής.
content[].cancellationADA String ΑΔΑ απόφασης ακύρωσης.
content[].credit Boolen Περιλαμβάνει πιστώσιες.
content[].paymentRelatedAda String ΑΔΑ Ανάληψης Υποχρέωσης.
content[].protocolNumber String Αριθμός Πρωτοκόλλου.
content[].authorEmail String Email συντάκτη.
content[].aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
content[].paymentCommitmentCode String Κωδικός Ανάληψης Υποχρέωσης.
content[].contractRefNo String Μοναδικός Αριθμός σύμβασης ή αριθμός πρωτοκόλλου.
content[].requestRefNo String Μοναδικός Αριθμός αιτήματος.
content[].organizationVatNumber String ΑΦΜ Φορέα.
content[].greekOrganizationVatNumber Boolean Υποδεικνύει αν το ΑΦΜ ανήκει σε ελληνικό φορέα.
content[].commitmentNo String ΑΔΑ Ανάληψης Υποχρέωσης.
content[].organization String Φορέας.
content[].nutsCodes[].nutsCode String Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
content[].approvedRequestsList String Λίστα εγκεκριμένων αιτημάτων.
content[].nutsCode String Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
content[].centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης.
content[].legalContext String Νομικό Πλαίσιο.
content[].contractType String Κύριος χαρακτήρας σύμβασης.
content[].classificationOfPublicLawOrganization String Ταξινόμηση Οργανισμού Δημοσίου Δικαίου.
content[].typeOfContractingAuthority String Είδος Αναθέτουσας Αρχής.
content[].mixedContract String Μικτή σύμβαση.
content[].additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης.
content[].contractingDataDetails.unitsOperator String Οργανική Μονάδα.
content[].contractingDataDetails.signers String Αποφαινόμενο όργανο.
content[].fundingDetails.publicFundingRef String Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
content[].fundingDetails.publicFundingRefNum String Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
content[].fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
content[].fundingDetails.cofundProgramRef String Συγχρηματοδοτούμενο Πρόγραμμα - Δηλώστε το σχετικό Κωδικό ΟΠΣ.
content[].fundingDetails.selfFundProgramRef String Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
content[].fundingDetails.espaFundProgramRef String Πρόγραμμα Χρηματοδοτούμενο Από το ΕΣΠΑ - Δηλώστε το σχετικό Κωδικό ΕΣΠΑ.
content[].fundingDetails.regularBudgetFundedProgramRef String Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
`content[].`nutsCodes[].nutsCode String Περιγραφή γεωγραφικής περιοχής (NUTS).
content[].totalCostWithVAT Decimal Συνολικό κόστος με ΦΠΑ.
content[].totalCostWithoutVAT Decimal Συνολική αξία σύμβασης χωρίς ΦΠΑ.
content[].objectDetailsList[].quantity Integer Ποσότητα αντικειμένου.
content[].objectDetailsList[].costWithoutVAT Decimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
content[].objectDetailsList[].vat String ΦΠΑ.
content[].objectDetailsList[].type String Μονάδα Μέτρησης.
content[].objectDetailsList[].currency String Περιγραφή νομίσματος.
content[].objectDetailsList[].shortDescription String Περιληπτική περιγραφή αντικειμένου.
content[].objectDetailsList[].cpvs[] String Περιγραφή με όρους CPV.
content[].objectDetailsList[].greenContracts String Εφαρμογή του Εθνικού Σχεδίου Δράσης για τις Πράσινες Δημόσιες Συμβάσεις (ΦΕΚ Β 466 /2021).
content[].objectDetailsList[].goodServices String Κατηγορία Αγαθών/Υπηρεσιών/Έργων του ΕΣΔ.
content[].objectDetailsList[].cityOfConstruction String Χώρα Κατασκευής.
content[].objectDetailsList[].countryOfDelivery String Χώρα Παράδοσης.
content[].objectDetailsList[].addressForDelivery String Διεύθυνση Παράδοσης.
content[].objectDetailsList[].postalCode String ΤΚ.
content[].objectDetailsList[].city String Πόλη Παράδοσης.
content[].objectDetailsList[].streetNumber String Αριθμός.
content[].objectDetailsList[].budgetCode String Κωδικός Προϋπολογισμού Φορέα.
content[].objectDetailsList[].invoiceNo String Αρ. Τιμολογίου.
content[].objectDetailsList[].commitmentCode String Κωδ. Ανάληψης Υποχρέωσης.
content[].requestRefNo String ΑΔΑΜ αιτήματος με το οποίο συνδέεται η εντολή πληρωμής.
content[].auctionRefNo String ΑΔΑΜ ανάθεσης με την οποία συνδέεται η εντολή πληρωμής.
content[].contractRefNo String ΑΔΑΜ σύμβασης με την οποίο συνδέεται η εντολή πληρωμής.
pageable Object Πληροφορίες Σελιδοποίησης της απάντησης.
last Boolean Υποδεικνύει εάν είναι η τελευταία σελίδα της απάντησης.
totalPages Integer Ο Συνολικός αριθμός τως Σελίδων.
totalElements Integer Ο Συνολικός αριθμός των αποτελεσμάτων με βάση τα κρητήρια αναζήτησης.
first Boolean Υποδεικνύει εάν είναι η πρώτη Σελίδα αποτελεσμάτων.
numberOfElements Integer Ο αριθμός των αποτελεσμάτων για την τρέχουσα σελίδα.
size Integer Ο προκαθορισμένος αριθμός αποτελεσμάτων ανα σελίδα.
number Integer Ο τρέχον αριθμός σελίδας.
sort Object Πληροφορίες ταξινόμησης που εφαρμόστηκε.
empty Boolean True μόνο εάν δεν υπάρχουν αποτελέσματα. False αν υπαρχουν αποτελέσματα.

Ανάκτηση αρχείου Εντολών Πληρωμής

GET /payment/attachment/{referenceNumber}

Περιγραφή

Ανακτά ένα έγγραφο PDF που αφορά μια συγκεκριμένη Σύμβαση, που προσδιορίζεται από τον κωδικό ΑΔΑΜ {referenceNumber}.

Παράμετρος

  • referenceNumber (string): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του συνημμένου αρχείου Σύμβασης.

Παράδειγμα Κλήσης

GET [API_BASE_URL]/khmdhs-opendata/payment/attachment/24PAY009215865

Απάντηση

Επιστρέφει ένα PDF αρχείο:

  • Content-Type: application/pdf
  • Body: Δυαδικό περιεχόμενο byte[] του αρχείου PDF.

Παράδειγμα cURL Εντολής

curl -o attachment.pdf [API_BASE_URL]/khmdhs-opendata/payment/attachment/24PAY009215865

Καταχώρηση Εντολών Πληρωμής

Η λειτουργικότητα της υποβολής Εντολής Πληρωμής αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Εντολής Πληρωμής μέσω REST κλήσης POST, με επισύναψη PDF αρχείου.
  • Προστασία μέσω Basic Authentication για διασφάλιση πρόσβασης μόνο σε εξουσιοδοτημένους χρήστες.

POST /khmdhs-api/payment

Περιγραφή

Η κλήση επιτρέπει την καταχώρηση μιας Εντολής Πληρωμής και τη μεταφόρτωση σχετικού αρχείου PDF.

Παράμετροι Κλήσης

  • file (MultipartFile, required): Το PDF αρχείο που συνοδεύει την Εντολή Πληρωμής. Το αρχείο πρέπει να είναι έγκυρο και σε μορφή PDF.
  • request (String, required): Ένα αντικείμενο JSON που περιέχει τα δεδομένα της Εντολής Πληρωμής.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:

{
	"title": "TEST",
    "signedDate": "2025-09-23",
    "requestAdam": "",
	"auctionAdam": "",
	"contractAdam": "",
	"credit": false,
	"paymentCommitmentCode": "123",
	"organizationVatNumber": "35345",
	"greekOrganizationVatNumber": false,
    "aaht": "string",
	"contractValue": 1000,
	"nutsCode": "FRI",
	"centralizedMarkets": ["3", "2"],
	"contractType": "14",
    "additionalContractTypes": [
        "1"
     ],
	"classificationOfPublicLawOrganization": "3",
	"typeOfContractingAuthority": "10",
	"unitsOperator": "100029237",
	"signers": "100059416",
	"fundingDetails": {
		"publicFundingRef": null,
		"publicFundingRefNum": null,
		"publicFundingRefOps": "123",
		"selfFundProgramRef": null,
		"regularBudgetFundedProgramRef": null
	},
	"objectDetailsList": [
		{
			"quantity": 3,
			"costWithoutVAT": 34234,
			"type": "MTK",
			"vat": "17",
			"currency": "EUR",
			"shortDescription": "evgera",
			"cpvs": ["33141120-7"],
			"city": "egrverf",
			"countryOfDelivery": "CC",
			"vatNo": "32423423",
			"greekVatNo": false,
			"name": "trgvefr",
			"country": "CK"
		},
        {
            "quantity": 23,
            "costWithoutVAT": 76544,
            "type": "MTK",
            "vat": "17",
            "currency": "EUR",
            "shortDescription": "evgera",
            "cpvs": ["33141120-7"],
            "city": "egrverf",
            "countryOfDelivery": "CC",
            "vatNo": "32423423",
            "greekVatNo": false,
            "name": "trgvefr",
            "country": "CK"
        }
	]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
requestAdam string Μοναδικός Κωδικός - Εγκεκριμένου Αιτήματος που σχετίζεται με την Εντολή Πληρωμής.
auctionAdam string Μοναδικός Κωδικός - ΑΔΑΜ Ανάθεσης που σχετίζεται με την Εντολή Πληρωμής.
contractAdam string Μοναδικός Κωδικός - ΑΔΑΜ Σύμβασης που σχετίζεται με την Εντολή Πληρωμής.
credit Boolean Περιλαμβάνει πιστώσεις (Τα ποσά των πιστωτικών αντικειμένων δηλώνονται με [-]).
paymentCommitmentCode string Κωδικός Ανάληψης Υποχρέωσης.
organizationVatNumber string ΑΦΜ Φορέα.
greekOrganizationVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"3" για Ηλεκτρονικός Κατάλογος,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"8" για Δεν χρησιμοποιείται
contractType string Κύριος χαρακτήρας σύμβασης.
Συμπληρώστε: "9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes Array Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"8" για ΕΚΑΑ ή ΚΑΑ,
"9" για ΝΠΔΔ,
"10" για ΝΠΙΔ,
"12" για Κεντρική Διοίκηση,
"13" για Ανεξάρτητη αρχή (με νομική προσωπικότητα)
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
fundingDetails Object Πηγή χρηματοδότησης.
fundingDetails.publicFundingRef string Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
fundingDetails.publicFundingRefNum string Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
fundingDetails.selfFundProgramRef string Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
fundingDetails.regularBudgetFundedProgramRef string Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.city string Πόλη Παράδοσης.
objectDetailsList.countryOfDelivery string Χώρα παράδοσης.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList.vatNo string ΑΦΜ αναδόχου.
objectDetailsList.greekVatNo Boolean Εάν το ΑΦΜ είναι ελληνικό.
objectDetailsList.name string Επωνυμία Αναδόχου.
objectDetailsList.country string Χώρα καταγωγής /εγκατάστασης του αναδόχου.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν


Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε τον Τίτλο (title).
Ο Τίτλος (title) θα πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
signedDate Παρακαλώ δώστε την ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate).
Η ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate) πρέπει να είναι προγενέστερη ή ίση της σημερινής.		 Ναι
requestAdam Ο ΑΔΑΜ (requestAdam) θα πρέπει να έχει σωστή μορφή (##REQ#########) ή να είναι κενός.
Ο ΑΔΑΜ (requestAdam) θα πρέπει να υπάρχει και το Αίτημα να είναι Εγκεκριμένο και να μην έχει Ακυρωθεί.		 Όχι
auctionAdam Ο ΑΔΑΜ (auctionAdam) θα πρέπει να έχει σωστή μορφή (##AWRD#########) ή να είναι κενός.
Ο ΑΔΑΜ (auctionAdam) θα πρέπει να υπάρχει και να μην έχει Ακυρωθεί.		 Όχι
contractAdam Ο ΑΔΑΜ (contractAdam) θα πρέπει να έχει σωστή μορφή (##SYMV#########) ή να είναι κενός.
Ο ΑΔΑΜ (contractAdam) θα πρέπει να υπάρχει και να μην έχει Ακυρωθεί.		 Όχι
unitsOperator Παρακαλώ δώστε τον κωδικό της Οργανικής Μονάδας (unitsOperator).
Η Οργανική Μονάδα (unitsOperator) πρέπει να είναι θετικός αριθμός.		 Ναι
signers Παρακαλώ δώστε τον κωδικό του Αποφαινόμενου οργάνου (signers).
Ο Υπογράφων (signers) πρέπει να είναι θετικός αριθμός.		 Ναι
organizationVatNumber Παρακαλώ δώστε τον ΑΦΜ Οργανισμού (organizationVatNumber).
Ο ΑΦΜ Οργανισμού (organizationVatNumber) πρέπει να περιέχει μόνο αριθμούς.
Ο ΑΦΜ Οργανισμού (organizationVatNumber) θα πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Οργανισμού (organizationVatNumber) είναι ελληνικός. Ναι
aaht Παρακαλώ δώστε τον Κωδικό Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht).
Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) πρέπει να έχει έως 30 χαρακτήρες. 		Ναι
credit Παρακαλώ δηλώστε αν Περιλαμβάνει πιστώσεις (credit). Ναι
paymentCommitmentCode Παρακαλώ δώστε τον Κωδικό Ανάληψης Υποχρέωσης (paymentCommitmentCode). Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβασης (contractType).
Ο Κύριος χαρακτήρας σύμβασης (contractType) πρέπει να είναι θετικός αριθμός.		 Ναι
centralizedMarkes Παρακαλώ δώστε την Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralizedMarkets).
Η Χρήση Τεχνικών – Εργαλείων ανάθεσης (centralizedMarkets) πρέπει να είναι θετικός αριθμός.		 Ναι
nutsCode Παρακαλώ δώστε τον Κωδικό NUTS (nutsCode). Ναι
typeOfContractingAuthority Παρακαλώ δώστε το Είδος Αναθέτουσας Αρχή (typeOfContractingAuthority).
Το Είδος Αναθέτουσας Αρχή (typeOfContractingAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization).
Η Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization) πρέπει να είναι θετικός αριθμός		 Ναι
fundingDetails Παρακαλώ συμπληρώστε την Πηγή Χρηματοδότησης (fundingDetails). Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένου (objectDetailsList). Ναι
objectDetailsList.city Παρακαλώ δώστε την Πόλη Παράδοσης (city) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.countryOfDelivery Παρακαλώ δώστε τη Χώρα καταγωγής /εγκατάστασης του αναδόχου (countryOfDelivery) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vatNo Παρακαλώ δώστε τον ΑΦΜ Αναδόχου (vatNo) για τα Στοιχεία Αντικειμένου.
Ο ΑΦΜ Αναδόχου (vatNo) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 30 χαρακτήρες.		 Ναι
objectDetailsList.greekVatNo Παρακαλώ δηλώστε αν ο ΑΦΜ (greekVatNo) για τα στοιχεία του αντικειμένου είναι ελληνικός. Ναι
objectDetailsList.name Παρακαλώ δώστε την Επωνυμία Αναδόχου (name) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.country Παρακαλώ δώστε τη Χώρα καταγωγής /εγκατάστασης του αναδόχου (country) για τα Στοιχεία Αντικειμένου. Ναι

Παράδειγμα Κλήσης

POST /khmdhs-api/payment
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: multipart/form-data;

 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="file"; filename="document.pdf"
Content-Type: application/pdf

<binary file content>
 -----------------------------boundary-----------------------------
Content-Disposition: form-data; name="payment"

{
	"title": "TEST",
    "requestAdam": "",
	"auctionAdam": "",
	"contractAdam": "",
	"credit": false,
	"paymentCommitmentCode": "123",
	"organizationVatNumber": "35345",
	"greekOrganizationVatNumber": false,
    "contractValue": 1000,
    "additionalContractTypes": [
        "1"
    ],
	"nutsCode": "FRI",
	"centralizedMarkets": ["2"],
	"contractType": "14",
	"classificationOfPublicLawOrganization": "3",
	"typeOfContractingAuthority": "10",
	"unitsOperator": "100029237",
	"signers": "100059416",
    "fundingDetails": {
        "publicFundingRef": 213131,
        "publicFundingRefNum": 3131,
        "publicFundingRefOps": "1213213",
        "selfFundProgramRef": null,
        "regularBudgetFundedProgramRef": null
    },
	"objectDetailsList": [
		{
			"quantity": 3,
			"costWithoutVAT": 34234,
			"type": "MTK",
			"vat": "17",
			"currency": "EUR",
			"shortDescription": "evgera",
			"cpvs": ["33141120-7"],
			"city": "egrverf",
			"countryOfDelivery": "CC",
			"vatNo": "32423423",
			"greekVatNo": false,
			"name": "trgvefr",
			"country": "CK"
		},
        {
            "quantity": 23,
            "costWithoutVAT": 76544,
            "type": "MTK",
            "vat": "17",
            "currency": "EUR",
            "shortDescription": "evgera",
            "cpvs": ["33141120-7"],
            "city": "egrverf",
            "countryOfDelivery": "CC",
            "vatNo": "32423423",
            "greekVatNo": false,
            "name": "trgvefr",
            "country": "CK"
        }
	]
}
 -----------------------------boundary-----------------------------

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης

{
        "referenceNumber": "24PAY009216531"
}
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.
  • Η παράμετρος file πρέπει να περιέχει έγκυρο PDF αρχείο.

Επεξεργασία Εντολών Πληρωμών

Η λειτουργικότητα της επεξεργασίας Εντολών Πληρωμών αποτελείται από τα εξής μέρη:

  • Επεξεργασία δεδομένων Επεξεργασίας Εντολών Πληρωμών μέσω REST κλήσης PUT.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PUT /khmdhs-api/payment/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την επεξεργασία μιας Εντολής Πληρωμών.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) της Εντολής Πληρωμών προς ακύρωση Εντολής Πληρωμών.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON που περιέχει τα εξής πεδία:

                    
{
	"title": "TEST",
	"signedDate": "2025-09-23",
	"credit": false,
	"paymentCommitmentCode": "123",
	"organizationVatNumber": "35345",
	"greekOrganizationVatNumber": false,
	"aaht": "string",
	"contractValue": 1000,
	"additionalContractTypes": [
	    "1"
	],
	"nutsCode": "FRI",
	"centralizedMarkets": ["2"],
	"contractType": "14",
	"classificationOfPublicLawOrganization": "3",
	"typeOfContractingAuthority": "10",
	"unitsOperator": "100029237",
	"signers": "100059416",
	"fundingDetails": {
        "publicFundingRef": 213131,
        "publicFundingRefNum": 3131,
        "publicFundingRefOps": "1213213",
        "selfFundProgramRef": null,
        "regularBudgetFundedProgramRef": null
    },
	"objectDetailsList": [
		{
			"quantity": 3,
			"costWithoutVAT": 34234,
			"type": "MTK",
			"vat": "17",
			"currency": "EUR",
			"shortDescription": "evgera",
			"cpvs": ["33141120-7"],
			"postalCode": null,
			"city": "egrverf",
			"cityOfConstruction": null,
			"countryOfDelivery": "CC",
			"vatNo": "32423423",
			"greekVatNo": false,
			"name": "trgvefr",
			"country": "CK",
			"invoiceNo": "56345234"
		}
	]
}

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
title string Τίτλος.
signedDate string Ημερομηνία Πρωτοκόλλου (έκδοσης).
credit Boolean Περιλαμβάνει πιστώσεις (Τα ποσά των πιστωτικών αντικειμένων δηλώνονται με [-]).
paymentCommitmentCode string Αριθμός Ανάληψης Υποχρέωσης.
organizationVatNumber string ΑΦΜ Φορέα.
greekOrganizationVatNumber Boolean Εάν το ΑΦΜ είναι ελληνικό.
aaht String Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής.
nutsCode string Γεωγραφική Περιοχή Αναθέτουσας Αρχής (NUTS).
Συμπληρώστε τον κωδικό NUTS.
Για παράδειγμα: "EL" για Ελλάδα, "EL3" για Αττική, "EL543" για Ιωάννινα
centralizedMarkets Array Χρήση Τεχνικών – Εργαλείων ανάθεσης. Συμπληρώστε:
"8" για Δεν χρησιμοποιείται,
"1" για Συμφωνία - πλαίσιο,
"2" για Δυναμικό σύστημα αγορών,
"4" για Ηλεκτρονικός Πλειστηριασμός,
"3" για Ηλεκτρονικός Κατάλογος
contractType string Κύριος χαρακτήρας σύμβασης.
Συμπληρώστε: "9" για Υπηρεσίες,
"10" για Έργα,
"12" για Μελέτες,
"13" για Προμήθειες,
"14" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
additionalContractTypes string Πρόσθετος χαρακτήρας σύμβασης. Συμπληρώστε:
"1" για Έργα,
"2" για Προμήθειες,
"3" για Υπηρεσίες,
"4" για Μελέτες τεχνικών έργων,
"5" για Τεχνικές ή λοιπές συναφείς Υπηρεσίες
classificationOfPublicLawOrganization string Ταξινόμηση Οργανισμού Δημοσίου Δικαίου. Συμπληρώστε:
"1" για Κεντρική Κυβέρνηση,
"2" για ΟΤΑ,
"3" για ΟΚΑ,
"4" για Εκτός Γενικής Κυβέρνησης
typeOfContractingAuthority string Είδος Αναθέτουσας Αρχής. Συμπληρώστε:
"1" για ΕΚΑΑ ή ΚΑΑ,
"2" για Κεντρική Διοίκηση,
"3" για ΝΠΔΔ,
"4" για ΝΠΙΔ,
"5" για Ανεξάρτητη αρχή
contractingData.unitsOperator string Οργανική Μονάδα.
Συμπληρώστε της Οργανικής Μονάδας.
Για παράδειγμα: "100024656" για ΓΡΑΦΕΙΟ ΑΣΦΑΛΕΙΑΣ ΥΠΟΥΡΓΕΙΟΥ ΕΞΩΤΕΡΙΚΩΝ, "72616" για ΥΠΗΡΕΣΙΑ ΕΝΗΜΕΡΩΣΗΣ & ΔΗΜΟΣΙΑΣ ΔΙΠΛΩΜΑΤΙΑΣ
contractingData.signers string Αποφαινόμενο όργανο.
Συμπληρώστε τον κωδικό του αποφαινόμενου οργάνου.
Για παράδειγμα: "100058015" για ΔΗΜΗΤΡΑ ΝΟΥΣΗ - Γενικός Διευθυντής, "100084174" για ΑΓΗΣΙΛΑΟΣ ΒΟΡΙΣΣΗΣ - Αναπληρωτής Διευθυντής
fundingDetails Object Πηγή χρηματοδότησης.
fundingDetails.publicFundingRef string Πρόγραμμα Δημοσίων Επενδύσεων - Δηλώστε τη σχετική ΣΑΕ.
fundingDetails.publicFundingRefNum string Πρόγραμμα Δημοσίων Επενδύσεων - Ενάριθμος ΠΔΕ.
fundingDetails.publicFundingRefOps String Πρόγραμμα Δημοσίων Επενδύσεων - Κωδικός Διαχείρισης Έργου.
fundingDetails.selfFundProgramRef string Πρόγραμμα Ιδίων Πόρων - Δηλώστε το σχετικό Κωδικό.
fundingDetails.regularBudgetFundedProgramRef string Τακτικός Προϋπολογισμός - Δηλώστε το σχετικό Κωδικό KAE/ΛΑΕ.
objectDetailsList Array Στοιχεία Αντικειμένου(ων).
objectDetailsList.quantity BigDecimal Ποσότητα.
objectDetailsList.costWithoutVAT BigDecimal Συνολική αξία αντικειμένου χωρίς ΦΠΑ. Μπορεί να δεχτεί εως 2 δεκαδικά με το χαρακτήρα τελεία (.)
objectDetailsList.type string Μονάδες Μέτρησης.
Συμπληρώστε τον κωδικό της μονάδας μέτρησης.
Για παράδειγμα: "LTR" για Λίτρο, "C62" για Τεμάχιο, "DAY" για Ημέρα
objectDetailsList.vat string Συντελεστής ΦΠΑ.
objectDetailsList.currency string Νόμισμα.
Συμπληρώστε τον κωδικό το Νόμισμα.
Για παράδειγμα: "USD" για Δολάριο ΗΠΑ, "EUR" για Ευρώ, "CHF" για Ελβετικό Φράγκο
objectDetailsList.shortDescription string Περιληπτική περιγραφή.
objectDetailsList.cpvs Array Περιγραφή με όρους CPVS.
Συμπληρώστε τους κωδικόυς CPV.
Για παράδειγμα: "34327200-7" για Άξονες και κιβώτια, "34711500-9" για Ελικόπτερα
objectDetailsList.city string Πόλη Παράδοσης.
objectDetailsList.countryOfDelivery string Χώρα παράδοσης.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν
objectDetailsList.vatNo string ΑΦΜ.
objectDetailsList.greekVatNo Boolean Εάν το ΑΦΜ είναι ελληνικό.
objectDetailsList.name string Επωνυμία Αναδόχου.
objectDetailsList.country string Χώρα καταγωγής /εγκατάστασης του αναδόχου.
Για παράδειγμα: "GR" για Ελλάδα, "AZ" για Aζερμπαϊτζάν


Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
title Παρακαλώ δώστε τον Τίτλο (title).
Ο Τίτλος (title) θα πρέπει να έχει έως 100 χαρακτήρες.		 Ναι
signedDate Παρακαλώ δώστε την ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate).
Η ημερομηνία πρωτοκόλλου (έκδοσης) (signedDate) πρέπει να είναι προγενέστερη ή ίση της σημερινής.		 Ναι
unitsOperator Παρακαλώ δώστε τον κωδικό της Οργανικής Μονάδας (unitsOperator).
Η Οργανική Μονάδα (unitsOperator) πρέπει να είναι θετικός αριθμός.		 Ναι
signers Παρακαλώ δώστε τον κωδικό του Αποφαινόμενου οργάνου (signers).
Ο Υπογράφων (signers) πρέπει να είναι θετικός αριθμός.		 Ναι
organizationVatNumber Παρακαλώ δώστε τον ΑΦΜ Οργανισμού (organizationVatNumber).
Ο ΑΦΜ Οργανισμού (organizationVatNumber) πρέπει να περιέχει μόνο αριθμούς.
Ο ΑΦΜ Οργανισμού (organizationVatNumber) θα πρέπει να έχει έως 30 χαρακτήρες.		 Ναι
greekOrganizationVatNumber Παρακαλώ δηλώστε αν ο ΑΦΜ Οργανισμού (organizationVatNumber) είναι ελληνικός. Ναι
aaht Παρακαλώ δώστε τον Κωδικό Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht).
Ο Κωδικός Ηλεκτρονικής Τιμολόγησης Αναθέτουσας Αρχής (aaht) πρέπει να έχει έως 30 χαρακτήρες. 		Ναι
credit Παρακαλώ δηλώστε αν Περιλαμβάνει πιστώσεις (credit). Ναι
paymentCommitmentCode Παρακαλώ δώστε τον Αριθμό Ανάληψης Υποχρέωσης (paymentCommitmentCode). Ναι
contractType Παρακαλώ δώστε τον Κύριο χαρακτήρα σύμβασης (contractType).
Ο Κύριος χαρακτήρας σύμβασης (contractType) πρέπει να είναι θετικός αριθμός.		 Ναι
centralizedMarket Παρακαλώ δώστε τον Κωδικό Συγκεντρωτικής Αγοράς (centralizedMarket).
Η Συγκεντρωτική Αγορά (centralizedMarket) πρέπει να είναι θετικός αριθμός.		 Ναι
nutsCode Παρακαλώ δώστε τον Κωδικό NUTS (nutsCode). Ναι
typeOfContractingAuthority Παρακαλώ δώστε το Είδος Αναθέτουσας Αρχή (typeOfContractingAuthority).
Το Είδος Αναθέτουσας Αρχή (typeOfContractingAuthority) πρέπει να είναι θετικός αριθμός		 Ναι
classificationOfPublicLawOrganization Παρακαλώ δώστε την Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization).
Η Ταξινόμηση Οργανισμού Δημοσίου Δικαίου (classificationOfPublicLawOrganization) πρέπει να είναι θετικός αριθμός		 Ναι
fundingDetails Παρακαλώ συμπληρώστε την Πηγή Χρηματοδότησης (fundingDetails). Ναι
objectDetailsList Παρακαλώ δώστε τα Στοιχεία Αντικειμένου (objectDetailsList). Ναι
objectDetailsList.city Παρακαλώ δώστε την Πόλη Παράδοσης (city) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.countryOfDelivery Παρακαλώ δώστε τη Χώρα Παράδοσης (countryOfDelivery) στα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.vatNo Παρακαλώ δώστε τον ΑΦΜ (vatNo) για τα Στοιχεία Αντικειμένου.
Ο ΑΦΜ (vatNo) για τα Στοιχεία Αντικειμένου πρέπει να είναι το πολύ 30 χαρακτήρες.		 Ναι
objectDetailsList.greekVatNo Παρακαλώ δηλώστε αν ο ΑΦΜ (greekVatNo) για τα στοιχεία του αντικειμένου είναι ελληνικός. Ναι
objectDetailsList.name Παρακαλώ δώστε την Επωνυμία Αναδόχου (name) για τα Στοιχεία Αντικειμένου. Ναι
objectDetailsList.country Παρακαλώ δώστε τη Χώρα καταγωγής /εγκατάστασης του αναδόχου (country) για τα Στοιχεία Αντικειμένου. Ναι

Παράδειγμα Κλήσης

PUT /khmdhs-api/payment/{referenceNumber}
Host: example.com
Authorization: Basic <base64_credentials>
Content-Type: application/json

{
	"title": "TEST",
	"credit": false,
	"paymentCommitmentCode": "123",
	"organizationVatNumber": "35345",
	"greekOrganizationVatNumber": false,
	"contractValue": 1000,
    "additionalContractTypes": [
        "1"
    ],
	"nutsCode": "FRI",
	"centralizedMarkets": ["2"],
	"contractType": "14",
	"classificationOfPublicLawOrganization": "3",
	"typeOfContractingAuthority": "10",
	"unitsOperator": "100029237",
	"signers": "100059416",
	"fundingDetails": {
        "publicFundingRef": 213131,
        "publicFundingRefNum": 3131,
        "publicFundingRefOps": "1213213",
        "selfFundProgramRef": null,
        "regularBudgetFundedProgramRef": null
    },
	"objectDetailsList": [
		{
			"quantity": 3,
			"costWithoutVAT": 34234,
			"type": "MTK",
			"vat": "17",
			"currency": "EUR",
			"shortDescription": "evgera",
			"cpvs": ["33141120-7"],
			"postalCode": null,
			"city": "egrverf",
			"cityOfConstruction": null,
			"countryOfDelivery": "CC",
			"vatNo": "32423423",
			"greekVatNo": false,
			"name": "trgvefr",
			"country": "CK",
			"invoiceNo": "56345234"
		}
	]
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
referenceNumber String Μοναδικός κωδικός - ΑΔΑΜ.

Παράδειγμα Απάντησης

{
        "message": "Η πράξη με ΑΔΑΜ 25PAY009223797 ενημερώθηκε με επιτυχία."
}

Ακύρωση Εντολών Πληρωμής

Η λειτουργικότητα της ακύρωσης εντολών πληρωμής αποτελείται από τα εξής μέρη:

  • Καταχώρηση δεδομένων Ακύρωσης Εντολής Πληρωμής μέσω REST κλήσης PATCH.
  • Προστασία μέσω Basic Authentication για τη διασφάλιση της πρόσβασης μόνο από εξουσιοδοτημένους χρήστες.

PATCH /khmdhs-api/payment/cancel/{referenceNumber}

Περιγραφή

Η κλήση επιτρέπει την ακύρωση ενός Αιτήματος.

Παράμετροι Κλήσης

  • referenceNumber (String, required): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ) του Αιτήματος προς ακύρωση.

Request Body Κλήσης

Το request body της κλήσης πρέπει να είναι σε μορφή JSON και να περιέχει τα εξής πεδία:

                        {
                            "type": "3",
                            "reason": "Test",
                            "cancellationADA": "rt45234"
                        }

Περιγραφή πεδίων κλήσης

Πεδίο Τύπος Περιγραφή
type string Είδος ακύρωσης. Συμπληρώστε:
"3" για Ακύρωση λόγω λανθασμένης καταχώρησης,
"4" για Ανάκληση
reason string Περιγραφή.
cancellationADA string ΑΔΑ απόφασης Ανάκλησης.

Κανόνες επικύρωσης των πεδίων της κλήσης

Πεδίο Κανόνας Υποχρεωτικότητα
type Παρακαλώ δώστε το Είδος ακύρωσης (type). Ναι
reason Παρακαλώ δώστε την Περιγραφή (reason). Ναι
cancellationADA - Όχι

Παράδειγμα Απάντησης

                        {
                                "message": "Η πράξη με ΑΔΑΜ 24PAY009216531 ακυρώθηκε με επιτυχία."
                        }
Παρατηρήσεις
  • Η κλήση απαιτεί Basic Authentication για πρόσβαση.

Ανάκτηση Συνδεδεμένων Πράξεων

GET /khmdhs-opendata/adamChain/{referenceNumber}

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση αποτελεσμάτων Συνδεδεμένων Πράξεων με βάση την παράμετρο referenceNumber.

Παράμετρος

  • referenceNumber (string): Ο μοναδικός αριθμός αναφοράς (ΑΔΑΜ).

Παράδειγμα απάντησης σε περίπτωση λανθασμένης τιμής στο πεδίο referenceNumber κατά την κλήση:

{
	"errors": {
		"referenceNumber": "Το πεδίο ΑΔΑΜ (referenceNumber) θα πρέπει να έχει σωστή μορφή (##REQ|PROC|AWRD|SYMV|PAY#########)."
	}
}

Παράδειγμα κλήσης

POST /khmdhs-opendata/adamChain/25REQ009222917

Παράδειγμα απάντησης


{
    "requests": [
        "25REQ009222917"
    ],
    "approvedRequests": [
        "25REQ009222918"
    ],
    "notices": [
        "25PROC009223037*",
        "25PROC009222919",
        "25PROC009223057**",
        "25PROC009223000**"
    ],
    "auctions": [
        "25AWRD009222920",
        "25AWRD009223038",
        "25AWRD009222921*"
    ],
    "contracts": [
        "25SYMV009222939*",
        "25SYMV009223040",
        "25SYMV009223197",
        "25SYMV009223199*",
        "25SYMV009223198**",
        "25SYMV009222922",
        "25SYMV009223039",
        "25SYMV009222923*"
    ],
    "payments": [
        "25PAY009223018",
        "25PAY009223041",
        "25PAY009223017"
    ]
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
requests Array Λίστα κωδικών ΑΔΑΜ Πρωτογενών Αιτημάτων.
approvedRequests Array Λίστα κωδικών ΑΔΑΜ Εγκεκριμένων Αιτημάτων.
notices Array Λίστα κωδικών ΑΔΑΜ Προσκλήσεων-Προκηρύξεων-Διαρρήξεων.
auctions Array Λίστα κωδικών ΑΔΑΜ Αναθέσεων.
contracts Array Λίστα κωδικών ΑΔΑΜ Συμβάσεων.
payments Array Λίστα κωδικών ΑΔΑΜ Εντολών Πληρωμής.
Παρατηρήσεις

  • Οι ΑΔΑΜ με * αφορούν τροποποιήσεις/επεκτάσεις
  • Οι ΑΔΑΜ με ** αφορούν ματαιώσεις/ακυρώσεις

Ανάκτηση κωδικών ΑΔΑΜ με Ενάριθμο ΠΔΕ

GET /khmdhs-opendata/pde?pdeNumber={pdeNumber}

Περιγραφή

Επιτρέπει την αναζήτηση και ανάκτηση των κωδικών ΑΔΑΜ με βάση την παράμετρο pdeNumber (Ενάριθμος ΠΔΕ).

Παράμετρος

  • pdeNumber (string): Ο Ενάριθμος ΠΔΕ.

Παράδειγμα κλήσης

GET /khmdhs-opendata/pde?pdeNumber=1234567

Παράδειγμα απάντησης


{
    "notices": [
        "25PROC009217643",
        "25PROC009217644",
        "24PROC009213652"
    ],
    "contracts": [
        "25SYMV009223559"
    ],
    "payments": [
        "25PAY009223560"
    ]
}

Περιγραφή πεδίων απάντησης

Πεδίο Τύπος Περιγραφή
notices Array Λίστα κωδικών ΑΔΑΜ Προσκλήσεων-Προκηρύξεων-Διαρρήξεων.
contracts Array Λίστα κωδικών ΑΔΑΜ Συμβάσεων.
payments Array Λίστα κωδικών ΑΔΑΜ Εντολών Πληρωμής.

HTTP Errors

Status Code Description
404 Not Found Αν έχει γίνει απόπειρα ανάκτησης ενός πόρου ο οποίος δεν είναι διαθέσιμος.
400 Bad Request Αν το request που έχει στείλει ο client δεν είναι σωστά διαμορφωμένο (π.χ. δεν είναι valid JSON), ή αν το request έχει ελλιπείς ή εσφαλμένες τιμές.
413 Payload Too Large Το αρχείο που υποβλήθηκε υπερβαίνει το μέγιστο επιτρεπτό μέγεθος.
422 Unprocessable Entity Μη έγκυρο αρχείο PDF που υποβλήθηκε στο αίτημα.
429 Too Many Requests Έχετε υπερβεί το όριο αιτημάτων ανά λεπτό. Δοκιμάστε ξανά αργότερα.
Παράδειγμα Απαντήσεων
{
    "error": "No data found for the given criteria"
}
Παράδειγμα Απάντησης Error 400
{
    "error": "Invalid request payload"
}
Error 400 - Validation Errors
{
    "fieldErrors": {
        "title": "Ο Τίτλος πρέπει να είναι μέχρι 100 χαρακτήρες.",
        "file": "Το αρχείο πρέπει να είναι σε μορφή PDF, μη σκαναρισμένο και μεγέθους < 60MB"."
    }
}
Error 413
{
    "error": "File size exceeds the allowable limit!"
}
Error 422
{
    "error": "Το αρχείο πρέπει να είναι σε μορφή PDF, μη σκαναρισμένο και μεγέθους < 60MB"
}