MATERIAŁY DLA INTEGRATORÓW V. 3.00

Transkrypt

1 MATERIAŁY DLA INTEGRATORÓW V. Opracowanie systemu informatycznego wraz z wdrożeniem jego podstawowych komponentów (rdzenia systemu) w ramach realizacji projektu Rozwój elektronicznej administracji w samorządach województwa mazowieckiego wspomagającej niwelowanie dwudzielności potencjału województwa wpisanego do Regionalnego Programu Operacyjnego Województwa Mazowieckiego w działaniu 2.2 Rozwój e-usług. OPIS DOKUMENTU Stworzony dla: Podstawa prawna: Nazwa skrócona: Samorząd Województwa Mazowieckiego GW MI (CA/1101/U/2012) RD: : Ostatnia modyfikacja: : Firma: Liczba stron: 190 Status dokumentu: Do użytku wewnętrznego Samorządu Województwa Mazowieckiego i Comarch oraz Partnerów projektu EA Wydatek współfinansowany przez Unię Europejską ze środków Europejskiego Funduszu Rozwoju Regionalnego w ramach Regionalnego Programu Operacyjnego Województwa Mazowieckiego

2 SPIS TREŚCI Spis treści... 2 I. Wstęp... 6 I.1 Słownik pojęć... 6 I.2 Konwencje dokumentu... 7 II. Rozmieszczenie usług... 8 II.1 Usługi udostępniane przez szynę centralną (RESB)... 8 II.2 Usługi udostępniane przez szyny lokalne (LESB) III. Definicje usług...16 Usługi / III.1 eurząd.eurzadboxws opis usługi III.1.1 Operacja nadaj III.1.2 Specyfikacja techniczna III.2 eurząd.eurzadpullws opis usługi III.2.1 Operacja oczekujacedokumenty III.2.2 Operacja pobierznastepny III.2.3 Operacja potwierdzodebranie III.2.4 Specyfikacja techniczna III.3 EZD.EUrzadEUrzadConsumerWS opis usługi III.3.1 Operacja wyslij III.3.2 Specyfikacja techniczna III.4 eurząd.eurzadsupplierws opis usługi III.4.1 Operacja dorecz III.4.2 Operacja odbierz III.4.3 Specyfikacja techniczna III.5 eurząd.eurzadcaseinfows opis usługi III.5.1 Operacja utworzonospraweweod III.5.2 Operacja zakonczonospraweweod III.5.3 Operacja wyslijkomunikat III.5.4 Operacja wezwijdozaplaty III.5.5 Operacja zatwierdzplatnosc III.5.6 Specyfikacja techniczna III.6 eurząd.eurzadeurzadwkupws opis usługi III.6.1 Operacja pobierzopisogolny III.6.2 Operacja pobierzopisszczegolowy III.6.3 Operacja pobierzopisyogolne III.6.4 Operacja pobierzopisyogolnedlapodmiotu III.6.5 Operacja pobierzopisyszczegolowe III.6.6 Operacja pobierzopisyszczegolowedlapodmiotu III.6.7 Operacja pobierzpodmiot III.6.8 Operacja pobierzpodmiotyswiadczaceusluge III.6.9 Operacja szukajuslugi III.6.10 Specyfikacja techniczna Usługi /epuap III.7 eurząd.eurzadepuapboxws opis usługi III.7.1 Operacja nadaj III.7.2 Specyfikacja techniczna III.8 eurząd.eurzadepuappullws opis usługi III.8.1 Operacja oczekujacedokumenty III.8.2 Operacja potwierdzodebranie /190

3 III.8.3 Operacja pobierznastepny III.8.4 Specyfikacja techniczna III.9 eurząd.eurzadepuapconsumerws opis usługi III.9.1 Operacja wyslij III.9.2 Operacja wyslijany III.9.3 Specyfikacja techniczna III.10 eurząd.eurzadepuapsupplierws opis usługi III.10.1 Operacja dorecz III.10.2 Operacja odbierz III.10.3 Specyfikacja techniczna Usługi ESB III.11 RESB.BIPPublisherService opis usługi III.11.1 Operacja publish III.11.2 Specyfikacja techniczna III.12 RESB.PortalUserService opis usługi III.12.1 Operacja getuser III.12.2 Specyfikacja techniczna III.13 RESB.WMSService opis usługi III.13.1 Operacja submitwmsquery III.13.2 Specyfikacja techniczna III.14 RESB.WFSService opis usługi III.14.1 Operacja submitwfsquery III.14.2 Specyfikacja techniczna III.15 RESB.DBIntegratorService opis usługi III.15.1 Operacja sqlbrowse III.15.2 Specyfikacja techniczna III.16 RESB.OceanPKIService opis usługi III.16.1 Operacja sign III.16.2 Operacja verify III.16.3 Operacja verifymultiple III.16.4 Specyfikacja techniczna Usługi EZD III.17 EZD.DocumentService opis usługi III.17.1 Operacja bindrgd III.17.2 Operacja getdocinfo III.17.3 Operacja getdocurl III.17.4 Operacja unbindrgd III.17.5 Operacja updatergd III.17.6 Specyfikacja techniczna III.18 EZD.StatusService opis usługi III.18.1 Operacja documentstatus III.18.2 Operacja issuestatus III.18.3 Specyfikacja techniczna III.19 EZD.SDService opis usługi III.19.1 Operacja login III.19.2 Operacja logout III.19.3 Operacja getmydocuments III.19.4 Operacja adddocument III.19.5 Operacja getdocument III.19.6 Operacja adddocfile III.19.7 Operacja setdocumentinfo III.19.8 Operacja returndocument III.19.9 Specyfikacja techniczna Usługi EOP III.20 EZD.EOPService opis usługi III.20.1 Operacja adddue III.20.2 Operacja addpayment III.20.3 Operacja addpaymentuniqueid III.20.4 Operacja getdue /190

4 III.20.5 Operacja getdueissue III.20.6 Operacja getjstdetails III.20.7 Operacja getpayment III.20.8 Specyfikacja techniczna Usługi PLP III.21 PLP.PLPExternal opis usługi III.21.1 Operacja binddocument III.21.2 Operacja getdocumentandobjecturl III.21.3 Operacja getdocumenturl III.21.4 Operacja updatergd III.21.5 Specyfikacja techniczna Usługi WKSP III.22 RESB.WKSPInquiry opis usługi III.22.1 Specyfikacja techniczna III.23 RESB.WKSPSubscription opis usługi III.23.1 Operacja delete_subscription III.23.2 Operacja save_subscription III.23.3 Operacja get_subscriptionresults III.23.4 Operacja get_subscriptions III.23.5 Specyfikacja techniczna III.24 RESB.WKSPSecurity opis usługi III.24.1 Operacja get_authtoken III.24.2 Operacja discard_authtoken III.24.3 Specyfikacja techniczna Usługi EPUAP III.25 EPUAP.TrustProfile opis usługi III.25.1 Specyfikacja techniczna III.26 EPUAP.Authorization opis usługi III.26.1 Specyfikacja techniczna III.27 EPUAP.SubjectManager opis usługi III.27.1 Specyfikacja techniczna III.28 EPUAP.ConsumerService opis usługi III.28.1 Specyfikacja techniczna III.29 EPUAP.SupplierService opis usługi III.29.1 Specyfikacja techniczna III.30 EPUAP.BoxService opis usługi III.30.1 Specyfikacja techniczna III.31 EPUAP.PullService opis usługi III.31.1 Specyfikacja techniczna III.32 EPUAP.TrustProfileSigning opis usługi III.32.1 Specyfikacja techniczna III.33 EPUAP.SAMLDecisionEngineService opis usługi III.33.1 Specyfikacja techniczna III.34 EPUAP.SAMLArtifactEngineService opis usługi III.34.1 Specyfikacja techniczna III.35 EPUAP.EPOService opis usługi III.35.1 Specyfikacja techniczna III.36 EPUAP.DocumentManagerService opis usługi III.36.1 Specyfikacja techniczna III.37 EPUAP.RefDictionariesService opis usługi III.37.1 Specyfikacja techniczna III.38 EPUAP.SubscriptionsService opis usługi III.38.1 Specyfikacja techniczna III.39 EPUAP.PeselService opis usługi III.39.1 Specyfikacja techniczna III.40 EPUAP.KUPWebServices opis usługi III.40.1 Specyfikacja techniczna III.41 EPUAP.PaymentsService opis usługi III.41.1 Specyfikacja techniczna /190

