Ändringshistorik

1. Ändringshistorik Dokumentet beskriver process- och interdialogregler i gränssnittet mellan TSS och entreprenörer. 2003-12-11 Ove Fritz C 2004-02-23 Lars Abrell D 2005-10-11 Per Rudal PE1 RenegOrder init av FNS uppdaterad, ny slide ExecuteOrder med OEAjusterade format (master slide), puts 2005-10-11 Per Rudal PE2 FNS ändrat till Supplier, puts av slide Villkor 2005-11-04 Per Rudal PE3 Nya slides Dialogöversikt o Affärsregler. ExecuteOrder med OEA borttagen tills vidare. 2005-11-04 Hans Guste PE3_1 Rubrik Affärsregler ändrad till Interdialogregler, Approved tillagt sid 1 2005-11-18 Anders Hultin PE3_2 Interdialogregler kommenterade efter internt Relacommöte 2005-12-07 Per Rudal PE4 Interdialogreglerna uppdaterade efter e-gs-forum 29/11.CancelOrder: ruta 6b, “ESN2”, är ny.RenegOrderBySup: ruta 12, “manuell hantering” är borttagen. 2005-12-23 Per Rudal PE5 Interdialogreglerna uppdaterade efter e-gs-forum 14/12 (h-regel 4, tillägg 4-6)Nya slides: 2 Transaktionsmönster, 3 Omsändning o larm 2006-01-16 Per Rudal PE6 Uppdatering efter e-gs-forum 11/1: slide 2, Transaktionsmönster; slide 3, Omsändning, heart-beat o larm; slide 11, Inderdialogregler 2, punkt 2, 3, 6. 2006-06-20 Per Rudal E Version för gränssnittsdokument J. PE7 utgår. Röd reservationstext i Interdialogreglerna borttagen. 2006-06-20 Per Rudal F Version för gränssnittsdokument K.Ny slide 9 RenegotiateOrder initierad av Supplier alt B. 2006-06-20 Per Rudal PG1 Dialog för leveransgodkännande, “ExecuteOrder med OEA” återinförd (jmfr PE1 o PE2 ovan) 2006-10-20 Per Rudal PG2 slide 3: Omsändning http-nivå Telia: 3*120s -> 7*4minslide 4 Dialogöversikt + slide 9, Reneg Supplier alt B + slide 11, EO m levgodk: version 3.1 -> 4.0 2006-11-08 Per Rudal G Version för gränssnittsdokument L

2. Transaktionsmönster NeBI Responder Initiator 1. B2B Application 2. Request (dialog + trans) B2B 3. ebMS service + action (=dialog + trans) 4. ebMS header validation Trans A 6. Ack / Error 5. MSHack / Error 7. Application 8. Request (dialog + trans) 9. Dialog X 10. 11. Request (dialog + trans) 12. ebMS service + action (=dialog + trans) 13. ebMS header validation Trans B 15. Ack / Error 14. MSHack / Error 16. Request (dialog + trans) 17. • Dialogen ovan är ett exempel. Dialogen X består av två transaktioner, A o B, vilka initieras från olika håll.En parts interna flöde bestäms av parten själv (inkl funktionsnamnen som i figuren bara är exempel). • Figurens fokus är det gemensamma NeBI-snittet vilket visar det transaktionsmönster alla transar i gränssnittet använder: • Transens request är ett http-request med ett ebMS-meddelande innehållande bl a ett affärsdokument, t ex Order • Transens svar är ett nytt http-request med ett ebMS-meddelande innehållande MSH-ack eller Error

3. Omsändning, heart-beat o larm Nedan beskrivs omsändningsmönstret i NeBI-snittet, heart-beat och de larm som parterna har riggat för (uteblivna) händelser i snittet. Alla värden är konfigurerbara. Aktuella värden är angivna. • Omsändning på http-nivåOm http-retur inte erhålls för ett http-request så sänder: • TSS om http-requestet var 4min7ggr • Eltel om http-requestet var 120s under 24h • Omsändning på transaktionsnivåOm inte MSH-ack (Message Service Handler Acknowledgment) för en trans inkommit, så sänder: • TSS om transen var 10:e minut under 24h (under förutsättning att http-retur erhålls, se 1 ovan) • Relacom om transenmed stegrande intervall under 24h • Eltel om transen var 10:e minut under 24h (under förutsättning att http-retur erhålls, se 1 ovan) • Heart-beatTSS sänder fiktiva order (även kallade Topaz-order) var 15:e minut för att kunna övervaka att flödet fungerar även vid gles normaltrafik. • Transaktionslarm • TSS Om inte OA inkommer till TSS inom X minuter efter att OR sänts,så larmas ett antal användare hos TSS via mejl (s k 15-minuterslarm).Tiden är konfigurerbar per avtal. • Relacom kommer att övervaka TSS heart-beat • Eltel kommer att övervaka TSS heart-beat

