Seitenvergleich

...

Titel	Auftrag (Providerwechsel / Verbundleistung) anlegen
Kurzbeschreibung	Folgender Ablauf beschreibt die typischen API Interaktionen zwischen dem aufnehmenden Auftrageber (EKPauf und TNBauf, aka AGauf), dem Leistungserbringer (LE, aka ANE) und dem abgebenden Auftraggeber (EKPab und TNBab, aka ABab) für die Anwendungsfälle "Auftrag (Providerwechsel / Verbundleistung) anlegen - Schlechtfall Negative RespondProviderChange (RUEM-PV)". Zu diesen Anwendungsfall sind zwei Sequenzen relevant: Die Vorabstimmung Die Durchführung
Vorbedingung	Rahmenverträge und Dienstverträge sind vorhanden Der Auftraggeber hat die Verfügbarkeit des Produktes geprüft der AGab hat sich beim LE für Kündigungen durch den Leistungserbringer registriert (siehe Auftrag (Kündigung durch LE, GF PV/VBL) anlegen)
Auslöser	Der aufnehmende Auftraggeber legt einen Auftrag für den Providerwechsel bzw. die Verbundleistung beim Leistungserbringer (ANE) an. Schlechtfall:Am Schalttag kann die Bereitstellung nicht erfolgen.
Ergebnis	Der Leistungserbringer fordert beim aufnehmenden Provider Auftraggeber einen neuen Termin an (Status "Pending" - Information Required (TAM)) Der Leistungserbringer sendet an den abgebenden Provider Auftraggeber eine Verzögerungsmeldung (ProcessingMessage JeopardyMessage "OrderDelayorderDelay", (VZM-PV)) Nach erfolgter Terminverschiebung durch den aufnehmenden Provider Auftraggeber sendet der Leistungserbringer an den abgebenden Provider Auftraggeber eine Information über den neuen Bereitstellungstermin: ProcessingMessage MilestoneEvent "orderConfirmationUpdate", (erneute ABM-PV) Der weitere Verlauf wird hier nicht mehr betrachtet.

...

Variante erfolgreiche Schaltung nach Terminanforderung

Img

src

//www.plantuml.com/plantuml/png/xLP1Knen5BxpAzvumfa5bD4wPMeh87QeKYaWXpeUmkQnPCmcssm2qj_MM_zOiyiAPX6fEXuwKmvCsBpllU_xNlAMarWJfKt82yHeAKmuGbM0x5COoJiOTCxULQlGLP8QNyEbegWyy8d6GAhvSNTOY6m6vhE820r8p1X833iDCqS5SWm2Py2PmDe2oaImuo3qFQAFdESXRjbreDgCx67iJv0QZhaahhnj-WQeGYQ8PbBOa2cpkmuBZcIK8o4v_Ilw8zSe2yiRjQAwNAG6bpwcwclGlUmFxekag6Bqu4TROzXKI3HwCAotwUu2_Q5Kok3LlNrO1D0YyM-5d76a0Tf08JM2Oi54soB3f7o6pQ1EqRucsiJD2H41jgOeTB5xwK7Tzp7I-MJVMes2pZGatjN0xhBn_FogjOYJKrJfZWSwsJvb27tyOL3yXElhYTPHNAjKV2d6t3xpiQnByJosIkDI6CPbD9M811XNfWndoQfC_AHvdv9rcnuV7XozFppQFzY3kXbhHG8edl_-9IWBZ0Y06kLFuABbmUSpgxioR5pi0X4S0nGtDp1ZYiA4eG8cRhcXTgKB2LUh9hLbeQLtrUgKkiCYYMmtfeHxe934KYpztzIzkjQAZOp68R7Y7XhgceZbe6o_xoBqDTAc32EEYSXJed5Bdp3NfhQm4O72E7PBr1iTfq-Pj5NulUwqIs-YnAcmzS1LFNX2Yst7Cus9K50c0ZVJeFweAwV8oHpfPi9VK4P4qNcTez8TIv0un6KIaoPnoms_Ro7U5cEfmdGwzUmTOGhfKe2o3p1USzM3vSQ0XTZdKkywKqLb1tCrG1zMT4U8Ucg6P97RawxxprQTVFcTiHx0HXFitPHCwD06leefbGB_eNlz_rvdNFBlfLRlub5Zbk7FPlr4eNNMhpGw_zOlPm_AwT-x5noV9fVn6lElWySjih6kFs-d1mLzqH7Qf2Vfn8bDQaB-1m00

