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

Img

src

//www.plantuml.com/plantuml/png/jP71wjD04CRl-nJ3_wG78_mF7dgGfbB1GsYnnVlivakokjc4sLcnx-ER-68kqK83HIpe79OvxFVz-37Rf2oQns0uwnJpQ276JjzebozbcrdKEpzpLBB4YPuEqa9yx9yCbLc-dX02XCxD-pVFpwl8F2sPeqnjThf4V-SuADNMIdO3MNZwmhaRVtoFqIStGEWJ1zzwI8wzCQNcrLko6peUJcUwRQjLnTkiAFyptWqSU-o_8kgBboPE2XBV3xeXL7sreVac-K4nLXmK4bbnxUowHQwAFC9GcJ-mJygwGWe-modQDRhUxHfZ419MmWett95zlHU53sNxltX8DuK-J0b2vxgX75jgol8mrN5q2E4liNNkLBXFWgAShlUbCl_io6097kbNz2DKBWyxTUpl2o6sPbkUF8QV

Codeblock

language	text
collapse	true

@startuml
autonumber
box Buyer
participant b as "Ordering"
    
box Seller TMF622
participant po as "ProductOrder"
    
alt Abbruch bei kaufmännischer Validierung

po -> b: POST ProductOrderAttributeValueChangeEvent()
note right: e.g.: productOrderItem.alternateProductOffering.name
    
po -> b: POST ProductOrderStateChangeEvent(rejected)
note right: ABBM

else Abbruch bei technischer Validierung/Erteilung
    
po -> b: POST ProductOrderStateChangeEvent(rejected)
note right: ABBM

else Abbruch bei erfolgloser TAM und MTAM
    
po -> b: POST ProductOrderStateChangeEvent(cancelled)
note right: ABBM

else Abbruch bei Auftragsrealisierung

    
po -> b: POST ProductOrderAttributeValueChangeEvent()
note right: e.g.: earliestOrderRetry
    
po -> b: POST ProductOrderStateChangeEvent(failed)
note right: ABBM
end
@enduml

...

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

StashincludebyfilepathrepoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepathtmf622/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

repoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepathtmf622/examples/ftth-no-opts

technisches EventDatum

2022-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

progLang

fachliche Felder

plain

Daten

collapsible

API Felder

trueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1dProductOrderStateChangeEvent: nach erfolgloser TAM/MTAMorderstatuscancelledstateeventDate/changeDate2022-05-11T10:31:00 StashincludebyfilepathrepoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepathtmf622/examples/ftth-no-opts

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

StashincludebyfilepathrepoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepathtmf622/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 StashincludebyfilepathrepoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepathtmf622/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 37	Neue Version Aktuell
Änderungen wurden vorgenommen von	Former user	Stephan Braune
Gespeichert am	Juli 23, 2024	Dez. 12, 2024

Versionen im Vergleich

Schlüssel

Beschreibung

Ablauf

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

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)