Web Services User Manual

Transcription

Γεληθή Γξακκαηεία Πιεξνθνξηαθώλ ΢πζηεκάηωλ
ΤΛΟΠΟΙΗ΢Η ΣΕΛΩΝΕΙΑΚΩΝ ΗΛΕΚΣΡΟΝΙΚΩΝ ΤΠΗΡΕ΢ΙΩΝ
ICISnet
WEB SERVICES
ΔΙΑΔΙΚΣΤΑΚΕ΢ ΤΠΗΡE΢ΙΕ΢ (WEB SERVICES) ΕΦΑΡΜΟΓΗ΢ ΗΛΕΚΣΡΟΝΙΚΗ΢ ΤΠΟΒΟΛΗ΢
ΠΑΡΑ΢ΣΑΣΙΚΩΝ
Έθδνζε: 2.01
01/01/2012
ΣΟ ΕΡΓΟ ΢ΤΓΥΡΗΜΑΣΟΔΟΣΕΙΣΑΙ ΑΠΟ
ΣΟ ΕΤΡΩΠΑΙΚΟ ΣΑΜΕΙΟ ΠΕΡΙΦΕΡΕΙΑΚΗ΢ ΑΝΑΠΣΤΞΗ΢ (ΕΣΠΑ),
ΣΟ ΕΤΡΩΠΑΙΚΟ ΚΟΙΝΩΝΙΚΟ ΣΑΜΕΙΟ (ΕΚΣ)
ΚΑΙ ΑΠΟ ΕΘΝΙΚΟΤ΢ ΠΟΡΟΤ΢
ΕΛΛΗΝΙΚΗ
ΔΗΜΟΚΡΑΣΙΑ
ΤΠΟΤΡΓΕΙΟ
ΟΙΚΟΝΟΜΙΑ΢ ΚΑΙ
ΟΙΚΟΝΟΜΙΚΧΝ
ΤΠ. Ε΢ΧΣ. ΔΗΜ.
ΔΙΟΙΚ. &
ΑΠΟΚΕΝΣΡΧ΢Η΢
ΕΤΡΧΠΑΙΚΗ
Γ’ ΚΟΙΝΟΣΙΚΟ
ΕΝΧ΢Η
ΠΛΑΙ΢ΙΟ ΢ΣΗΡΙΞΗ΢
2000 – 2006
ΕΙΔΙΚΗ ΓΡΑΜΜΑΣΕΙΑ
ΦΗΦΙΑΚΟΤ ΢ΥΕΔΙΑ΢ΜΟΤ
ΕΙΔΙΚΗ ΤΠΗΡΕ΢ΙΑ ΔΙΑΥΕΙΡΙ΢Η΢
ΕΠΙΥΕΙΡΗ΢ΙΑΚΟΤ
ΠΡΟΓΡΑΜΜΑΣΟ΢
«ΚΟΙΝΩΝΙΑ ΣΗ΢ ΠΛΗΡΟΦΟΡΙΑ΢»
ΕΠΙΥΕΙΡΗ΢ΙΑΚΟ
ΠΡΟΓΡΑΜΜΑ
«ΚΟΙΝΧΝΙΑ ΣΗ΢
ΠΛΗΡΟΦΟΡΙΑ΢
2000 – 2006»
ICISnet
REF: WebServicesV2.00
ΔΙΑΔΙΚΣΤΑΚΕ΢ ΤΠΗΡE΢ΙΕ΢ (WEB SERVICES) ΕΦΑΡΜΟΓΗ΢ ΗΛΕΚΣΡΟΝΙΚΗ΢ ΤΠΟΒΟΛΗ΢ ΠΑΡΑ΢ΣΑΣΙΚΩΝ
ΣΙΣΛΟ΢
:
ΔΙΑΔΙΚΣΤΑΚΕ΢ ΤΠΗΡΕ΢ΙΕ΢ (WEB SERVICES) ΕΦΑΡΜΟΓΗ΢ ΗΛΕΚΣΡΟΝΙΚΗ΢
ΤΠΟΒΟΛΗ΢
ΠΑΡΑ΢ΣΑΣΙΚΩΝ
ΤΛΟΠΟΙΗ΢Η
–
ΣΔΛΧΝΔΙΑΚΧΝ
ΗΛΔΚΣΡΟΝΙΚΧΝ ΤΠΗΡΔ΢ΙΧΝ - ICISnet
ΚΧΓΙΚΟ΢
:
WebServices
ΣΤΠΟ΢
:
ΔΓΥΔΙΡΙΓΙΟ ΥΡΗ΢Η΢
ΔΚΓΟ΢Η
:
02.01
ΚΑΣΑ΢ΣΑ΢Η
:
Γεύηεξε Έθδνζε
ΗΜΔΡΟΜΗΝΙΑ
:
01/01/2012
΢ΤΓΓΡΑΦΔΑ΢
:
ΛΙ΢ΣΑ ΓΙΑΝΟΜΗ΢
:
Γ.Γ.Π.΢.
Ι΢ΣΟΡΙΚΟ ΑΛΛΑΓΩΝ
Έθδνζε
Ηκεξνκελία
Αηηηνινγία Αιιαγήο
0.10
21/01/11
Αξρηθή έθδνζε γηα εζσηεξηθό πνηνηηθό έιεγρν
1.00
20/04/11
Πξώηε έθδνζε
1.1
20/05/11
Μηθξέο δηνξζώζεηο
1.11
26/5/11
΢πγρξνληζκόο Server/Client
2.00
01/07/11
Έλαξμε Παξαγσγηθήο Λεηηνπξγίαο
2.01
01/01/12
Λεηηνπξγία ECS
2 / 45
ICISnet
Πίλαθαο Πεξηερνκέλωλ
1.1.
΢θνπόο ............................................................................................................................... 5
1.1.1.
2.
3.
Σερλνινγίεο Τινπνίεζεο θαη Αζθάιεηα ........................................................................................... 5
2.1.
Γεληθά................................................................................................................................. 5
2.2.
Ο Μεραληζκόο Αζθάιεηαο .................................................................................................... 6
Γηαδηθηπαθέο Τπεξεζίεο (Web Services) Δθαξκνγήο Ηιεθηξνληθήο Τπνβνιήο Παξαζηαηηθώλ ............. 8
3.1.
Γεληθά................................................................................................................................. 8
3.2.
Η Τπεξεζία Τπνβνιήο Παξαζηαηηθώλ ................................................................................... 8
3.2.1.
Πεξηγξαθή ................................................................................................................... 8
3.2.2.
Πεξηγξαθή Οξηζκάησλ MessageProcessorService ........................................................... 8
3.3.
4.
΢ε πνηνύο αλαθέξεηαη απηό ην Έγγξαθν ........................................................................ 5
Οη Τπεξεζίεο Αλαδήηεζεο Παξαζηαηηθώλ ............................................................................ 10
3.3.1.
Η Τπεξεζία MovementRetrievalService ........................................................................ 10
3.3.2.
Η ππεξεζία DateMovementRetrievalService .................................................................. 12
3.3.2.1
Πεξηγξαθή ................................................................................................................. 12
Παξαξηήκαηα / Αλαθνξέο .......................................................................................................... 15
4.1.
Παξαδείγκαηα Απεζηαικέλσλ SOAP Μελπκάησλ ................................................................. 15
4.1.1.
ProcessIncomingMessageRequest ................................................................................ 15
4.1.1.1
Χο String.................................................................................................................... 15
4.1.1.2
Χο embedded XML δνκή ............................................................................................. 17
4.1.1.3
Φεθηαθή Τπνγξαθή .................................................................................................... 19
4.1.2.
RetrieveMovementRequest .......................................................................................... 23
4.1.3.
DateRetrieveMovement ............................................................................................... 24
4.2.
Αλάιπζε παξακέηξσλ Web Service .................................................................................... 25
4.3.
Γηαρείξηζε Λαζώλ .............................................................................................................. 30
4.3.1.
Πηζηνπνηεηηθά Server .................................................................................................. 30
4.3.2.
΢πγρξνληζκόο Server/Client ......................................................................................... 30
4.3.3.
Καηαγξαθή Λαζώλ ..................................................................................................... 30
4.3.3.1
Δπηηπρεκέλε ππνβνιή κελύκαηνο ................................................................................ 32
4.3.3.2
WrongState ................................................................................................................ 33
4.3.3.3
InvalidArgument ......................................................................................................... 33
4.3.3.4
ValError ..................................................................................................................... 35
3 / 45
ICISnet
4.3.3.5
OtherError ................................................................................................................. 38
4.3.3.6
NothingFound ............................................................................................................ 38
4.3.3.7
NotAuthorized ............................................................................................................ 38
4.3.3.8
InvalidSignature ......................................................................................................... 39
4.3.3.9
IncompleteResults ...................................................................................................... 40
4.4.
΢πζρέηηζε Τπνζπζηεκάησλ/Ρόισλ & Τπνζπζηεκάησλ/Κιεηδηώλ ........................................... 40
4.5.
Δμνπζηνδνηήζεηο ............................................................................................................... 41
4.6.
Σύπνη Μελπκάησλ (MessageTypes) .................................................................................... 42
4.6.1.
Τπνζύζηεκα Δηδηθώλ Φόξσλ Καηαλάισζεο .................................................................. 42
4.6.2.
Τπνζύζηεκα Γεισηηθώλ ............................................................................................. 43
Πίλαθαο ΢ρεκάηωλ
΢ρήκα 2-1: Σνπνζεζίεο WSDL αξρείσλ ..................................................................................................... 6
΢ρήκα 3-1: Σν Όξηζκα processIncomingMessageRequest .......................................................................... 9
΢ρήκα 3-2: Σν Όξηζκα processIncomingMessageResponse ........................................................................ 9
΢ρήκα 3-3: XML Παξάδεηγκα dateRetrieveMovement ............................................................................... 13
΢ρήκα 4-1: SOAP Παξάδεηγκα processIncomingMessageRequest σο String ............................................... 17
΢ρήκα 4-2: SOAP Παξάδεηγκα processIncomingMessageRequest σο XML.................................................. 18
΢ρήκα 4-3: SOAP Παξάδεηγκα processIncomingMessageRequest σο String κε Φεθηαθή Τπνγξαθή ............ 21
4 / 45
ICISnet
Εηζαγωγή
1.1.΢θνπόο
΢θνπόο ηνπ παξόληνο εγγξάθνπ είλαη λα απνηππώζεη ηελ πινπνίεζε ησλ δηαδηθηπαθώλ ππεξεζηώλ (Web
Services) ηνπ ICISnet. Η ζπγθεθξηκέλε παξνπζίαζε απνηειείηαη από ηηο εμήο ηξεηο βαζηθέο ελόηεηεο:

Σερλνινγίεο Τινπνίεζεο θαη Αζθάιεηα: Πεξηιακβάλεη κηα ζπλνπηηθή αλαθνξά ζηηο ηερλνινγίεο
πνπ ρξεζηκνπνηήζεθαλ γηα ηελ αλάπηπμε ησλ δηαδηθηπαθώλ ππεξεζηώλ θαζώο θαη ζηελ πινπνίεζε
ηνπ κεραληζκνύ αζθαιείαο πνπ παξέρεη ε εθαξκνγή Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ γηα λα
εμαζθαιίζεη ηελ αζθαιή δηακεηαγσγή ησλ SOAP κελπκάησλ από θαη πξνο ην ινγηζκηθό πειάηε
(client software), ην νπνίν ρξεζηκνπνηεί ηηο ελ ιόγσ ππεξεζίεο.

Πεξηγξαθή ηωλ Δηαδηθηπαθώλ Τπεξεζηώλ: Πεξηιακβάλεη ην ζύλνιν ησλ Γηαδηθηπαθώλ
Τπεξεζηώλ (Web Services), νη νπνίεο παξέρνληαη από ηελ εθαξκνγή Ηιεθηξνληθήο Τπνβνιήο
παξαζηαηηθώλ θαη κπνξνύλ λα ρξεζηκνπνηεζνύλ γηα ηελ αληαιιαγή κελπκάησλ από θαη πξνο ηα
ηέζζεξα δηαθνξεηηθά ππνζπζηήκαηα κε ηα νπνία ζπλδέεηαη ε εθαξκνγή (ζπζηήκαηα Δηζαγσγώλ /
Δμαγσγώλ, Γεισηηθώλ, Δηδηθώλ Φόξσλ Καηαλάισζεο θαη Γηακεηαθόκηζεο).

Παξάξηεκα κε παξαδείγκαηα απεζηαικέλωλ SOAP κελπκάηωλ: ΢ε απηή ηελ ελόηεηα
παξαηίζεληαη παξαδείγκαηα SOAP κελπκάησλ, ηα νπνία αληαιιάζζνληαη .
1.1.1. ΢ε πνηνύο αλαθέξεηαη απηό ην Έγγξαθν
Απηό ην έγγξαθν αλαθέξεηαη ζε δύν θαηεγνξίεο ρξεζηώλ:

΢ε αξρηηέθηνλεο ππνινγηζηηθώλ ζπζηεκάησλ, αλαιπηέο θαη πξνγξακκαηηζηέο, νη νπνίνη επηζπκνύλ λα
θάλνπλ ρξήζε ησλ παξερόκελσλ δηαδηθηπαθώλ ππεξεζηώλ ηεο Ηιεθηξνληθήο Τπνβνιήο
παξαζηαηηθώλ πξνο ρξήζε ησλ δηθώλ ηνπο εθαξκνγώλ.

