MWD Komunikaty dla usług komercyjnych. Wersja dokumentu Status

Transkrypt

1 MWD Komunikat dla usług komrcjnch Wrsja dokumntu Status Wdrożon Data wdrożnia 3Q 2014

2 Spis trści 1 Dokumnt powiązan Słownik pojęć Wstęp Zasad numrowania dokumntu MWDK Zasad komunikacji Mapowani danch biznsowch na komunikat tchniczn Schmat komunikacji Kanał komunikacjn Format komunikatu Kanał WbSrvic Dan konfiguracjn kanału Spcfikacja tchniczna kanału Sposób przsłania komunikatów w kanal Zasad bzpiczństwa przsłu danch w kanal Przsłani plików w kanal WbSrvic Obsługa trbu RELAY w kanal WbSrvic Kanał Dan konfiguracjn kanału Spcfikacja postaci pliku z komunikatami Podgląd historii komunikacji Tabla mapowania komunikatów na rozdział MWDP Tp podstawow BASKET-ID BOOLEAN CHAR_ CHAR_ MWD Komunikat dla usług komrcjnch wrsja

3 6.5 CHAR_ CHAR_ CHAR_12_FIXED CHAR_ CHAR_ CHAR_ CHAR_ CHAR_ CHAR_ CHAR_ CHAR_ CHAR_5_FIXED CHAR_ CHAR_6_FIXED CHAR_ CHAR_ DATE DATETIME DECIMAL_12_ FILE-ID_TYPE FLOAT_5_ FLOAT_7_ ID INT_ INT_ INT_ INT_ MWD Komunikat dla usług komrcjnch wrsja

4 6.32 INT_ INT_1_FIXED INT_ INT_ INT_2_FIXED INT_ INT_ INT_4_FIXED INT_ INT_ INT_ INT_9_POS IP MSN-QUANTITY NDS OA PHONE-NUMBER POSTAL-CODE RN SERVICE-ID SWAREF Tchniczna spcfikacja rkordów MSG-HEADER ADDRESS LOC-ADDRESS CONTACT-DATA CUSTOMER-CONTACT-DATA MWD Komunikat dla usług komrcjnch wrsja

5 7.6 CUSTOMER-NAME PERSON DOCUMENT ATTACHMENT Komunikat ABORT ACK ATTACHMENTS TECHNICAL-PROOF TECHNICAL-PROOF-STATUS-NFV TECHNICAL-PROOF-STATUS ASSISTANCE-ORDER ASSISTANCE-ORDER-STATUS-FV CANCEL-ASSISTANCE-ORDER CANCEL-ASSISTANCE-ORDER-STATUS ASSISTANCE-ORDER-CHANGE-DATE ASSISTANCE-ORDER-CHANGE-DATE-STATUS ASSISTANCE-ORDER-TP-CHANGE-DATE ASSISTANCE-ORDER-STATUS PAYMENT-START PAYMENT-STOP COMPLAINT-NFV COMPLAINT-NFV-STATUS FAULT-SERVICE FAULT-SERVICE-STATUS-FV FAULT-SERVICE-STATUS APPOINTMENT-DATE-CHANGE MWD Komunikat dla usług komrcjnch wrsja

6 8.23 FAULT-SERVICE-STATUS-RESTORE FAULT-SERVICE-STATUS-ACC FAULT-PRIORITY-DATABASE-UPDATE FAULT-PRIORITY-DATABASE-UPDATE-NFV FAULT-PRIORITY-DATABASE-STATUS MASS-IMPORT MASS-IMPORT-STATUS COMPLAINT COMPLAINT-QUEST COMPLAINT-ANSWER COMPLAINT-ESCALATION COMPLAINT-STATUS INTERVENTION INTERVENTION-STATUS ORDER-MIGRATION ORDER-STATUS-NFV ORDER-MIGRATION-ACC-TO-DONOR ORDER-MIGRATION-ACC-TO-HOST ORDER-VERIFICATION-FROM-DONOR ORDER-VERIFICATION-FROM-HOST ORDER-MIGRATION-REJECTION-TO-DONOR ORDER-MIGRATION-REJECTION ORDER-MIGRATION-REJECTION-TO-HOST ORDER-MIGRATION-STATUS-PTV ORDER-MIGRATION-STATUS-PTV-TO-HOST ORDER-MIGRATION-STATUS-PTV-TO-DONOR ORDER-MIGRATION-INS-ACTIVE-STATUS-NTV MWD Komunikat dla usług komrcjnch wrsja