5 III.42 EPUAP.KupWebServiceExt opis usługi III.42.1 Specyfikacja techniczna III.43 EPUAP.TpSigning2 opis usługi III.43.1 Specyfikacja techniczna Usługa TERYT III.44 RESB.TerytService opis usługi III.44.1 Operacja getchangesinfo III.44.2 Operacja finish III.44.3 Operacja getpart III.44.4 Operacja getcataloginfo III.44.5 Operacja getupdateinfo III.44.6 Operacja getsubscriptiondiclist III.44.7 Specyfikacja techniczna Usługa RDP III.45 RDP.PRService opis usługi III.45.1 Operacja getprocess III.45.2 Operacja getprocesslist III.45.3 Specyfikacja techniczna IV. Załączniki V. Modyfikacje /190

6 I. Wstęp Dokument Materiały dla integratorów zawiera dokumentację wszystkich usług zewnętrznych Systemu, za pomocą których możliwa jest integracja systemów zewnętrznych z Systemem. I.1 Słownik pojęć Komponent nazwana część systemu, może udostępniać i/lub konsumować usługi. Przykłady: RESB - regionalna esb LESB - lokalna esb Komponent definiujący usługę - Komponent, który nie dość że usługę oferuje, to jeszcze określa jej biznesowa definicję. Przykłady: epuap definiuje epuapowego doreczyciela, eurząd definiuje eurzędowego-epuapowego doręczyciela. RESB oferuje obie te usługi, ale żadnej nie definiuje. Granica pomiędzy oferowaniem, a definiowaniem może być trudno uchwytna należy zwrócić uwagę na komponent który definiuje/implementuje biznesowy aspekt usługi, czyli: RESB technicznie nieco ingeruje w usługę Doreczyciel - ale nie zmienia biznesowego aspektu tej usługi eurząd, poza oferowaniem usługi (której głównym implementatorem jest epuap) Doreczyciel, wzbogaca jej biznesową funkcjonalność - stąd jest komponentem definiującym. Biznesowy identyfikator usługi Unikalna wewnątrz komponentu definiującego usługę nazwa, powinna wskazywać na biznesową potrzebę realizowaną przez usługę. Wykorzystywana jest przede wszystkim w opisach procesów biznesowych realizowanych przez usługi. 6/190

7 Przykład: W eurzędzie, epuap_doreczyciel - oznacza epuapowego deoręczyciela Identyfikator usługi Unikalny w skali całego systemu identyfikator funkcjonalności (aspektu biznesowego ) danej usługi. Zbudowany jest w formie: kod_komponentu_definiującego.zwyczajowa_nazwa_biznesowa. Pozwala na uniknięcie wielokrotnego opisywania tej samej (takiej samej) usługi oferowanej przez wiele komponentów systemu (na różnych poziomach). Logiczny adres usługi Oznacza adres pod którym usługa jest świadczona. Zbudowany jest w formie: kod_komponentu_oferującego.kod_komponentu_definiującego.nazwa_biznesowa. Pozwala na posługiwanie się adresem usługi bez kontekstu środowiska (testowe, produkcyjne szkoleniowe). Przykłady: RESB.RESB.BIPPublisherService oznacza usługę BIPPublisher definiowaną przez RESB i oferowaną przez RESB LESB.RESB.BIPPublisherService oznacza usługę BIPPublisher definiowaną przez RESB a oferowaną przez LESB RESB.eUrząd.ePUAP_Doreczyciel oznacza usługę epuap_doreczyciel definiowaną przez eurząd i oferowaną przez RESB. Fizyczny adres usługi Określa adres pod którym usługa faktycznie jest oferowana. I.2 Konwencje dokumentu Usługi opisywane są w kontekście komponentów je definiujących, z wykorzystaniem ich identyfikatorów biznesowych. Fizyczne adresy usług (odwzorowanie: logiczny adres usługi -> fizyczne adresy na poszczególnych środowiskach) prezentowane są rozdziale II Rozmieszczenie usług. 7/190

8 II. Rozmieszczenie usług II.1 Usługi udostępniane przez szynę centralną (RESB) L. Identyfikator usługi p. 1. RESB.BIPPublisherS ervice 2. RESB.PortalUserServ ice 3. RESB.OceanPKIServ ice Biznesowy identyfikator usługi BIPPublisherService PortalUserService Signing Fizyczny adres usługi (endpoint URI) /esb-comarchportal-rest-bippublisher-wsservice/http/rest/portal- REST-BIP-Publisher-WS- Consumer /esb-comarchportal-restusers-wsservice/http/rest/portal- REST-Users-WS-Consumer /esb-oceanpki-wsservice/http/central/ocea npki-ws-consumer 4. RESB.WMSService WMSService /esb-wms-ws- service/http/gis/wms-ws- Consumer 6. RESB.DBIntegratorS ervice DBIntegrator 7. RESB.Teryt WebServiceServantP orttype 5. RESB.WFSService WFSService /esb-wfs-ws- service/http/gis/wfs-ws- Consumer /esb-db-integrator-ws- service/http/central/db- Integrator-WS-Consumer /esb-teryt-proxy-wsservice/http/soap/terytws 9. EUrzad.ePUAP_Dore czycie 10. EUrzad.ePUAP_Skryt ka 11. EUrzad.ePUAP_Pull Doreczyciel Skrytka Pull 8. RDP.PRService PRService /esb-rdp-proxy-prservice/http/soap/rdpprw S /esb-eurzad-epuap-proxysupplierservice/http/soap/eurzade PUAPSupplierWS /esb-eurzad-epuap-proxyboxservice/http/soap/eurzade PUAPBoxWS /esb-eurzad-epuap-proxypullservice/http/soap/eurzade PUAPPullWS Definicja usługi w dokumencie III.11 RESB.BIPPublis herservice opis usługi III.12 RESB.PortalUse rservice opis usługi III.16 RESB.OceanPK IService opis usługi III.13 RESB.WMSSer vice opis usługi III.14 RESB.WFSServ ice opis usługi III.15 RESB.DBIntegr atorservice opis usługi III.44 RESB.TerytServ ice opis usługi III.45 RDP.PRService opis usługi III.10 eurząd.eurzad EPUAPSupplier WS opis usługi III.7 eurząd.eurzad EPUAPBoxWS opis usługi III.8 eurząd.eurzad EPUAPPullWS opis usługi 8/190