...

language	text
collapse	true

...

Bitbucket file macro

url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/ProviderChange_FailedOnSwitchDay.puml
syntaxHighlighting	PlantUML

Beispieldaten (linker Block, TNBauf ↔ ANE)

...

Erweitern

title	5) ProductOrderStateChangeEvent: inProgress - identisch zu Gutfall und Geschäftsfall Neu

...

ProductOrderStateChangeEvent: pending

...

(11)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-4c-state-change-event-pending.json
showLineNumberssyntaxHighlighting	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

ProductOrderStateChangeEvent: pending
fachliche Felder	Daten	API Felder
Orderstatus	pending	state
fachliches Änderungsdatum	2022-12-16T11:30:00+01:00	stateChangeDate
technisches EventDatum	2022-12-16T11:30:00+01:00	eventTime
Grund der Änderung	6001 "Endkunde nicht angetroffen"	stateChangeReason.code stateChangeReason.description

11) ProductOrderInformationRequiredEvent

...

ProductOrderInformationRequiredEvent (14)

Bitbucket file macro

cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-5b-information-required-event-requested-completion-date.json
showLineNumbers	true
collapsible	true
applicationLink	syntaxHighlighting	JSON

fachliche Felder

Daten

API Felder

Feld, zu dem eine Information benötigt wird

/requestedCompletionDate

replace

fieldPath.path

fieldPath.typeOfChange

...

POST RescheduleProductOrder

...

(15)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/reschedule-product-order-provider-change-0.json
showLineNumberssyntaxHighlighting	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

fachliche Felder

Daten

API Felder

Verschobener Kundenwunschtermin

2022-12-19T12:00:00+01:00

rescheduledRequestedCompletionDate

Wunschzeitfenster

2022-12-19T08:00:00+01:00

2022-12-19T12:00:00+01:00

productOrderItem.requestedTimeSlot.validFor.startDateTime

productOrderItem.requestedTimeSlot.validFor.endDateTime

...

POST RescheduleProductOrderStateChangeEvent:

...

inProgress (17)

Bitbucket file macro

collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

...

13b) POST RescheduleProductOrderStateChangeEvent: inProgress

Stashincludebyfilepath

tmf622/examples/ftth-no-opts

repoSlug	fit-root
branchId	refs/heads/main
projectKey	TFIT
filepath	url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/reschedule-product-order-provider-change-2-state-change-event-in-progress.json
showLineNumberssyntaxHighlighting	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

fachliche Felder	Daten	API Felder
technisches EventDatum	2022-12-16T11:40:10+01:00	eventTime
Orderstatus	inProgress	event.rescheduleProductOrder.state
Orderstatus Änderungsdatum	2022-12-16T11:40:10+01:00	event.rescheduleProductOrder.stateChangeDate

...

POST ProductOrderAttributeValueChangeEvent

...

(18)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-6b-attribute-value-change-event-requested-completion-date.json
showLineNumberssyntaxHighlighting	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

fachliche Felder

Daten

API Felder

technisches EventDatum

2022-12-16T11:40:20+01:00

eventTime

Kundenwunschtermin

2022-12-19T12:00:00+01:00

event.productOrder.requestedCompletionDate

Wunschzeitfenster

2022-12-19T08:00:00+01:00