7 8.50 ORDER-MIGRATION-INS-ACTIVE-STATUS-NTV-TO-DONOR ORDER-MIGRATION-INS-ACTIVE-STATUS-NTV-TO-HOST ORDER-STATUS-ANNEX ORDER-LOC-STATUS-ANNEX ORDER-ESTIMATION ORDER-ESTIMATION-ACC ORDER-INVEST ORDER-INVEST-ACC ORDER-NEW-REALIZATION-DATE ORDER-NEW-REALIZATION-DATE-NEG-TO-HOST ORDER-NEW-REALIZATION-DATE-NEG-TO-DONOR ORDER-NEW-REALIZATION-DATE-NEG ORDER-NEW-REALIZATION-DATE-ACC-TO-HOST ORDER-NEW-REALIZATION-DATE-ACC-TO-DONOR ORDER-NEW-REALIZATION-DATE-ACC ORDER-BUILD-END ORDER-REALIZATION-DATE ORDER-REALIZATION-DATE-TO-HOST ORDER-REALIZATION-DATE-TO-DONOR ORDER-MIGRATION-INS-WITH-PARAMS ORDER-RTN ORDER-RTN-TO-DONOR ORDER-RTN-TO-HOST ORDER-SUPERIORFORCE ORDER-SUPERIORFORCE-TO-DONOR ORDER-SUPERIORFORCE-TO-HOST ORDER-RTN-END MWD Komunikat dla usług komrcjnch wrsja

8 8.77 ORDER-RTN-END-TO-DONOR ORDER-RTN-END-TO-HOST ORDER-REGISTRATION-POS ORDER-REGISTRATION-NEG ORDER-REGISTRATION-DEACT ORDER-BSA-TYPE-MOD ORDER-BSA-TYPE-MOD-WITH-PARAMS ORDER-MOD-STATUS-NFV ORDER-MOD-STATUS-PTV ORDER-BSA-MOD-STATUS-NTV ORDER-BSA-MOD-NEW-REALIZATION-DATE-ACC ORDER-BSA-OPTION-MOD ORDER-LLU-MOD ORDER-LLU-MOD-WITH-PARAMS ORDER-CORR-CABLE-MOD ORDER-CORR-CABLE-MOD-FV ORDER-CORR-CABLE-MOD-STATUS ORDER-VPVC-MOD ORDER-VPVC-MOD-STATUS ORDER-LLU-LPPA ORDER-LLU-LPPA-STATUS-NTV ORDER-LLU-LPPA-WITH-PARAMS ORDER-INS-ACTIVE ORDER-INS-ACTIVE-STATUS-PTV ORDER-INS-NEW-REALIZATION-DATE-ACC ORDER-INS-INACTIVE ORDER-INS-INACTIVE-STATUS-NFV MWD Komunikat dla usług komrcjnch wrsja

9 8.104 ORDER-INS-INACTIVE-STATUS-PTV ORDER-INS-INACTIVE-STATUS-NTV LOG-QUERY LOG-QUERY-RES CANCEL-ORDER CANCEL-ORDER-NEG CANCEL-ORDER-POS RESIGN RESIGN-NFV ORDER-RMV-REALIZATION-DATE RESIGN-END RESIGN-EQUIPMENT ORDER-WLR-PRESELECTION ORDER-WLR-STATUS-NFV ORDER-WLR-PRESELECTION-REALIZATION-DATE ORDER-WLR-SUSPEND ORDER-WLR-SUSPEND-REALIZATION-DATE ORDER-WLR-VAS ORDER-WLR-VAS-REALIZATION-STATUS ORDER-WLR-NUMBER ORDER-WLR-NUMBER-TV ORDER-WLR-NUMBER-REALIZATION-STATUS CESSION CESSION-ACC-TO-DONOR CESSION-FV CESSION-STATUS CESSION-NFV-FROM-RECIPIENT MWD Komunikat dla usług komrcjnch wrsja

10 8.131 SERVICE-QUERY SERVICE-QUERY-RES ORDER-LOCATION-CHG ORDER-LOCATION-CHG-STATUS-PTV ORDER-LOCATION-CHG-STATUS-NTV ORDER-LOCATION-CHG-REALIZATION-DATE ORDER-WLR-ADDRMV ORDER-WLR-ADDRMV-STATUS-PTV ORDER-WLR-ADDRMV-STATUS-NTV ORDER-WLR-ADDRMV-REALIZATION-DATE ORDER-WLR-ADDRMV-WITH-PARAMS CUSTOMER-CLAIM ORDER-WLR-ADDRMV-CHANNEL ORDER-WLR-ADD-PBX ORDER-WLR-MOD-PBX ORDER-WLR-RMV-PBX ORDER-WLR-ADD-PBXDDI ACCEPTANCE-PROTOCOL ACCEPTANCE-PROTOCOL-REMARKS ORDER-BCHANNELS-ADDRMV-PTV ORDER-BCHANNELS-ACC ORDER-PBX-SLA-TV ORDER-WLR-INSTALL-LINE ORDER-WLR-REINSTALL-LINE ORDER-WLR-ADD-PBXDDI-STATUS ORDER-WLR-MOD-PBXDDI ORDER-WLR-MOD-SLA MWD Komunikat dla usług komrcjnch wrsja