9 L. Identyfikator usługi p. 12. EUrzad.ePUAP_Odbi orca Biznesowy identyfikator usługi Odbiorca Fizyczny adres usługi (endpoint URI) /esb-eurzad-epuap-proxyconsumerservice/http/soap/eurzade PUAPConsumerWS 13. EUrzad.Doreczyciel Doreczyciel /esb-eurzad-proxy-supplierservice/http/soap/eurzads upplierws 14. EUrzad.Skrytka Skrytka /esb-eurzad-proxy-boxservice/http/soap/eurzadb oxws 15. EUrzad.Status_Spra wy Status_Sprawy /esb-eurzad-proxy-caseinfoservice/http/soap/eurzadc aseinfows 16. EUrzad.Pull Pull /esb-eurzad-proxy-pullservice/http/soap/eurzadp ullws 17. EUrzad.Odbiorca Odbiorca /esb-eurzad-eurzad-proxyconsumerservice/http/soap/eurzade UrzadConsumerWS 18. EUrzad.WKUP Wkup /esb-eurzad-proxy-wkupservice/http/soap/eurzadw KUPWS 19. EZD.StatusDynamicR outerservice 20. EZD.EOPDynamicRo uterservice statusservice EOPService /esb-ezd-status-dynamicrouter-wsservice/http/soap/status- Dynamic-Router /esb-eop-dynamic-router-ws- service/http/soap/eop- 22. EPUAP.TrustProfileSi gningservice 23. EPUAP.SupplierServi ce TpSigning SupplierService Dynamic-Router 21. EPUAP.PullService PullService /esb-epuap-proxy-pullservice/http/soap/pullws /esb-epuap-proxy-trustpsigningservice/http/soap/trustprofi lesigningws /esb-epuap-proxy-supplierservice/http/soap/supplier WS 25. EPUAP.TrustProfileS ervice TpUserInfoService 24. EPUAP.BoxService BoxService /esb-epuap-proxy-boxservice/http/soap/boxws /esb-epuap-proxy-trustpservice/http/soap/trustprofi lews Definicja usługi w dokumencie III.9 eurząd.eurzad EPUAPConsum erws opis usługi III.4 eurząd.eurzad SupplierWS opis usługi III.1 eurząd.eurzad BoxWS opis usługi III.5 eurząd.eurzad CaseInfoWS opis usługi III.2 eurząd.eurzad PullWS opis usługi III.3 EZD.EUrzadEUr zadconsumerw S opis usługi III.6 eurząd.eurzade UrzadWKUPWS opis usługi III.18 EZD.StatusServic e opis usługi III.20 EZD.EOPServic e opis usługi III.31 EPUAP.PullServ ice opis usługi III.32 EPUAP.TrustPr ofilesigning opis usługi III.29 EPUAP.Supplier Service opis usługi III.30 EPUAP.BoxSer vice opis usługi III.25 EPUAP.TrustP rofile opis usługi 9/190

10 L. Identyfikator usługi p. 26. EPUAP.Authorization Service 27. EPUAP.SAMLDecisio nengineservice 28. EPUAP.SubjectMana gerservice 29. EPUAP.ConsumerSe rvice 30. EPUAP.SAMLArtifact EngineService Biznesowy identyfikator usługi AuthorisationWS SAMLDecisionEngin eservice SubjectManagerWS ConsumerService SAMLArtifactEngine Service Fizyczny adres usługi (endpoint URI) /esb-epuap-proxyauthorizationservice/http/soap/authoriza tionws /esb-epuap-proxy-samldecision-engineservice/http/soap/samlde cisionenginews /esb-epuap-proxysubjectmanagerservice/http/soap/subjectm anagerws /esb-epuap-proxy-consumerservice/http/soap/consume rws /esb-epuap-proxy-samlartifact-engineservice/http/soap/samlarti factenginews 32. EPUAP.DocumentMa nagerservice 33. EPUAP.RefDictionari esservice 34. EPUAP. SubscriptionsService DocumentManagerS ervice RefDictionariesServi ce SubscriptionsService 31. EPUAP.EPOService EPOService /esb-epuap-proxy-eposervice/http/soap/epows /esb-epuap-proxydocumentmanagerservice/http/soap/documen tmanagerws /esb-epuap-proxydictionariesservice/http/soap/refdictio nariesws /esb-epuap-proxysubscriptionsservice/http/soap/subscripti onsws 36. EPUAP.KUPWebSer vices 37. EPUAP.PaymentsSer vice 38. EPUAP. KupWebServiceExt KUPWebServices PaymentsService KupWebServiceExt 35. EPUAP. PeselService PeselService /esb-epuap-proxy-peselservice/http/soap/peselws /esb-epuap-proxy-kupservice/http/soap/kupws /esb-epuap-proxy-paymentsservice/http/soap/payments WS /esb-epuap-proxy-kupextservice/http/soap/kupextw S Definicja usługi w dokumencie III.26 EPUAP.Author ization opis usługi III.33 EPUAP.SAML DecisionEngin eservice opis usługi III.27 EPUAP.Subject Manager opis usługi III.28 EPUAP.Consum erservice opis usługi III.34 EPUAP.SAMLAr tifactengineserv ice opis usługi III.35 EPUAP.EPOSer vice opis usługi III.36 EPUAP.Docume ntmanagerservi ce opis usługi III.37 EPUAP.RefDicti onariesservice opis usługi III.38 EPUAP.Subscri ptionsservice opis usługi III.39 EPUAP.PeselSe rvice opis usługi III.40 EPUAP.KUPWe bservices opis usługi III.41 EPUAP.Paymen tsservice opis usługi III.42 EPUAP.KupWe bserviceext opis usługi 10/190

11 L. p. Identyfikator usługi Biznesowy identyfikator usługi Fizyczny adres usługi (endpoint URI) 39. EPUAP. TpSigning2 TpSigning2 /esb-epuap-proxy-trustp- signing2- service/http/soap/trustprofi lesigning2ws 40. RESB.WKSPInquiry WKSPInquiry /esb-wksp-inquiry-proxy-wsservice/http/soap/wkspinq uiryws 41. RESB.WKSPSubscri ption WKSPSubscription /esb-wksp-subscriptionproxy-wsservice/http/soap/wkspsu bscriptionws 42. RESB.WKSPSecurity WKSPSecurity /esb-wksp-security-proxywsservice/http/soap/wkspse curityws Definicja usługi w dokumencie III.43 EPUAP.TpSigni ng2 opis usługi III.22 RESB.WKSPInq uiry opis usługis III.23 RESB.WKSPSu bscription opis usługi III.24 RESB.WKSPSe curity opis usługi Logiczny identyfikator usługi dla regionalnej szyny danych tworzony jest poprzez dodanie prefixu RESB oraz separatora w postaci kropki. Prefix symbolizuje komponent oferujący usługę. Przykład: Logiczny identyfikator usługi: RESB.RESB.BIPPublisherService; Identyfikator powyższej usługi to RESB.BIPPublisherService. Biznesowy identyfikator usługi tworzony z reguły w oparciu o nazwę usługi używaną w opisach procesów biznesowych. Przykład: Dla usługi o identyfikatorze: EUrzad.Odbiorca utworzony jest identyfikator biznesowy Odbiorca. Do jednoznacznej identyfikacji usługi wykorzystywane są 3 elementy: identyfikator usługi, biznesowy identyfikator usługi oraz fizyczny adres usługi (endpoint URI). Pełny fizyczny adres usługi (endpoint URL) dla wybranego środowiska oferującego usługi tworzony jest poprzez dodanie protokołu dostępowego (HTTP, HTTPS), host'a oraz portu do fizycznego adresu URI usługi. Przykład dla usługi RESB.BIPPublisherService na środowisku testowym: 11/190

12 REST-BIP-Publisher-WS-Consumer II.2 Usługi udostępniane przez szyny lokalne (LESB) L. p. Identyfikator usługi 1. RESB.BIPPublisherS ervice 2. RESB.PortalUserServ ice 3. RESB.OceanPKIServi ce Biznesowy identyfikator usługi BIPPublisherService PortalUserService Signing Fizyczny adres usługi (endpoint URI) URL dla WSDL wystawionej usługi otrzymujemy poprzez dodanie suffix "?wsdl" do pełnego fizycznego adresu usługi. Przykład tworzenia URL do WSDL dla usługi RESB.BIPPublisherService na środowisku testowym: REST-BIP-Publisher-WS-Consumer?wsdl /esb-local-comarchportalrest-bip-publisher-wsservice/http/rest/portal- REST-BIPLocal-Publisher- WS-Consumer /esb-local-comarchportalrest-users-wsservice/http/rest/local- Portal-REST-Users-WS- Consumer /esb-local-oceanpki-wsservice/http/central/ocea npki-local-ws-consumer 4. RESB.WMSService WMSService /esb-local-wms-ws- service/http/gis/wms- Local-WS-Consumer 5. RESB.WFSService WFSService /esb-local-wfs-ws- service/http/gis/wfs-local- WS-Consumer 6. EUrzad.Status_Spraw y 7. EUrzad.Skrytka Status_Sprawy Skrytka /esb-local-eurzad-proxycaseinfoservice/http/soap/eurzadl ocalcaseinfows /esb-local-eurzad-proxy-boxservice/http/soap/eurzadl ocalboxws Definicja usługi w dokumencie III.11 RESB.BIPPu blisherservic e opis usługi III.12 RESB.Portal UserService opis usługi III.16 RESB.Ocean PKIService opis usługi III.13 RESB.WMSS ervice opis usługi III.14 RESB.WFSS ervice opis usługi III.5 eurząd.eurz adcaseinfow S opis usługi III.1 eurząd.eurz adboxws opis usługi 12/190

