ΑΝΑΡΤΗΤΕΑ ΣΤΟ ΔΙΑΔΙΚΤΥΟ ΕΛΛΗΝΙΚΗ ΔΗΜΟΚΡΑΤΙΑ Πειραιάς, 25/06/2018 ΥΠΟΥΡΓΕΙΟ ΝΑΥΤΙΛΙΑΣ & Αριθ. Πρωτ.: 2432.6-8/47759/2018 ΝΗΣΙΩΤΙΚΗΣ ΠΟΛΙΤΙΚΗΣ ΚΛΑΔΟΣ ΔΙΟΙΚΗΣΗΣ ΚΑΙ ΗΛΕΚΤΡΟΝΙΚΗΣ ΔΙΑΚΥΒΕΡΝΗΣΗΣ ΔΙΕΥΘΥΝΣΗ ΗΛΕΚΤΡΟΝΙΚΗΣ ΔΙΑΚΥΒΕΡΝΗΣΗΣ & ΕΠΙΚΟΙΝΩΝΙΩΝ Ταχ. Δ/νση : Ακτή Βασιλειάδη (Πύλη Ε1-Ε2) ΠΡΟΣ: Ως Πίνακας Διανομής Ταχ. Κώδικας : 18510, Πειραιάς Πληροφορίες : Πλωτάρχης Λ.Σ. ΑΓΑΠΗΤΟΣ Θ. Ανθυποπλοίαρχος Λ.Σ. ΠΑΝΑΓΙΩΤΙΔΗΣ Σ. Τηλ. : 2131371387/2131371577 FAX : 2104522630 ΘΕΜΑ: «Διαδικασία Υποβολής Ηλεκτρονικού Αρχείου Εκδοθέντων Εισιτηρίων Επιβατών και Αποδείξεων Μεταφοράς Οχημάτων Συστημάτων Η.Σ.Κ.Θ.Ε.Ε.Α. - Μεταφορικού Ισοδύναμου». ΣΧΕΤ: α) Η Αριθ. Πρωτ. 2432.6-8/109763/16/28-12-2016 εγκύκλιος ΥΝΑΝΠ/ΑΛΣ- ΕΛ.ΑΚΤ/ΔΗΔΕΠ «Διαδικασία Υποβολής Ηλεκτρονικού Αρχείου Εκδοθέντων Εισιτηρίων Επιβατών και Αποδείξεων Μεταφοράς Οχημάτων Συστημάτων Η.Σ.Κ.Θ.Ε.Ε.Α.». β) Η Αριθ. Πρωτ. 2432.6-8/44996/18/15-06-2018 εγκύκλιος ΥΝΑΝΠ/ΑΛΣ- ΕΛ.ΑΚΤ/ΔΗΔΕΠ «Διαδικασία Υποβολής Ηλεκτρονικού Αρχείου Εκδοθέντων Εισιτηρίων Επιβατών και Αποδείξεων Μεταφοράς Οχημάτων Συστημάτων Η.Σ.Κ.Θ.Ε.Ε.Α. - Μεταφορικού Ισοδύναμου» (ΑΔΑ: Ω0ΦΒ4653ΠΩ-ΥΚΩ). γ) Το Αριθ. Πρωτ. 2432.6-1/46327/20-06-2018 Έγγραφό μας. 1. Σε συνέχεια του (γ) σχετικού, πραγματοποιήθηκε την Παρασκευή 22/06/2018 σύσκεψη εργασίας στο Υπουργείο Ναυτιλίας και Νησιωτικής Πολιτικής, με αντικείμενο την προσαρμογή των πληροφοριακών συστημάτων των ακτοπλοϊκών εταιριών στις απαιτήσεις του μέτρου του Μεταφορικού Ισοδύναμου (ΜΙ) στα νησιά, ενόψει της έναρξης της πιλοτικής εφαρμογής του ΜΙ που αναμένεται από τις αρχές Ιουλίου. 2. Για την έγκαιρη προετοιμασία των ναυτιλιακών και λοιπών συναφών εταιρειών, πριν την έναρξη της πιλοτικής εφαρμογής του ΜΙ, σας γνωρίζουμε ότι ήδη λειτουργεί δοκιμαστικό σύστημα στο διαδικτυακό τόπο https://hsk9eea-pubuat.hcg.gr/ τον οποίο οι ενδιαφερόμενοι μπορούν να χρησιμοποιήσουν ώστε να επιβεβαιώσουν την συμβατότητα των προς αποστολή αρχείων και των σχετικών διαδικασιών τους προκειμένου να προβούν έγκαιρα στις απαραίτητες ρυθμίσεις/διορθώσεις. Σελίδα 1 από 18
3. Σημειώνεται ότι για την πρόσβαση στον ανωτέρω διαδικτυακό τόπο θα χρησιμοποιούνται τα διαπιστευτήρια (credentials) που σας είχαν χορηγηθεί στο πλαίσιο της (α) σχετικής, που επισυνάπτεται εκ νέου για την ενημέρωσή σας. Σε περίπτωση που απαιτηθεί η εγγραφή νέων χρηστών στο δοκιμαστικό σύστημα, θα πρέπει να ακολουθηθεί η διαδικασία που περιγράφεται στην (α) σχετική. Επιπρόσθετα, η θέση 177 [Επιβεβαίωση επιβίβασης επιβάτη (1=ναι 2=όχι)] όπως περιγράφεται στο Παράρτημα της (β) σχετικής, θα πρέπει να έχει προκαθορισμένη (default) την τιμή 2. 4. Πέραν των ανωτέρω και ως προς την υλοποίηση του πληροφοριακού συστήματος του ΜΙ, που αναπτύσσεται από την ΕΔΕΤ ΑΕ, σας γνωρίζεται ότι έχουν υλοποιηθεί κατάλληλες διεπαφές (web services), με τις οποίες κάθε εμπλεκόμενη επιχείρηση (ναυτιλιακή εταιρία, επιχείρηση online κρατήσεων εισιτηρίων κ.λπ.) μπορεί να αντλεί στοιχεία σύμφωνα με τις διαδικασίες που περιγράφονται στο επισυναπτόμενο παράρτημα. 5. Για την παροχή τυχόν περαιτέρω διευκρινήσεων ή/και οδηγιών μπορείτε να απευθύνεστε στο ΥΝΑΝΠ/ΑΛ.Σ.-ΕΛ.ΑΚΤ/ΔΗΔΕΠ Β /Γρ. ΗΣΚΘΕΕΑ (Ανθυποπλοίαρχος Λ.Σ. ΠΑΝΑΓΙΩΤΙΔΗΣ Σταύρος, στα τφ: 2131371577, 2131371386, Fax: 2104522630 και στην ηλεκτρονική διεύθυνση isktheea@hcg.gr), στη Γενική Γραμματεία Αιγαίου και Νησιωτικής Πολιτικής/Διεύθυνση Νησιωτικής Πολιτικής/Τμήμα Ευρωπαϊκών Θεμάτων (Κελαϊδίτης Κωνσταντίνος, στα τφ: 2251350273 και 2251046920, Fax: 2251041175 και στην ηλεκτρονική διεύθυνση kkela@ypai.gr), και στην ΕΔΕΤ Α.Ε. (Διακονικολάου Κυριάκος στην ηλεκτρονική διεύθυνση kdiako@grnet.gr).- Ο ΔΙΕΘΥΝΤΗΣ Επισυνάπτονται: 1. Παράρτημα (σελ. 09) 2. Η (α) σχετική (σελ. 05) Αντιπλοίαρχος Λ.Σ. ΜΑΡΓΑΡΩΝΗΣ Ι. Σελίδα 2 από 18
ΠΙΝΑΚΑΣ ΔΙΑΝΟΜΗΣ: Ι. ΑΠΟΔΕΚΤΕΣ ΠΡΟΣ ΕΝΕΡΓΕΙΑ (Μέσω Τ/Ο) 1. ABP SINGLE MEMBER PRIVATE COMPANY 2. ΑΒΛΕΜΟΝ ΝΕ 3. ΑΓΙΑ ΜΑΡΙΝΗ Ι ΝΕ 4. ΑΓΙΟΣ ΕΥΣΤΑΘΙΟΣ ΝΕ 5. ΑΕΙΝΑΥΤΗΣ ΝΕ 6. ΑΘΩΝΙΤΗΣ ΝΕ 7. ΑΙΓΑΙΟΝ ΠΕΛΑΓΟΣ ΘΑΛΑΣΣΙΕΣ ΓΡΑΜΜΕΣ ΝΕ 8. ΑΙΔΗΨΟΣ ΦΕΡΡΥΣ ΝΕ 9. ΑΙΤΖΙΑΝ ΣΠΗΝΤ ΛΑΪΝΣ ΝΕ 10. ΑΝΔΡΟΣ ΦΑΣΤ ΦΕΡΡΙΣ ΝΕ 11. Α.Ν.Ε. ΚΑΛΥΜΝΟΥ 12. ΑΝΕΝΔΥΚ ΑΕ 13. ΑΝΩΝΥΜΟΣ ΝΑΥΤΙΛΙΑΚΗ ΜΕΤΑΦΟΡΙΚΗ ΕΤΑΙΡΕΙΑ ΖΑΚΥΝΘΟΥ ΑΕ 14. ΑΞΙΟΚΕΡΣΑ ΝΕ 15. ΓΑΥΛΟΣ Ι ΝΕ 16. ΓΚΟΛΝΤΕΝ ΣΤΕΠ ΣΙΠΙΝΓΚ Ε.Π.Ε. 17. ΕΛΛΗΝΙΚΗ ΦΛΟΓΑ ΦΑΣΤ ΦΕΡΙΣ ΝΕ 18. ΘΑΛΑΣΣΙΟ ΠΑΛΑΤΙ ΝΑΥΤΙΚΗ ΕΤΑΙΡΕΙΑ 19. ΙΟΝΙΟΝ Π ΝΕ 20. ΙΠΤΑΜΕΝΑ ΔΕΛΦΙΝΙΑ ΑΙΓΑΙΟΥ V ΝΕ 21. ΙΠΤΑΜΕΝΑ ΔΕΛΦΙΝΙΑ ΑΙΓΑΙΟΥ VI ΝΕ 22. ΙΠΤΑΜΕΝΑ ΔΕΛΦΙΝΙΑ ΑΙΓΑΙΟΥ VII ΝΕ 23. Κ ΛΑΪΝΣ ΝΕ 24. ΚΑΡΘΑΙΑ ΝΕ 25. ΚΑΡΥΣΤΙΑ ΝΕ 26. ΚΑΤΕΡΟΣ ΝΕ 27. ΚΟΙΝΟΠΡΑΞΙΑ ΑΝΕΚ ΑΕ SUPERFAST ENDEKA (HELLAS) INC & ΣΙΑ 28. ΚΟΙΝΟΠΡΑΞΙΑ ΔΡΟΜΟΛΟΓΙΑΚΩΝ ΠΛΟΙΩΝ ΚΕΡΚΥΡΑΣ ΠΑΞΩΝ 29. ΚΟΙΝΟΠΡΑΞΙΑ ΔΩΔΕΚΑΝΗΣΟΣ ΘΑΛΑΣΣΙΕΣ ΓΡΑΜΜΕΣ 30. ΚΟΙΝΟΠΡΑΞΙΑ ΙΟΝΙΑΝ ΓΚΡΟΥΠ 31. ΚΟΙΝΟΠΡΑΞΙΑ ΜΠΛΟΥ ΣΤΑΡ ΦΕΡΡΙΣ ΝΑΥΤΙΛΙΑΚΗ ΑΕ & ΣΙΑ 32. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΑΝΕΣ ΦΕΡΡΙΣ 33. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΚΕΡΚΥΡΑΣ 34. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΚΕΦΑΛΟΝΙΑΝ ΛΑΪΝΣ 35. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΠΟΡΘΜΕΙΑΚΩΝ ΓΡΑΜΜΩΝ ΘΑΣΟΥ ΚΑΒΑΛΑΣ 36. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΡΑΦΗΝΑΣ ΜΑΡΜΑΡΙΟΥ 37. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΣΑΡΩΝΙΚΟΥ 38. ΚΟΙΝΟΠΡΑΞΙΑ ΠΛΟΙΩΝ ΣΤΥΡΩΝ ΑΓ. ΜΑΡΙΝΑΣ 39. ΚΟΙΝΟΠΡΑΞΙΑ ΠΟΡΘΜΕΙΩΝ ΑΙΔΗΨΟΥ ΑΡΚΙΤΣΑΣ 40. ΚΟΙΝΟΠΡΑΞΙΑ ΣΙΤΖΕΤΣ HSJ ΝΕ & ΣΙΑ 41. ΚΟΙΝΟΠΡΑΞΙΑ ΣΙΤΖΕΤΣ ΤΣΑΜΠΙΟΝΣ ΝΕ & ΣΙΑ 42. ΚΥΚΛΑΔΕΣ ΦΑΣΤ ΦΕΡΙΣ ΝΕ 43. ΛΑΦΑΣΙ ΝΕ 44. ΛΕΥΚΙΜΜΗ ΛΑΪΝΣ ΝΕ 45. ΛΥΡΑ ΝΕ 46. ΜΑΝΟΥΣΟΣ ΓΕΩΡΓΙΟΣ 47. ΜΙΚΡΕΣ ΚΥΚΛΑΔΕΣ ΝΕ 48. ΜΙΝΩΙΚΕΣ ΓΡΑΜΜΕΣ ΑΝΕ 49. ΝΑΥΤΙΚΗ ΕΤΑΙΡΕΙΑ ΑΙΓΑΙΟΥ 50. ΝΑΥΤΙΚΗ ΕΤΑΙΡΕΙΑ ΝΗΣΟΣ ΠΑΞΩΝ 51. ΝΕ ΠΟΡΘΜΕΙΩΝ ΓΛΥΦΑΣ ΑΓΙΟΚΑΜΠΟΥ 52. ΝΟΣΤΟΣ ΝΕ 53. ΠΑΡΟΣ ΑΝΤΙΠΑΡΟΣ ΝΕ 54. ΠΟΡΘΜΕΙΑΚΗ Ι ΝΕ 55. ΠΟΡΦΥΡΟΥΣΑ ΝΕ 56. ΣΑΝ ΡΑΪΖ ΛΑΪΝΣ ΕΠΕ 57. ΣΑΡΡΗΣ ΚΕΡΚΥΡΑΪΚΕΣ ΓΡΑΜΜΕΣ ΝΕ 58. ΣΙ ΕΣ ΦΕΡΙΣ ΝΕ 59. ΣΙ ΤΖΕΤΣ ΝΕ 60. ΣΚΥΡΟΣ ΝΕ 61. ΣΥΛΛΟΓΟΣ ΦΙΛΟΙ ΟΙΝΟΥΣΩΝ 62. ΤΑΦΙΩΝ ΝΑΥΤΙΚΗ ΕΤΑΙΡΕΙΑ 63. ΤΖΑΜΠΟ ΤΖΕΤ ΝΕ 64. ΦΛΙΠ ΕΝΑ ΝΑΥΤΙΚΗ ΕΤΑΙΡΕΙΑ 65. ΧΕΛΛΕΝΙΚ ΣΗΓΟΥΕΪΣ ΑΝΕ 66. ΧΡΥΣΟ ΑΣΤΕΡΙ ΝΕ Σελίδα 3 από 18
ΙΙ. ΑΠΟΔΕΚΤΕΣ ΠΡΟΣ ΚΟΙΝΟΠΟΙΗΣΗ 1. Σύνδεσμος Επιχειρήσεων Επιβατηγού Ναυτιλίας Ακτή Μιαούλη 7-9, Πειραιάς, 185 35 (Τ/Ο: 2104220822) 2. ΕΔΕΤ Α.Ε. (Υπόψη κ. ΔΙΑΚΟΝΙΚΟΛΑΟΥ Κ., E-Mail: kdiako@grnet.gr) ΙΙΙ. ΕΣΩΤΕΡΙΚΗ ΔΙΑΝΟΜΗ 1. Γρ. κ. ΥΝΑΝΠ (υτα) 2. Γρ. κ. ΥΦΝΑΝΠ (υτα) 3. Γρ. κ. Γ.Γ. ΥΝΑΝΠ (υτα) 4. Γρ. κ. ΓΓΑΙΝΠ (υτα) 5. Γρ. κ. Α/ΛΣ - ΕΛ.ΑΚΤ. (υτα) 6. Γρ. κ. Α Υ/ΛΣ - ΕΛ.ΑΚΤ. (υτα) 7. Γρ. κ. Β Υ/ΛΣ - ΕΛ.ΑΚΤ. (υτα) 8. Γρ. κ. ΓΕΛΣ - ΕΛ.ΑΚΤ. (υτα) 9. Γρ. κ. ΔΚΑ (υτα) 10. Γρ. κ. ΔΚΒ (υτα) 11. Γρ. κ. ΔΚΓ (υτα) 12. Γρ. κ. ΔΚΔ (υτα) 13. ΔΛΑ 14. ΔΘΣ 15. Γενικό Διευθυντή ΓΑΙΝΠ Σελίδα 4 από 18
ΠΑΡΑΡΤΗΜΑ Web Services στη διάθεση των Ναυτιλιακών Εταιριών Στο πλαίσιο του Π.Σ. της δράσης του Μεταφορικού Ισοδύναμου, έχουν υλοποιηθεί web services με τα οποία κάθε νόμιμα ενδιαφερόμενος (ναυτιλιακή εταιρία, επιχείρηση online κρατήσεων εισιτηρίων, κα) μπορεί: 1. Να ελέγχει εάν ένας Μ.Α.Ν. που έχει λάβει από έναν πολίτη είναι έγκυρος και ότι όντως έχει αποδοθεί σε κάποιον δικαιούχο (χωρίς να μαθαίνει τα προσωπικά στοιχεία του δικαιούχου) 2. Να λαβαίνει το Ονοματεπώνυμο και το Νησί της κύριας κατοικίας του πολίτη που προσκόμισε ή συμπλήρωσε το Μ.Α.Ν. του. Για την κλήση του 2ου σετ (όπου η ενδιαφερόμενη εταιρία λαβαίνει το Ονοματεπώνυμο και το Νησί που αντιστοιχεί σε ένα Μ.Α.Ν. που προσκόμισε σε αυτόν ένας πολίτης) απαιτείται ειδική διαπίστευση του Π.Σ. που τα καλεί, δεδομένου ότι ανακοινώνονται προσωπικά δεδομένα του πολίτη. Για τις ανάγκες του ελέγχου της λειτουργίας των Web Services από τους ενδιαφερόμενους φορείς, είναι άμεσα διαθέσιμα σε πιλοτικό περιβάλλον, όπου τα δεδομένα Μ.Α.Ν. και Ονομάτων που περιέχει είναι εικονικά και εξυπηρετούν μόνο λόγους ελέγχου. Σελίδα 5 από 18
Τεχνική περιγραφή των Web Services Τα Web Services βρίσκονται στα εξής endpoints: http://metaforiko.pilotiko.gr/api/common/manvalidation M.A.N. Web Service ελέγχου εγκυρότητας http://metaforiko.pilotiko.gr/api/common/login Web Service λήψης access token http://metaforiko.pilotiko.gr/api/common/mandata Web Service λήψης του ονοματεπωνύμου που αντιστοιχεί σε ένα Μ.Α.Ν. ΠΑΡΑΤΗΡΗΣΗ: Στην παραγωγική έκδοση του Π.Σ. του Μεταφορικού Ισοδύναμου, τα παρακάτω Web Services θα καλούνται σε διαφορετικά Access Points και θα είναι πάνω από secure σύνδεση (https). Η απάντηση σε κάθε Web Service είναι πάντα της μορφής Success: true/false, StatusCode: enumeration με τα πιθανά errors, StatusMessage: μήνυμα λάθους, Result: το αποτέλεσμα του service, Reminder: δευτερεύοντα ενημερωτικά μηνύματα (δεν συνδέονται με την επιτυχία ή όχι της κλήσης) Τα κοινά StatusCode για κάθε Service είναι τα εξής: Status Code OK Errors UnexpectedError Status Message Επιτυχής κλήση Υπήρξαν σφάλματα. Για περισσότερες πληροφορίες ελέγξτε το πεδίο Errors μέσα στο Result. Παρουσιάστηκε σφάλμα στην εφαρμογή (π.χ. λάθος κλήση του service, λάθος json, κλπ) Κάθε Web Service μπορεί να έχει επιπλέον δικά του Status Code, τα οποία αναφέρονται στην περιγραφή του κάθε ενός από αυτά. Για τις ανάγκες του ελέγχου της λειτουργίας των Web Services από τους ενδιαφερόμενους φορείς, μπορείτε να δοκιμάσετε κλήσεις με τα ακόλουθα M.A.N. Μ.Α.Ν.: 344455733 Ον/μο: ΠΕΤΡΟΣ ΝΙΚΟΛΑΟΥ Νησί: ΙΚΑΡΙΑ Μ.Α.Ν.: 117175022 Ον/μο: ΕΛΕΝΗ ΤΣΑΛΙΚΗ Νησί: ΙΚΑΡΙΑ Τόσο τα Μ.Α.Ν. όσο και τα Ονοματεπώνυμα που έχουν ανατεθεί σε αυτά είναι εικονικά και μόνο για τις ανάγκες ελέγχου της καλής λειτουργίας των Web Services. Σελίδα 6 από 18
1 Web Service ελέγχου εγκυρότητας M.A.N. Με το Web Service αυτό κάθε ενδιαφερόμενος μπορεί να ελέγξει εάν ένας 9 ψήφιος αριθμός: Είναι έγκυρος αριθμός Μ.Α.Ν. σύμφωνα με τους κανόνες εγκυρότητας Εφόσον είναι έγκυρος, εάν έχει αποδοθεί σε δικαιούχο της δράσης. Εφόσον είναι έγκυρος και έχει αποδοθεί σε δικαιούχο, λαμβάνει τους 2 πρώτους χαρακτήρες του Επωνύμου και του Ονόματος του δικαιούχου (που δεν αποτελούν προσωπικό δεδομένο) Για την κλήση του Web Service αυτού, ο καλών πρέπει να εισάγει στους Headers του request το πεδίο access_token με τιμή D991B9D0-A7DE-4130-B7F3-8E24A875F855 Αν δεν εισαχθεί το πεδίο, η κλήση επιστρέφει HTTP CODE 400 Bad Αν εισαχθεί, αλλά όχι με τη σωστή τιμή, η κλήση επιστρέφει HTTP CODE 401 Unauthorized GET στο endpoint http://metaforiko.pilotiko.gr/api/common/manvalidation/man όπου MAN ο Μοναδικός Αριθμός Νησιώτη "Reminder":"String content", "StatusCode":"String content", "StatusMessage":"String content", "Success":true/false, "Result": "CheckedMAN":"String content", "PersonInitials":"String content" Όπου Success: true μόνο αν ο ΜΑΝ είναι έγκυρος και ανήκει σε κάποιο δικαιούχο της εφαρμογής CheckedMAN: Ο ΜΑΝ για τον οποίο έγινε ο έλεγχος PersonInitials: Το αρχικό γράμμα του επωνύμου και του ονόματος του δικαιούχου Status Messages Σελίδα 7 από 18
Status Code EmptyMAN InvalidMAN MANNotFound Status Message Δεν δώσατε Μοναδικό Αριθμό Νησιώτη Ο αριθμός που δώσατε δεν είναι έγκυρος Μοναδικός Αριθμός Νησιώτη Δεν βρέθηκε δικαιούχος με το Μοναδικό Αριθμό Νησιώτη που δώσατε Παραδείγματα κλήσης στο πιλοτικό site http://metaforiko.pilotiko.gr/api/common/manvalidation/ "Reminder": null, "StatusCode": "EmptyMAN", "StatusMessage": "Δεν δώσατε Μοναδικό Αριθμό Νησιώτη", "Success": false, "Result": null http://metaforiko.pilotiko.gr/api/common/manvalidation/111111111 "Reminder": null, "StatusCode": "InvalidMAN", "StatusMessage": "Ο αριθμός που δώσατε δεν είναι έγκυρος Μοναδικός Αριθμός Νησιώτη", "Success": false, "Result": null http://metaforiko.pilotiko.gr/api/common/manvalidation/656075150 Σελίδα 8 από 18
"Reminder": null, "StatusCode": "MANNotFound", "StatusMessage": "Δεν βρέθηκε δικαιούχος με το Μοναδικό Αριθμό Νησιώτη που δώσατε", "Success": false, "Result": null http://metaforiko.pilotiko.gr/api/common/manvalidation/344455733 "Reminder": null, "StatusCode": "OK", "StatusMessage": "Επιτυχής κλήση", "Success": true, "Result": "CheckedMAN": "344455733", "PersonInitials": "ΠΝ" Σελίδα 9 από 18
2 Web Service λήψης του Ον/μου που αντιστοιχεί σε ένα M.A.N. Με το Web Service αυτό, διαπιστευμένα Π.Σ. τρίτων φορέων (ναυτιλιακών εταιριών, εταιριών online κρατήσεων εισιτηρίων, κλπ) μπορούν να λαμβάνουν το Ονοματεπώνυμου που αντιστοιχεί σε ένα Μ.Α.Ν. που τους έχει προσκομίσει ένας επιβάτης που είναι δικαιούχος της δράσης. Σε κάθε διαπιστευμένο Π.Σ. τρίτου φορέα θα αποδίδουμε ένα username, password προκειμένου με αυτά να λαμβάνουν το κατάλληλο access token προκειμένου να καλεί το Web Service λήψης του ονοματεπωνύμου που αντιστοιχεί σε ένα Μ.Α.Ν. 2.1 Λήψη access token POST στο endpoint http://metaforiko.pilotiko.gr/api/common/login "Username":username, "Password":password "Reminder": "String content", "StatusCode": "String content", "StatusMessage": "String content", "Success": true/false, "Result": "AccessToken": "String content" ΣΗΜΑΝΤΙΚΗ ΣΗΜΕΙΩΣΗ: Κατά την κλήση οποιουδήποτε άλλου service πρέπει στο Header του να υπάρχει το property access_token με τιμή την τιμή AccessToken που επιστρέφει το service Login. Η διάρκεια ισχύος του AccessToken είναι 24 ώρες. Άρα θα πρέπει να το ανανεώνετε σε μικρότερο από αυτό το χρονικό διάστημα. Status Messages Status Code FailedUserValidation Status Message Τα στοιχεία χρήστη (username, password) δεν είναι σωστά Για απόκτηση access token στο πιλοτικό περιβάλλον, κάθε ενδιαφερόμενος μπορεί να δώσει: Username: praktoreio Password: pr@kt0r310 Σελίδα 10 από 18
2.2 Κλήση του Web Service MANData GET στο endpoint http://metaforiko.pilotiko.gr/api/common/mandata/man όπου MAN ο Μοναδικός Αριθμός Νησιώτη "Reminder": "String content", "StatusCode": "String content", "StatusMessage": "String content", "Success": true/false, "Result": "CheckedMAN": "String content", "Island": "String content", "PersonName": "String content", "PersonNameInLatin": "String content" όπου Success: true μόνο αν ο ΜΑΝ είναι έγκυρος και ανήκει σε κάποιο δικαιούχο της εφαρμογής CheckedMAN: Ο ΜΑΝ για τον οποίο έγινε ο έλεγχος Island: Το νησί της κύριας κατοικίας του δικαιούχου PersonName: Το Ον/μο του δικαιούχου PersonNameInLatin: Το Ον/μο του δικαιούχου με λατινικούς χαρακτήρες Status Messages Status Code EmptyMAN InvalidMAN MANNotFound Status Message Δεν δώσατε Μοναδικό Αριθμό Νησιώτη Ο αριθμός που δώσατε δεν είναι έγκυρος Μοναδικός Αριθμός Νησιώτη Δεν βρέθηκε δικαιούχος με το Μοναδικό Αριθμό Νησιώτη που δώσατε Σελίδα 11 από 18
Παραδείγματα κλήσης στο πιλοτικό site http://metaforiko.pilotiko.gr/api/common/mandata/ "Reminder": null, "StatusCode": "EmptyMAN", "StatusMessage": "Δεν δώσατε Μοναδικό Αριθμό Νησιώτη", "Success": false, "Result": null http://metaforiko.pilotiko.gr/api/common/mandata/111111111 "Reminder": null, "StatusCode": "InvalidMAN", "StatusMessage": "Ο αριθμός που δώσατε δεν είναι έγκυρος Μοναδικός Αριθμός Νησιώτη", "Success": false, "Result": null http://metaforiko.pilotiko.gr/api/common/mandata/656075150 "Reminder": null, "StatusCode": "MANNotFound", "StatusMessage": "Δεν βρέθηκε δικαιούχος με το Μοναδικό Αριθμό Νησιώτη που δώσατε", "Success": false, "Result": null Σελίδα 12 από 18
http://metaforiko.pilotiko.gr/api/common/mandata/344455733 "Reminder": null, "StatusCode": "OK", "StatusMessage": "Επιτυχής κλήση", "Success": true, "Result": "CheckedMAN": "344455733", "Island": "ΙΚΑΡΙΑ", "PersonName": "ΠΕΤΡΟΣ ΝΙΚΟΛΑΟΥ", "PersonNameInLatin": "PETROS NIKOLAOU" Σελίδα 13 από 18