11 8.158 ORDER-WLR-MOD-SLA-STATUS ORDER-PBX-MOD-STATUS-PTV ORDER-WLR-PBXDDI-REALIZATION-DATE ORDER-WLR-MOD-STATUS ORDER-WLR-RMV-STATUS ORDER-WLR-CHG-NTV ORDER-WLR-INS-WITH-PARAMS ORDER-WLR-REALIZATION-STATUS Słowniki ABORT-REASON ACC-STATUS ACCEPTANCE-RESULT ACCEPTANCE-STATUS ACCESS-TIME ADDRMV-TYPE ANNEXATION-STATUS ANNEXATION-TYPE ASSISTANCE-STATUS ATM-TYPE BSA-MOD-TYPE BSA-TECHNOLOGY BSA-TYPE BUSL-STATUS-DICT CEASE-MODE CHANNELS-NUMBER CHECK-STATUS-DICT CLAIM MWD Komunikat dla usług komrcjnch wrsja

12 9.19 COMPLAINT-STATUS-DICT COMPLAINT-TYPE DDI-NUMBERS EQUIPMENT-STATUS FAULT-SERVICE-TYPE FAULT-STATUS FV-STATUS GENERAL-SERVICE-TYPE ISDN-TYPE LINK-TYPE LOC-FLAG MASS-OPERATION-MODE MASS-OPERATION-SUBJECT MEETING-SLOT MOD-LOC-TYPE MODIFICATION-TYPE MSG-VER NP-TYPE OPTION-TYPE ORDER-MODE ORDER-TYPE PROOF-STATUS REALIZATION-STATUS RESIGN-TYPE RTN-RESPONSIBILITY SERVICE-TYPE SLA-NTV MWD Komunikat dla usług komrcjnch wrsja

13 9.46 SLA-TYPE STATE TEST-VER TP-SERVICE-TYPE TV-STATUS USER-ACTIVATION VAS-ACTION VAS-ACTION-STATUS VAS-OPTIONAL-TYPE VAS-TYPE VAS-VALUE-TYPES VERIFICATION-STATUS VI VOICE-TYPE WLR-INSTALL-LINE-TYPE Kod odrzucń CANCEL-ORDER-DICT COMPLAINT-PROLONG COMPLAINT-REJECT COMPLAINT-RESULT COMPLAINT-SUBJECT EC-FIA FV-DONOR FV-DONORHOST FV-HOST FV-TP NTV MWD Komunikat dla usług komrcjnch wrsja

14 RR-FIA RTN SYMPTOMS Załączniki Dopuszczaln kombinacj usług zamawianch i usług, z którch następuj rzgnacja Format załącznik do komunikatu FAULT-PRIORITY-DATABASE-UPDATE Format załącznika do komunikatu MASS-IMPORT oraz MASS-IMPORT-STATUS Obsługa zamówiń na Tldiagnostkę i Rstart Portu Wstęp Tp podstawow Tchniczna spcfikacja rkordów rror TstRsult TstDataCatgor TstData Komunikat Słowniki Obsługa procsu Wstępnj Wrfikacji Tchnicznj Wstęp Tp podstawow Komunikat Słowniki MWD Komunikat dla usług komrcjnch wrsja

15 1 Dokumnt powiązan L.p. Wrsja Data [1] MWD Procs dla usług komrcjnch [2] MWD Procs (Infrastruktura) dla Modlu Współprac Międzopratorskij zgodn z Ofrtą Ramową (SOR) Słownik pojęć W dokumnci wkorzstwano pojęcia z [1]. 3 Wstęp Dokumnt stanowi tchniczną spcfikację komunikacji zdfiniowanj w dokumnci [1]. Dokumnt ni opisuj przbigu procsów, możliwch scnariusz, poszczgólnch kroków, dozwolonch czasów odpowidzi. Wszstki t informacj zawart są w dokumnci [1]. W rozdzial 4 opisano zasad komunikacji. Rozdział 5 opisuj mapowania komunikatów na rozdział dokumntu [1]. Rozdział 6 opisuj tp danch wkorzstwan w komunikacji. Rozdział 7 opisuj struktur wkorzstwan w komunikacji. Rozdział 8 opisuj komunikat jaki są przsłan w ramach Modlu Wmian Danch. Rozdział 9 dfiniuj słowniki. W rozdzial 10 zamiszczono załączniki do dokumntu Opisan w dokumnci zasad komunikacji obowiązują zarówno część hurtową Orang Polska (Hurt) jak i Przdsiębiorcę Tlkomunkacjngo (PT) przstępującgo do Modlu Wmian Danch (MWD) zgodni z [1]. 3.1 Zasad numrowania dokumntu MWDK Dokumnt będzi odnosił się do numracji dokumntu [1] zgodni z następującą konwncją MWDK_[wrsja dokumntu MWDP]-[tap_implmntacji]-[wrsja dokumntu MWDK dla danj wrsji MWDP].[podwrsja MWDK (zmian dcjn)] Etap implmntacji będą oznaczan następująco: 0 - wrsja draft, przznaczona do konsultacji 1 wrsja po zamknięciu konsultacji (skirowana do konstrukcji kodu) 2 wrsja wdrożona produkcjni Przkładowo wrsja oznacza: MWDK dla MWDP w wrsji 4.0 wrsja 15.0 MWDK dla MWDP w wrsji 4.0 jst to wrsja do konsultacji Załóżm, ż wrsja ta podlgała konsultacjom. Po uwzględniniu uwag opratorów powstani koljna wrsja , czli: MWDK dla MWDP w wrsji 4.0 wrsja 16 MWDK dla MWDP w wrsji 4.0 jst to wrsja po zamknięciu konsultacji (skirowana do konstrukcji kodu) MWD Komunikat dla usług komrcjnch wrsja