2022-12-19T12:00:00+01:00

event.productOrder.productOrderItem.requestedTimeSlot.validFor.startDateTime

event.productOrder.productOrderItem.requestedTimeSlot.validFor.endDateTime

...

POST RescheduleProductOrderStateChangeEvent: done

...

(19)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/reschedule-product-order-provider-change-3-state-change-event-done.json
showLineNumbers	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting	JSON

fachliche Felder	Daten	API Felder
technisches EventDatum	2022-12-16T11:40:20+01:00	eventTime
Orderstatus	done	event.rescheduleProductOrder.state
Orderstatus Änderungsdatum	2022-12-16T11:40:20+01:00	event.rescheduleProductOrder.stateChangeDate

16) ProductOrderAttributeValueChangeEvent

...

ProductOrderAttributeValueChangeEvent (20)

Bitbucket file macro

cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-7-attribute-value-change-event-expected-completion-date.json
showLineNumbers	true
collapsible	true
applicationLink	syntaxHighlighting	JSON

fachliche Felder

Daten

API Felder

technisches EventDatum

2022-12-16T11:40:25+01:00

eventTime

Verbindlicher Liefertermin

2022-12-19T12:00:00+01:00

event.productOrder.expectedCompletionDate

Vereinbartes Zeitfenster

2022-12-19T08:00:00+01:00

2022-12-19T12:00:00+01:00

event.productOrder.productOrderItem.appointment.validFor.startDateTime

event.productOrder.productOrderItem.appointment.validFor.endDateTime

...

ProductOrderStateChangeEvent: inProgress

...

(21)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-8-state-change-event-in-progress.json
showLineNumbers	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting	JSON

ProductOrderStateChangeEvent: inProgress
fachliche Felder	Daten	API Felder
Orderstatus	inProgress	state
fachliches Änderungsdatum	2022-12-16T11:40:30+01:00	stateChangeDate
technisches EventDatum	2022-12-16T11:40:30+01:00	eventTime
Grund der Änderung	0011 "Montage beim Endkunden erforderlich."	stateChangeReason.code stateChangeReason.description

...

ProductOrderStateChangeEvent: completed

...

(25)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-9-state-change-event-completed.json
showLineNumberssyntaxHighlighting	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

ProductOrderStateChangeEvent: completed
fachliche Felder	Daten	API Felder
Orderstatus	completed	state
fachliches Änderungsdatum	2022-12-19T10:00:00+01:00	stateChangeDate
technisches EventDatum	2022-12-19T10:00:00+01:00	eventTime
Grund der Änderung	0010 "Auftrag ausgeführt."	stateChangeReason.code stateChangeReason.description

vor 24) ProductOrderAttributeValueChange

...

ProductOrderAttributeValueChange (28)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-10-attribute-value-change-event-start-date.json
showLineNumbers	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting	JSON

ProductOrderAttributeValueChange (setzen von startDate)
fachliche Felder	Daten	API Felder
technisches EventDatum	2022-12-19T10:00:30+01:00	eventTime
Nutzungsdatum	2022-12-19T10:00:00+01:00	product.startDate

...

ProductOrderStateChangeEvent: closed

...

(29)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-11-state-change-event-closed.json
showLineNumberssyntaxHighlighting	true
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

ProductOrderStateChangeEvent: closed
fachliche Felder	Daten	API Felder
Orderstatus	closed	state
fachliches Änderungsdatum	2022-12-19T10:01:00+01:00	stateChangeDate
technisches EventDatum	2022-12-19T10:01:00+01:00	eventTime
Grund der Änderung	0010 "Auftrag ausgeführt."	stateChangeReason.code stateChangeReason.description

Variante LineInUse

...

Bitbucket file macro

collapsible	true

...


url	https://

...

bitbucket.

...

Img

src