4. Dialogöversikt • NegotiateOrder [nebi.biz:BC:NegotiateOrder_3.0] • RenegotiateOrderinitierad av TSS [nebi.biz:BC:RenegotiateOrder_3.0] • CancelOrder [nebi.biz:BC:CancelOrder_3.0] • RenegotiateOrderinitierad av Supplier alt A [nebi.biz:BC:RenegotiateOrder_3.0] • RenegotiateOrderinitierad av Supplier alt B [nebi.biz:BC:RenegotiateOrder_4.0] • ExecuteOrder [nebi.biz:BC:ExecuteOrder_3.0] • ExecuteOrder med leveransgodkännande [nebi.biz:BC:ExecuteOrder_4.0]

5. NegotiateOrder[nebi.biz:BC:NegotiateOrder_3.0] Supplier api NeBI TSS api TSSApplication TSS B2B Supplier B2B Supplier Application Lämna (Beställning) BTA:OrderRequestByBuyer 1. Konvertering Lämna (Beställning) 2. Konvertering 3. Kan ordernutföras? Avvisa (Beställning) BTA:DialogueCancellationBySupplier 4. Konvertering 5. Konvertering Avvisa (Beställning) 6. Orderbekräfta! Acceptera (Beställning) 7. Konvertering BTA:OrderAcknowledgment BySupplier 8. Konvertering Acceptera (Beställning)