16 4 Zasad komunikacji 4.1 Mapowani danch biznsowch na komunikat tchniczn Dokumnt [1] opisuj przbig procsów obsługi usług hurtowch. Ninijsz dokumnt przdstawia w jaki sposób dan zakrs informacjn ma zostać przsłan pomiędz sstmami informatcznmi. Stąd prz każdm komunikaci wróżniono numr rozdziału w dokumnci [1] jaką spcfikuj np. komunikat TECHNICAL_PROOF spcfikuj zakrs danch przsłanch w kroku Dla rozdziałów nazwanch w [1] "Wrfikacja informatczna" wsłan jst zawsz komunikat tchniczn ACK, któr informuj o przjęciu lub odrzucniu zlcnia. Zgodni z rozdziałm Schmat komunikacji komunikat tchniczn ACK są wsłan przsłan dla wszstkich komunikatów biznsowch. W przpadku komunikatów kirowanch do różnch aktorów, komunikat rozdzilono nazwniczo zgodni z poniższa tablą: Aktor Sufiks Przkładow komunikat Orang Hurt brak ORDER-MIGRATION Biorca brak ORDER-NEW-REALIZATION-DATE-NEG Dawca -TO-DONOR ORDER-NEW-REALIZATION-DATE-NEG-TO-DONOR Oprator Macirzst -TO-HOST ORDER-NEW-REALIZATION-DATE-NEG-TO-HOST W takim wpadku prz komunikaci zaznaczono iż dotcz on komunikacji z konkrtnm aktorm. Wjątkim jst komunikat anulowania zamówinia CANCEL-ORDER-POS, któr moż bć wsłan do wszstkich aktorów (bz wróżninia w nazwi komunikatu do kogo jst kirowan). W przpadku gd dan Przdsiębiorca Tlkomunikacjn wstępuj w danm procsi w dwóch rolach np. Dawc i Opratora Macirzstgo zostaną do nigo wsłan dwa komunikat. Komunikat potwirdzając anulowania zlcnia są wsłan do wszstkich uczstników procsu nawt do Przdsiębiorstwa Tlkomunikacjngo, z którgo powodu anulowano zlcni. Prz tworzniu nazw komunikatów przjęto nastpującą konwncję nazwniczą Sufiks Rozwinięci (ang.) Znaczni -STATUS- Komunikat jst informacją o statusi zlcnia/zamówinia lub informuj o jgo wniku. -FV formal vrification Wnik wrfikacji formalnj -NFV ngativ formal vrification Ngatwn wnik wrfikacji formalnj -PTV positiv tchnical vrification Poztwn wnik wrfikacji tchnicznj -NTV ngativ tchnical vrification Ngatwn wnik wrfikacji tchnicznj Dla ułatwinia wszstki mapowania komunikatów zbrano w rozdzial Tabla mapowania komunikatów na rozdział MWDP 4.2 Schmat komunikacji Komunikacja w ramach MWD jst ralizowana zawsz wg tgo samgo schmatu. MWD Komunikat dla usług komrcjnch wrsja

