Inhalt

Beschreibung

Titel	Auftrag abbrechen
Kurzbeschreibung	Folgender Ablauf beschreibt die typischen API- Interaktionen zwischen Auftraggeber Auftrageber und Leistungserbringer im Anwendungsfall "Auftrag abbrechen". Der Leistungserbringer bricht Auftragsrealisierung die Auftragsbearbeitung ab und meldet dem Auftraggeber den Abbruch zurück. Dabei werden die für diesen Ablauf erforderlichen Auftrags-Status durchlaufen und die für diesen Ablauf relevanten Informationen übermittelt.
Vorbedingung	Der abzubrechende Auftrag wurde angelegt und ist noch nicht abgeschlossen ( d.h. der Auftrag befindet sich initial nicht in den Auftrags-Status closed, rejected or failed)
Auslöser	Folgende Auslöser des Auftragsabbruches können vorkommenEs gibt folgende Auslöser eines Auftragsabbruchs: Negative kaufmännische Validierung (nach dem Auftrags-Status acknowledeged) Negative technische Validierung / ErteilungErteilung (nach dem Auftrags-Status accepted) Erfolglose Terminanforderung (TAM und MTAM), (nach dem Auftrags-Status pending) Scheitern der AuftragsrealisierungAuftragsrealisierung (nach dem Auftrags-Status inProgress)
Ergebnis	Die Bereitstellung wurde abgebrochen und der Abbruch dem Auftraggeber gemeldet

Ablauf

...

Untervariante "Auftrag Providerwechsel und Verbundleistung" abbrechen

Happy Path siehe hier: Auftrag (Providerwechsel / Verbundleistung) anlegen

Im folgenden sollen die Auswirkungen eines Abbruchs auf einen PV bzw. eine VBL dargestellt werden.

Im Fall

Erfolglose Terminanforderung (TAM und MTAM)
Scheitern der Auftragsrealisierung

gibt es keine besondere Einflüsse:

AKM-PV und RUEM-PV sind bereits ausgetauscht
die RUEM-PV war positiv
Der Statuswechsel Rejected bzw. Failed wird auf beide POs propagiert.

Erfolgt die Ablehnung aufgrund der Validierungen, ist das Zusammenspiel jeweils wie folgt:

Kaufmännische Validierung

Es kommt nicht zum Einstellen einer "Kündigung durch den LE":

Img

src	//www.plantuml.com/plantuml/png/LOvTIiD058NVPnM7FasmtO2864kGeZI33Nc_JQvjnFbXSgVeRhgMhinsQg32m9mBv_iuJwDGb6I_52NnBjajHtKwggt_Xec-JvsWZZr77Bn5ynDWMcXJ5ogSkQ4R0Za1K_e0ZPXLhmQNV8Tc_PoJBbykVp7x1yW4bEiA-gswDax7lvTzYyTSkuUfDyqq9c_HuUPO2TjbP1AUeorNVQ6S5qOSTdivi-rLzh2OP3VeHaZIkDoJst5rO2VQr7EyyoTtmdtn2m00

Codeblock

language	text
title	Abbruch PV während der kaufm. Validierung
linenumbers	true
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)"
 
 
 
eauf -> tauf: POST ProductOrder(productOrderItemCreate, VAId)
note right: PV
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Rejected)

Technische Validierung

Img

src

//www.plantuml.com/plantuml/png/bP7FZfim4CRlFCLeJw0kFUIuwbObMrH5IHChIRdRC12tO5Ddd3PlqsVfazKOMOB-IHK9oSRszytlctbt9cx8Tct4BMbbEu4c-laZ4lexCAChMnBiJ8K6Bhg3uxK7La3CTadKEvqiPSyL0N9R0p_3GxvcCEnVmN6xzBiu-p2ioSDCG46GRNE8Dxb_4Uf2VB0Y-NlrzQSytUG3mMAEq28NCqVnHydnteC9H-XOtUhvn5ZSVJv9-jO3FW7R7OwX3PuZxYS_AyBknI0dV8GYMrL9f3GX6DcSo6cBqUnD6imcqWDnikUN4rSDvXTKv08zGbP-KVfRYmqwBnf9VB0dSCwolhhqaGyQpaV2suZliSK1iNIWZJRNvx67YKiRl8YBETyOgmfeYsJwzFzH5hCizuiPgaggvePmfMfjEavIgpr-jT9WDT7N4jkASJezJvlnsesUYwntPnVUpgULhJ-ch82xHxR7prZIl-OLRkzkG13-1hbS3fI_0000

