Προδιαγραθε ς WebServices Κενηρικου Κο μβοσ Διαλειηοσργικο ηηηας Περιετο μενα 1. Δηζαγσγή... 2 2. Σηνηρεία Οηθνλνκηθνύ... 2 2.1. Απνινγηζηηθά Σηνηρεία... 2 2.2. Σηνηρεία Ιζνδπγίνπ Γεληθνύ Καζνιηθνύ... 4 2.3. Μεληαία Σηνηρεία Δγθπθιίνπ 2/61968/0094/17-9-2010 (Σηνηρεία Γηαζεζίκσλ, Γαλείσλ θαη Υπνρξεώζεσλ)... 5 2.4. Μεηξών Γεζκεύζεσλ... 7 2.5. Σηνηρεία Πνξείαο Δίζπξαμεο Δζόδσλ... 10 2.6. Σηνηρεία Δλδνθπβεξλεηηθώλ ζπλαιιαγώλ πιεξσκώλ θαη εηζπξάμεσλ... 11 3. Πεξηπηώζεηο Σθαικάησλ... 14 1
1. Ειζαγωγή Παξαθάησ αλαθέξνληαη αλαιπηηθά νη πξνδηαγξαθέο ησλ δηαδηθηπαθώλ ππεξεζηώλ πνπ ζα αλαπηπρζνύλ ζην ζύζηεκα ηνπ Κεληξηθνύ Κόκβνπ Γηαιεηηνπξγηθόηεηαο, έηζη ώζηε λα δίλεηαη ε δπλαηόηεηα ζε ηξίηνπο θνξείο, κε θαηάιιεινπο θσδηθνύο πξόζβαζεο, λα κπνξνύλ λα αληινύλ ηα ζηνηρεία πνπ έρνπλ απνζηείιεη νη θνξείο ζην ζύζηεκα. 2. Σηοιτεία Οικονομικου 2.1. Απνινγηζηηθά Σηνηρεία Η ππεξεζία δέρεηαη σο νξίζκαηα έλα xml αξρείν, ην νπνίν πεξηέρεη ην έηνο ηεο νηθνλνκηθήο ρξήζεο, ηνλ κήλα γηα ηνλ νπνίν δεηά απνινγηζηηθά ζηνηρεία, ηνλ θσδηθό ηνπ θνξέα θαη ηα αλαγλσξηζηηθά ζύλδεζεο (username θαη password). Η ππεξεζία επηζηξέθεη έλα xml αξρείν πνπ πεξηέρεη όια ηα ζηνηρεία ηνπ απνινγηζκνύ. Μέζνδνο Πεξηγξαθή Οξίζκαηα Δπηζηξεθόκελε ηηκή public String getreportdataaccountsdata(string data) throws LoginException, UnavailableDataException, UnfinalizedDataException, RemoteException Η κέζνδνο επηζηξέθεη ηα απνινγηζηηθά ζηνηρεία. Τν πξώην όξηζκα είλαη έλα string κε ην πεξηερόκελα ελόο xml θεηκέλνπ. To xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified"> <xs:element name="arguments"> <xs:all> <xs:element name="credentials"> <xs:attribute name="username" type="xs:string" use="required" <xs:attribute name="password" type="xs:string " use="required" </xs:all> <xs:attribute name="year" type="xs:integer" use="required" <xs:attribute name="month" type="xs:integer" use="required" <xs:attribute name="orgunit" type="xs:string" use="required" Δπηζηξέθεη έλα string κε ην πεξηερόκελν ελόο xml θεηκέλνπ. Τν xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="accounts_review"> <xs:element ref="expenses" minoccurs="1" maxoccurs="1" <xs:element ref="incomes" minoccurs="1" maxoccurs="1" <xs:attribute name="year" type="year_type" use="required" <xs:attribute name="month" type="month_type" use="required" <xs:element name="expenses"> <xs:element ref="expense_account" minoccurs="1" maxoccurs="unbounded" 2
<xs:element name="incomes"> <xs:element ref="income_account" minoccurs="1" maxoccurs="unbounded" <xs:element name="expense_account"> <xs:attribute name="kae" type="kae_type" use="required" <xs:attribute name="approved" type="decimal15_2" use="required" <xs:attribute name="formatted" type="decimal15_2" use="required" <xs:attribute name="bounded" type="decimal15_2" use="required" <xs:attribute name="invoiced" type="decimal15_2" use="required" <xs:attribute name="payed" type="decimal15_2" use="required" <xs:element name="income_account"> <xs:attribute name="kae" type="kae_type" use="required" <xs:attribute name="approved" type="decimal15_2" use="required" <xs:attribute name="formatted" type="decimal15_2" use="required" <xs:attribute name="confirmed" type="decimal15_2" use="required" <xs:attribute name="collected" type="decimal15_2" use="required" <xs:simpletype name="year_type"> <xs:pattern value="[0-9]{4}" <xs:simpletype name="month_type"> <xs:pattern value="[0-9] 1[012]" <xs:simpletype name="kae_type"> <xs:maxlength value="32" <xs:simpletype name="decimal15_2"> <xs:restriction base="xs:decimal"> <xs:fractiondigits value="2" <xs:totaldigits value="15" Παξαηεξήζεηο YEAR Έηνο (1.1.1 1.2.1) MONTH Μήλαο (1.1.2 1.2.2) KAE ΚΑΔ (1.1.3 1.2.3) APPROVED Δγθεθξηκέλνο Π/Υ (1.1.4 1.2.4) FORMATTED Γηακνξθσκέλνο Π/Υ (1.1.5 1.2.5) BOUNDED Γεζκεπζέληα (1.1.6) INVOICED Δληαιζέληα (1.1.7) PAYED Πιεξσζέληα (1.1.8) CONFIRMED Βεβαησζέληα (1.2.6) COLLECTED Δηζπξαρζέληα (1.2.7) 3
2.2. Σηνηρεία Ιζνδπγίνπ Γεληθνύ Καζνιηθνύ Η ππεξεζία δέρεηαη σο νξίζκαηα έλα xml αξρείν, ην νπνίν πεξηέρεη ην έηνο ηεο νηθνλνκηθήο ρξήζεο, ηνλ κήλα γηα ηνλ νπνίν δεηά ζηνηρεία ηζνδπγίνπ, ηνλ θσδηθό ηνπ θνξέα θαη ηα αλαγλσξηζηηθά ζύλδεζεο (username θαη password). Η ππεξεζία επηζηξέθεη έλα xml αξρείν πνπ πεξηέρεη όια ηα ζηνηρεία ηνπ ηζνδπγίνπ. Μέζνδνο public String getreportdataaccountsbalance(string data) throws LoginException, UnavailableDataException, UnfinalizedDataException, RemoteException Πεξηγξαθή Οξίζκαηα Δπηζηξεθόκελε ηηκή Δπηζηξέθεη ηα ζηνηρεία ηνπ ηζνδπγίνπ γεληθνύ θαζνιηθνύ Τν πξώην όξηζκα είλαη έλα string κε ην πεξηερόκελα ελόο xml θεηκέλνπ. To xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified"> <xs:element name="arguments"> <xs:all> <xs:element name="credentials"> <xs:attribute name="username" type="xs:string" use="required" <xs:attribute name="password" type="xs:string " use="required" </xs:all> <xs:attribute name="year" type="xs:integer" use="required" <xs:attribute name="month" type="xs:integer" use="required" <xs:attribute name="orgunit" type="xs:string" use="required" Δπηζηξέθεη έλα string κε ην πεξηερόκελν ελόο xml θεηκέλνπ. Τν xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="accounts_balance"> <xs:element ref="account" minoccurs="1" maxoccurs="unbounded" <xs:attribute name="year" type="year_type" use="required" <xs:attribute name="month" type="month_type" use="required" <xs:element name="account"> <xs:attribute name="kgl" type="kgl_type" use="required" <xs:attribute name="ex_year_debit" type="decimal15_2" use="required" <xs:attribute name="ex_year_credit" type="decimal15_2" use="required" <xs:attribute name="previous_debit" type="decimal15_2" use="required" <xs:attribute name="previous_credit" type="decimal15_2" use="required" <xs:attribute name="period_debit" type="decimal15_2" use="required" <xs:attribute name="period_credit" type="decimal15_2" use="required" <xs:simpletype name="year_type"> <xs:pattern value="[0-9]{4}" <xs:simpletype name="month_type"> <xs:pattern value="[0-9] 1[012]" <xs:simpletype name="kgl_type"> 4
<xs:maxlength value="8" <xs:simpletype name="decimal15_2"> <xs:restriction base="xs:decimal"> <xs:fractiondigits value="2" <xs:totaldigits value="15" Παξαηεξήζεηο YEAR Έηνο (2.1) MONTH Μήλαο (2.2) KGL Κσδηθόο Λνγαξηαζκνύ (2.3) EX_YEAR_DEBIT Φξέσζε απνγξαθήο (2.4) EX_YEAR_CREDIT Πίζησζε απνγξαθήο (2.5) PREVIOUS_DEBIT Φξέσζε πξνεγνύκελεο πεξηόδνπ (2.6) PREVIOUS_CREDIT Πίζησζε πξνεγνύκελεο πεξηόδνπ (2.7) PERIOD_DEBIT Φξέσζε πεξηόδνπ (2.8) PERIOD_CREDIT Πίζησζε πεξηόδνπ (2.9) 2.3. Μεληαία Σηνηρεία Εγθπθιίνπ 2/61968/0094/17-9-2010 (Σηνηρεία Δηαζεζίκωλ, Δαλείωλ θαη Υπνρξεώζεωλ) Η ππεξεζία δέρεηαη σο νξίζκαηα έλα xml αξρείν, ην νπνίν πεξηέρεη ην έηνο ηεο νηθνλνκηθήο ρξήζεο, ηνλ κήλα γηα ηνλ νπνίν δεηά ηα κεληαία ζηνηρεία ηεο εγθπθιίνπ, ηνλ θσδηθό ηνπ θνξέα θαη ηα αλαγλσξηζηηθά ζύλδεζεο (username θαη password). Η ππεξεζία επηζηξέθεη έλα xml αξρείν πνπ πεξηέρεη όια ηα ζηνηρεία ηεο εγθπθιίνπ. Μέζνδνο public String getreportdatastats(string data) throws LoginException, UnavailableDataException, UnfinalizedDataException, RemoteException Πεξηγξαθή Οξίζκαηα Δπηζηξεθόκελε ηηκή Δπηζηξέθεη ηα κεληαία ζηνηρεία ηεο εγθπθιίνπ Τν πξώην όξηζκα είλαη έλα string κε ην πεξηερόκελα ελόο xml θεηκέλνπ. To xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified"> <xs:element name="arguments"> <xs:all> <xs:element name="credentials"> <xs:attribute name="username" type="xs:string" use="required" <xs:attribute name="password" type="xs:string " use="required" </xs:all> <xs:attribute name="year" type="xs:integer" use="required" <xs:attribute name="month" type="xs:integer" use="required" <xs:attribute name="orgunit" type="xs:string" use="required" Δπηζηξέθεη έλα string κε ην πεξηερόκελν ελόο xml θεηκέλνπ. Τν xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> 5
<xs:element name="stats_data"> <xs:attribute name="year" type="year_type" use="required" <xs:attribute name="month" type="month_type" use="required" <xs:attribute name="cash" type="decimal15_2" use="required" <xs:attribute name="bog" type="decimal15_2" use="required" <xs:attribute name="other_banks" type="decimal15_2" use="required" <xs:attribute name="gov_securities" type="decimal15_2" use="required" <xs:attribute name="other_securities" type="decimal15_2" use="required" <xs:attribute name="stocks" type="decimal15_2" use="required" <xs:attribute name="loans_to_others" type="decimal15_2" use="required" <xs:attribute name="loans_from_cr_found" type="decimal15_2" use="required" <xs:attribute name="liabil_third" type="decimal15_2" use="required" <xs:attribute name="liabil_gov" type="decimal15_2" use="required" <xs:simpletype name="year_type"> <xs:pattern value="[0-9]{4}" <xs:simpletype name="month_type"> <xs:pattern value="[0-9] 1[012]" <xs:simpletype name="decimal15_2"> <xs:restriction base="xs:decimal"> <xs:fractiondigits value="2" <xs:totaldigits value="15" Παξαηεξήζεηο YEAR Έηνο (3.1) MONTH Μήλαο (3.2) CASH Τακείν (3.3) BOG Καηαζέζεηο ζηελ ΤηΔ (3.4) OTHER_BANKS Καηαζέζεηο ζε ινηπέο Τξάπεδεο (3.5) GOV_SECURITIES Τίηινη Διιεληθνύ Γεκνζίνπ (3.6) OTHER_SECURITIES Λνηπά Οκόινγα (3.7) STOCKS Μεηνρέο (3.8) LOANS_TO_OTHERS Γάλεηα πξνο ηξίηνπο (3.9) LOANS_FROM_CR_FOUND Γάλεηα από πηζησηηθά ηδξύκαηα θαη νξγαληζκνύο (3.10) LIABIL_THIRD Υπνρξεώζεηο ζε θνξείο εθηόο γεληθήο θπβέξλεζεο (3.11) LIABIL_GOV Υπνρξεώζεηο ζε θνξείο ηεο γεληθήο θπβέξλεζεο (3.13) 6
2.4. Μεηξών Δεζκεύζεωλ Η ππεξεζία δέρεηαη σο νξίζκαηα έλα xml αξρείν, ην νπνίν πεξηέρεη ην έηνο ηεο νηθνλνκηθήο ρξήζεο, ηνλ κήλα γηα ηνλ νπνίν δεηά ηα ζηνηρεία ηνπ κεηξώνπ δεζκεύζεσλ, ηνλ θσδηθό ηνπ θνξέα θαη ηα αλαγλσξηζηηθά ζύλδεζεο (username θαη password). Η ππεξεζία επηζηξέθεη έλα xml αξρείν πνπ πεξηέρεη όια ηα ζηνηρεία ηνπ κεηξώνπ. Μέζνδνο Πεξηγξαθή Οξίζκαηα Δπηζηξεθόκελε ηηκή public String getreportdataboundsrecord(string data) throws LoginException, UnavailableDataException, UnfinalizedDataException, RemoteException Δπηζηξέθεη ηα ζηνηρεία ηνπ κεηξώνπ δεζκεύζεσλ Τν πξώην όξηζκα είλαη έλα string κε ην πεξηερόκελα ελόο xml θεηκέλνπ. To xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified"> <xs:element name="arguments"> <xs:all> <xs:element name="credentials"> <xs:attribute name="username" type="xs:string" use="required" <xs:attribute name="password" type="xs:string " use="required" </xs:all> <xs:attribute name="year" type="xs:integer" use="required" <xs:attribute name="month" type="xs:integer" use="required" <xs:attribute name="orgunit" type="xs:string" use="required" Δπηζηξέθεη έλα string κε ην πεξηερόκελν ελόο xml θεηκέλνπ. Τν xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="bounds_record"> <xs:element ref="account_record" minoccurs="1" maxoccurs="unbounded" <xs:attribute name="year" type="year_type" use="required" <xs:attribute name="month" type="month_type" use="required" <xs:element name="account_record"> <xs:element ref="bound_records" minoccurs="1" maxoccurs="unbounded" <xs:attribute name="kae" type="kae_type" use="required" <xs:attribute name="approved" type="decimal15_2" use="required" <xs:element name="bound_records"> <xs:element ref="bound_invoices" minoccurs="0" maxoccurs="unbounded" <xs:attribute name="bound_aa" type="xs:string" use="required" <xs:attribute name="trans_date" type="date_type" use="required" <xs:attribute name="kae_reform_until" type="decimal15_2" use="required" <xs:attribute name="kae_formatted_until" type="decimal15_2" use="required" <xs:attribute name="kae_serviced_until" type="decimal15_2" use="required" 7
<xs:attribute name="bound_code" type="xs:string" use="required" <xs:attribute name="bound_date" type="date_type" use="required" <xs:attribute name="bound_value" type="decimal15_2" use="required" <xs:attribute name="rest_kae_value" type="decimal15_2" use="required" <xs:element name="bound_invoices"> <xs:attribute name="invoice_code" type="xs:string" use="required" <xs:attribute name="invoice_seira" type="xs:string" use="required" <xs:attribute name="invoice_date" type="date_type" use="required" <xs:attribute name="afm" type="xs:string" use="required" <xs:attribute name="invoice_value" type="decimal15_2" use="required" <xs:attribute name="ental_code" type="xs:string" use="required" <xs:attribute name="pay_value" type="decimal15_2" use="required" <xs:attribute name="pay_date" type="date_type" use="required" <xs:attribute name="pay_type" type="xs:string" use="required" <xs:attribute name="pending_bounds" type="decimal15_2" use="required" <xs:attribute name="unpayed_invoices" type="decimal15_2" use="required" <xs:attribute name="unpayed_gov" type="decimal15_2" use="required" <xs:attribute name="unpayed_third" type="decimal15_2" use="required" <xs:attribute name="paydue_date" type="date_type" use="required" <xs:attribute name="unpayed_gov_30" type="decimal15_2" use="required" <xs:attribute name="unpayed_third_30" type="decimal15_2" use="required" <xs:attribute name="unpayed_gov_60" type="decimal15_2" use="required" <xs:attribute name="unpayed_third_60" type="decimal15_2" use="required" <xs:attribute name="unpayed_gov_90" type="decimal15_2" use="required" <xs:attribute name="unpayed_third_90" type="decimal15_2" use="required" <xs:attribute name="unpayed_gov_overdue" type="decimal15_2" use="required" <xs:attribute name="unpayed_third_overdue" type="decimal15_2" use="required" <xs:simpletype name="year_type"> <xs:pattern value="[0-9]{4}" <xs:simpletype name="month_type"> <xs:pattern value="[0-9] 1[012]" <xs:simpletype name="kae_type"> <xs:maxlength value="32" <xs:simpletype name="date_type"> <xs:union> <xs:simpletype> <xs:restriction base="xs:date"> <xs:simpletype> <xs:enumeration value="" </xs:union> <xs:simpletype name="decimal15_2"> <xs:restriction base="xs:decimal"> <xs:fractiondigits value="2" <xs:totaldigits value="15" 8
Παξαηεξήζεηο YEAR Έηνο (4.1) MONTH Μήλαο (4.2) KAE ΚΑΔ (4.3) APPROVED Δγθεθξηκέλνο Π/Υ (4.4) TRANS_DATE Ηκεξνκελία Δγγξαθήο (4.5.1) BOUND_AA Α/Α εγγξαθήο δέζκεπζεο (4.5.2) KAE_REFORM_UNTIL Αλακνξθώζεηο Π/Υ (4.5.3) KAE_FORMATTED_UNTIL Γηακνξθσκέλνο Π/Υ (4.5.4) KAE_SERVICED_UNTIL Πνζνζηό δηάζεζεο πίζησζεο (4.5.5) BOUND_CODE Αξηζκόο απόθαζεο αλάιεςεο ππνρξέσζεο (4.5.6) BOUND_DATE Ηκεξνκελία αλάιεςεο ππνρξέσζεο (4.5.7) BOUND_VALUE Πνζό δέζκεπζεο (4.5.8) REST_KAE_VALUE Υπνιεηπόκελε πξνο δηάζεζε πίζησζε (4.5.9) INVOICE_CODE Αξηζκόο ηηκνινγίνπ (4.5.10) INVOICE_SEIRA Σεηξά ηηκνινγίνπ (4.5.11) INVOICE_DATE Ηκεξνκελία ηηκνινγίνπ (4.5.12) AFM ΑΦΜ (4.5.13) INVOICE_VALUE Πνζό ηηκνινγίνπ (4.5.14) ENTAL_CODE Αξηζκόο εληάικαηνο πιεξσκήο (4.5.15) PAY_VALUE Πνζό πιεξσκήο (4.5.16) PAY_DATE Ηκεξνκελία εμόθιεζεο (4.5.17) PAY_TYPE Δίδνο παξαζηαηηθνύ πιεξσκήο (4.5.18) PENDING_BOUNDS Δθθξεκείο δεζκεύζεηο (4.5.19) UNPAYED_INVOICES Απιήξσηεο ππνρξεώζεηο (4.5.20) UNPAYED_GOV Απιήξσηεο ππνρξεώζεηο πξνο γεληθή θπβέξλεζε (4.5. 20.1) UNPAYED_THIRD Απιήξσηεο ππνρξεώζεηο πξνο ηξίηνπο (4.5.20.2) PAYDUE_DATE Ηκεξνκελία ππνρξέσζεο εμόθιεζεο (4.5.21) UNPAYED_GOV_30 UNPAYED_THIRD_30 UNPAYED_GOV_60 UNPAYED_THIRD_60 UNPAYED_GOV_90 UNPAYED_THIRD_90 UNPAYED_GOV_OVERDUE UNPAYED_THIRD_OVERDUE Δθθξεκείο νθεηιέο από 1 έσο 30 εκέξεο πξνο Γεληθή Κπβέξλεζε (4.5.22) Δθθξεκείο νθεηιέο από 1 έσο 30 εκέξεο πξνο ηξίηνπο (4.5.23) Δθθξεκείο νθεηιέο από 31 έσο 60 εκέξεο πξνο Γεληθή Κπβέξλεζε (4.5.24) Δθθξεκείο νθεηιέο από 31 έσο 60 εκέξεο πξνο ηξίηνπο (4.5.25) Δθθξεκείο νθεηιέο από 61 έσο 90 εκέξεο πξνο Γεληθή Κπβέξλεζε (4.5.26) Δθθξεκείο νθεηιέο από 61 έσο 90 εκέξεο πξνο ηξίηνπο (4.5.27) Λεμηπξόζεζκεο νθεηιέο άλσ ησλ 90 εκεξώλ πξνο Γεληθή Κπβέξλεζε (4.5.28) Λεμηπξόζεζκεο νθεηιέο άλσ ησλ 90 εκεξώλ πξνο ηξίηνπο (4.5.29) 9
2.5. Σηνηρεία Πνξείαο Είζπξαμεο Εζόδωλ Η ππεξεζία δέρεηαη σο νξίζκαηα έλα xml αξρείν, ην νπνίν πεξηέρεη ην έηνο ηεο νηθνλνκηθήο ρξήζεο, ηνλ κήλα γηα ηνλ νπνίν δεηά ζηνηρεία πνξείαο είζπξαμεο εζόδσλ, ηνλ θσδηθό ηνπ θνξέα θαη ηα αλαγλσξηζηηθά ζύλδεζεο (username θαη password). Η ππεξεζία επηζηξέθεη έλα xml αξρείν πνπ πεξηέρεη όια ηα ζηνηρεία πνξείαο είζπξαμεο εζόδσλ. Μέζνδνο public String getreportdataincomescollection(string data) throws LoginException, UnavailableDataException, UnfinalizedDataException, RemoteException Πεξηγξαθή Οξίζκαηα Δπηζηξεθόκελε ηηκή Δπηζηξέθεη ηα ζηνηρεία πνξείαο είζπξαμεο εζόδσλ Τν πξώην όξηζκα είλαη έλα string κε ην πεξηερόκελα ελόο xml θεηκέλνπ. To xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified"> <xs:element name="arguments"> <xs:all> <xs:element name="credentials"> <xs:attribute name="username" type="xs:string" use="required" <xs:attribute name="password" type="xs:string " use="required" </xs:all> <xs:attribute name="year" type="xs:integer" use="required" <xs:attribute name="month" type="xs:integer" use="required" <xs:attribute name="orgunit" type="xs:string" use="required" Δπηζηξέθεη έλα string κε ην πεξηερόκελν ελόο xml θεηκέλνπ. Τν xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="incomes_collection"> <xs:element ref="account" minoccurs="1" maxoccurs="unbounded" <xs:attribute name="year" type="year_type" use="required" <xs:attribute name="month" type="month_type" use="required" <xs:element name="account"> <xs:attribute name="kae" type="kae_type" use="required" <xs:attribute name="approved" type="decimal15_2" use="required" <xs:attribute name="formatted" type="decimal15_2" use="required" <xs:attribute name="not_confirmed_lists" type="decimal15_2" use="required" <xs:attribute name="confirmed_lists" type="decimal15_2" use="required" <xs:attribute name="home_confirmed" type="decimal15_2" use="required" <xs:attribute name="other_confirmed" type="decimal15_2" use="required" <xs:attribute name="sum_confirmed" type="decimal15_2" use="required" <xs:attribute name="overdue_debts" type="decimal15_2" use="required" <xs:attribute name="overdue_debts_dtc" type="decimal15_2" use="required" <xs:attribute name="overdue_debts_cm" type="decimal15_2" use="required" <xs:attribute name="overdue_debts_dtc_ao_cm" type="decimal15_2" use="required" <xs:attribute name="collected" type="decimal15_2" use="required" 10
<xs:attribute name="overdue_collected" type="decimal15_2" use="required" <xs:simpletype name="year_type"> <xs:pattern value="[0-9]{4}" <xs:simpletype name="month_type"> <xs:pattern value="[0-9] 1[012]" <xs:simpletype name="kae_type"> <xs:maxlength value="32" <xs:simpletype name="decimal15_2"> <xs:restriction base="xs:decimal"> <xs:fractiondigits value="2" <xs:totaldigits value="15" Παξαηεξήζεηο YEAR Έηνο (5.1) MONTH Μήλαο (5.2) KAE ΚΑΔ (5.3) APPROVED Δγθεθξηκέλνο Π/Υ (5.4) FORMATTED Γηακνξθσκέλνο Π/Υ (5.5) NOT_CONFIRMED_LISTS Αβεβαίσηνη Φξεκαηηθνί Καηάινγνη (5.6) CONFIRMED_LISTS Βεβαηώζεηο Φξεκαηηθώλ Καηαιόγσλ (5.7) HOME_CONFIRMED Οίθνζελ Βεβαηώζεηο (5.8) OTHER_CONFIRMED Λνηπέο Βεβαηώζεηο (5.9) SUM_CONFIRMED Σύλνιν Βεβαηώζεσλ (5.10) OVERDUE_DEBTS Λεμηπξόζεζκεο νθεηιέο (5.11) OVERDUE_DEBTS_DTC OVERDUE_DEBTS_CM OVERDUE_DEBTS_DTC_AO_CM COLLECTED Δηζπξάμεηο (5.15) Λεμηπξόζεζκεο νθεηιέο γηα ηηο νπνίεο έγηλε ζηέξεζε θνξνινγηθήο ελεκεξόηεηαο (5.12) Λεμηπξόζεζκεο νθεηιέο γηα ηηο νπνίεο έρνπλ ιεθζεί κέηξα είζπξαμεο (5.13) Λεμηπξόζεζκεο νθεηιέο γηα ηηο νπνίεο έρνπλ ιεθζεί κέηξα επηδίσμεο είζπξαμεο ή/θαη έγηλε ζηέξεζε θνξνινγηθήο ελεκεξόηεηαο (5.14) OVERDUE_COLLECTED Δηζπξάμεηο Λεμηπξόζεζκσλ (5.16) 2.6. Σηνηρεία Ελδνθπβεξλεηηθώλ ζπλαιιαγώλ πιεξωκώλ θαη εηζπξάμεωλ Η ππεξεζία δέρεηαη σο νξίζκαηα έλα xml αξρείν, ην νπνίν πεξηέρεη ην έηνο ηεο νηθνλνκηθήο ρξήζεο, ηνλ κήλα γηα ηνλ νπνίν δεηά ηηο ελδνθπβεξλεηηθέο ζπλαιιαγέο πιεξσκώλ θαη εηζπξάμεσλ, ηνλ θσδηθό ηνπ θνξέα θαη ηα αλαγλσξηζηηθά ζύλδεζεο (username θαη password). Η ππεξεζία επηζηξέθεη έλα xml αξρείν πνπ πεξηέρεη όια ηα ζηνηρεία ησλ ελδνθπβεξλεηηθώλ ζπλαιιαγώλ. 11
Μέζνδνο public String getreportdataintrogoverntrans(string data) throws LoginException, UnavailableDataException, UnfinalizedDataException, RemoteException Πεξηγξαθή Οξίζκαηα Δπηζηξεθόκελε ηηκή Δπηζηξέθεη ηα ζηνηρεία ελδνθπβεξλεηηθώλ ζπλαιιαγώλ Τν πξώην όξηζκα είλαη έλα string κε ην πεξηερόκελα ελόο xml θεηκέλνπ. To xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified"> <xs:element name="arguments"> <xs:all> <xs:element name="credentials"> <xs:attribute name="username" type="xs:string" use="required" <xs:attribute name="password" type="xs:string " use="required" </xs:all> <xs:attribute name="year" type="xs:integer" use="required" <xs:attribute name="month" type="xs:integer" use="required" <xs:attribute name="orgunit" type="xs:string" use="required" Δπηζηξέθεη έλα string κε ην πεξηερόκελν ελόο xml θεηκέλνπ. Τν xml θείκελν έρεη ηελ αθόινπζε δνκή: <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="introgovern_transactions"> <xs:element ref="transactions" minoccurs="1" maxoccurs="1" <xs:attribute name="year" type="year_type" use="required" <xs:attribute name="month" type="month_type" use="required" <xs:element name="transactions"> <xs:element ref="transaction" minoccurs="1" maxoccurs="unbounded" <xs:element name="transaction"> <xs:attribute name="transaction_type" type="trans_types" use="required" <xs:attribute name="kae" type="kae_type" use="required" <xs:attribute name="trans_date" type="date_type" use="required" <xs:attribute name="afm" type="xs:string" use="required" <xs:attribute name="value" type="decimal15_2" use="required" <xs:simpletype name="trans_types"> <xs:enumeration value="ex" <xs:enumeration value="in" <xs:simpletype name="year_type"> <xs:pattern value="[0-9]{4}" <xs:simpletype name="month_type"> <xs:pattern value="[0-9] 1[012]" 12
<xs:simpletype name="kae_type"> <xs:maxlength value="32" <xs:simpletype name="decimal15_2"> <xs:restriction base="xs:decimal"> <xs:fractiondigits value="2" <xs:totaldigits value="15" <xs:simpletype name="date_type"> <xs:union> <xs:simpletype> <xs:restriction base="xs:date"> <xs:simpletype> <xs:enumeration value="" </xs:union> Παξαηεξήζεηο YEAR Έηνο (7.1) MONTH Μήλαο (7.2) TRANS_TYPE Έλδεημε είδνπο θίλεζεο Έζνδν/Έμνδν (7.3) KAE ΚΑΔ (7.4) TRANS_DATE Ηκεξνκελία θίλεζεο (7.5) AFM ΑΦΜ Φνξέα ζπλαιιαγήο (7.6) VALUE Αμία ζπλαιιαγήο (7.7) 13
3. Περιπηώζεις Σθαλμάηων Οη δηαρείξηζε ησλ ζθαικάησλ πνπ κπνξεί λα επηζηξαθνύλ κεηά από κηα απνηπρεκέλε θιήζε ηεο ππεξεζίαο γίλεηαη κέζσ ησλ παξαθάησ exception: LoginException: Γελ είλαη έγθπξα ηα αλαγλσξηζηηθά ζύλδεζεο ηνπ νλόκαηνο θαη θσδηθνύ ρξήζηε (username-password) UnavailableDataException: Γελ ππάξρνπλ ηα δεδνκέλα πνπ δεηήζεθαλ UnfinilizedDataException: Γελ έρνπλ νξηζηηθνπνηεζεί ηα δεδνκέλα πνπ δεηήζεθαλ RemoteException: Οπνηνδήπνηε άιιν γεληθό ζθάικα πξνθύςεη, πέξα από ηε δηαρείξηζε ησλ δεδνκέλσλ πξνο απνζηνιή 14