17 Dan wspóln dla wszstkich komunikatów wdzilono do nagłówka MSG-HEADER. Komunikat wminian w ramach jdngo procsu są powiązan poprzz pol ordr-numbr (Idntfikator zamówinia / zgłosznia). W ramach pojdnczgo procsu moż dojść do wilu intrakcji (wmian danch). Pojdncza intrakcja składa się z wsłania odpowidnigo komunikatu przz nadawcę oraz odbrania lub odrzucnia przz odbiorcę skorlowan prz pomoc pola intraction-id. Nadawca wsła komunikat dfiniując następując pola nagłówka: Pol intraction-id Znaczni numr intrakcji rozumian jako wsłani komunikatu oraz otrzmania potwirdznia (komunikatu ACK). Taka para komunikatów posiada wspóln numr intrakcji. Idntfikator intrakcji (INTERACTION-ID) musi bć unikalnm idntfikatorm wmian danch w obrębi dango źródła komunikatu (Przdsiębiorc tlkomunikacjngo). Idntfikator tn będzi liczbą całkowitą o długości maksmalnj 15 znaków [INT(15)]. Idntfikator ni musi zachowwać skwncjności numracji. Wszstki komunikat niosąc trść biznsową są sparowan z odpowidnim komunikatm potwirdznia. Komunikat ABORT ni jst on w snsi ścisłm częścią intrakcji w ramach którj został wsłan, a jdni sgnałm, ż intrakcja się ni powiodła. subjct-id dst-subjct-id ordr-numbr numr jdnoznaczni idntfikując nadawcę komunikatu poprzz numr pod jakim Oprator figuruj w rjstrz przdsiębiorców tlkomunikacjnch UKE. Na potrzb ninijszgo modlu wmian danch Orang-Hurt będzi posiadała idntfikator 0 numr jdnoznaczni idntfikując odbiorcę komunikatu poprzz numr pod jakim Oprator figuruj w rjstrz przdsiębiorców tlkomunikacjnch UKE. Na potrzb ninijszgo modlu wmian danch Orang-Hurt będzi posiadała idntfikator 0 numr oznaczając idntfikator zamówinia/zgłosznia, dla komunikatów rozpocznającch procs numr musi bć unikaln w ramach jdngo PT MWD Komunikat dla usług komrcjnch wrsja

18 msg-vr tst-vr stat W przpadku gd: pol okrślając zgodni z którą wrsją MWD przgotowan został komunikat. W wpadku komunikatów zgodnch z ninijszm MWD jgo wartość będzi wnosiła "SOR [wrsja dokumntu MWDP]-[wrsja dokumntu MWDK dla danj wrsji MWDP]" (patrz Zasad numrowania dokumntu MWDK). W przpadku popraw błędów lub wprowadzania rozszrzń funkcjonalnch wartość ta moż ulgać zmiani. Stąd opratorz korzstając z kanału WbSrvic powinni bć przgotowani na taką zmianę. pol okrślając, cz komunikat jst komunikatm produkcjnm cz tstowm. Stron w wpadkach szczgólnch dopuszczają możliwość wsłania komunikatów tstowch na środowisku produkcjnm. Komunikat taki spowoduj odsłani właściwgo komunikatu potwirdznia ACK jdnak bz uruchamiania procsów biznsowch pol okrślając stan intrakcji w ramach którgo nastąpiło gnrowania komunikatu. Dopuszczaln wartości to REQ dla żądania, ACK dla potwirdznia i ABR dla komunikatu. Dodatkowa wartość ATTACHMENT jst wkorzstwana prz przsłaniu plików (patrz Przsłani plików) 1. odbiorca ni jst w stani odbrać/odcztać komunikatu (z powodu błędów krtcznch w strukturz wiadomości, nipoprawngo uwirztlninia nadawc, awarii sstmu, włącznia sstmu na czas prac konsrwacjnch, włącznia kanału komunikacjngo itp.) odpowiada nadawc komunikatm ABORT 2. przsłan komunikat ni spłnia wmagań nakładanch na dan komunikat, w szczgólności a) brakuj wmagalnch pól b) wartości pól są nizgodn z tpm lub wartościami słownikowmi c) komunikat ni spłnia wspcfikowanch dla każdgo komunikatu rguł odbiorca odpowiada komunikatm ACK z flagą acc-status=odrzucon oraz opism błędu (pol rjction-rason-cod) zgodnm z słownikim VI 3. w przciwnm wpadku odbiorca odpowiada komunikatm ACK z flagą acc-status=przjęt, któr potwirdza dostarczni komunikatu Komunikat ABORT oraz ACK powinn posiadać idntczn pol intraction-id jak w komunikaci od nadawc. Po otrzmaniu informacji o odrzucniu wiadomości nadawca moż ponowni wsłać poprawion komunikat al z zminioną wartością pola intraction-id (pol ordr-numbr moż pozostać bz zmian). W przpadku gd odbiorca ni odpowi komunikatm ABORT lub ACK na komunikat biznsow nadawc w przciągu 30 minut, nadawca moż przsłać ponowni tn sam komunikat z takim samm intraction-id. Odbiorca powinin zignorować zdublowan komunikat jśli jgo trśc jst idntczna (jśli trść jst różna wtd odbiorca powinin odpowidzić komunikatm ABORT z błędm 1007). Zakłada się, ż dan komunikat będzi powtarzan maksmalni 2 raz. Jśli odbiorca nadal ni odpowi nadawca powinin zgłosić awarię ISI zgodni z odpowidnim procsm zdfiniowanm w [2]. Wskazan dokumnt opisuj takż obsługę prac planowch na sstmach informatcznch Po naprawi awarii komunikat moż bć ponowni wsłan przz nadawcę do odbiorc Z względu na fakt, iż Orang-Hurt jst zobligowan do dotrzmania czasów ralizacji poszczgólnch kroków procsu zdfiniowanch w SOR, Orang-Hurt kontnuuj ralizację procsu ni czkając na dostarczni komunikatu do OA. Brak potwirdznia dostarcznia komunikatu lub odrzucni komunikatu przz OA oznacza błąd w komunikacji Orang-Hurt wrfikuj wszstki przchodząc komunikat zgodni z poniższm schmatm: MWD Komunikat dla usług komrcjnch wrsja