//www.plantuml.com/plantuml/png/dPFDJjj04CVlVeeH5PAjsgIb85JK3v9WQ9G05Wa-575OUoUELNlNtO_GzDbwwujrrt52N8WGvEA9P_ypl_dl-4Gg8fGk2uTenPak4nGEs9-Jy5yG2Kvrgk1AK1GmvoLC5XL4CRZHbUTKHfgdUKMO0YHw2aJ2JZYCmCPlONBPgoEtUswVtavBe5Q2xcK8xYYiJsoq1dUi4-zfWE5D68n22x7VfYYG9AsYoQEkotpDbXX8WskUDMAoxbyF4tof6OyXkXfFLaxK76wryMUWiEmB90fzYBi3wZcCAmIHPpDbjB6pglSfMDNRK8yLKLhsPuHb6CwHAJEJ3ztq1-Ft1MPeoga6nivs3APuFbqO0vPj-1n5dV51sVHfZZ36dnhPRu3RsvbIbJpkT5BEfeLvcUAU2kH26cOPbANSGzsfI8QoCy_ntaPx95KvPrzjFA2V3m-EFXuUlJzuzwQhfqgGp1tkzZ_izlgCvfbc6TKYdOr2__miYZjnR-GHPh5Py8rKrI8YQWQD4DpXtp-D2ceP61sSdy5IwKCjWSfeF6ZAtDt1VIuep78KaBEqqDH4oh4J6qzgFvUEND-45q4KkwQ6u7DI-22GICuyvpdxyJ_t1yoSo0HAsVQ-QVIGNb5Ovv-_rNqV7gJj9UdsBFeBCIiqPh9i6-CokntHnAa1CMSkp8EqE2aMPD6yRfF6tvyX7R0f5oMnAtHjrZ0NIDV4mkwbL4ZxlAmAj6TEYKBlgS-jNt29cuNRFTk7jlj4cW-9PaXzoDV-cnavG-_rc_52PJCnqYtNjSw_UAVMolP5XTUZL-oKDNGxeqc-1j387j5TJcgw4sHKbyK_

→ gemäß Absprache in UAG01:

org/fit-api/fit-api/src/main/tmf622/assets/ProviderChange_FailedOnSwitchDay_WithLineInUse.puml
syntaxHighlighting	PlantUML

hierzu wird kein Beispiel erzeugt

Variante Cancel

Codeblock

collapse	true

@startuml
autonumber
     
box Product Order vom Typ PV (PO)
participant eauf as "EKP auf + TNB auf (AG auf)"
participant tauf as "ANE (LEauf)"
     
box  (Sub)Product Order vom Typ KUE-LE (PO2)
participant leab as "ANE (LEab)"
participant tab as "TNB ab + EKPab (AG ab)"
     