Codeblock

language	text
title	Abbruch eines Providerwechsels während er technischen Validierung
linenumbers	true
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
leab -> leab: POST  ProductOrder(productOrderItemDelete, category=KUE-LE) 
leab -> tab: ProductOrderCreatedEvent(PO2)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Acknowleged)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Pending)
leab -> tab: ProductOrderInformationRequiredEvent(PO2, fieldPath=productOrder.TNBabApproval)
note right: AKM-PV 
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Rejected)
tauf -> leab: notifyRejected
leab -> tab: ProductOrderStatusChangeEvent(PO2, Rejected)
note right: ABBM-PV

Untervariante "Kündigung durch LE, GF PV und VBL" abbrechen

Happy Path siehe Auftrag (Kündigung durch LE, GF PV/VBL) anlegen

Keine rechtzeitige RUEM-PV

Schickt der AG die RUEM-PV nicht rechtzeitig, wird die Kündigung vom LE zurückgewiesen.

Auch der Eltern-Auftrag PV bzw. VBL wird dann zurückgewiesen (hier nicht dargestellt).

Img

src	//www.plantuml.com/plantuml/png/bP11JiCm54JtESLNLutKic1PgOYqHAXg8LOJsF_4lud1iOFp7UXjE0idemqL2aWWLVB6utap8r-tZ8vzhGFqR8slStB1ntkGspU0SUhpK3WhVS6GE4aEEbj3jczW_H1FDp6CHN8P1WqwLeLgq31emXomXT4c7lruu9CUtOuE1SVJMwTNFJ83aQGPmAcjBnitWykAgRuXJKmJA92fj6u__reH3hAuZnfmIqV89EEE3FTh_xQcZEpRPOMcf6__1ABYsTXNJIN9ys51HYfJ_WEkpCww6bbPiwKNhnp90RzJfAL0hkR3pxZ8xXUOHyr1wr27WR5Cu5HPyGoYzTrKF9uzT4jFL339Ns6BnJ7j4m00

Codeblock

language	text
title	Keine rechtzeitige RUEM-PV
linenumbers	true
collapse	true

@startuml
autonumber
 
box  (Sub)Product Order vom Typ KUE-LE (PO2)
participant leab as "LE"
participant tab as "AG"
 
 
leab -> leab: POST  ProductOrder(productOrderItemDelete, category=KUE-LE) 
leab -> tab: ProductOrderCreatedEvent(PO2)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Acknowleged)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Pending)
leab -> tab: ProductOrderInformationRequiredEvent(PO2, fieldPath=productOrder.TNBabApproval)
note right: AKM-PV
leab -> tab: ProductOrderStatusChangeEvent(PO2, Rejected)
note right: ABBM-PV

Ablehnung der RespondProviderChange durch LE

Der LE kann die Task Resource ablehnen.

Die Kündigung ( und der sie auslösende PV- bzw. VBL-Auftrag) werden dann vom LE zurückgewiesen.

Img

src

//www.plantuml.com/plantuml/png/bP31JeD048RlFCMa9qYA1u-DDT9AJDDg2Msz3-oKhi8kBaErR-Ep-6HIm6QRg4aJBkpCz____7SLe-6wo1siMQkwICWuNvzEeZy0t5MTU97HeauPbaQGWRqkO7qeORu9_KK8RhIyzfmI3SjKbgWOSi84i8B18XoS3RX_3nu6HuFcQrVzsnOPGRHShG5wjzRCBQsV6LDnJpan3I55faoRmxXBuLbQt4fPtDGGCebmJugxj7-khXYvhgOxL1cTzeSGfAzAl-UKaRWSZaW9gR9_m9dQQbCWIwrYUgkb8M7nMqcvY91tOxkCg_NJ19EWRDxsc7kEqanWPBRZ4GJpHpzwxlnkVE1Jjp5LMeceGQGWqoLriTSOWY5ivkTQyIRinApml-hOr_VnVseJVM-NAyJqGYatD5nS-mazhsOoEPxp3G00