19 wrfikacja informatczna przdwstępna (w przpadku nipowodznia powoduj wsłani komunikatu ABORT) o wrfikacja cz nadawca ma uprawninia do komunikacji kanałm przchodzącm o wrfikacja cz komunikat jst możliw do odszfrowania i odcztania o wrfikacja cz komunikat posiada prawidłow pol intraction-id. wrfikacja informatczna (w przpadku nipowodznia powoduj wsłani komunikatu ACK z flagą acc-status=odrzucon) o wrfikacja wrsji MWD oraz jj zgodności przsłango komunikatu o wrfikacja cz komunikat posiada wmagan pola o wrfikacja cz pola komunikatu mają prawidłow format tchniczn o wrfikacja cz wskazan dat ralizacji zamówinia/zlcnia spłniają warunki wspcfikowan w [1] wrfikacja formalna polga na sprawdzniu poprawności danch biznsowch, w komunikaci zawsz jst poprzdzona wsłanim komunikatu ACK z flagą accstatus=przjęt. Ewntualn błęd sa zwracan jako osobn komunikat zdfiniowan w [1] W przpadku odrzucnia zamówinia/zgłosznia na tapi wrfikacji formalnj koniczn jst przsłani zamówinia z nowm numrm ordr-numbr Wjątkim dla powższgo są komunikat TECHNICAL-PROOF, MASS-IMPORT, ORDER-VPVC- MOD, któr umożlwiają korktę zamówinia Komunikat FAULT-SERVICE można wsłać z tm samm ordr-numbr w przpadku, gd Biorca stwirdzi brak usunięcia uszkodznia (szczgół dotcząc procsu opisano w [1]) W ramach pojdnczj intrakcji istnij możliwość przsłania tlko pojdnczgo komunikatu. Spcfikacja ni umożliwia przsłani wilu komunikatów na raz (paczkowani komunikatów). 4.3 Kanał komunikacjn Komunikat zdfiniowan w ninijszj spcfikacji mogą bć przsłan poprzz jdn z następującch kanałów komunikacji WbSrvic WWW Kanał WWW jst ralizowan na infrastrukturz Orang-Hurt. Kanał WbSrvic wmaga od Przdsiębiorc Tlkomunikacjngo zapwninia własnj części infrastruktur nizbędnj do wmian informacji Format komunikatu Komunikat będą zapisan w stroni kodowj UTF-8. W clu umożliwinia kontroli postaci plików XML, Orang Polska przkaż Przdsiębiorcom Tlkomunikacjnm schmat XSD pozwalając na parsowani zawartości komunikatów przd ich wsłanim. Nalż zaznaczć, iż XML Schma ni pozwala na wrfikację wszstkich rguł zawartch w spcfikacji np. wmagalności pól w zalżności od wartości innch pól. Są to ogranicznia samgo standardu XML Schma. Dan konfiguracjn XML Dana root-tag namspac nampspac (dla komunikatu Wartość cbnp-mssag MWD Komunikat dla usług komrcjnch wrsja

20 ABORT w przpadku, gd w komunikaci tpu REQ brakowało pola intraction-id lub ordr-numbr. W takim wpadku ABORT ni zawira danch, którch ni otrzmał) 4.4 Kanał WbSrvic Kanał WbSrvic udostępnia możliwość przsłania komunikatów MWD w tchnologii WbSrvic Dan konfiguracjn kanału Do uruchominia kanału koniczn są następując dan konfiguracjn Dostarczon przz Orang-Hurt Orang-Hurt i PT Orang-Hurt i PT Orang-Hurt i PT Orang-Hurt i PT Orang-Hurt Orang-Hurt Orang-Hurt Orang-Hurt Orang-Hurt Orang-Hurt Orang-Hurt Orang-Hurt Spcfikacja WSDL Dana konfiguracjna URL pod jakim dostępn jst WbSrvic crtfikat SSL srwra crtfikat SSL klinta dan kontaktow do administratora sstmu (imię i nazwisko, nr tlfonu, adrs -mail) maksmaln rozmiar załącznika (po rozpakowaniu) maksmaln rozmiar paczki w komunikaci ATTACHEMENTS maksmalna liczba komunikatów produkcjnch w jdnostc czasu maksmalna liczba komunikatów tstowch w jdnostc czasu maksmalna ilość ponowiń prz braku ACK odstęp czasu pomiędz koljnmi ponowiniami komunikatu (brak ACK) maksmalna ilość ponowiń prz braku HTTP 200 OK maksmaln czas przz jaki ponawian jst komunikat (brak HTTP 200 OK) Spcfikacja tchniczna kanału komunikat MWD SOAP Protokół HTTP mtoda POST 1.1 Wrsja/Spcfikacja XML 1.0 kodowani UTF-8 WS-I Basic Profil 1.1 / On-Wa Opration Komunikat będą przkazwan w trbi asnchronicznm zgodni z zasadami komunikacji jdnokirunkowj (On-Wa Opration, komunikacja tpu "push") zawartj w spcfikacji Basic Profil MWD Komunikat dla usług komrcjnch wrsja