13 L. p. Identyfikator usługi 8. EUrzad.Doreczyciel 9. EUrzad.Pull Biznesowy identyfikator usługi Doreczyciel Pull Fizyczny adres usługi (endpoint URI) /esb-local-eurzad-proxysupplierservice/http/soap/eurzadl ocalsupplierws /esb-local-eurzad-proxy-pullservice/http/soap/eurzadl ocalpullws 10. EUrzad.Odbiorca Odbiorca /esb-local-eurzad-eurzadproxy-consumerservice/http/soap/eurzade urzadlocalconsumerws 11. EUrzad.ePUAP_Dore czyciel 12. EUrzad.ePUAP_Pull 13. EUrzad.ePUAP_Skryt ka 14. EUrzad.WKUP 15. EUrzad.ePUAP_Odbi orca Doreczyciel Pull Skrytka Wkup Odbiorca /esb-local-eurzad-epuapproxy-supplierservice/http/soap/eurzade PUAPLocalSupplierWS /esb-local-eurzad-epuapproxy-pullservice/http/soap/eurzade PUAPLocalPullWS /esb-local-eurzad-epuapproxy-boxservice/http/soap/eurzade PUAPLocalBoxWS esb-local-eurzad-proxywkupservice/http/soap/eurzadl ocalwkupws /esb-local-eurzad-epuapproxy-consumerservice/http/soap/eurzade PUAPLocalConsumerWS 16. EZD.EOPService EOPService /esb-local-eopservice/http/soap/ezdloca leopws 17. EZD.StatusService statusservice /esb-local-ezd-statusservice/http/soap/ezdloca lstatusws 18. EZD.DocumentServic e documentservice /esb-local-ezd-documentservice/http/soap/ezdloca ldocumentws 19. EZD.SDService SDService /esb-local-ezd-sdservice/http/soap/ezdloca lsdws Definicja usługi w dokumencie III.4 eurząd.eurz adsupplierw S opis usługi III.2 eurząd.eurz adpullws opis usługi III.3 EZD.EUrzad EUrzadConsu merws opis usługi III.10 eurząd.eurz adepuapsu pplierws opis usługi III.8 eurząd.eurz adepuappull WS opis usługi III.7 eurząd.eurz adepuapbox WS opis usługi III.6 eurząd.eurz adeurzadwk UPWS opis usługi III.9 eurząd.eurz adepuapco nsumerws opis usługi III.20 EZD.EOPSer vice opis usługi III.18 EZD.StatusS ervice opis usługi III.17 EZD.Docume ntservice opis usługi III.19 EZD.SDServi ce opis usługi 13/190

14 L. p. Identyfikator usługi Biznesowy identyfikator usługi Fizyczny adres usługi (endpoint URI) 20. PLP.PLPExternal PLPExternal /esb-local-plpservice/http/soap/plpexter nalws 22. RESB.WKSPSubscrip tion WKSPSubscription 21. RESB.WKSPInquiry WKSPInquiry /esb-local-wksp-inquiryproxy-wsservice/http/soap/wksplo calinquiryws /esb-local-wkspsubscription-proxy-wsservice/http/soap/wksplo calsubscriptionws 23. RESB.WKSPSecurity WKSPSecurity /esb-local-wksp-securityproxy-wsservice/http/soap/wksplo calsecurityws 24. RDP.PRService PRService /esb-local-rdp-proxy-prservice/http/soap/rdploca lprws 25. RESB.Teryt WebServiceServantPort Type /esb-local-teryt-proxy-wsservice/http/soap/terytloc alws Definicja usługi w dokumencie III.21 PLP.PLPExte rnal opis usługi III.22 RESB.WKSPI nquiry opis usługi III.23 RESB.WKSP Subscription opis usługi III.24 RESB.WKSP Security opis usługi III.45 RDP.PRServi ce opis usługi III.44s RESB.TerytS ervice opis usługi Logiczny Identyfikator usługi dla lokalnej szyny danych tworzony jest poprzez dodanie prefix LESB oraz separatora w postaci kropki. Prefix symbolizuje komponent oferujący usługę. Przykład: Logiczny ldentyfikator usługi: LESB.RESB.BIPPublisherService; Identyfikator powyższej usługi to RESB.BIPPublisherService. Biznesowy identyfikator usługi tworzony z reguły w oparciu o nazwę usługi używaną w opisach procesów biznesowych. Przykład: Dla usługi o identyfikatorze: EUrzad.ePUAP_Skrytka utworzony jest identyfikator biznesowy Skrytka. Do jednoznacznej identyfikacji usługi wykorzystywane są 3 elementy: identyfikator usługi, biznesowy identyfikator usługi oraz fizyczny adres usługi (endpoint URI). 14/190

15 Pełny fizyczny adres usługi (endpoint URL) dla wybranego środowiska oferującego usługi tworzony jest poprzez dodanie protokołu dostępowego (HTTP, HTTPS), host'a oraz portu do fizycznego adresu URI usługi. Przykład dla lokalnej usługi LEBS.RESB.BIPPublisherService na środowisku testowym: URL dla WSDL wystawionej usługi otrzymujemy poprzez dodanie suffix "?wsdl" do pełnego fizycznego adresu usługi. Przykład tworzenia URL do WSDL dla usługi LEBS.RESB.BIPPublisherService na lokalnym środowisku testowym: 15/190

16 III. Definicje usług Usługi / III.1 eurząd.eurzadboxws opis usługi Usługa wykorzystywana jest do nadawania dokumentów na skrytki. Jest to jedna z kluczowych usług, która w procesie obsługi wymiany dokumentów pomiędzy elementami Systemu oraz Systemem, a innym zintegrowanym systemem Zarządzania Dokumentacją, pozwala na przesyłanie dokumentów na skrytkę (również wydanych decyzji administracyjnych w trybie przedłożenia). Usługa jest zabezpieczona poprzez mechanizmy WSSecurity podpis elementu Body oraz Timestamp koperty SOAP. III.1.1 Operacja nadaj Metoda wykorzystywana może być przez EZD lub inny system Zarządzania Dokumentacją do przesyłania dokumentów (np. decyzji, wezwań, innych dokumentów w trakcie procesu obsługi sprawy). Metoda może być wykorzystywana w modelu komunikacji Urzędu z Interesantem jak i Urzędu z Urzędem. Metoda przyjmuje parametr(y): Nazwa Typ Czy wymagany? Opis envelopenadaj EnvelopeBase64 T Kopertka zakodowana Base64 Typ EnvelopeBase64 to łańcuch znaków zakodowany Base64 zawierający zabezpieczoną kopertę WSSecurity o następujących wartościach: Nazwa Typ Czy wymagany? Opis identyfikatorsprawye Urzad IdentyfikatorSprawy EUrzad T Zawiera identyfikator sprawy eurzad (dosyłanie dokumentów do istniejącej sprawy eurząd) lub null (dosyłanie dokumentów i 16/190

17 Nazwa Typ Czy wymagany? Opis utworzenie sprawy eurząd) nowej nazwasprawyeod String T/N Nazwa sprawy w EZD. Parametr wymagany przy dosyłaniu dokumentów wraz z zakładaniem nowej sprawy eurząd. podmiot String T Identyfikator podmiotu skrytki adresata adresskrytki String T Adres skrytki adresata adresodpowiedzi String T Adres skrytki nadawcy (EZD) identyfikatorpodmiotu Odpowiedzi String T Identyfikator podmiotu skrytki nadawcy (EZD) czyprobne Boolean T Informacja czy próbne nadawanie dokumentów danedodatkowe Byte[] N Aktualnie nie używane. dokumenty DokumentTypArray T Tablica z nadawanymi dokumentami Typ DokumentTypArray jest typem złożonym zawierającym tablicę elementów typu DokumentTyp o następujących parametrach: nazwapliku (wymagany) typu String zawiera nazwę pliku 17/190