Codeblock

language	text
title	Ablehnung RespondProviderChange
linenumbers	true
collapse	true

@startuml
autonumber
 
box  (Sub)Product Order vom Typ KUE-LE (PO2)
participant leab as "LE"
participant tab as "AG"
 
 
leab -> leab: POST  ProductOrder(productOrderItemDelete, category=KUE-LE) 
leab -> tab: ProductOrderCreatedEvent(PO2)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Acknowleged)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Pending)
leab -> tab: ProductOrderInformationRequiredEvent(PO2, fieldPath=productOrder.TNBabApproval)
note right: AKM-PV
leab <- tab: POST ResondProviderChange(approval, reason)
note right: RUEM-PV
leab -> tab: ResondProviderChangeStatusChangedEvent(Acknowledged)
leab -> tab: ResondProviderChangeStatusChangedEvent(Rejected) 
leab -> tab: ProductOrderStatusChangeEvent(PO2, Rejected)
note right: ABBM-PV

Ablehnung durch den AG

Der AG kann die AKM-PV negativ beantworten.

Auch in diesem Fall werden die Kündigung ( und der sie auslösende PV- bzw. VBL-Auftrag) dann vom LE zurückgewiesen:

Img

src

//www.plantuml.com/plantuml/png/bLBFxff04Bxp51DFa4WFFPhQ59KqHbi9_haFx8ZRmYvTPcrzcpvBdwmer433puI42yFtvvjl-5Gn6hP5xg1bhMoHa77-_7OI_Gl0tTl4YumMDcNO6K46hhg0mws4pJ7qjo6uqUwzvvHeMAQoHCMG4oQ05KosuQJtWTjvy7boDwYV1zJ_-A3C8Dhj3m2jsyFCBJilQwPYHJanJI55faoRsxn9uNMqk9RgYImD8PC8hwIuIVicTC_8jbfUK6Nqn4yXIByh_JEdZCHuSaHAI9Mz8AxLMPi2MMeLqmyh3OaE_omf5n7oPTujuztXwmAJeAndLymzHsacC3Axy0o2pHS_EZL-7tpWPxSnLLg9gAR8Mg99seirYEZkrGRxLuXe6ncli5Or93DKLLutw30_O3OoiKmdp2qrCnVRtQTW26lEYuA7-4svGoBZbrbfHVqJnCUmkS78doMcRvGoYVyEkbZSrVu2

Codeblock

language	text
title	Ablehung durch den AG
linenumbers	true
collapse	true

@startuml
autonumber
 
box  (Sub)Product Order vom Typ KUE-LE (PO2)
participant leab as "LE"
participant tab as "AG"
 
 
leab -> leab: POST  ProductOrder(productOrderItemDelete, category=KUE-LE) 
leab -> tab: ProductOrderCreatedEvent(PO2)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Acknowleged)
leab -> tab: ProductOrderStatusChangeEvent(PO2, Pending)
leab -> tab: ProductOrderInformationRequiredEvent(PO2, fieldPath=productOrder.TNBabApproval)
note right: AKM-PV
leab <- tab: POST ResondProviderChange
leab -> tab: ResondProviderChangeStatusChangedEvent(Acknowledged)
leab -> tab: ResondProviderChangeStatusChangedEvent(InProgress)
leab <- tab: ResondProviderChangeAttributeValueChange(approval, reason)
leab -> tab: ProductOrderAttributeValueChange(PO2, approval, reason)
leab -> tab: ResondProviderChangeStatusChangedEvent(Done)
note right: RUEM-PV
leab -> tab: ProductOrderStatusChangeEvent(PO2, Rejected)
note right: ABBM-PV

Business Rule

...

.

Der Auftrag befindet sich final in einem der folgenden Auftrags-Status:

failed
rejected
cancelled (nach pending, bei erfolgloser Kundentermin anfordern)

Ablauf