21 w wrsji 1.1 opublikowaną przz Wb Srvics Introprabilit Organization ( Sposób przsłania komunikatów w kanal Komunikat MWD będą przsłan w kanal uzupłnion o nagłówk SOAP. Sposób przsłu SOAP został pokazan poniżj Nadawca przsła komunikat SOAP do odbiorc. Komunikat podlga autorzacji nadawc. W przpadku braku autorzacji wsłan jst komunikat HTTP 401 (bz koprt SOAP). W przpadku przkrocznia dozwolonj ilości komunikatów w jdnostc czasu zwracan jst błąd HTTP 429 (Too Man Rqust). Obowiązują osobn limit dla komunikatów tstowch i produkcjnch. W przpadku poprawnj transmisji komunikatu SOAP odbiorca odsła nadawc komunikat HTTP 200 (bz koprt SOAP). Oznacza on jdni poprawn dostarczni komunikatu. Ni oznacza poprawności samgo komunikatu MWD. Ni oznacza on takż wsłania komunikatu ACK. Taki komunikat jst wsłan jako now komunikat SOAP. W kanal obowiązują nastpując zasad: odpowidź HTTP instancji srwisu ni moż zawirać koprt SOAP, ani tż innj trści (poza informacją statusową dotczącą transmisji HTTP) klint srwisu musi ignorować wntualną koprtę SOAP przkazaną w odpowidzi HTTP klint srwisu ni moż intrprtować pomślngo statusu transmisji HTTP (np. 200 bądź 202) jako uznani komunikatu za prawidłow cz tż przjęt do prztwarzania żądania powinn bć przkazwan do srwisu mtodą POST status przkazan w odpowidzi HTTP z stron srwisu oznaczając błąd oznacza błąd na poziomi transmisji i ni nisi informacji o wntualnch błędach żądania SOAP w przpadku poprawnj transmisji HTTP srwis udzili odpowidzi z statusm 200 MWD Komunikat dla usług komrcjnch wrsja

22 w przpadku braku poztwnj odpowidzi HTTP nadawca moż ponowić wsłani komunikatu, zakłada się 2-krotn ponowini z intrwałm 30 minut; jśli odbiorca nadal ni odpowi nadawca powinin zgłosić awarię ISI zgodni z odpowidnim procsm zdfiniowanm w [2]. Ilość ponowiń moż ulc zmiani w razi potrzb. srwis będzi akcptował w nagłówku SOAP (soap:hadr) znaczniki Mssag-Id oraz In- Rpl-To Poniżj zamiszczono przkładow komunikat SOAP wraz z trścią biznsową. Przkład pokazuj jdni sposób opakowania komunikatu biznsowgo poprzz nagłówki SOAP. Zgodność przkładu z spcfikacją komunikatów moż ni bć zachowana <soapnv:envlop xmlns:soapnv=" xmlns:tp=" <soapnv:hadr/> <soapnv:bod> <tp:documntrqust> <cbnp-mssag:cbnp-mssag xmlns=" xmlns:cbnp-mssag=" <msg-hadr> <intraction-id></intraction-id> <subjct-id>39999</subjct-id> <dst-subjct-id>0</dst-subjct-id> <ordr-numbr></ordr-numbr> <msg-vr>sor 4.3-1</msg-vr> <tst-vr>0</tst-vr> <stat>req</stat> </msg-hadr> <ordr-ins-inactiv> <ordr-tp>6</ordr-tp> <rcipint-nam>56</rcipint-nam> <customr-addrss> <cit-nam>katowice</cit-nam> <strt-nam>ścianowa</strt-nam> <proprt-numbr>3</proprt-numbr> <flat-numbr>9</flat-numbr> <postal-cod>10-846</postal-cod> </customr-addrss> <customr-nam>posti</customr-nam> <customr-contact> <nam>posti</nam> <phon-numbr> </phon-numbr> </customr-contact> <oprator-tchnical-contact> <nam>jan KOWALSKI</nam> <phon-numbr> </phon-numbr> </oprator-tchnical-contact> <implmntation-dat> </implmntation-dat> <customr-claim>0</customr-claim> <ordr-itm> <srvic-tp>1</srvic-tp> <voic> <voic-tp>1</voic-tp> <prslction> <prslction-dom>1066</prslction-dom> <prslction-int>1066</prslction-int> </prslction> </voic> </ordr-itm> MWD Komunikat dla usług komrcjnch wrsja

23 </ordr-ins-inactiv> </cbnp-mssag:cbnp-mssag> </tp:documntrqust> </soapnv:bod> </soapnv:envlop> Zasad bzpiczństwa przsłu danch w kanal Kanał WbSrvic wkorzstuj zabzpiczni trasmisji danch poprzz zastosowani protokołu HTTPS z uwirztlninim po stroni srwra i stroni klinta. Do uwirztlninia będą wkorzstwan crtfikat Przsłani plików w kanal WbSrvic W przpadku, gd polm komunikatu jst plik obowiązują następując zasad jgo przsłania: 1. Pol w komunikaci zawirając nazwę pliku jst tpu DOCUMENT 2. W ramach tj samj intrakcji plik (lub kilka plików) po spakowaniu do archiwum ZIP jst przsłan osobnm komunikatm ATTACHMENTS przd lub po wsłaniu właściwgo komunikatu, lcz z tm samm polm ordr-numbr oraz intraction-id w nagłówku MSG- HEADER 3. W ramach jdnj intrakcji odbiorca oczkuj na liczbę attachmnt-quantit komunikatów tpu ATTACHEMENTS oraz jdn komunikat biznsow (stat=req), po czm odsła komunikat ACK potwirdzając poprawność wszstkich komunikatów w intrakcji. Odbiorca zgłasza błąd do pirwszgo wkrtgo komunikatu. Nadawca ponawia komunikat, dla którch ni dostał potwirdznia dostarcznia, zgodni z ogólnmi zasadami ponawiania 4. Załączniki muszą bć kodowan w standardzi BASE64 5. Rozmiar załączongo do komunikatu ATTACHMENTS(spakowango) pliku ni moż przkroczć wartości konfiguracjnj (obcni 10MB). W przpadku większch plików, Nadawca musi podzilić plik korzstając z standardu ZIP i wsłać jako oddziln paczki (osobn komunikat ATTACHMENTS) 6. Przwiduj się możliwość przsłania następującch formatów plików PDF, JPG, RTF, DOC, TXT, XLS, TIFF. Przsłani innch formatów jst dozwolon natomiast jśli ich odcztani ni będzi możliw prz użciu oprogramowania wkorzstwango przz Odbiorcę, załącznik ni będzi bran pod uwagę prz procsowaniu zlcnia. Odbiorca i nadawca mogą uzgodnić rozszrzoną listę obsługiwanch formatów. 7. Wilkość pliku załącznika (po rozpakowaniu) przsłango kanałm WbSrvic ni moż przkroczć wartości 47,68 MB ( bajtów) 8. Nazw plików przsłanch w ramach komunikatów MWDK są ograniczon formatm oraz zakrsm dozwolonch znaków. Nazwa moż zawirać cfr oraz duż i mał litr, takż z polskigo alfabtu. Nazwa przsłango pliku moż zawirać rozszrzni, al ni jst to koniczn. Dozwolonmi znakami spcjalnmi są: spacja "\s", podkrślni "_", mślnik "-". Nidozwolon jst równiż wstawiani w nazwę pliku dwóch kropk obok sobi, co przntuj przkład: "aaa..bb.zip". Przkład przsłania plików Zakładam wsłkę dwóch plików a.doc oraz b.pdf jako załączników do komunikatu biznsowgo. W komunikaci biznsowm w polach fil-id (patrz DOCUMENT) nalż podać fil-id=a.doc oraz filid=b.pdf. Następni oba pliki mogą zostać spakowan do jdngo archiwum x.zip. Nazwę pliku x.zip nalż podać w polu fil-nam w komunikaci ATTACHMENTS. Jśli wilkość pliku x.zip jst większa niż 10 MB to nalż podzilić plik na mnijsz i wsłać jako osobn paczki. Opcjonalni do powższgo nadawca moż spakować każd plik osobno (a.zip i b.zip) i przsłać w jdnm lub w kilku komunikatach ATTACHMENTS Poniższ rsunk pokazuj scnariusz przsłania plików załącznika w dwóch paczkach Wartości X, Y nalż zastąpić wartościami liczbowmi zgodni z spcfikacją. Wartość attachmntguantit informuj o ilości paczk natomiast attachmnt-numbr jst numrm konkrtnj paczki. MWD Komunikat dla usług komrcjnch wrsja