6. RenegotiateOrder initierad av TSS[nebi.biz:BC:RenegotiateOrder_3.0] Supplier api NeBI TSS api TSSApplication TSS B2B Supplier B2B Supplier Application Ändra(Beställning) BTA:OrderUpdateRequestByInitiator 1. Konvertering Ändra(Beställning) 2. Konvertering 3. Kan ordern ändras? Avvisa (Orderändring) BTA:DialogueCancellationByResponder 4. Konvertering 5. Konvertering Avvisa (Orderändring) 6. Bekräftaändring Acceptera (Orderändring 7. Konvertering BTA:OrderUpdate AcknowledgmentByResponder 8. Konvertering Acceptera (Orderändring)

7. CancelOrder[nebi.biz:BC:CancelOrder_3.0] Supplier api TSS api NeBI TSSApplication TSS B2B Supplier B2B Supplier Application Avbryt(Beställning) BTA:OrderCancellationRequest 1. Konvertering Avbryt(Beställning) 2. Konvertering 3. Kanmakuleringenutföras? Avvisa (Makulering) BTA:DialogueCancellationByResponder 4. Konvertering 5. Konvertering 6a. Bekräftamakulering Avvisa (Makulering) Acceptera (Makulering 7. Konvertering BTA:OrderCancellation • 6b. • Om Supplier vill ta betalt för den maku-lerade ordern sätts Reason.Name till 'faktureras’. • I en annan dialog (ExecuteOrder) sänder Supplier ESN2.I så fall behöver inte 6a utföras. 8. Konvertering Acceptera (Makulering)

8. RenegotiateOrder initierad av Supplier alt A[nebi.biz:BC:RenegotiateOrder_3.0] Supplier api NeBI TSS api Supplier Application Supplier B2B TSS B2B TSS Application Ändringsbegäran (Beställning) BTA:OrderUpdateProposalRequestByInitiator 1. Konvertering Ändringsbegäran (Beställning) 2. Konvertering 3. Kan ordern ändras? Avvisa (Ändringsbegäran) BTA:DialogueCancellationByResponder 4. Konvertering 5. Konvertering Avvisa (Ändringsbegäran) 6a. Ändra order! Ändra (Beställning BTA:OrderUpdate RequestByResponder 7. Konvertering 6b. Supplier OUPR avser makulering. Dialogen avslutas. TSS inleder ny dialog, CancelOrder. 8. Konvertering Ändra (Beställning) 9. Kan ordern ändras? Avvisa (Orderändring) BTA: DialogueCancellationByInitiator 10. Konvertering Avvisa(Orderändring) 11. Konvertering 13. Bekräftaändring Acceptera (Orderändring) BTA: OrderUpdate AcknowledgmentByInitiator 14. Konvertering Acceptera(Orderändring) 15. Konvertering

9. RenegotiateOrder initierad av Supplier alt B[nebi.biz:BC:RenegotiateOrder_4.0] TSS api NeBI Supplier api Supplier Application Supplier B2B TSS B2B TSS Application Ändra(Beställning) BTA:OrderUpdateRequestBySupplier 1. Konvertering Ändra(Beställning) 2. Konvertering 3. Kan ordern ändras? Avvisa (Orderändring) BTA:DialogueCancellationByBuyer 4. Konvertering 5. Konvertering Avvisa (Orderändring) 6. Bekräftaändring Acceptera (Orderändring 7. Konvertering BTA:OrderUpdate AcknowledgmentByBuyer 8. Konvertering Acceptera (Orderändring)

10. ExecuteOrder[nebi.biz:BC:ExecuteOrder_3.0] Supplier api NeBI TSS api Supplier Application Supplier B2B TSS B2B TSS Application ESN1 sänds för varje statusförändringföre status ’Arbetsrapport’ Meddela (Status) BTA:ExecutionStatusNotification (1) 1. Konvertering Meddela (Status) 2. Konvertering Meddela (Arbetsrapport) BTA:ExecutionStatusNotification (2) 3. Konvertering Meddela (Arbetsrapport) 4 Konvertering Meddela(Åtagande klart) BTA:OrderExecuted 5. Konvertering Meddela(Åtagande klart) 6. Konvertering

11. ExecuteOrdermed leveransgodkännande[nebi.biz:BC:ExecuteOrder_4.0] Supplier api NeBI TSS api Supplier Application Supplier B2B TSS B2B TSS Application Meddela (Status) BTA:ExecutionStatusNotification (1) 1. Konvertering Meddela (Status) 2. Konvertering Meddela (Arbetsrapport) BTA:ExecutionStatusNotification (2) 3. Konvertering Meddela (Arbetsrapport) 4 Konvertering Meddela(Åtagande klart) BTA:OrderExecutedRequest 5. Konvertering Meddela(Åtagande klart) 6. Konvertering 7. Äråtagandet klart? Avvisa (Åtagande klart) BTA:OrderExecutedDenial 8. Konvertering Avvisa (Åtagande klart) 9. Konvertering 10. Bekräfta åtagande klart Acceptera (Åtagande klart) 11. Konvertering BTA:OrderExecutedAcknowledgment 12. Konvertering Acceptera (Åtagande klart)

12. Interdialogregler 1 Inom varje dialog illustreras processreglerna av sekvensdiagrammen i föregående bilder. Interdialogregler, dvs regler för hur olika dialoger mot samma order får agera, beskrivs i de följande punkterna. • Huvudregler • Första dialogen för varje order är NegotiateOrder • Samtidigt pågående dialoger mot en och samma order är tillåtet • Efter OrderExecuted ska inga fler transaktioner mot ordern förekomma • En order identifieras av dess OrderId vilket ska vara uniktInfo: Regeln innebär att varje NegotiateOrder-dialog ska behandla en ny order med unikt orderId. Om en ny unik order avvisas genom att dialogen NegotiateOrder avbryts med DialogueCancellation, så betyder det att ordern inklusive dess orderId inte existerar. Den avvisade orderns orderId är därmed fritt att användas i en ny order i en ny NegotiateOrder-dialog, vilket inte betraktas som en omsändning av ordern.

13. Interdialogregler 2 • Undantag, tillägg o förtydliganden • Dialogen NegotiateOrder måste slutföras innan ExecuteOrder får inledas[OA före ESN/OE]Info: Brott mot regeln förekommer av tekniska skäl eftersom IT-komponenterna mellan ändpunkternas affärssytem inte alltid klarar att upprätthålla affärssytemens ursprungliga transaktionssekvens. Skälet är att IT-komponenterna innehåller parallella exekveringstrådar. Problemet är vanligast vid återhämtning efter stopp. • ESN2/OE får ej skickas under pågående RenegOrderBySupInfo: Om RenegOrderBySup drar ut på tiden så kan Supplier kontakta TSS via andra kanaler. • Arbetsrapport Klar (ESN2) bekräftar makuleringsbegäran (OCR)[ESN2 = OC + ESN2]Förtydligande: Supplier behöver inte besvara OCR med OC om Supplier skickar ESN2 i dialogen ExecuteOrder, se även flödet CancelOrder. • I dialogen RenegOrderBySup får en orimlig orderändring (OUR) som svar på OUPR avvisas av SupplierInfo: Fortsatt statusrapportering (ESN/OE) är tillåtet, men kan inte hanteras av TSS. Manuella rutiner fungerar. • En ny dialog RenegOrderBySup får inledas medan en RenegOrderBySup pågår.Info: TSS kommer att avvisa den nya RenegOrderBySup. Supplier får invänta den pågående dialogens slut eller kontakta TSS via andra kanaler för att gå vidare. • Omsändning av en order är tillåtet om resend-flaggan är satt.Info: Omsändning innebär att orderinnehållet är identiskt bortsett från resend-flaggan. Omsändning används när en order behöver sändas via den ordinarie kanalen då den redan nått Supplier via en reservkanal.