Bitbucket file macro

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

Der Fehlschlag während der Realisierung für die category VBL oder PV ist im Detail hier dargestellt: 2) Fehlschlag beim Leistungserbringer

Besonderheit

Im Geschäftsfall "KUE-LE" (catogory: terminationBySeller) gibt es nur den Ablauf "Scheitern der Auftragsrealisierung" (siehe Beschreibung, Auslöser).

...

werden im Geschäftsfall "KUE-LE" nicht unterstützt.

Beispieldaten

ProductOrderAttributeValueChange (Alternativprodukt/korrigierter Standort)

...

(1)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-1b-attribute-value-change-event-alternate-offering.json
syntaxHighlighting	JSON

fachliche Felder	Daten	API Felder
technisches Eventdatum	2022-05-11T10:30:30+02:00	eventTime
Wiedervorlagetermin	2023-01-16T10:00:00+01:00	earliestOrderRetry
Alternativprodukt	alternateProductOffering
Alternativprodukt	FTTH L2 PON 1500 1000	name
StandortA Korrektur		RelatedPlaceRefOrValue
StandortA Korrektur	AlternateAddress	role
	Rheinhausen	city
	DEU	country
	59055	postcode
	Biberweg	streetName
	2	streetNr
	b	streetNrSuffix

StashincludebyfilepathrepoSlugtmf622-product-orderbranchIdrefs/heads/mainprojectKeyTFITfilepathsrc/test/examples/ftth-no-opts

ProductOrderStateChangeEvent: Abbruch bei kaufmännischer/technischer Validierung (2)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-

...

1c-

...

state-

...

change-event-

...

rejected.json

...

syntaxHighlighting	JSON

fachliche Felder	Daten	API Felder
orderstatus	rejected	state

eventDate/changeDate

fachliches Änderungsdatum

2022-05-11T10:31:00

stashincludebyfilepath

stateChangeDate

repoSlug

technisches EventDatum

tmf622

2022-

product-orderbranchIdrefs/heads/mainprojectKeyTFITfilepathsrc/test/examples/ftth-no-opts/product-order-1c-state-change-event-rejected.jsonshowLineNumberstrueprogLangplaincollapsibletrueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1dProductOrderStateChangeEvent: nach erfolgloser TAM/MTAMorderstatuscancelledstateeventDate/changeDate2022-05-11T10:31:00 StashincludebyfilepathrepoSlugtmf622-product-orderbranchIdrefs/heads/mainprojectKeyTFITfilepathsrc/test/examples/ftth-no-opts/product-order-1a

05-20T10:40:00+01:00

eventTime

Grund der Änderung

"1001"

"Die Anschrift ist nicht bekannt."

stateChangeReason.code

stateChangeReason.text

ProductOrderAttributeValueChange (Wiedervorlagedatum) (3)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-1b-attribute-value-change-event-earliest-order-retry.json
syntaxHighlighting	JSON

fachliche Felder	Daten	API Felder
technisches Eventdatum	2022-05-11T10:30:30	eventTime
Wiedervorlagetermin	2023-01-16T10:00:00+01:00	earliestOrderRetry

ProductOrderStateChangeEvent: Abbruch bei kaufmännischer/technischer Validierung (4)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-1c-state-change-event-

...

rejected.json

...

syntaxHighlighting

...

JSON

progLang

fachliche Felder

plain

Daten

collapsible

API Felder

trueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1dProductOrderStateChangeEvent: Abbruch bei AuftragsrealisierungorderstatusfailedstateeventDate/changeDate

technisches EventDatum	2022-05-11T10:31:00+02:00	eventTime
orderstatus	rejected	state
fachliches Änderungsdatum	2022-05-11T10:31:00

StashincludebyfilepathrepoSlugtmf622-product-orderbranchIdrefs/heads/mainprojectKeyTFITfilepathsrc/test/examples/ftth-no-opts

stateChangeDate

Grund der Änderung

"1023"

"Ihr Auftrag ist derzeit aus technischen Gründen nicht bearbeitbar. Bitte versuchen Sie es zu einem späteren Zeitpunkt erneut."

stateChangeReason.code