18 Nazwa Typ Czy wymagany? Opis typpliku (opcjonalny) typu String zawiera typ MIME pliku zawartosc (wymagany) typu Byte[] zawiera zawartość pliku Metoda zwraca dane w postaci: Typ OdpowiedzSkrytkiTyp Opis Odpowiedź Typ OdpowiedzSkrytkiTyp jest postaci: Nazwa Typ Opis status StatusTyp Status wykonania operacji. Typ StatusTyp jest typem złożonym zawierającym następujące parametry: kod (opcjonalny) typu Int zawiera kod statusu komunikat (wymagany) typu String zawiera treść komunikatu statusu identyfikatorupp String Identyfikator dokumentu UPO. statusodbiorcy StatusTyp Aktualnie nie używane. zalacznik DokumentTyp Aktualnie nie używane. upo String Dokument UPO. identyfikatorsprawyeurzad Int Identyfikator sprawy eurząd 18/190

19 Nazwa Typ Opis zarejestrowanego dokumentu. identyfikatordokumentu Int Identyfikator zarejestrowanego dokumentu w eurzędzie. Możliwe błędy: NadajFaultMsg Wyjątek wysyłany jest m.in. gdy nie uzupełniono wymaganych dokumentów, rozmiar nadawanych dokumentów przekroczył 5MB, skrytka nie istnieje. Szczegóły błędu zawarte są wewnątrz typu danych WyjatekTyp. Typ WyjatekTyp jest typem złożonym zawierającym następujące parametry: kod (opcjonalny) typu Int zawiera kod błędu komunikat (wymagany) typu String zawiera treść komunikatu błędu Usługa może zwrócić jedną z poniższych wartości jako status/wyjątek wykonania operacji: Kod: 1, Komunikat: Dokument został nadany. Kod: 2, Komunikat: Skrytka adresskrytki, identyfikator podmiotu idpodmiotu nie istnieje w systemie. Kod: 3, Komunikat: Wystąpił błąd podczad połączenia z bazą danych Kod: 4, Komunikat: Wystąpił nieoczekiwany błąd. Kod: 8, Komunikat: Nie znaleziono aktualnej sprawy eurząd związanej z adresem skrytki. idsprawy 'idsprawy, identyfikatorpodmiotu idpodmiotu, adresskrytki adresskrytki. Kod: 9, Komunikat: Nie nadano dokumentu Kod: 15, Komunikat: Brak wymaganych parametrów. Kod: 20, Komunikat: Skrytka adresskrytki, identyfikator podmiotu idpodmiotu nie umożliwia nadawania dokumentów. Kod: 29, Komunikat: Przekroczono maksymalny rozmiar dokumentów - 5MB. 19/190