eauf -> tauf: POST ProductOrder(productOrderItemCreate, VAId)
note right: PV
  
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Acknowleged)
tauf -> leab: notifyKUE
note over leab, tab: Die Sequenz  [[https://confluence.t-systems-mms.eu/pages/viewpage.action?pageId=547957140#Auftrag(K%C3%BCndigungdurchLE,GFPV/VBL)anlegen-HappyPath Auftrag (Kündigung durch LE, GF PV/VBL, Happy path) anlegen]] wird hier includiert
leab ->tauf:notifyRUEM-PV(approval, reason)
 
eauf <- tauf: ProductOrderStateChangeEvent(PO,InProgress)
tauf -> leab:notifyInProgress
leab -> tab: ProductOrderStatusChangeEvent(PO2, InProgress)
note right: ABM-PV
eauf <- tauf: ProductOrderStateChangeEvent(PO,pending)
tauf -> leab:notifyInPending
leab -> tab: ProductOrderProcessingMessageEvent(PO2, delayMessage)
note right: VZM-PV
eauf <- tauf: ProductOrderInformationRequiredEvent(PO,requestedCompletionDate)
eauf -> tauf: POST CancelProductOrder
eauf <- tauf: POST CancelProductOrderStateChangeEvent(acknowledged, inProgress)
eauf <- tauf: ProductOrderStateChangeEvent(PO,assessingCancellation)
eauf <- tauf: ProductOrderStateChangeEvent(PO,Cancelled)
eauf <- tauf: POST CancelProductOrderStateChangeEvent(done)
tauf -> leab:notifyFailed
leab -> tab: ProductOrderStatusChangeEvent(PO2, failed)
note right: ABBM-PV
@enduml

Img

src

//www.plantuml.com/plantuml/png/dPFRJjj048Rl_HGZAYHRjKbBGQYe1v9WQ9G05W5V576nzawSLUrTTm-XwRFrhY_MzI44eo2KvcOdk_lFVFFl-4Hf8hKfSeSOBRWf4fGEL3yd4RyWaeAQLCELf2XX8GguMPOGnU16LvvJMYbBMKcu1YHc1aJ1JZYEe8hVmitbe8xS_dcrUZiTWLu9-fSXk9EmkR4k3UxK9DvcWF5j64p22cA_Iv4ZIJf9a-TLs_EQBR6G5jUkDMBoMBzk9lXICnv3T3MzMJbHSxZbapyZZSLG8j7eGzmVKS_XGYD8bisrrSREAj-deCdNIJNLH1ird1EUORX0hcrFFlJJ7rmyv9YXJQSRcBgtOx39sMnf3MZAY0NA-iG7NHsVCeGf_ZJ8VmFStSsrBjLnhvSAFiljPefxEb1BPPbLK1Hg3qsl91cgteBXGnNjaLGpmRzMyOX-FZmu-dXuzFxWtPk-cMb9CdUyE_omEnXooZB3CsfaEf-4_lbP5FVYmSGZlCBcmJTIbik8w3cqGd37V_-qAgXbO7LmVWQDqeTQ0gNLUD2ckR-71oOfp1bAO3pD3RMHTggEhIUrduqZrxVXHH35hiqXnOBaFaWaId3FUSr-VER-YDiRcKIbkjwtXTR7AuhA-TTVTT-7jRGx9Fr1XRubPedMJ9wznDYSleneuzI2s3iNTY4TJeevMRRRNTBu-oka8puJiY3L25tRCMGIwIEnj1keDDAXACeSgpkdHAEtwNCR4fvY_ZHpf-YcMvkT8ksdH3EaFh3r2snfDr6giQkfcTSjRfkarIBr_hCRAZXkVF4pmcpQhIToLikUJsCpZYV8gIdoVm00

→ gemäß Absprache in UAG01:

Bitbucket file macro

url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/ProviderChange_FailedOnSwitchDay_WithCancel.puml
syntaxHighlighting	PlantUML

hierzu wird kein Beispiel erzeugt

...

Versionen im Vergleich

Alte Version 53

Neue Version Aktuell

Schlüssel

Variante erfolgreiche Schaltung nach Terminanforderung

Beispieldaten (linker Block, TNBauf ↔ ANE)

ProductOrderStateChangeEvent: pending

(11)

11) ProductOrderInformationRequiredEvent

ProductOrderInformationRequiredEvent (14)

POST RescheduleProductOrder

(15)

POST RescheduleProductOrderStateChangeEvent:

inProgress (17)

13b) POST RescheduleProductOrderStateChangeEvent: inProgress

POST ProductOrderAttributeValueChangeEvent

(18)

POST RescheduleProductOrderStateChangeEvent: done

(19)

16) ProductOrderAttributeValueChangeEvent

ProductOrderAttributeValueChangeEvent (20)

ProductOrderStateChangeEvent: inProgress

(21)

ProductOrderStateChangeEvent: completed

(25)

vor 24) ProductOrderAttributeValueChange

ProductOrderAttributeValueChange (28)

ProductOrderStateChangeEvent: closed

(29)

Variante LineInUse

Variante Cancel