Σημειώνεται ότι τα αρχεία επιτρέπεται να περιέχουν αγγλικούς και ελληνικούς χαρακτήρες αλλά πρέπει να είναι κωδικοποιημένα σύμφωνα με το πρότυπο ISO-8859-7 (αντίστοιχο του ΕΛΟΤ-928) και όχι ως unicode.
Εκτός από τα απλά αρχεία κειμένου, μπορείτε να ανεβάσετε και συμπιεσμένα αρχεία (τύπου zip) τα οποία περιέχουν ένα ή περισσότερα απλά αρχεία ΗΣΚΘΕΕΑ. Σημειώνεται ότι τα αρχεία zip πρέπει να περιέχουν μόνον απλά αρχεία ΗΣΚΘΕΕΑ, χωρίς αυτά να βρίσκονται μέσα σε υποφακέλους εντός του zip
Για την απλή υποβολή των αρχείων, θα πρέπει, αφού συνδεθείτε κανονικά στο σύστημα (δηλαδή αφού δημιουργηθεί ο λογαριασμός σας και γίνει η συσχέτιση του με τα στοιχεία της εταιρείας που εκπροσωπείτε) να χρησιμοποιήσετε την επιλογή "Αρχεία ΗΣΚΘΕΕΑ". Στη σελίδα αυτή έχετε τη δυνατότητα να δείτε τα αρχεία που έχετε ήδη ανεβάσει (είτε μέσω φόρμας είτε μέσω API) καθώς και να επιλέξετε το κουμπί "Ανέβασμα αρχείου".
Όταν επιλέξετε το "Ανέβασμα αρχείου" θα μεταφερθείτε σε μια φόρμα στην οποία θα μπορείτε να επιλέξετε το αρχείο που θέλετε να ανεβάσετε και πατώντας "Ανέβασμα". Σημειώνεται ότι αφού υποβληθεί το αρχείο θα εκτελεστούν άμεσα μια σειρά από έλεγχοι εγκυρότητας του αρχείου, ενώ σε περίπτωση που το αρχείο δεν είναι έγκυρο θα δείτε κατάλληλο μήνυμα σφάλματος και θα πρέπει να διορθώσετε κατάλληλα το αρχείο και να το υποβάλλετε ξανά αλλιώς δε θα καταγραφεί η υποβολή του!
Σε περίπτωση ορθής υποβολής του αρχείου θα μπορείτε να δείτε πληροφορίες για το αρχείο στην αντίστοιχη λίστα.
Σε περίπτωση που το μηχανογραφικό σας σύστημα έχει κατάλληλες δυνατότητες μπορείτε να το συνδέσετε με την εφαρμοφή ώστε τα αρχεία να υποβάλλονται αυτόματα όταν ετοιμαστούν. Συγκεκριμένα, η αυτόματη υποβολή ενός αρχείου μπορεί να γίνει εκτελώντας ένα απλό HTTP POST στη διεύθυνση "/api/upload". Συγκεκριμένα, θα πρέπει να εκτελέσετε POST με το όνομα του αρχείου μέσω της παραμέτρου "name" και τα περιεχόμενα του μέσω της παραμέτρου "file". Το περιεχόμενο που θα ανεβάσετε θα πρέπει να είναι της μορφής "multipart/form-data" ενώ για την ταυτοποίηση θα χρησιμοποιήσετε τα ίδια credentials μέσω των οποίων συνδέεσετε στην εφαρμογή ως BASIC HTTP authentication.
Σαν παράδειγμα, έστω ότι θέλετε να υποβάλετε το αρχείο με όνομα "11141500.083" και το email/password που χρησιμοποιείτε είναι τα paul@company.gr / 123. Η υποβολή του εν λόγω αρχείου, μπορεί να γίνει μέσω της ακόλουθης κλήσης του προγράμματος cURL (https://curl.haxx.se/): για το δοκιμαστικό σύστημα εκτελέστε:
curl -u paul@company.gr:123 https://hsk9eea-pubuat.hcg.gr/api/upload/ -X POST -H "Content-Type: multipart/form-data" -F "name=11141500.083" -F "file=@11141500.083"
ενώ για το παραγωγικό σύστημα εκτελέστε:
curl -u paul@company.gr:123 https://isktheea.hcg.gr/api/upload/ -X POST -H "Content-Type: multipart/form-data" -F "name=11141500.083" -F "file=@11141500.083"
Σημειώνεται ότι το αρχείο μπορεί να είναι είτε απλό αρχείο κειμένου ΗΣΚΘΕΕΑ (όπως στο
παράδειγμα) είτε αρχείο zip που περιέχει πολλαπλά αρχεία ΗΣΚΘΕΕΑ.
Για κάθε κλήση του API θα λάβετε απάντηση σε μορφή JSON. Σε περίπτωση που η υποβολή του αρχείου έγινε με επιτυχία η ιδιότητα "success" του JSON response θα είναι αληθής (true). Σε αντίθετη περίπτωση, η εν λόγω ιδιότητα θα είναι ψευδής (false) ενώ μέσω της ιδιότητας "message" θα δείτε το ακριβές μήνυμα σφάλματος που εμφανίζεται και μέσω της ιδιότητας "exception" θα δείτε την εξαίρεση (exception) λόγω της οποίας απέτυχε η υποβολή του αρχείου.
Σαν παράδειγμα, για την προηγούμενη υποβολή του αρχείου 11141500.83, αν θεωρηθεί ότι έχει ξαναγίνει, θα ληφθεί το εξής απαντητικό μήνυμα:
{
"success":false,
"exception":"gr.hcg.hsk9eea.service.parse.exceptions.InvalidFileException",
"message":"Sailing 11141500.083 has already been handled!"
}
Κατά την υποβολή των αρχείων γίνονται έλεγχοι εγκυρότητας των στοιχείων που περιέχει το αρχείο. Σε περίπτωση σφάλματος η υποβολή θεωρείται αποτυχημένη και θα πρέπει το αρχείο να υποβληθεί ξανά αφού διορθωθεί. Σε περίπτωση που υποβάλλεται zip αρχείο θα γίνει έλεγχος σε όλα τα επιμέρους αρχεία ΗΣΚΘΕΕΑ που περιέχει και η υποβολή τους θα γίνει μόνον εφόσον όλα είναι έγκυρα. Δηλαδή για ένα zip αρχείο είτε θα υποβληθούν όλα τα επιμέρους αρχεία ΗΣΚΘΕΕΑ που αυτό περιέχει (όταν όλα είναι έγκυρα) είτε κανένα (αν εστω και ένα αρχείο έχει σφάλμα).
Ορισμένοι έλεγχοι που εκτελούνται στα αρχεία:
Γραφείο εποπτείας συστημάτων ΗΣΚΘΕΕΑ:
Τηλέφωνα :213 137 1577 - 213 137 1061 - 213 137 1388
E-mail: isktheea@hcg.gr