΢ε πξνρσξεκέλνπο ρξήζηεο, νη νπνίνη επηζπκνύλ λα παξαθάκςνπλ ηελ δηαδηθηπαθή δηεπαθή (web
interface), πνπ παξέρεη ε εθαξκνγή Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ θαη λα ππνβάινπλ
απεπζείαο κελύκαηα ζε κνξθή XML κέζσ εδηθά αλεπηπγκέλσλ, γηα ην ζθνπό απηό, εθαξκνγώλ.
2.
Σερλνινγίεο Τινπνίεζεο θαη Αζθάιεηα
2.1.
Γεληθά
Οη δηαδηθηπαθέο ππεξεζίεο παξέρνληαη από ηελ εθαξκνγή ηεο Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ ππό ηε
κνξθή ηξηώλ WSDL αξρείσλ, ηα νπνία δηαηίζεληαη από ηηο παξαθάησ ηνπνζεζίεο.
Πεξηβάιινλ δνθηκώλ:
https://www2.gsis.gr/wsicisnet/MessageProcessorService?wsdl
https://www2.gsis.gr/wsicisnet/MovementRetrievalService?wsdl
https://www2.gsis.gr/wsicisnet/DateMovementRetrievalService?wsdl
Παξαγσγηθό πεξηβάιινλ:
https://www1.gsis.gr/wsicisnet/MessageProcessorService?wsdl
5 / 45
ICISnet
https://www1.gsis.gr/wsicisnet/MovementRetrievalService?wsdl
https://www1.gsis.gr/wsicisnet/DateMovementRetrievalService?wsdl
΢ρήκα 2-1: Σνπνζεζίεο WSDL αξρείωλ
Οη παξερόκελεο δηαδηθηπαθέο ππεξεζίεο δίλνπλ ηε δπλαηόηεηα ζηνπο ρξήζηεο λα ρξεζηκνπνηήζνπλ ην
ζύλνιν ηεο ιεηηνπξγηθόηεηαο ηεο εθαξκνγήο Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ κέζσ ηεο αληαιιαγήο
θαη ιήςεο κελπκάησλ βάζεη ηνπ πξσηνθόιινπ SOAP, όπσο απηό νξίδεηαη ζην αληίζηνηρν W3C
recommendation (http://www.w3.org/TR/2000/NOTE-SOAP-20000508/).
Οη ζπγθεθξηκέλεο δηαδηθηπαθέο ππεξεζίεο βαζίδνληαη ζηε ρξήζε ηεο ηερλνινγίαο JAX-WS. Πξνηείλεηαη ε
ρξήζε ησλ autogeneration tools (wsgen) γηα ηελ απηόκαηε δεκηνπξγία ηνπ θώδηθα, ν νπνίνο κπνξεί λα
ρξεζηκνπνηήζεη ηηο ελ ιόγσ ππεξεζίεο. Δλαιιαθηηθά όκσο ν ρξήζηεο κπνξεί λα ρξεζηκνπνηήζεη νπνηαδήπνηε
άιιε ηερλνινγία (ιρ SAAJ https://saaj.dev.java.net/) αξθεί ηα SOAP κελύκαηα ηα νπνία απνζηέιιεη λα
πιεξνύλ ηηο πξνδηαγξαθέο ησλ αληίζηνηρσλ XSDs πνπ πεξηγξάθνληαη από ηηο ππεξεζίεο (βιέπε ηα XSDs
νξηζκώλ ηύπσλ ηεο θάζε ππεξεζίαο, πνπ πεξηγξάθνληαη ζηα ζρεηηθά wsdl, θαζώο θαη ηα ζρεηηθά
παξαδείγκαηα απεζηαικέλσλ SOAP Μελπκάησλ ζην παξάξηεκα).
2.2.
Ο Μεραληζκόο Αζθάιεηαο
Γηα ηελ επίηεπμε αζθαινύο αληαιιαγήο πιεξνθνξηώλ, κεηαμύ εθαξκνγήο ζπλαιιαζζόκελνπ θαη εθαξκνγήο
Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ ζε κηα ζύλνδν Γηαδηθηπαθώλ Τπεξεζηώλ (Web Service session) κε ηελ
ρξήζε ηεο ηερλνινγίαο SOAP Security, εθαξκόδνληαη νη παξαθάησ κεραληζκνί (ν κεραληζκόο ηεο ςεθηαθήο
ππνγξαθήο από ηνλ client, αλ θαη ππνζηεξίδεηαη δελ ζα ρξεζηκνπνηεζεί πξνο ην παξόλ):

΢ύλδεζε κε HTTPS (Secure HTTP) – Ο δηαρεηξηζηήο ηνπ site ηεο ΓΓΠ΢ έρεη εθδώζεη θαη
εγθαηαζηήζεη πηζηνπνηεηηθά δεκνζίνπ θιεηδηνύ ζηνπο ρξεζηκνπνηνύκελνπο servers. Η ζύλδεζε ηεο
εθαξκνγήο ηνπ ζπλαιιαζζνκέλνπ γίλεηαη κε Secure http.
Με ηνλ ηξόπν απηό νη ζπλαιιαζζόκελνη κπνξνύλ λα δνπλ ηελ ππνγξαθή ηεο αξρήο πηζηνπνίεζεο
θαη λα βεβαησζνύλ όηη ην πηζηνπνηεηηθό είλαη έγθπξν θαη όηη θαλέλαο θαθόβνπινο ρξήζηεο δελ ην
έρεη πιαζηνγξαθήζεη.

΢ύλδεζε κε SOAP Security Extensions (WS-Security). Θα ρξεζηκνπνηεζεί ν εγγελήο
κεραληζκόο πνπ παξέρεη ν Weblogic Application Server γηα ηελ αζθάιεηα δηαδηθηπαθώλ ππεξεζηώλ, ν
νπνίνο βαζίδεηαη ζην πξόηππν OASIS WS-Security (γηα πεξηζζόηεξεο πιεξνθνξίεο δείηε
http://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-osSOAPMessageSecurity.pdf ).
Σα extensions είλαη πξνδηαγξαθέο πνπ ζα δηέπνληαη από W3C ζπζηάζεηο:
-
XML Encryption, ε νπνία θαζνξίδεη ην πώο λα θξππηνγξαθήζεηε ηα πεξηερόκελα ελόο XML ζηνηρείνπ
„XML-Encryption ΢πληαθηηθό θαη Δπεμεξγαζία (W3C)‟ http://www.w3.org/TR/xmlenc-core/.
-
XML Signature, πνπ θαζνξίδεη κηα XML ζύληαμε γηα ηηο ςεθηαθέο ππνγξαθέο, όπσο νξίδνληαη ζην
θείκελν „XML-Signature ΢πληαθηηθό θαη Δπεμεξγαζία (W3C)‟ http://www.w3.org/TR/xmldsig-core/.
(O κεραληζκόο ηεο ςεθηαθήο ππνγξαθήο δελ ζα ρξεζηκνπνηεζεί πξνο ην παξόλ)
6 / 45
ICISnet
7 / 45
ICISnet
3.
Δηαδηθηπαθέο
Τπεξεζίεο
(Web
Ηιεθηξνληθήο Τπνβνιήο Παξαζηαηηθώλ
3.1.
Services)
Εθαξκνγήο
Γεληθά
΢πγθεθξηκέλα ε εθαξκνγή ηεο Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ πεξηέρεη ηξεηο βαζηθέο ππεξεζίεο ζηνπο
ζπλαιιαζζόκελνπο:

MessageProcessorService: Η δηαδηθηπαθή ππεξεζία ππεύζπλε γηα ηελ απνζηνιή κελπκάησλ ζε
κνξθή XML πξνο ηα δηαθνξεηηθά ππνζπζηήκαηα ηεο εθαξκνγήο ηεο Ηιεθηξνληθήο Τπνβνιήο
παξαζηαηηθώλ (Τπνζπζηήκαηα Δηζαγσγώλ / Δμαγσγώλ, Γεισηηθώλ, Δηδηθώλ Φόξσλ Καηαλάισζεο
θαη Γηακεηαθόκηζεο).

MovementRetrievalService: Η δηαδηθηπαθή ππεξεζία ππεύζπλε γηα ηελ αλαδήηεζε θαη ιήςε
κελπκάησλ βάζεη MRN/ARC θαη LRN.

DateMovementRetrievalService: Η δηαδηθηπαθή ππεξεζία ππεύζπλε γηα ηελ αλαδήηεζε θαη ιήςε
κελπκάησλ βάζεη εκεξνκελίαο θαη ώξαο.
3.2.
Η Τπεξεζία Τπνβνιήο Παξαζηαηηθώλ
3.2.1. Πεξηγξαθή
Η ππεξεζία MessageProcessorService είλαη ππεύζπλε γηα ηελ απνζηνιή κελπκάησλ ζε κνξθή XML πξνο ηα
δηαθνξεηηθά ππνζπζηήκαηα ηεο εθαξκνγήο ηεο Ηιεθηξνληθήο Τπνβνιήο παξαζηαηηθώλ. Η κνξθή ησλ XML
πνπ πεξηιακβάλεηαη ζην SOAP message πξέπεη λα είλαη ζύκθσλε κε ηα αληίζηνηρα XSDs πνπ πξνδηαγξάθνπλ
ηε δνκή ησλ κελπκάησλ θαη βξίζθνληαη αλαξηεκέλα ζην δηθηπαθό ηόπν ηεο ΓΓΠ΢.
Οη απαληήζεηο από ην Web Service είλαη ζύγρξνλεο (ε απάληεζε είλαη άκεζε) είηε ην αξρηθό αίηεκα είλαη
ζσζηό είηε είλαη ιάζνο από πιεπξάο ηεο εθαξκνγήο ηνπ ζπλαιιαζζόκελνπ. Έλα αίηεκα ειέγρεηαη
ζπληαθηηθά (syntactic: XML Validation θαη XSD Conformance) θαη ζεκαζηνινγηθά (semantic: Reference Data,
Rules, Conditions θαη State Machine). Πξνθεηκέλνπ έλα ππνβαιιόκελν κήλπκα λα ζεσξεζεί ζσζηό θαη λα
θαηαρσξεζεί ζην ζύζηεκα όινη νη πξναλαθεξζέληεο έιεγρνη ζα πξέπεη λα έρνπλ νινθιεξσζεί επηηπρώο.
Η απάληεζε ζε έλα ζσζηό αίηεκα γηα ηελ ππνβνιή κελύκαηνο επηζηξέθεη ηα απνηειέζκαηα ηεο
θαηαρώξεζεο ηνπ κελύκαηνο ζε έλα αληίζηνηρν ζηνηρείν (element) ηνπ επηζηξεθόκελνπ SOAP κελύκαηνο.
΢ε πεξίπησζε ιαλζαζκέλνπ αηηήκαηνο από πιεπξάο ηεο εθαξκνγήο ηνπ ζπλαιιαζζόκελνπ, ηα Web Services
επηζηξέθνπλ έλα εληαίν κήλπκα ιάζνπο, θνηλό γηα όια ηα ππνζπζηήκαηα, ην νπνίν πεξηγξάθεηαη ζηηο
πξνδηαγξαθέο ηύπσλ πνπ ππάξρνπλ ζηα XSDs definitions ηνπ WSDL.
3.2.2. Πεξηγξαθή Οξηζκάησλ MessageProcessorService
Η ππεξεζία MessageProcessorService ιακβάλεη σο πιεξνθνξία ην όξηζκα processIncomingMessageRequest
θαη επηζηξέθεη ην κήλπκα processIncomingMessageResponse. Αλαιπηηθόηεξα:
1. Γνκή ηνπ κελύκαηνο processIncomingMessageRequest.
8 / 45
ICISnet
΢ρήκα 3-1: Σν Όξηζκα processIncomingMessageRequest
2. Γνκή ηνπ κελύκαηνο processIncomingMessageResponse.
΢ρήκα 3-2: Σν Όξηζκα processIncomingMessageResponse
9 / 45
ICISnet
3.3.
Οη Τπεξεζίεο Αλαδήηεζεο Παξαζηαηηθώλ
Οη ππεξεζίεο ζηελ θαηεγνξία MovementRetrieval επηηξέπνπλ ηελ αλαδήηεζε παξαζηαηηθώλ βάζεη θξηηεξίσλ,
ησλ νπνίσλ ε κνξθή νξίδεηαη ζηηο πεξηγξαθέο δηαδηθηπαθήο δηεπαθήο.
3.3.1. Η Τπεξεζία MovementRetrievalService
Η ππεξεζία MovementRetrievalService επηηξέπεη ηελ αλαδήηεζε κελπκάησλ πνπ ζρεηίδνληαη κε έλα
δεδνκέλν LRN ή MRN/ARC. Δηδηθόηεξα γηα αλαδεηήζεηο κε ρξήζε ARC ζην EMCS (Τπνζύζηεκα ΔΦΚ), ην
θξηηήξην αλαδήηεζεο είλαη ARC ή ARC +sequence number. Η αλαδήηεζε εγγξάθνπ κέζσ δηαδηθηπαθήο
δηεπαθήο νινθιεξώλεηαη κε δύν κελύκαηα: ηα retrieveMovemenRequest θαη retrieveMovementResponse.
1. Γνκή ηνπ κελύκαηνο retrieveMovementRequest
XML Παξάδεηγκα:
<?xml version="1.0" encoding="UTF-8"?>

<tns:retrieveMovementRequest xsi:schemaLocation="http://icis.externaldomain.services.ws
https://www2.gsis.gr/wsicisnet/MovementRetrievalService?xsd=3"
10 / 45
ICISnet
xmlns:tns="http://icis.externaldomain.services.ws" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
<tns:movementRequest wsPass="String" traderID="String" wsuserID="String" isXmlString="true">
<domain>NCTS</domain>
<role>Dep</role>
<typeOfKey>LRN</typeOfKey>
<key>String</key>
</tns:movementRequest>
</ tns: retrieveMovementRequest >
2. Γνκή ηνπ κελύκαηνο retrieveMovementResponse.
<tns:retrieveMovementResponse xsi:schemaLocation="http://icis.externaldomain.services.ws
https://www2.gsis.gr/wsicisnet/MovementRetrievalService?xsd=3" xmlns:tns="http://icis.externaldomain.services.ws"
xmlns:n1="http://www.altova.com/samplexml/other-namespace" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
<movementRequestResult>
<resultState requestId="String">
<status>IncompleteResults</status>
<reasonCode>Other</reasonCode>
<explanation>String</explanation>
11 / 45
ICISnet
</resultState>
<movementInfo>
<localReference>String</localReference>
<movementReference>String</movementReference>
<submissionDate>2001-12-17T09:30:47Z</submissionDate>
<declarationType>TIR</declarationType>
<stateCode>String</stateCode>
<stateDescription>String</stateDescription>
<modificationDate>2001-12-17T09:30:47Z</modificationDate>
<messages>
<messageExchanged>
<IEMessage messageType="String">
<xmlData>String</xmlData>
<n1:auto-generated_for_wildcard/>
</IEMessage>
</messageExchanged>
</messages>
</movementInfo>
</movementRequestResult>
</tns:retrieveMovementResponse>
3.3.2. Η ππεξεζία DateMovementRetrievalService
3.3.2.1 Πεξηγξαθή
Η ππεξεζία DateMovementRetrievalService επηηξέπεη ηελ αλαδήηεζε κελπκάησλ πνπ αθνξνύλ ηνλ
ζπλαιιαζζόκελν βάζεη εκεξνκελίαο. Η αλαδήηεζε επηζηξέθεη έσο 150 θηλήζεηο (movements). ΢ηελ
πεξίπησζε θαηά ηελ νπνία νη θηλήζεηο είλαη πεξηζζόηεξεο, εκθαλίδνληαη νη πξώηεο 150 καδί κε έλα κήλπκα
πνπ αλαθέξεη όηη δελ έρνπλ έξζεη όιεο (not all messages found). Η αλαδήηεζε βάζεη εκεξνκελίαο κέζσ
δηαδηθηπαθήο
δηεπαθήο
νινθιεξώλεηαη
κε
δύν
κελύκαηα:
ηα
dateRetrieveMovement
θαη
dateRetrieveMovementResponse.
1. Γνκή ηνπ κελύκαηνο dateRetrieveMovement.
12 / 45
ICISnet
<tns:dateRetrieveMovement xsi:schemaLocation="http://icis.externaldomain.services.ws
https://www2.gsis.gr/wsicisnet/DateMovementRetrievalService?xsd=3" xmlns:tns="http://icis.externaldomain.services.ws"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<tns:dateMovementRequest wsPass="String" traderID="String" wsuserID="String" isXmlString="true">
<dateFrom>2001-12-17T09:30:47Z</dateFrom>
<dateTo>2001-12-17T09:30:47Z</dateTo>
<domain>NCTS</domain>
<role>AnyRole</role>
</tns:dateMovementRequest>
</tns:dateRetrieveMovement>
΢ρήκα 3-3: XML Παξάδεηγκα dateRetrieveMovement
2. Γνκή ηνπ κελύκαηνο dateRetrieveMovementResponse.
13 / 45
ICISnet
<tns:dateRetrieveMovementResponse xsi:schemaLocation="http://icis.externaldomain.services.ws
https://www2.gsis.gr/wsicisnet/DateMovementRetrievalService?xsd=3" xmlns:tns="http://icis.externaldomain.services.ws"
xmlns:n1="http://www.altova.com/samplexml/other-namespace" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
<DateMovementRequestResult>
<resultState requestId="String">
<status>OtherError</status>
<reasonCode>InvalidMessageContent</reasonCode>
<explanation>String</explanation>
</resultState>
<movements>
<movementInfo>
<localReference>String</localReference>
<movementReference>String</movementReference>
<declarationType>T2</declarationType>
<stateCode>String</stateCode>
<stateDescription>String</stateDescription>
<modificationDate>2001-12-17T09:30:47Z</modificationDate>
<messages>
<messageExchanged>
<IEMessage messageType="String">
<xmlData>String</xmlData>
<n1:auto-generated_for_wildcard/>
</IEMessage>
</messageExchanged>
</messages>
</movementInfo>
</movements>
</DateMovementRequestResult>
</tns:dateRetrieveMovementResponse>
14 / 45
ICISnet
4. Παξαξηήκαηα / Αλαθνξέο
4.1.
Παξαδείγκαηα Απεζηαικέλωλ SOAP Μελπκάηωλ
4.1.1. ProcessIncomingMessageRequest
Σν παξάδεηγκα δείρλεη ηα SOAP κελύκαηα ζηηο ηέζζεξηο πεξηπηώζεηο απνζηνιήο εγγξάθνπ ζην DCL domain.
4.1.1.1 Χο String
<?xml version="1.0" encoding="utf-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
S:mustUnderstand="1">
<wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility1.0.xsd" wsu:Id="unt_XSusV97nquD0i9KC">
<wsse:Username>someuser</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile1.0#PasswordText">12345678</wsse:Password>
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-messagesecurity-1.0#Base64Binary">/kXSj7KKhfsDTlTd5KNR+9fpX389SAxW/syaNmimfVo=</wsse:Nonce>
<wsu:Created>2011-04-07T07:29:43Z</wsu:Created>
</wsse:UsernameToken>
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsu:Expires>2011-04-07T07:30:43Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:processIncomingMessageRequest xmlns:ns2="http://icis.externaldomain.services.ws">
<ns2:messageRequest traderID="045580187" wsPass="12345678" wsUserID="testApp1">
<DigitallySignedMessage isXmlString="true" messageType="DCL_IE315">
<xmlMessage xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string"><?xml version="1.0" encoding="UTF-8"?>
<CC315A>
<MesSenMES3>TRADER.GR</MesSenMES3>
<MesRecMES6>NICA.GR</MesRecMES6>
<DatOfPreMES9>101103</DatOfPreMES9>
<TimOfPreMES10>1353</TimOfPreMES10>
<TesIndMES18>1</TesIndMES18>
<MesIdeMES19>9928785225753</MesIdeMES19>
<MesTypMES20>CC315A</MesTypMES20>
<CorIdeMES25>1288785225752</CorIdeMES25>
<HEAHEA>
<RefNumHEA4>ABC6487353663sdfsfsfsd</RefNumHEA4>
<TraModAtBorHEA76>4</TraModAtBorHEA76>
<TotNumOfIteHEA305>3</TotNumOfIteHEA305>
<TotNumOfPacHEA306>31</TotNumOfPacHEA306>
<TotGroMasHEA307>500.85</TotGroMasHEA307>
<DecPlaHEA394>Malta</DecPlaHEA394>
<SpeCirIndHEA1>A</SpeCirIndHEA1>
<TraChaMetOfPayHEA1>A</TraChaMetOfPayHEA1>
<ComRefNumHEA>IS123412</ComRefNumHEA>
<ConRefNumHEA>OLY0145</ConRefNumHEA>
<PlaUnlGOOITE334>IT2345ASDFF</PlaUnlGOOITE334>
<DecDatTimHEA114>201011030000</DecDatTimHEA114>
</HEAHEA>
<TRACONCO1>
<NamCO17>sadasd</NamCO17>
15 / 45
ICISnet
<StrAndNumCO122>DU PONT</StrAndNumCO122>
<PosCodCO123>65234</PosCodCO123>
<CitCO124>ROME</CitCO124>
<CouCO125>IT</CouCO125>
<TINCO159>GR300000570</TINCO159>
</TRACONCO1>
<NOTPAR670>
<TINNOTPAR671>GR300000570</TINNOTPAR671>
</NOTPAR670>
<GOOITEGDS>
<IteNumGDS7>1</IteNumGDS7>
<UNDanGooCodGDI1>0004</UNDanGooCodGDI1>
<PRODOCDC2>
<DocTypDC21>N235</DocTypDC21>
<DocRefDC23>54783</DocRefDC23>
</PRODOCDC2>
<SPEMENMT2>
<AddInfCodMT23>10600</AddInfCodMT23>
</SPEMENMT2>
<COMCODGODITM>
<ComNomCMD1>010110</ComNomCMD1>
</COMCODGODITM>
<PACGS2>
<KinOfPacGS23>VQ</KinOfPacGS23>
<MarNumOfPacGSL21>Mark111</MarNumOfPacGSL21>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<GooDesGDS23>Potatos</GooDesGDS23>
<CONNR2>
<ConNumNR21>98765</ConNumNR21>
</CONNR2>
<PACGS2>
<KinOfPacGS23>NE</KinOfPacGS23>
<NumOfPieGS25>15</NumOfPieGS25>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<GooDesGDS23>Tomatos</GooDesGDS23>
<PACGS2>
<KinOfPacGS23>AD</KinOfPacGS23>
<NumOfPacGS24>15</NumOfPacGS24>
</PACGS2>
</GOOITEGDS>
<ITI>
<CouOfRouCodITI1>GR</CouOfRouCodITI1>
</ITI>
<PERLODSUMDEC>
<TINPLD1>GR300000570</TINPLD1>
</PERLODSUMDEC>
<SEAID529>
<SeaIdSEAID530>K244</SeaIdSEAID530>
</SEAID529>
<CUSOFFFENT730>
<RefNumCUSOFFFENT731>GR001102</RefNumCUSOFFFENT731>
<ExpDatOfArrFIRENT733>201011261200</ExpDatOfArrFIRENT733>
</CUSOFFFENT730>
<TRACARENT601>
<TINTRACARENT602>ATDF1234</TINTRACARENT602>
</TRACARENT601>
</CC315A>
</xmlMessage>
</DigitallySignedMessage>
</ns2:messageRequest>
</ns2:processIncomingMessageRequest>
16 / 45
ICISnet
</S:Body>
</S:Envelope>
΢ρήκα 4-1: SOAP Παξάδεηγκα processIncomingMessageRequest ωο String
4.1.1.2 Χο embedded XML δνκή
<S:Header>
<wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility1.0.xsd" wsu:Id="unt_8Kr0VkRcSggP2AD5">
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-messagesecurity-1.0#Base64Binary">n+FYpG44W4oWeRXrJ1sQqGc+bBxfquDq3Iy9M3NasTg=</wsse:Nonce>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<DigitallySignedMessage isXmlString="false" messageType="DCL_IE315">
<xmlMessage>
<CC315A>
<HEAHEA>
<RefNumHEA4>ABC6487353663sdhdthfh</RefNumHEA4>
</HEAHEA>
<TRACONCO1>
<TINCO159>GR300000570</TINCO159>
</TRACONCO1>
<NOTPAR670>
</NOTPAR670>
17 / 45
ICISnet
<GOOITEGDS>
<PRODOCDC2>
</PRODOCDC2>
<SPEMENMT2>
</SPEMENMT2>
<COMCODGODITM>
</COMCODGODITM>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<CONNR2>
</CONNR2>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<ITI>
</ITI>
<PERLODSUMDEC>
</PERLODSUMDEC>
<SEAID529>
</SEAID529>
<CUSOFFFENT730>
</CUSOFFFENT730>
<TRACARENT601>
</TRACARENT601>
</CC315A>
</xmlMessage>
</S:Body>
</S:Envelope>
΢ρήκα 4-2: SOAP Παξάδεηγκα processIncomingMessageRequest ωο XML
18 / 45
ICISnet
4.1.1.3 Φεθηαθή Τπνγξαθή
Η εθαξκνγή ππνζηεξίδεη dsa_sh1 θαη rsa_sha1 αιγόξηζκνπο γηα ηελ ςεθηαθή ππνγξαθή. Αθνινπζνύλ
παξαδείγκαηα ππνβνιήο κελύκαηνο σο XML String θαη σο DOM object κε ελεξγνπνηεκέλε ηελ ςεθηαθή
ππνγξαθή. Τπελζπκίδεηαη όηη ε ςεθηαθή ππνγξαθή δελ ρξεζηκνπνηείηαη πξνο ην παξόλ.
<S:Header>
<wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility1.0.xsd" wsu:Id="unt_PQxtsT0a8iV1KN2Y">
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-messagesecurity-1.0#Base64Binary">i03CXze0uiIYG8+q8MhEMYHiMcL/NOpCwvEVpQ5xo+M=</wsse:Nonce>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<DigitallySignedMessage isXmlString="true" messageType="DCL_IE315">
<xmlMessage xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string"><?xml version="1.0" encoding="UTF-8"?>
<CC315A>
<HEAHEA>
</HEAHEA>
<TRACONCO1>
<TINCO159>GR300000570</TINCO159>
</TRACONCO1>
<NOTPAR670>
</NOTPAR670>
<GOOITEGDS>
19 / 45
ICISnet
<PRODOCDC2>
</PRODOCDC2>
<SPEMENMT2>
</SPEMENMT2>
<COMCODGODITM>
</COMCODGODITM>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<CONNR2>
</CONNR2>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<ITI>
</ITI>
<PERLODSUMDEC>
</PERLODSUMDEC>
<SEAID529>
</SEAID529>
<CUSOFFFENT730>
</CUSOFFFENT730>
<TRACARENT601>
</TRACARENT601>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#dsa-sha1"/>
<Reference URI="">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>pfFSPnIpXvn1MXMShwm/cXK6C5A=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>CTGTO0F17hczG1JZYoh1CeWjrDdgV4+6YMG+l01lJW6LmjQeOdfghQ==</SignatureValue>
<KeyInfo>
<X509Data>
20 / 45
ICISnet
<X509SubjectName>CN=Antypas Ch,OU=Java,O=ii,C=GR</X509SubjectName>
<X509Certificate>MIICtjCCAnOgAwIBAgIES2x2lTALBgcqhkjOOAQDBQAwPjELMAkGA1UEBhMCR1IxCzAJBgNVBAoT
AmlpMQ0wCwYDVQQLEwRKYXZhMRMwEQYDVQQDEwpBbnR5cGFzIENoMB4XDTEwMDIwNTE5NTA0NVoX
DTE1MDExMDE5NTA0NVowPjELMAkGA1UEBhMCR1IxCzAJBgNVBAoTAmlpMQ0wCwYDVQQLEwRKYXZh
MRMwEQYDVQQDEwpBbnR5cGFzIENoMIIBtzCCASwGByqGSM44BAEwggEfAoGBAP1/U4EddRIpUt9K
nC7s5Of2EbdSPO9EAMMeP4C2USZpRV1AIlH7WT2NWPq/xfW6MPbLm1Vs14E7gB00b/JmYLdrmVCl
pJ+f6AR7ECLCT7up1/63xhv4O1fnxqimFQ8E+4P208UewwI1VBNaFpEy9nXzrith1yrv8iIDGZ3R
SAHHAhUAl2BQjxUjC8yykrmCouuEC/BYHPUCgYEA9+GghdabPd7LvKtcNrhXuXmUr7v6OuqC+VdM
Cz0HgmdRWVeOutRZT+ZxBxCBgLRJFnEj6EwoFhO3zwkyjMim4TwWeotUfI0o4KOuHiuzpnWRbqN/
C/ohNWLx+2J6ASQ7zKTxvqhRkImog9/hWuWfBpKLZl6Ae1UlZAFMO/7PSSoDgYQAAoGAZkxlws63
gGdVF5th7MUoMnC+BnQyC3GiydhqE3mtNMd6qInzKnWVm73Bdl1Og/cEU/02DZYV27dbFIVpM7pq
XjS/KTkNYlOrndrkKgGRy4E1H5zmsRMXuAxXqo0iBcY9FRi+DdLkhG5W1FJ5V3iO7dDexGbKhIYi
bcMCwZmNlC8wCwYHKoZIzjgEAwUAAzAAMC0CFDXyK106yDc2uF+kU3GoYC8VX6QvAhUAkpUnP08Y
pyF2ePcLT7GBWVMnaJY=</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</CC315A>
</xmlMessage>
</S:Body>
</S:Envelope>
΢ρήκα 4-3: SOAP Παξάδεηγκα processIncomingMessageRequest ωο String κε Ψεθηαθή
Τπνγξαθή
<?xml version='1.0' encoding='utf-8'?><S:Envelope
xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Header><wsse:Security xmlns:wsse="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" S:mustUnderstand="1"><wsse:UsernameToken
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
wsu:Id="unt_Z1k4LnxEmBzzKuPP"><wsse:Username>someuser</wsse:Username><wsse:Password Type="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-username-token-profile1.0#PasswordText">12345678</wsse:Password><wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis200401-wss-soap-message-security1.0#Base64Binary">iNs+LF1iwwPU2AMer8uU6NKY9tfzgYqMTaP3mIEgoK0=</wsse:Nonce><wsu:Created>2011-0407T11:57:30Z</wsu:Created></wsse:UsernameToken><wsu:Timestamp xmlns:wsu="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><wsu:Created>2011-0407T11:57:30Z</wsu:Created><wsu:Expires>2011-0407T11:58:30Z</wsu:Expires></wsu:Timestamp></wsse:Security></S:Header><S:Body><ns2:processIncomingMessageReque
st xmlns:ns2="http://icis.externaldomain.services.ws"><ns2:messageRequest traderID="045580187" wsPass="12345678"
wsUserID="testApp1"><DigitallySignedMessage isXmlString="false" messageType="DCL_IE315"><xmlMessage><CC315A>
<HEAHEA>
</HEAHEA>
21 / 45
ICISnet
<TRACONCO1>
<TINCO159>GR300000570</TINCO159>
</TRACONCO1>
<NOTPAR670>
</NOTPAR670>
<GOOITEGDS>
<PRODOCDC2>
</PRODOCDC2>
<SPEMENMT2>
</SPEMENMT2>
<COMCODGODITM>
</COMCODGODITM>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<CONNR2>
</CONNR2>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<GOOITEGDS>
<PACGS2>
</PACGS2>
</GOOITEGDS>
<ITI>
</ITI>
<PERLODSUMDEC>
</PERLODSUMDEC>
<SEAID529>
</SEAID529>
<CUSOFFFENT730>
</CUSOFFFENT730>
<TRACARENT601>
</TRACARENT601>
<Signature:Signature xmlns="http://www.w3.org/2000/09/xmldsig#"
xmlns:Signature="http://www.w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod xmlns=""
xmlns:ns5="http://www.w3.org/2000/09/xmldsig#" Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-
22 / 45
ICISnet
20010315"></CanonicalizationMethod><SignatureMethod xmlns="" xmlns:ns5="http://www.w3.org/2000/09/xmldsig#"
Algorithm="http://www.w3.org/2000/09/xmldsig#dsa-sha1"></SignatureMethod><Reference xmlns=""
xmlns:ns5="http://www.w3.org/2000/09/xmldsig#" URI=""><ns5:Transforms><ns5:Transform
Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"></ns5:Transform></ns5:Transforms><ns5:DigestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></ns5:DigestMethod><ns5:DigestValue>pfFSPnIpXvn1MXMShwm/cXK6
C5A=</ns5:DigestValue></Reference></SignedInfo><SignatureValue>C7NkeKqeUrxGnuaBS+YvPIQVT3ByblP13at2KXEtaIHt
HpO8LXuKrQ==</SignatureValue><KeyInfo><X509Data><X509SubjectName>CN=Antypas
Ch,OU=Java,O=ii,C=GR</X509SubjectName><X509Certificate>MIICtjCCAnOgAwIBAgIES2x2lTALBgcqhkjOOAQDBQAwPjEL
MAkGA1UEBhMCR1IxCzAJBgNVBAoT
AmlpMQ0wCwYDVQQLEwRKYXZhMRMwEQYDVQQDEwpBbnR5cGFzIENoMB4XDTEwMDIwNTE5NTA0NVoX
DTE1MDExMDE5NTA0NVowPjELMAkGA1UEBhMCR1IxCzAJBgNVBAoTAmlpMQ0wCwYDVQQLEwRKYXZh
MRMwEQYDVQQDEwpBbnR5cGFzIENoMIIBtzCCASwGByqGSM44BAEwggEfAoGBAP1/U4EddRIpUt9K
nC7s5Of2EbdSPO9EAMMeP4C2USZpRV1AIlH7WT2NWPq/xfW6MPbLm1Vs14E7gB00b/JmYLdrmVCl
pJ+f6AR7ECLCT7up1/63xhv4O1fnxqimFQ8E+4P208UewwI1VBNaFpEy9nXzrith1yrv8iIDGZ3R
SAHHAhUAl2BQjxUjC8yykrmCouuEC/BYHPUCgYEA9+GghdabPd7LvKtcNrhXuXmUr7v6OuqC+VdM
Cz0HgmdRWVeOutRZT+ZxBxCBgLRJFnEj6EwoFhO3zwkyjMim4TwWeotUfI0o4KOuHiuzpnWRbqN/
C/ohNWLx+2J6ASQ7zKTxvqhRkImog9/hWuWfBpKLZl6Ae1UlZAFMO/7PSSoDgYQAAoGAZkxlws63
gGdVF5th7MUoMnC+BnQyC3GiydhqE3mtNMd6qInzKnWVm73Bdl1Og/cEU/02DZYV27dbFIVpM7pq
XjS/KTkNYlOrndrkKgGRy4E1H5zmsRMXuAxXqo0iBcY9FRi+DdLkhG5W1FJ5V3iO7dDexGbKhIYi
bcMCwZmNlC8wCwYHKoZIzjgEAwUAAzAAMC0CFDXyK106yDc2uF+kU3GoYC8VX6QvAhUAkpUnP08Y
pyF2ePcLT7GBWVMnaJY=</X509Certificate></X509Data></KeyInfo></Signature:Signature></CC315A></xmlMessage></Digi
tallySignedMessage></ns2:messageRequest></ns2:processIncomingMessageRequest></S:Body></S:Envelope>
4.1.2. RetrieveMovementRequest
Σν παξάδεηγκα δείρλεη ην SOAP κήλπκα ζε κία αλαδήηεζε εγγξάθνπ ζην ππνζύζηεκα Γεισηηθώλ (ICS),
βάζεη ηνπ LRN ABC6487353663sdfsfsfsd, κε trader ID “045580187” ζε ξόιν παξαιαβήο (Other).
<?xml version="1.0" encoding="utf-8" ?>
- <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
- <S:Header>
- <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
- <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
wsu:Id="unt_ZBahGmd1aEtnpZ9l">
<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security1.0#Base64Binary">+YYVoOEex0jFlNRq4dP4c1uwhgRkNAZpXpjnbUFAsv4=</wsse:Nonce>
- <wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
</wsu:Timestamp>
</wsse:Security>
</S:Header>
- <S:Body>
- <ns2:retrieveMovementRequest xmlns:ns2="http://icis.externaldomain.services.ws">
- <ns2:movementRequest isXmlString="true" traderID="045580187" wsPass="12345678" wsUserID="testApp1">
<domain>DCL</domain>
<role>Other</role>
<typeOfKey>LRN</typeOfKey>
<key>ABC6487353663sdfsfsfsd</key>
<messageType>IE315</messageType>
</ns2:movementRequest>
</ns2:retrieveMovementRequest>
</S:Body>
</S:Envelope>
23 / 45
ICISnet
4.1.3. DateRetrieveMovement
Σν παξάδεηγκα δείρλεη ην SOAP κήλπκα ζε κία αλαδήηεζε εγγξάθνπ ζην ππνζύζηεκα ΔΦΚ (EMCS), γηα ην
ρξνληθό δηάζηεκα πνπ νξίδεηαη από ηα πεδία dateFrom θαη dateTo κε trader ID “045580187” ζε ξόιν
παξαιαβήο (AnyRole).
<?xml version='1.0' encoding='utf-8'?>
<S:Header>
<wsse:Security
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
<wsse:UsernameToken
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
wsu:Id="unt_mCOjEqtfEbbvF3gi">
<wsse:Password
Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile1.0#PasswordText">12345678</wsse:Password>
<wsse:Nonce
EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security1.0#Base64Binary">wMvzophWYguJWllLgYPsuzYE5jZTp4Npva7x8MY782A=
</wsse:Nonce>
<wsu:Timestamp
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:dateRetrieveMovement xmlns:ns2="http://icis.externaldomain.services.ws">
<ns2:dateMovementRequest isXmlString="true"
traderID="045580187" wsPass="12345678" wsUserID="testApp1">
<dateFrom>2011-04-29T11:23:00</dateFrom>
<dateTo>2011-04-28T17:38:43</dateTo>
<domain>EMCS</domain>
<role>AnyRole</role>
</ns2:dateMovementRequest>
</ns2:dateRetrieveMovement>
</S:Body>
</S:Envelope>
24 / 45
ICISnet
4.2.
Αλάιπζε παξακέηξωλ Web Service
Αθνινπζεί ε αλάιπζε ησλ ζρεηηθώλ παξακέηξσλ. (Οη ηνπνζεζίεο αλαθέξνληαη ζην πεξηβάιινλ δνθηκώλ. Οη αληίζηνηρεο παξαγσγηθέο ηνπνζεζίεο
βξείζθνληαη: https://www1.gsis.gr/wsicisnet/....)
Όξηζκα
Πεξηγξαθή
Σύπνο/ Σνπνζεζία
Κνηλά
icisUserName
Όλνκα ρξήζηε ηεο ICISnet εθαξκνγήο
Αιθαξηζκεηηθό
icisPassword
Κσδηθόο πξόζβαζεο ρξήζηε ηεο ICISnet εθαξκνγήο
δηαδηθηπαθώλ
εθαξκνγή:
Αιθαξηζκεηηθό. Βξίζθεηαη ζηελ ηνπνζεζία:
wsUserID
΢πκπιεξσκαηηθό όλνκα
ππεξεζηώλ.
Πξνθύπηεη
΢πκπιεξσκαηηθόο θσδηθόο πξόζβαζεο ηνπ ρξήζηε ησλ
δηαδηθηπαθώλ ππεξεζηώλ. Πξνθύπηεη από ηελ εθαξκνγή:
Αιθαξηζκεηηθό. Βξίζθεηαη ζηελ ηνπνζεζία:
ρξήζηε
από
ησλ
ηελ
εμνπζηνδνηήζεσλ/Γηαπηζηεπηεξίσλ Αζθάιεηαο
wsPass
εμνπζηνδνηήζεσλ/Γηαπηζηεπηεξίσλ Αζθάιεηαο
https://www2.gsis.gr/wsicisnet/MessageProcessor
Service?xsd=3
Service?xsd=3
Τπεξεζία Τπνβνιήο Παξαζηαηηθώλ
Απαξηζκεηόο. Βξίζθεηαη ζηελ ηνπνζεζία:
messageType
Ο ηύπνο ηνπ κελύκαηνο . Πρ. EMCS_GR815
Service?xsd=2
Όξηζκα " MessageType"
Βξίζθεηαη ζηελ ηνπνζεζία
traderID
To ΑΦΜ (αξηζκόο ελληαςήθηνο) ή EORI ηνπ ελεξγνύ
ζπλαιιαζζόκελνπ
Service?xsd=3
Όξηζκα "traderID"
isXmlString
Η κνξθή ηνπ κελύκαηνο πνπ ζα ππνβιεζεί (XML String:true
ή DOM Object :false)
25 / 45
ICISnet
Service?xsd=2
xmlMessage
Σν κήλπκα πνπ ζα ππνβάινπκε ζε κνξθή XML ( ζε κνξθή
String ή Object αλάινγα κε ηελ ηηκή ηνπ νξίζκαηνο
isXmlString)
Service?xsd=2
Τπεξεζία αλαδήηεζεο παξαζηαηηθώλ βάζε LRN ή MRN/ARC
traderID
ζπλαιιαζζόκελνπ
isXmlString
domain
Σν ππνζύζηεκα ηνπ ICISnet ζην νπνίν απεπζύλεηαη
ππεξεζίαο αλαδήηεζεο. (Πρ DCL (Γεισηηθά))
https://www2.gsis.gr/wsicisnet/MovementRetrieval
Service?xsd=3
Service?xsd=3
Απαξηζκεηόο ηύπνο δεδνκέλσλ. Βξίζθεηαη ζηελ
ηνπνζεζία
Service?xsd=2
Όξηζκα " Domains"
key
typeOfKey
To MRN/ARC ή ην LRN ηεο θίλεζεο
Ο ηύπνο θιεηδηνύ αλαδήηεζεο
ππεξεζία. (Π.ρ. LRN).
γηα
ηελ
ζπγθεθξηκέλε
ηνπνζεζία:
Service?xsd=2
Όξηζκα " KeyTypes"
role
Ρόινη γηα ηελ ζπγθεθξηκέλε ππεξεζία
Dep: Μελύκαηα αλαρώξεζεο γηα θάζε domain, αλ ππάξρεη
Απαξηζκεηόο
ηύπνο
(Dep/Des/AnyRole/Other)
δεδνκέλσλ
26 / 45
ICISnet
Ρόινο αλαρώξεζεο
Des: Μελύκαηα πξννξηζκνύ γηα θάζε domain, αλ ππάξρεη
ξόινο πξννξηζκνύ
Service?xsd=2
AnyRole: Μελύκαηα αλαρώξεζεο ή πξννξηζκνύ
Όξηζκα "DomainRoles"
Other: Τπόινηπα κελύκαηα εθηόο κελπκάησλ αλαρώξεζεο
θαη πξννξηζκνύ.
messageDirectionType
messageType
H παξάκεηξνο αλαθέξεη εάλ ην κήλπκα ζα είλαη εηζεξρόκελν
(πξνο ηελ εθαξκνγή ηνπ ζπλαιιαζζόκελνπ) ή εμεξρόκελν
(από ηελ εθαξκνγή ηνπ ζπλαιιαζζόκελνπ).
InComing/OutGoing
όξηζκα " MessageDirectionTypes"
Ο ηύπνο ηνπ κελύκαηνο. Πρ. GR815. Πξνζνρή δελ
ρξεηάδεηαη ην ζρεηηθό πξόζεκα ηνπ ππνζπζηήκαηνο (EMCS_)
απαξηζκεηόο ηύπνο δεδνκέλσλ.
Service?xsd=2
Service?xsd=3
Τπεξεζία αλαδήηεζεο παξαζηαηηθώλ βάζε εκεξνκελίαο
domain
Σν ππνζύζηεκα ηνπ ICISnet ζην νπνίν απεπζύλεηαη
ππεξεζίαο αλαδήηεζεο. (Πρ DCL (Γεισηηθά))
ηνπνζεζία:
https://www2.gsis.gr/wsicisnet/DateMovementRet
rievalService?xsd=2
Όξηζκα " Domains"
isXmlString
traderID
rievalService?xsd=3
27 / 45
ICISnet
΢πλαιιαζζόκελνπ
rievalService?xsd=3
Ρόινη γηα ηελ ζπγθεθξηκέλε ππεξεζία
role
Dep: Μελύκαηα αλαρώξεζεο γηα θάζε domain, αλ ππάξρεη
ξόινο αλαρώξεζεο
Απαξηζκεηόο
ηύπνο
(Dep/Des/AnyRole/Other)
Des: Μελύκαηα πξννξηζκνύ γηα θάζε domain, αλ ππάξρεη
ξόινο πξννξηζκνύ
Βξίζθεηαη ζηελ ηνπνζεζία:
AnyRole: Μελύκαηα αλαρώξεζεο ή πξννξηζκνύ
messageDirectionType
δεδνκέλσλ
rievalService?xsd=2
Other: Τπόινηπα κελύκαηα εθηόο κελπκάησλ αλαρώξεζεο
θαη πξννξηζκνύ.
Όξηζκα "DomainRoles"
H παξάκεηξνο αλαθέξεη εάλ ην κήλπκα ζα είλαη εηζεξρόκελν
(πξνο ηελ εθαξκνγή ηνπ ζπλαιιαζζόκελνπ) ή εμεξρόκελν
(από ηελ εθαξκνγή ηνπ ζπλαιιαζζόκελνπ).
InComing/OutGoing
Όξηζκα " MessageDirectionTypes"
rievalService?xsd=2
messageType
Ο ηύπνο ηνπ κελύκαηνο. Πρ. GR815. Πξνζνρή δελ
ρξεηάδεηαη ην ζρεηηθό πξόζεκα ηνπ ππνζπζηήκαηνο (EMCS_)
Βξίζθεηαη
ζηελ
ηνπνζεζία:
rievalService?xsd=3
DateTime
dateFrom
Ηκεξνκελία θαη ώξα έλαξμεο αλαδήηεζεο
rievalService?xsd=3
DateTime
dateTo
Ηκεξνκελία θαη ώξα ιήμεο αλαδήηεζεο
28 / 45
ICISnet
rievalService?xsd=3
29 / 45
ICISnet
4.3.
Δηαρείξηζε Λαζώλ
(Οη ηνπνζεζίεο αλαθέξνληαη ζην πεξηβάιινλ δνθηκώλ. Οη αληίζηνηρεο παξαγσγηθέο ηνπνζεζίεο βξείζθνληαη: https://www1.gsis.gr/wsicisnet/....)
4.3.1. Πηζηνπνηεηηθά Server
Δηδηθά θαη κόλν γηα ην πεξηβάιινλ δνθηκώλ εκπόξσλ, επηβάιιεηαη λα απελεξγνπνηήζεηε ηνπο ειέγρνπο γηα ην πηζηνπνηεηηθό αζθαιείαο. Έλαο ηξόπνο γηα
απηό, είλαη ε ρξήζε ησλ παξαθάησ κεζόδσλ ηεο java (εθόζνλ ρξεζηκνπνηείηαη Java Client):
SSLUtilities.trustAllHostnames();
SSLUtilities.trustAllHttpsCertificates();
πνπ πεξηγξάθνληαη αλαιπηηθά ζην site: http://en.wikibooks.org/wiki/WebObjects/Web_Services/How_to_Trust_Any_SSL_Certificate
4.3.2. ΢πγρξνληζκόο Server/Client
Απαξαίηεηε πξνϋπόζεζε γηα ηελ ζσζηή ιεηηνπξγία ησλ webServices ππεξεζηώλ είλαη ν ζπγρξνληζκόο ησλ ξνινγηώλ κεηαμύ client θαη server. Ο
ζπγρξνληζκόο πξέπεη λα γίλεη κε ώξα GMT. Η ρξνληθή δηαθνξά κεηαμύ ησλ ξνινγηώλ πξέπεη λα είλαη ην πνιύ 1 ιεπηό. ΢ηελ πεξίπησζε πνπ ε ρξνληθή
δηαθνξά είλαη άλσ ηνπ 1 ιεπηνύ, εκθαλίδεηαη ην παξαθάησ κήλπκα ιάζνπο:
A Java exception has occured: Security token failed to validate.
weblogic.xml.crypto.wss.SecurityTokenValidateResult@45eca2[status: false][msg UNT Error:Message Created time past
the current time even accounting for set clock skew]
Γηα ηελ επίιπζε ηνπ πξνβιήκαηνο απαηηείηαη ζπγρξνληζκόο ηεο ώξαο ηνπ client κε βάζε ηελ ώξα ηνπ server. Η ππεξεζία, ε νπνία αθνξά ηελ εκθάληζε
ηεο ώξαο ηνπ server δηαηίζεηαη ζηελ ηνπνζεζία: https://www2.gsis.gr/wsicisnet/TimeService?wsdl (Πεξηβάιινλ δνθηκώλ) ή
https://www1.gsis.gr/wsicisnet/TimeService?wsdl (Παξαγσγηθό πεξηβάιινλ).
Δλαιιαθηηθά, πξνηείλεηαη ν ζπγρξνληζκόο κε θάπνην ntp time server.
4.3.3. Καηαγξαθή Λαζώλ
Σα ιάζε θαηαγξάθνληαη ζε 4 επίπεδα. Σν πξώην επίπεδν αθνξά ην Status ησλ ιαζώλ
30 / 45
ICISnet
(https://www2.gsis.gr/wsicisnet/MessageProcessorService?xsd=2,
https://www2.gsis.gr/wsicisnet/MovementRetrievalService?xsd=2,
https://www2.gsis.gr/wsicisnet/DateMovementRetrievalService?xsd=2) θαη έρεη ηηο αθόινπζεο ηηκέο:

InvalidArgument

ValError

OtherError

NothingFound

NotAuthorized

InvalidSignature

IncompleteResults

WrongState
Σν δεύηεξν επίπεδν αθνξά ην ReasonCode ησλ ιαζώλ (ζηηο ηνπνζεζίεο
https://www2.gsis.gr/wsicisnet/MessageProcessorService?xsd=2,
https://www2.gsis.gr/wsicisnet/DateMovementRetrievalService?xsd=2) θαη έρεη ηηο αθόινπζεο ηηκέο:

SyntacticValidationError

RulesConditionasError

RequestParameterError

InvalidMessageContent

PeriodError

RoleError

KeyTypeError

InvalidMessageType

WrongDeclaredMessageType
31 / 45
ICISnet

NotSupportedMessageType

NotSupportedDomain

WrongCredentials

CredentialsNotMatching

NoTraderAuthorization

NoSignatureFound

WrongSignature

StateNotAcceptsMessageType

TechnicalProblem

Other

Failure
Θα πξέπεη λα ζεκεησζεί, όηη όια ηα Status ησλ ιαζώλ δελ ζπλδένληαη κε όια ηα ReasonCodes (γηα παξάδεηγκα ην WrongState ζπλδέεηαη κόλν κε
WrongMessageType reasonCode, όπσο αλαθέξεηαη ζηελ παξάγξαθν 4.3.3.2)
Σα επόκελα επίπεδα θαηαγξαθήο ησλ ιαζώλ είλαη ην Processing Error (αθνξά κόλν ηελ ππεξεζία MessageProcessorService, βξίζθεηαη ζηελ ηνπνζεζία
https://www2.gsis.gr/wsicisnet/MessageProcessorService?xsd=3) θαη ην Explanation (ζηηο ηνπνζεζίεο
https://www2.gsis.gr/wsicisnet/MessageProcessorService?xsd=1,
https://www2.gsis.gr/wsicisnet/DateMovementRetrievalService?xsd=1).
Σν errorCode ηνπ Processing Error, ην νπνίν πεξηγξάθεηαη ζηελ ηνπνζεζία https://www2.gsis.gr/wsicisnet/MessageProcessorService?xsd=1
δελ ρξεζηκνπνηείηαη.
4.3.3.1 Δπηηπρεκέλε ππνβνιή κελύκαηνο
΢ηελ πεξίπησζε επηηπρεκέλεο ππνβνιήο κελύκαηνο ην Status έρεη ηηκή ΟΚ. Οη ηηκέο ησλ ππόινηπσλ πεδίσλ είλαη:
32 / 45
ICISnet
Reason Code
Processing Error
Γελ εκθαλίδεηαη
Other
Explanation
Αλάιπζε/Πεξηγξαθή
OK
Message
has
Been
Successfully Submitted
Σν κήλπκα ππνβιήζεθε κε επηηπρία
Αθνινπζνύλ πίλαθεο νκαδνπνίεζεο ησλ ιαζώλ βάζεη όισλ ησλ ζπλδπαζκώλ ηνπ Status θαη ηνπ ReasonCode.
4.3.3.2 WrongState
Σν παξόλ ιάζνο αθνξά ηελ πξώηε ππεξεζία απνζηνιήο κελπκάησλ (MessageProcessorService).
Reason Code
StateNotAcceptsMessageT
ype
Processing Error
The Movement is in state [Υ], which
does not allow for reception of message
type [messageType]
Explanation
Submitted message out of
Sequence, wrong state. This
message
could
not
be
received in current state.
A
πεξίπησζε)
Σν
LRN
ηνπ
κελύκαηνο δελ είλαη κνλαδηθό,
ππάξρεη ήδε ζηε βάζε
B πεξίπησζε) Αδπλακία ππνβνιήο
ηνπ
παξόληνο
κελύκαηνο.
Σν
ζύζηεκα αλακέλεη κήλπκα ζε
δηαθνξεηηθή θαηάζηαζε.
4.3.3.3 InvalidArgument
Σν παξόλ ιάζνο αθνξά ηηο ππεξεζίεο ππνβνιήο θαη αλαδήηεζεο κελπκάησλ. ΢ηελ πεξίπησζε θαηά ηελ νπνία ζηαιεί κήλπκα πνπ δελ είλαη xml,
εκθαλίδεηαη ην παξαθάησ κήλπκα:
Status Code: INVALID_ARGUMENT
ReasonCode: WRONG_DECLARED_MESSAGE_TYPE
Explanation: Invalid Argument.Wrong Declared Message Type.
33 / 45
ICISnet
(ην κήλπκα δελ έρεη ζσζηό messageType)
Reason Code
PeriodError
WrongDeclaredMessageType
NotSupportedDomain
Processing Error
Parameter [Invalid Message
Type:] was passed an invalid
argument with value [name]
Δεν εμφανίζεται
Explanation
InvalidArgument
Request
Parameter Error, Wrong Period.
Δκθαλίδεηαη
όηαλ ε εκεξνκελία
έλαξμεο είλαη κεγαιύηεξε από ηελ
εκεξνκελία
ιήμεο
ζην
DateMovementRetrievalService
Invalid Argument. Wrong Declared
Message Type
Απνζηέιιεηαη κήλπκα κε ιάζνο
messageType, ζε ζρέζε κε απηό πνπ
έρεη
δεισζεί
ζην
όξηζκα
MessageType πνπ βξίζθεηαη ζηελ
ηνπνζεζία
https://www2.gsis.gr/wsicisnet/Mess
ageProcessorService?xsd=2.
Invalid
Argument.
This
Release does not support
this Message Type.
Γελ ππνζηεξίδεηαη ν παξόλ ηύπνο
κελύκαηνο ζε απηή ηελ έθδνζε.
(MessageType, βρίσκεται στιην
τοποθεσία
https://www2.gsis.gr/wsicisnet/
MessageProcessorService?xsd=2
)
Invalid
Argument.
This
this domain.
Σν ππνζύζηεκα πνπ έρεη δεισζεί,
(όξηζκα Domains ζηελ ηνπνζεζία
https://www2.gsis.gr/wsicisnet/Date
MovementRetrievalService?xsd=2 ή
https://www2.gsis.gr/wsicisnet/Move
mentRetrievalService?xsd=2)
δελ
ππνζηεξίδεηαη
ζηηο
ππεξεζίεο
αλαδήηεζεο.
34 / 45
ICISnet
RoleError
KeyTypeError
InvalidMessageType
Δεν εμφανίζεται
Invalid
Argument.This
this Message Type.
InvalidArgument
Request
Parameter Error, Role is not
supported for Domain.
InvalidArgument
Request
Parameter Error, key is not
supported for Domain/role.
Invalid Argument.
Parameter Error,
Message Type.
Request
Invalid
Ό ηύπνο κελύκαηνο πνπ έρεη
δεισζεί, (όξηζκα messageType
στις τοποθεσίες
DateMovementRetrievalService?
xsd=3 ή
MovementRetrievalService?xsd=
3) δελ ππνζηεξίδεηαη ζηηο ππεξεζίεο
αλαδήηεζεο.
Σν παξόλ ππνζύζηεκα (domain) δελ
ζπλδέεηαη κε ηνλ παξόληα
ξόιν
(role).
Βιέπε παξάγξαθν 4.4
Σν παξόλ ππνζύζηεκα (domain) δελ
ζπλδέεηαη κε ην παξόλ θιεηδί
(keyType)
Βιέπε παξάγξαθν 4.4
Λάζνο MessageType (όξηζκα
messageType στις τοποθεσίες
DateMovementRetrievalService?
xsd=3 ή
MovementRetrievalService?xsd=
3) γηα ηηο ππεξεζίεο αλαδήηεζεο.
4.3.3.4 ValError
Σν παξόλ ιάζνο αθνξά ηελ ππεξεζία ππνβνιήο κελπκάησλ.
35 / 45
ICISnet
Reason Code
Processing Error
Explanation
SyntacticValidationE
rror
The end-tag for element type "%element% r" must
end with a '>' delimiter.
Validation
Error.
Syntactic
Validation Error
Σν
end-xml tag ηνπ
%element% ζην κήλπκα
πνπ ππνβάιιεηαη είλαη
ιάζνο.
rror
rror
rror
rror
null: Το πεδίο %element% είναι απαραίτητο.
Το πεδίο %element% (num) πρέπει να
μεγαλύτερο από %number% χαρακτήρες.
μην
είναι
Validation Error : invalid character on numeric Field: %element%
Validation Error : invalid character on numeric
FieldValue %number% for hourOfDay must be in the
range [0,23]
Validation
Error.
Syntactic
Validation Error
Λείπεη
ην
πεδίν
%element%
από
ην
κήλπκα
πνπ
ππνβάιιεηαη.
Validation
Error.
Syntactic
Validation Error
Η ηηκή ηνπ πεδίνπ
%element% πξέπεη λα
είλαη
κηθξόηεξε
από
%number%) ραξαθηήξεο.
invalid
character
on numeric Field:
"%element%"
Validation Error :
invalid
character
on
numeric
FieldValue 28 for
hourOfDay must be
in
the
range
[0,23]
Η
ηηκή
ζην
πεδίν
%element%
ηνπ
κελύκαηνο
πνπ
ππνβάιιεηαη πξέπεη λα
είλαη αξηζκόο.
H ηηκή %number% δελ
είλαη έγθπξε ώξα. Η ηηκή
πξέπεη λα είλαη κεηαμύ 0
θαη 23.
36 / 45
ICISnet
rror
Validation Error: invalid character on numeric
FieldValue %number% for monthOfYear must be in
the range [1,12]
Validation Error :
invalid
character
on
numeric
FieldValue 99 for
monthOfYear
must
be in the range
[1,12]
Η ηηκή %number% δελ
είλαη έγθπξνο κήλαο. Η
ηηκή πξέπεη λα είλαη
κεηαμύ 1 θαη 12.
Η ηηκή %number% δελ
είλαη έγθπξε εκέξα.
rror
processing
Error:
Validation
Error:
invalid
character on numeric FieldValue %number% for
dayOfMonth must be in the range [1,30]
Validation
Error:
invalid
character
on
numeric
FieldValue 40 for
dayOfMonth must be
in
the
range
[1,30]
Γηα
ηνπο
κήλεο
Ιαλνπάξην, Μάξηην, Μάην,
Ινύιην,
Αύγνπζην,
Οθηώβξην θαη Γεθέκβξην,
ε ηηκή πξέπεη λα είλαη
κεηαμύ 1 θαη 31.
Γηα ηνπο κήλεο Απξίιην,
Ινύλην, ΢επηέκβξην θαη
Ννέκβξην, ε ηηκή πξέπεη
λα είλαη κεηαμύ 1 θαη 30.
Γηα
ηνλ
κήλα
Φεβξνπάξην,
ε
ηηκή
πξέπεη λα είλαη κεηαμύ 1
θαη 28, εθηόο από ηελ
πεξίπησζε
δίζεθηνπ
έηνπο, νπόηε θαη ε
κέγηζηε ηηκή είλαη 29.
37 / 45
ICISnet
rror
XML document structures must start and end within
the same entity.
Validation
Error.
Syntactic
Validation Error
Η δνκή ηνπ κελύκαηνο
πνπ ππνβάιιεηαη δελ
είλαη έγθπξε. (ην start
xml tag είλαη δηαθνξεηηθό
από ην end xml tag)
4.3.3.5 OtherError
Σν παξόλ ιάζνο αθνξά θαη ηηο ηξείο (3) ππεξεζίεο πνπ ππνζηεξίδεη ε εθαξκνγή. ΢ην πεδίν explanation πξνζηίζεηαη έλα κνλαδηθό id ηεο κνξθήο
@numeric@. Γηα ηελ δηεξεύλεζε ηνπ ιάζνπο ν ρξήζηεο είλαη απαξαίηεην λα επηθνηλσλήζεη κε ην helpdesk ησλ ηεισλείσλ δίλνληαο ην παξαπάλσ id.
Reason Code
Explanation
Technical Problem
id @number@ : Other Error.
Λάζε πνπ αθνξνύλ ηερληθά ζέκαηα.
Other
Γηάθνξα γεληθά ιάζε πνπ δελ εμαξηώληαη από ηελ
εθαξκνγή.
Failure
Γεληθά Λάζε, επηθνηλσλείζηε κε ηνλ ππεύζπλν ηνπ
ζπζηήκαηνο.
4.3.3.6 NothingFound
Σν παξόλ ιάζνο αθνξά ηηο 2 ππεξεζίεο αλαδήηεζεο κελπκάησλ.
Reason Code
OTHER
Explanation
Nothing Found.
Η αλαδήηεζε δελ έθεξε θάπνηα απνηειέζκαηα.
4.3.3.7 NotAuthorized
Σν παξόλ ιάζνο αθνξά θαη ηηο ηξείο (3) ππεξεζίεο πνπ ππνζηεξίδεη ε εθαξκνγή. ΢ην πξώην επίπεδν ειέγρνπ εμεηάδεηαη ε εγθπξόηεηα ηνπ νλόκαηνο ηνπ
ρξήζηε (icisUserName) θαη ν θσδηθόο πξόζβαζήο ηνπ (icisPassword). ΢ε πεξίπησζε κε έγθπξνπ νλόκαηνο ή θσδηθνύ πξόζβαζεο ηνπ ρξήζηε,
ιακβάλεηαη ην αθόινπζν κήλπκα πξνηνύ απνζηαιεί ην αίηεκα γηα ηελ ρξήζε ησλ ππεξεζηώλ ηνπ server:
38 / 45
ICISnet
Failed to assert identity with UsernameToken.
Reason Code
WRONG_CREDENTIALS
Processing Error
User is not authorized to use
web services
Explanation
User is Not
Wrong
web
Credentials.
Authorized.
services
CredentialsNotMatching
Not_Authorized.
The
Credentials
are
Matching
two
not
NoTraderAuthorization
The user with ID [{0}] is not authorised
to perform operation [{2}] on behalf of
trader [{1}]
Not_Authorized. User is not
Authorized for Trader
Σν ζπκπιεξσκαηηθό όλνκα ρξήζηε
όξηζκα wsUserID ζηελ ηνπνζεζία
ageProcessorService?xsd=3
ή ν
ζπκπιεξσκαηηθόο
θσδηθόο
πξόζβαζεο ηνπ ρξήζηε (όξηζκα
wsPass
ζηελ
ηνπνζεζία
ageProcessorService?xsd=3) είλαη κε
έγθπξνο.
Σν ζπκπιεξσκαηηθό όλνκα ρξήζηε
(όξηζκα wsUserID ζηελ ηνπνζεζία
ageProcessorService?xsd=3)
είλαη
κε έγθπξν ζε ζρέζε κε ην traderID)
(όξηζκα traderID ζηελ ηνπνζεζία
ageProcessorService?xsd=3) .
Γελ
ππάξρεη
εμνπζηνδόηεζε.
θαηάιιειε
4.3.3.8 InvalidSignature
Σν παξόλ ιάζνο αθνξά κόλν ηελ πξώηε ππεξεζία απνζηνιήο κελπκάησλ (MessageProcessorService)
Reason Code
Processing Error
39 / 45
ICISnet
NoSignatureFound
WrongSignature
Σν πξόβιεκα αθνξά ηελ ςεθηαθή ππνγξαθή.
To κήλπκα ππνβάιιεηαη ιαλζαζκέλα ρσξίο ςεθηαθή ππνγξαθή
Σν πξόβιεκα αθνξά ηελ ςεθηαθή ππνγξαθή.
Η ςεθηαθή ππνγξαθή πνπ απνζηέιιεηαη καδί κε ην κήλπκα είλαη ιαλζαζκέλε.
4.3.3.9 IncompleteResults
Σν παξόλ ιάζνο αθνξά κόλν ηελ ππεξεζία αλαδήηεζεο βάζεη εκεξνκεληώλ.
Reason Code
Δεν εμφανίζεται.
4.4.
Explanation
Number of retrieved Movements exceeded the 150
threshold
Δκθαλίδεηαη όηαλ ηα απνηειέζκαηα ηεο
αλαδήηεζεο είλαη πάλσ από ηνλ κέγηζην αξηζκό
θηλήζεσλ (κέγηζηνο αξηζκόο θηλήζεσο = 150).
΢πζρέηηζε Τπνζπζηεκάηωλ/Ρόιωλ & Τπνζπζηεκάηωλ/Κιεηδηώλ
Οη επηηξεπηνί ζπλδπαζκνί κεηαμύ ππνζπζηεκάησλ θαη ξόισλ παξαηίζεληαη ζηνλ αθόινπζν πίλαθα.
Ρόινη
Dep
Des
Other
AnyRole
DCL – Γεισηηθώλ
OXI
OXI
NAI
NAI
EMCS - Δ.Φ.Κ.
NAI
NAI
OXI
NAI
ECS - Δμαγσγώλ
OXI
OXI
NAI
NAI
Τπνζπζηήκαηα
40 / 45
ICISnet
IMP – Δηζαγσγώλ
OXI
OXI
NAI
NAI
NCTS - Γηακεηαθόκηζεο
NAI
NAI
OXI
NAI
Οη επηηξεπηνί ζπλδπαζκνί κεηαμύ ππνζπζηεκάησλ θαη θιεηδηώλ παξαηίζεληαη ζηνλ αθόινπζν πίλαθα.
Κιεηδηά
LRN
MRN
ARC
DCL
NAI
NAI
OXI
EMCS (Dep)
NAI
OXI
NAI
EMCS (Des)
ΟΥΙ
ΟΥΙ
ΝΑΙ
EMCS (AnyRole)
NAI
OXI
NAI
ECS
NAI
NAI
OXI
IMP
NAI
ΝΑΙ
ΟΥΙ
NCTS
NAI
ΝΑΙ
ΟΥΙ
Τπνζπζηήκαηα
4.5.
Εμνπζηνδνηήζεηο
Σν θύθισκα ησλ εμνπζηνδνηήζεσλ έρεη πινπνηεζεί κε βάζε ηηο παξαθάησ αξρέο:

Τπάξρεη ε νληόηεηα Υξήζηεο, πνπ είλαη απηόο ν νπνίνο ζπλδέεηαη ζην ζύζηεκα θαη ε νληόηεηα Δλεξγόο ΢πλαιιαζζόκελνο, πνπ είλαη εθείλνο γηα
ηνλ νπνίν ελεξγεί ν ρξήζηεο.

Δλαο ρξήζηεο κπνξεί λα ελεξγεί γηα ηνλ εαπηό ηνπ, νπόηε ρξήζηεο θαη ελεξγόο ζπλαιιαζζόκελνο ηαπηίδνληαη.

Υξήζηεο ρσξίο εμνπζηνδόηεζε δελ έρεη ηε δπλαηόηεηα ππνβνιήο θαη ιήςεο κελπκάησλ γηα άιιν ελεξγό ζπλαιιαζζόκελν, παξά κόλν γηα ηνλ
εαπηό ηνπ.
41 / 45
ICISnet

Ο ρξήζηεο πνπ έρεη εμνπζηνδόηεζε κπνξεί λα ππνβάιεη κελύκαηα θαη λα πξαγκαηνπνηεί αλαδήηεζε κελπκάησλ πνπ έρεη ππνβάιεη.

Ο ρξήζηεο πνπ έρεη εμνπζηνδόηεζε δελ έρεη ηε δπλαηόηεηα αλαδήηεζεο κελπκάησλ πνπ δελ έρεη ππνβάιεη.

΢ε πεξίπησζε άξζεο ηεο εμνπζηνδόηεζεο ν ρξήζηεο δελ έρεη ηε δπλαηόηεηα ππνβνιήο θαη αλαδήηεζεο κελπκάησλ.
4.6.
Σύπνη Μελπκάηωλ (MessageTypes)
΢ην παξόλ θεθάιαην παξαηίζεληαη ηα messageTypes πνπ ππνζηεξίδεη θάζε ππνζύζηεκα (domain). Πξνο ην παξόλ είλαη δηαζέζηκα ηα ππνζπζηήκαηα ΔΦΚ
θαη Γεισηηθώλ πνπ θαιύπηνπλ ηηο αλάγθεο ησλ Κνηλνηηθώλ έξγσλ EMCS-FS1 θαη ICS κε πεξηνξηζκέλν εύξνο κελπκάησλ. Σν ππνζύζηεκα ησλ εμαγσγώλ
είλαη δηαζέζηκν γηα δνθηκέο κόλν!
4.6.1. Τπνζύζηεκα Δηδηθώλ Φόξσλ Καηαλάισζεο
Μήλπκα
Ελέξγεηα
e-ΔΕ
GR815
Τπνβνιή
GR813
Γηόξζσζε
GR810
Αθύξσζε
Αλαθνξά Παξαιαβήο
GR818
Τπνβνιή
Λόγνη Καζπζηέξεζεο Παξάδνζεο
GR837
Τπνβνιή
Απαληεηηθά Μελύκαηα Εηδηθώλ Φόξωλ Καηαλάιωζεο
42 / 45
ICISnet
GR801
GR802
GR803
GR810
GR813
GR818
GR837
GR704
GR905
4.6.2. Τπνζύζηεκα Γεισηηθώλ
Μήλπκα
Ελέξγεηα
΢πλνπηηθή Δηαζάθεζε Εηζόδνπ
IE315
Τπνβνιή
IE313
Γηόξζσζε
Δηεζλήο Εθηξνπή
Τπνβνιή
IE323
Αλαγγειία Άθημεο 1εο Εηζόδνπ
IE344
Τπνβνιή
DA013
Γηόξζσζε
43 / 45
ICISnet
Αλαγγειία Άθημεο Επόκελεο Εηζόδνπ
IE347
Τπνβνιή
DA413
Γηόξζσζε
Απαληεηηθά Μελύκαηα Δειωηηθώλ
IE316
IE328
IE304
IE305
IE351
IE323
IE324
IE348
IE349
IE330
IE361
IE329
IE322
DA404
DA405
IE345
IE346
IE330
IE361
44 / 45
ICISnet
IE329
IE322
DA004
DA005
4.6.3. Τπνζύζηεκα Δμαγσγώλ.
Πιήξε ιίζηα ησλ δηαζέζηκσλ κελπκάησλ ππάξρεη ζην portal: http://www.gsis.gr/teloneia/ICISnet/ICISnet_ECStables.html
45 / 45

Web Services User Manual

Transcription

Similar documents

Digital Object