stateChangeReason.text

ProductOrderStateChangeEvent: nach erfolgloser TAM/MTAM (5)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-

...

1a-state-change-event-

...

cancelled.json

...

syntaxHighlighting

...

JSON

progLang

fachliche Felder

plain

Daten

collapsible

API Felder

trueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1dProductOrderAttributeValueChange (Fehlauftragsnummer bei Auftragsklammer)eventDate/changeDate

technisches EventDatum	2022-06-13T10:42:00+02:00	eventTime
orderstatus	cancelled	state
fachliches Änderungsdatum	2022-05-11T10:

30 StashincludebyfilepathrepoSlugtmf622-product-orderbranchIdrefs/heads/mainprojectKeyTFITfilepathsrc/test/examples/ftth-no-opts

31:00

FehlauftragsnummerrelatedRejectedProductOrderproductOrder/productOrderChacteristic.nameExterne Auftragsnummer eines anderen abgewiesenen Auftrages mit der gleichen AuftragsklammerEXT123456789productOrder/productOrderChacteristic.value

stateChangeDate

Grund der Änderung

"1198"

"Es wurde kein neuer Ausführungstermin übermittelt."

stateChangeReason.code

stateChangeReason.text

ProductOrderStateChangeEvent: Abbruch bei Auftragsrealisierung (6)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-

...

1e-

...

state-change-event-

...

failed.json

...

syntaxHighlighting

...

JSON

progLang

fachliche Felder

plain

Daten

collapsible

API Felder

trueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

technisches EventDatum	2022-05-11T10:31:00+02:00	eventTime
orderstatus	failed	state
fachliches Änderungsdatum	2022-05-11T10:31:00	stateChangeDate
Grund der Änderung	"1305" "Es wurde kein neuer Ausführungstermin übermittelt."	stateChangeReason.code stateChangeReason.text

Version	Alte Version 33	Neue Version Aktuell
Änderungen wurden vorgenommen von	Former user	Stephan Braune
Gespeichert am	Dez. 27, 2022	Dez. 12, 2024

Versionen im Vergleich

Schlüssel

Beschreibung

Ablauf

Untervariante "Auftrag Providerwechsel und Verbundleistung" abbrechen

Kaufmännische Validierung

Technische Validierung

Untervariante "Kündigung durch LE, GF PV und VBL" abbrechen

Keine rechtzeitige RUEM-PV

Ablehnung der RespondProviderChange durch LE

Ablehnung durch den AG

Business Rule

Ablauf

Besonderheit

Beispieldaten

ProductOrderAttributeValueChange (Alternativprodukt/korrigierter Standort)

(1)

ProductOrderStateChangeEvent: Abbruch bei kaufmännischer/technischer Validierung (2)

ProductOrderAttributeValueChange (Wiedervorlagedatum) (3)

ProductOrderStateChangeEvent: Abbruch bei kaufmännischer/technischer Validierung (4)

ProductOrderStateChangeEvent: nach erfolgloser TAM/MTAM (5)

ProductOrderStateChangeEvent: Abbruch bei Auftragsrealisierung (6)

Seitenvergleich

Versionen im Vergleich

Schlüssel

Beschreibung

Ablauf

Untervariante "Auftrag Providerwechsel und Verbundleistung" abbrechen

Kaufmännische Validierung

Technische Validierung

Untervariante "Kündigung durch LE, GF PV und VBL" abbrechen

Keine rechtzeitige RUEM-PV

Ablehnung der RespondProviderChange durch LE

Ablehnung durch den AG

Business Rule

Ablauf

Besonderheit

Beispieldaten

ProductOrderAttributeValueChange (Alternativprodukt/korrigierter Standort)

(1)

ProductOrderStateChangeEvent: Abbruch bei kaufmännischer/technischer Validierung (2)

ProductOrderAttributeValueChange (Wiedervorlagedatum) (3)

ProductOrderStateChangeEvent: Abbruch bei kaufmännischer/technischer Validierung (4)

ProductOrderStateChangeEvent: nach erfolgloser TAM/MTAM (5)

ProductOrderStateChangeEvent: Abbruch bei Auftragsrealisierung (6)