20 Przykładowe żądanie wywołania usługi zgodne z schematem WSDL wewnętrznej usługi: <soapenv:envelope xmlns:soapenv=" xmlns:obi=" <soapenv:header> <obi:danedodatkowe></obi:danedodatkowe> <obi:czyprobne>false</obi:czyprobne> <obi:identyfikatorpodmiotuodpowiedzi>admin</obi:identyfikatorpodmiotuodpowiedzi> <obi:adresodpowiedzi>/eurzad/pull17</obi:adresodpowiedzi> <obi:adresskrytki>/interesant03/skrytka</obi:adresskrytki> <obi:identyfikatorpodmiotu>interesant03</obi:identyfikatorpodmiotu> <obi:nazwasprawyeod></obi:nazwasprawyeod> <obi:identyfikatorsprawyeurzad> <identyfikatorsprawyeurzad>3602</identyfikatorsprawyeurzad> </obi:identyfikatorsprawyeurzad> </soapenv:header> <obi:dokumenty> <item> <nazwapliku>test.txt</nazwapliku> <typpliku>application/download</typpliku> <zawartosc>vgvzda==</zawartosc> </item> </obi:dokumenty> Zwracane dane mają postać: <soap:envelope xmlns:soap=" <soap:body> <ns2:odpowiedzskrytki xmlns:ns2=" <status> <kod>1</kod> <komunikat>dokument został nadany</komunikat> </status> <identyfikatorsprawyeurzad>3602</identyfikatorsprawyeurzad> <identyfikatordokumentu>9</identyfikatordokumentu> <identyfikatorupp>eurzad-upp_odok_9</identyfikatorupp> <upo><![cdata[<?xml version="1.0" encoding="utf-8" standalone="yes"?> <ns6:dokument xmlns:ns2=" xmlns=" xmlns:ns4=" xmlns:ns3=" xmlns:ns5=" xmlns:ns6=" xmlns:ns7=" <ns6:upp> <ns6:identyfikatorposwiadczenia>eurzad-upp_odok_9</ns6:identyfikatorposwiadczenia> <ns6:adresat> <ns6:nazwa>interesant 03</ns6:Nazwa> 20/190

21 <ns6:identyfikatorpodmiotu TypIdentyfikatora="eURZAD-ID">interesant03</ns6:IdentyfikatorPodmiotu> </ns6:adresat> <ns6:nadawca> <ns6:nazwa></ns6:nazwa> <ns6:identyfikatorpodmiotu TypIdentyfikatora="eURZAD-ID">admin</ns6:IdentyfikatorPodmiotu> </ns6:nadawca> <ns6:datadoreczenia> t10:16: :00</ns6:datadoreczenia> <ns6:datawytworzeniaposwiadczenia> t10:16: :00</ns6:datawytworzeniaposwiadczenia> <ns6:identyfikatordokumentu>odok_9</ns6:identyfikatordokumentu> <ns6:informacjauzupelniajaca TypInformacjiUzupelniajacej="Źródło">Poświadczenie wystawione przez platformę eurząd Urzędu Marszałkowskiego Województwa Mazowieckiego</ns6:InformacjaUzupelniajaca> <ns6:informacjauzupelniajaca TypInformacjiUzupelniajacej="Identyfikator sprawy">eurząd- 3602</ns6:InformacjaUzupelniajaca> </ns6:upp> <ds:signature Id="ID-16b7aaa1-33c b6bf-015f51f93196" xmlns:ds=" Algorithm=" Algorithm=" URI=""><ds:Transforms><ds:Transform Algorithm=" xmlns:xades=" Algorithm=" Algorithm=" UQ=</ds:DigestValue></ds:Reference><ds:Reference URI="test.txt"><ds:DigestMethod Algorithm=" =</ds:digestvalue></ds:reference><ds:reference Type=" URI="#ID-afa38f27-3c0a- 450f-8e0b-b9d694b4f51a"><ds:Transforms><ds:Transform Algorithm=" "></ds:Transform></ds:Transforms><ds:DigestMethod Algorithm=" </ds:digestvalue></ds:reference></ds:signedinfo><ds:signaturevalue Id="ID b2e8-4a13-88fe- 64b e">RwL8NnhcLnMt4M+iz0rtovXIDppfyb0jmjtEWlmFsjPNpU1eQKkmmkCyX+Miv2ZJ5mXkpXcM2QglicQZg6q7o9p 8e1xS5BrwR+laMhRnbn/tNtDnLrmfPWzFb6kVdwiapqYGZ/MSC7NScWFpnCPaBDuFAxsGQThdID8f2CGxcoQ9N8zp8JqOlw/G Yq2QRtv6Te3vKITP9igokRwBBBEqV+PZn4P2yKuLa8urQZcVtMMZ7Ae+LEH8RrqjmU8oVQSf4RNn/Yw3WYuwzY97qn6Ea4rIt q2qp1athruqadle4ralyb7sj6tl5siaya5ov1fknqimrmqfpmkp1ff7ls7lkg==</ds:signaturevalue><ds:keyinfo Id="ID- 57dc6d7b-57c2-4b96-bcc0- b c58"><ds:x509data><ds:x509certificate>miiepjccayagawibagieuh086zanbgkqhkig9w0baq0fadcb4detmcs GCSqGSIb3DQEJARYedXJ6YWRfbWFyc3phbGtvd3NraUBtYXpvdmlhLnBsMQswCQYDVQQGEwJQTDEUMBIGA1UECAwLb WF6b3dpZWNraWUxETAPBgNVBAcMCFdhcnN6YXdhMR4wHAYDVQQKDBVVcnrEhWQgTWFyc3phxYJrb3dza2kxHjAcBgN VBAsMFVVyesSFZCBNYXJzemHFgmtvd3NraTE5MDcGA1UEAwwwVXJ6xIVkIE1hcnN6YcWCa293c2tpIFdvamV3w7NkenR3Y SBNYXpvd2llY2tpZWdvMB4XDTEyMTAxNjEwNTc0NloXDTIyMTAxNjEwNTc0NlowgeAxLTArBgkqhkiG9w0BCQEWHnVyemFk X21hcnN6YWxrb3dza2lAbWF6b3ZpYS5wbDELMAkGA1UEBhMCUEwxFDASBgNVBAgMC21hem93aWVja2llMREwDwYDVQ QHDAhXYXJzemF3YTEeMBwGA1UECgwVVXJ6xIVkIE1hcnN6YcWCa293c2tpMR4wHAYDVQQLDBVVcnrEhWQgTWFyc3ph xyjrb3dza2kxota3bgnvbammmfvyessfzcbnyxjzemhfgmtvd3nrasbxb2pld8ozzhp0d2egtwf6b3dpzwnrawvnbzcca SIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKKBLy2HEJGiG8uYiL1kdMqe75BlXhqjUf1oahBlHkHer5yRaCKiJfKrD xuwwxgcpt+rsfzjjqmnupkomug7pocpyk64mdh5ob0l9xs/3dyzd3aqhsgh1puqyxey6fxtphrzkqeiuf61gz9rrnhg/2ar2 fyrsrqtfnot8kutmmcttzgdvvc7cvtuxr/z/qv/pdwsle2f/wdgprdcqmxlygrnjhvkmm7ynphdmjdnwdn+yitc2kj36y8qago QJZ3QOjbFZ2FE5xpaOyPp7HoXkTX3uFcCYqgXNrzNQbp6ee61p0N8sKywP0EJoOzga/tpUx3M/afzLEWJzvJl7tgZvpcCAwEAA TANBgkqhkiG9w0BAQ0FAAOCAQEAMxeMgiM8Ht4KpLsSbG/Faz4tgYTiCZpmLcfWSSi0IVq9TWsbqkNhzuXZ+7GQJt0ZqTK6a vzikdxovp7/clh0zvj+ztyunjy/vml+j6qfaxofc9cy/yo8wqi4nz1mc/drs6it6iyao3te9fsihu+cj1lfxmjsrgc0hzdfahau8v H07P/toYYMvy6XIe4w/iXpGELoFDwDd+L5KoK4PSmVAFiw7QCCOOnJibh+j07FVdPwoziiiBoA/TOc9e7d1hgWtSU6bU8oJ7+g pazbtvnt/flig4su3fvxsp3fbq4wqv4o55wdx1dj5avle33pgzagimljtygug+8+3x9suddpea==</ds:x509certificate></ds:x 509Data></ds:KeyInfo><ds:Object xmlns:xades=" Target="#ID- 16b7aaa1-33c b6bf-015f51f93196"><xades:SignedProperties Id="ID-afa38f27-3c0a-450f-8e0b- b9d694b4f51a"><xades:signedsignatureproperties><xades:signingtime> T08:16:22Z</xades:SigningTime><xades:SigningCertificate><xades:Cert><xades:CertDigest><ds:DigestMethod Algorithm=" =</ds:digestvalue></xades:certdigest><xades:issuerserial><ds:x509issuername>cn=urząd Marszałkowski Województwa Mazowieckiego, OU=Urząd Marszałkowski, O=Urząd Marszałkowski, L=Warszawa, ST=mazowieckie, C=PL, X509SerialNumber></xades:IssuerSerial></xades:Cert></xades:SigningCertificate></xades:SignedSignatureProperties><xade s:signeddataobjectproperties></xades:signeddataobjectproperties></xades:signedproperties></xades:qualifyingproperties> </ds:object></ds:signature></ns6:dokument>]]></upo> </ns2:odpowiedzskrytki> </soap:body> </soap:envelope> 21/190

22 III.1.2 Specyfikacja techniczna Dokładna specyfikacja zawarta jest w plikach wsdl: eurząd\eurząd\skrytka.wsdl oraz eurząd\eurząd\skrytka_inside_base64.wsdl III.2 eurząd.eurzadpullws opis usługi Usługa wykorzystywana jest do pobierania dokumentów ze skrytki typu PULL. Sprowadza się to do tego, że po nadaniu dokumentu elektronicznego na skrytkę danego JST, EZD lub inny system Zarządzania Dokumentacją, pełniącego rolę klienta, po sprawdzeniu liczby oczekujących dokumentów, pobierana będzie pula przygotowanych dokumentów. Dodatkowo usługa umożliwia obsługę potwierdzenia prawidłowo zakończonego procesu odebrania dokumentów. W obsłudze procesu biznesowego procesowania dokumentu elektronicznego wysłanego z wykorzystaniem portalu e-urzędu jest to usługa, z wykorzystaniem, której inicjowana jest komunikacja pomiędzy portalem e-urzędu, a EZD lub innym systemem Zarządzania Dokumentacją. Usługa jest zabezpieczona poprzez mechanizmy WSSecurity podpis elementu Body oraz Timestamp koperty SOAP. III.2.1 Operacja oczekujacedokumenty Metoda zwraca ilość oczekujących dokumentów w kolejce do pobrania z skrytki typu PULL. Metoda przyjmuje parametr(y): Nazwa Typ Opis envelopeoczekujacedokumenty EnvelopeBase64 Kopertka zakodowana Base64 Typ EnvelopeBase64 to łańcuch znaków zakodowany Base64 zawierający zabezpieczoną kopertę WSSecurity o następujących wartościach: Nazwa Typ Czy wymagany? Opis podmiot String T Identyfikator podmiotu skrytki. adresskrytki String T Adres skrytki. nazwaskrytki String T Nazwa skrytki. 22/190

23 Metoda zwraca dane w postaci: Typ Opis OdpowiedzPullOczekujaceTyp Odpowiedź Typ OdpowiedzPullOczekujaceTyp jest postaci: Nazwa Typ Opis oczekujace Int Ilość oczekujących dokumentów w kolejce do pobrania z skrytki typu PULL status StatusTyp Status wykonania operacji. Typ StatusTyp jest typem złożonym zawierającym następujące parametry: kod (opcjonalny) typu Int zawiera kod statusu komunikat (wymagany) typu String zawiera treść komunikatu statusu Możliwe błędy: PullFaultMsg Wyjątek wysyłany jest m.in. gdy skrytka nie istnieje. Szczegóły błędu zawarte są wewnątrz typu danych WyjatekTyp. Typ WyjatekTyp jest typem złożonym zawierającym następujące parametry: kod (opcjonalny) typu Int zawiera kod błędu komunikat (wymagany) typu String zawiera treść komunikatu błędu Usługa może zwrócić jedną z poniższych wartości jako status/wyjątek wykonania operacji: Kod: 1, Komunikat: X dokumentów do pobrania / Brak dokumentów do pobrania. Kod: 2, Komunikat: Skrytka typu pull adresskrytki, identyfikator podmiotu idpodmiotu nie istnieje w systemie. 23/190

24 Kod: 3, Komunikat: Wystąpił błąd podczad połączenia z bazą danych Kod: 4, Komunikat: Wystąpił nieoczekiwany błąd Kod: 15, Komunikat: Brak wymaganych parametrów. Przykładowe żądanie wywołania usługi zgodne z schematem WSDL wewnętrznej usługi: <soapenv:envelope xmlns:soapenv=" xmlns:obi=" <soapenv:header/> <obi:zapytaniepulloczekujace> <podmiot>admin</podmiot> <nazwaskrytki>pull17</nazwaskrytki> <adresskrytki>/eurzad/pull17</adresskrytki> </obi:zapytaniepulloczekujace> Zwracane dane mają postać: <soapenv:envelope xmlns:soapenv=" xmlns:obi=" <soapenv:header/> <obi:odpowiedzpulloczekujace> <status> <kod>1</kod> <komunikat>1 dokumentów do pobrania</komunikat> </status> <oczekujace>1</oczekujace> </obi:odpowiedzpulloczekujace> III.2.2 Operacja pobierznastepny Metoda pobiera najstarszy dokument oczekujący w kolejce do pobrania z skrytki typu PULL. Metoda przyjmuje parametr(y): Nazwa Typ Opis envelopepobierznastepny EnvelopeBase64 Kopertka zakodowana Base64 Typ EnvelopeBase64 to łańcuch znaków zakodowany Base64 zawierający zabezpieczoną kopertę WSSecurity o następujących wartościach: 24/190

25 Nazwa Typ Czy wymagany? Opis podmiot String T Identyfikator podmiotu skrytki. adresskrytki String T Adres skrytki. nazwaskrytki String T Nazwa skrytki. Metoda zwraca dane w postaci: Typ OdpowiedzPullPobierzTyp Opis Odpowiedź Typ OdpowiedzPullPobierzTyp jest postaci: Nazwa Typ Opis danepodmiotu DanePodmiotuTyp Informacje o nadawcy dokumentu/interesancie. Typ DanePodmiotuTyp jest typem złożonym zawierającym następujące parametry: identyfikator (wymagany) typu String zawiera identyfikator użytkownika w eurzedzie typosoby typu String (opcjonalny) typ osoby imieskrot typu String (opcjonalny) imię nazwiskonazwa typu String (opcjonalny) nazwisko nip typu String (opcjonalny) pesel typu String 25/190

26 Nazwa Typ Opis (opcjonalny) regon typu String (opcjonalny) zgoda typu Boolean (opcjonalny) zgoda na otrzymywanie korespondencji drogą elektroniczną danenadawcy DaneNadawcyTyp Informacje o nadawcy dokumentu/interesancie. Typ DaneNadawcyTyp jest typem złożonym zawierającym następujące parametry: uzytkownik (wymagany) typu String zawiera identyfikator użytkownika w eurzedzie system typu String (opcjonalny) nie używane datanadania Calendar Data nadania dokumentów przez interesanta. nazwaskrytki String Nazwa skrytki. adresskrytki String Adres skrytki. adresodpowiedzi String Adres skrytki interesanta, służący m.in. do odsyłania dokumentów identyfikatorpodmiotuodpowiedzi String Identyfikator podmiotu interesanta, służący m.in. do odsyłania dokumentów 26/190

27 Nazwa Typ Opis czytestowe Boolean Informacja czy testowa odpowiedź danedodatkowe Byte[] Dokument XML. Kodowanie UTF8. Szczegóły poniżej. dokumenty DokumentTypArray Tablica nadawanych dokumentów. Typ DokumentTypArray jest typem złożonym zawierającym tablicę elementów typu DokumentTyp o następujących parametrach: nazwapliku (wymagany) typu String zawiera nazwę pliku typpliku (opcjonalny) typu String zawiera typ MIME pliku zawartosc (wymagany) typu Byte[] zawiera zawartość pliku podpis String Podpis nadanych dokumentów. Zawiera podpis certyfikatem (detached XADES) lub podpis Profilem Zaufanym epuap (szczegóły poniżej). typpodpisu String B brak podpisu, C 27/190

28 Nazwa Typ Opis podpis certyfikatem, P podpis profilem zaufanyn epuap upo String Dokument UPO identyfikatorsprawyeurzad Int Identyfikator sprawy eurząd. identyfikatordokumentu Int Identyfikator nadanego dokumentu. status StatusTyp Status wykonania operacji. Typ StatusTyp jest typem złożonym zawierającym następujące parametry: kod (opcjonalny) typu Int zawiera kod statusu komunikat (wymagany) typu String zawiera treść komunikatu statusu Dla wysłanych dokumentów podpisanych Profilem Zaufanym epuap podpis: Dla podpisywanego dokumentu XML jest dokumentem XML zawierającym wyłącznie znacznik <ds:signature> pochodzący z epuapu. Aby móc zweryfikować taki podpis usługą TPSigning epuapu, należy dołączyć do podpisanego dokumentu (jako ostatni element węzła głównego) węzeł <ds.:signature> z podpisu. Dla podpisanego dokumentu nie będącego dokumentem XML zawiera podpis dokumentu o poniższej składni: <?xml version="1.0" encoding="utf-8"?><dokument><zawartosc> danebinarnezakodowanebase64</zawartosc></dokument> Pole danedodatkowe zawiera dokument XML o poniższej składni: <?xml version="1.0" encoding="utf-8"?> <root> 28/190

29 <payment value= wartoscdomyslnejnaleznosciuslugi bankaccount= nrrachunkubankowegouslugodawcy canmodify= czymożnamodyfikowaćwartośćdomyślnejnależności dayofpaymenttext = terminpłatności /> <visualization>wizualizacjapdfwnioskuzakodowanebase64</visualization> <visualizationhtml>wizualizacjahtmlwnioskuzakodowanebase64</visualizationhtml> </root> Węzeł payment jest dostępny wyłącznie dla dokumentów powiązanych z usługą posiadającą zdefiniowaną płatność. Węzeł visualization i visualizationhtml są dostępne wyłącznie dla dokumentów będących wnioskiem XForms. Możliwe błędy: PullFaultMsg Wyjątek wysyłany jest m.in. gdy skrytka nie istnieje, brak dokumentów do pobrania. Szczegóły błędu zawarte są wewnątrz typu danych WyjatekTyp. Typ WyjatekTyp jest typem złożonym zawierającym następujące parametry: kod (opcjonalny) typu Int zawiera kod błędu komunikat (wymagany) typu String zawiera treść komunikatu błędu Usługa może zwrócić jedną z poniższych wartości jako status/wyjątek wykonania operacji: Kod: 1, Komunikat: Przekazano kolejny oczekujący dokument. Kod: 2, Komunikat: Skrytka typu pull adresskrytki, identyfikator podmiotu idpodmiotu nie istnieje w systemie. Kod: 3, Komunikat: Wystąpił błąd podczad połączenia z bazą danych Kod: 4, Komunikat: Wystąpił nieoczekiwany błąd Kod: 5, Komunikat: Brak dokumentów do pobrania. Kod: 15, Komunikat: Brak wymaganych parametrów. Przykładowe żądanie wywołania usługi zgodne z schematem WSDL wewnętrznej usługi: <soapenv:envelope xmlns:soapenv=" xmlns:obi=" <soapenv:header/> <obi:zapytaniepullpobierz> <podmiot>admin</podmiot> <nazwaskrytki>pull17</nazwaskrytki> <adresskrytki>/eurzad/pull17</adresskrytki> 29/190

30 </obi:zapytaniepullpobierz> Zwracane dane mają postać: <soap:envelope xmlns:soap=" xmlns:ns2=" kolejny oczekujący dokument</komunikat></status><identyfikatorsprawyeurzad>3602</identyfikatorsprawyeurzad><identyfikatordokumentu>24 </identyfikatordokumentu><danepodmiotu><identyfikator>interesant03</identyfikator><typosoby></typosoby><imieskrot>inte resant</imieskrot><nazwiskonazwa>03</nazwiskonazwa><nip></nip><pesel></pesel><regon></regon><zgoda>false</zgoda ></danepodmiotu><danenadawcy><uzytkownik>interesant03</uzytkownik></danenadawcy><datanadania> T10:25: :00</dataNadania><nazwaSkrytki>PULL17</nazwaSkrytki><adresSkrytki>/eurzad/pull17</adresSkrytki>< adresodpowiedzi>/interesant03/skrytka</adresodpowiedzi><identyfikatorpodmiotuodpowiedzi>interesant03</identyfikatorpod miotuodpowiedzi><czytestowe>false</czytestowe><danedodatkowe>pd94bwwgdmvyc2lvbj0ims4wiiblbmnvzgluzz0ivvr GLTgiPz48cm9vdD48cGF5bWVudCBiYW5rQWNjb3VudD0iMzI4NjQ2MDAwODAwMDAwMDAwNjM0NzAwMDEiIGNhbk1vZGl met0idhj1zsigdmfsdwu9ijixldawii8+pc9yb290pg==</danedodatkowe><dokumenty><nazwapliku>test.txt</nazwapliku><t yppliku>text/plain</typpliku><zawartosc>vgvzda==</zawartosc></dokumenty><podpis><?xml version="1.0" encoding="utf-8"?><ds:signature Id="ID-1334e427-8cb0-40c2-99ea-7fbd a" xmlns:ds=" Algorithm=" "></ds:CanonicalizationMethod><ds:SignatureMethod Algorithm=" URI="test.txt"><ds:DigestMethod Algorithm=" 7cTBY/Z5p0b3q3+10fo=</ds:DigestValue></ds:Reference><ds:Reference Type=" URI="#ID-630cdbcf d5-8ebe- 7a660a6cf649"><ds:Transforms><ds:Transform Algorithm=" "></ds:Transform></ds:Transforms><ds:DigestMethod Algorithm=" ye6vw8funmcgviqa7zk=</ds:digestvalue></ds:reference></ds:signedinfo><ds:signaturevalue Id="ID-5573e5a1-0f6b cdbe ee">RoNdlRL7WCylSLlJii0eTtxMDyKHxgZnM0b3TPspQRhPqpjOd1eoq8AJGIirmSKVAhhe4erL79szo+Hct 0cVHkrAK9N/uUXMSv50c2LaNSj0zyQLAq/XEjI3HAh/HhxV9CzdK2aeDVXKkm/ehfDA6Pl4e6AlWjfdMV4ui6G5BUaFUmaBBAhj LqoXeZ985P8xgMAd83NW8faQANcKJFHwmkftAQ63Zim73/lKKY5MqKY/2Qhi35mEd9/N+KcqNhohmrHyqD1Id9gyWiP+CEy3U AqsRFh9ZArEMylMbU6L3deudc8LuODC/XJWZMx0Iwzu2GzrB1TSxd617rhbYwvxOw==</ds:SignatureValue><ds:KeyInf o Id="ID-47eb10bb-4bbd-4203-b183- bcfb91cc27f6"><ds:x509data><ds:x509certificate>miidqdccapcgawibagieuknnudanbgkqhkig9w0baq sfadcbljedmbsgcsqgsib3dqejaryocm9vdgnhqg5vbmuucgwxczajbgnvbaytalbmmrqwegydvqqidattywxvcg9s c2tpztepma0ga1uebwwgs3jha293mrmweqydvqqkdapdt01bukniifnbmq0wcwydvqqldarbufvtmr0wgwydv QQDDBRDT01BUkNIIFJPT1QgQ0EgVEVTVDAeFw0xMjExMTkwODAxMzJaFw0yMDExMTkwODAxMzJaMIGUMSMwIQYJKo ZIhvcNAQkBFhRqYW4ua293YWxza2lAbm9uZS5wbDELMAkGA1UEBhMCUEwxFDASBgNVBAgMC21hbG9wb2xza2llMQ8wD QYDVQQHDAZLcmFrb3cxEzARBgNVBAoMCkNPTUFSQ0ggU0ExDTALBgNVBAsMBEFQVVMxFTATBgNVBAMMDEphbiBLb 3dhbHNraTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK05EGjSULyEVRxCz80qC3n+24BkHrs0LDoS3IWF6 hz/mw3273oh1qhy63lugk7anlecpb1863upzonf36h6ey4grauts+oq71rpuqdodockw/fcedq8shjcsp8sjc1sehak9fms T3Kot3xsilDahC69/rJE6BLMwJ3OsRTcfy89nrYqNv8ujUqCg0Mol/XaFpPG+F7lEsZq78tHFPprPRdoEbrHC0Sbdvn58D+Z9KtqM /7x8mbcH5minkDiU7bimG2U5HY6ocpouP9h71qM/9RvOubw2zhqOLRR4YT+AWLzBKo8XOfRCDTh6cDjEfqtwVUhmHUcg2Cu v13d5nkb15mcaweaatanbgkqhkig9w0baqsfaaocaqeaqnahhi7g5oe/nhjaapihbqgixbcwjp8w97er8bgfxx462rbf/c 30/190

31 MZasJWmPmc6F4dY2Z1KuDgncm6+fGO6+HZJaOP3KB2ihY1joVcd3PASsy8/uaPqa5jeRyWuS4qxuLNEJ1uXG7agCNgd+/wW UlzJ3RtUTXqc4ePl15pPjHHzcNed7ADxTSYpjJ3XtLttMq2uvTMTUlLBolr9q2wCiNwOhj8FpR5pIAbkW0UHW4TYD9WG4bIaL1q SCOQO0256+CCfnpwd7b+e9U4bNUFPbnhPrGbuY80afVxj+VOgqocEcYGZuD30UEa7ykHWaH2C1tqSClp27DCMmrryieaKIHII Q==</ds:X509Certificate></ds:X509Data></ds:KeyInfo><ds:Object xmlns:xades=" Target="#ID-1334e427-8cb0-40c2-99ea-7fbd a"><xades:SignedProperties Id="ID-630cdbcf d5-8ebe- 7a660a6cf649"><xades:SignedSignatureProperties><xades:SigningTime> T08:24:46Z</xades:SigningTime><xades:SigningCertificate><xades:Cert><xades:CertDigest><ds:Diges tmethod Algorithm=" ZDa4PCs8CQqKQ0SIjWs=</ds:DigestValue></xades:CertDigest><xades:IssuerSerial><ds:X509IssuerName& gt;cn=comarch ROOT CA TEST, OU=APUS, O=COMARCH SA, L=Krakow, ST=malopolskie, C=PL, erialnumber></xades:issuerserial></xades:cert></xades:signingcertificate></xades:signedsignatureproper ties><xades:signeddataobjectproperties></xades:signeddataobjectproperties></xades:signedproperties>&lt ;/xades:qualifyingproperties></ds:object></ds:signature> </podpis><typpodpisu>c</typpodpisu><upo><?xml version="1.0" encoding="utf-8" standalone="yes"?> <ns6:dokument xmlns:ns2=" xmlns=" xmlns:ns4=" xmlns:ns3=" xmlns:ns5=" xmlns:ns6=" xmlns:ns7=" <ns6:upp> <ns6:identyfikatorposwiadczenia>eurzad-upp_wdok_24</ns6:identyfikatorposwiadczenia> <ns6:adresat> <ns6:nazwa></ns6:nazwa> <ns6:identyfikatorpodmiotu TypIdentyfikatora="eURZAD-ID">admin</ns6:IdentyfikatorPodmiotu> </ns6:adresat> <ns6:nadawca> <ns6:nazwa>interesant 03</ns6:Nazwa> <ns6:identyfikatorpodmiotu TypIdentyfikatora="eURZAD- ID">interesant03</ns6:IdentyfikatorPodmiotu> </ns6:nadawca> <ns6:datadoreczenia> t10:25: :00</ns6:datadoreczenia> <ns6:datawytworzeniaposwiadczenia> t10:25: :00</ns6:datawytworzeniaposwiadczenia> <ns6:identyfikatordokumentu>wdok_24</ns6:identyfikatordokumentu> <ns6:informacjauzupelniajaca TypInformacjiUzupelniajacej="Źródło">Poświadczenie wystawione przez platformę eurząd Urzędu Marszałkowskiego Województwa Mazowieckiego</ns6:InformacjaUzupelniajaca> 31/190