Titel	Auftrag (Kündigung durch AG) anlegen
Kurzbeschreibung	Folgender Ablauf beschreibt für den Gut-Fall die typischen API- Interaktionen zwischen Auftraggeber Auftrageber und Leistungserbringer im Anwendungsfall "Auftrag (Kündigung durch Auftraggeber/Kunde"AG) anlegen" von der Anlage des Auftrags bis zu seinem Abschluss. Dieser Anwendungsfall behandelt die Kündigung eines Produktes durch den Auftraggeber. Die Kündigung muss sich auf ein im Bestand des jeweiligen Auftraggebers befindliches Produkt beziehen. Eine Kündigung ist nur dann möglich, wenn keine weiteren offenen Aufträge zum Bestand des Auftraggebers vorliegen. Dies gilt sowohl für Aufträge des bestandsführenden Auftraggebers als auch von anderen Auftraggebern (z.B. beim Geschäftsfall Providerwechsel). Voraussetzung für den Geschäftsfall Kündigung durch Auftraggeber ist ein bestehender Rahmenvertrag zwischen dem Auftraggeber und dem Leistungserbringer sowie die Angabe aller ausführungsrelevanten Daten. Entsprechung: KUE/KD in WITA, KUE/AG in SPRI Dabei werden die für diesen Ablauf erforderlichen Auftrags-Status durchlaufen und die für diesen Ablauf relevanten Informationen übermittelt.
Vorbedingung	Rahmenvertrag ist vorhanden Das zu kündigende Produkt befindet sich im Bestand des Auftraggebers Es liegen keine offenen Aufträge zum Produkt vorDer Auftrageber hat sich für seine Meldungen registiertbetroffenen Bestand (z.B. für den Anschluss oder dem Übertragungsweg) vor. Mindestens alle Pflichtfelder für eine Product Order im Anwendungsfall KUE-AG sind laut Auftrags-/Meldungsstruktur (download) gefüllt.
Auslöser	Der Auftraggeber legt einen Kündigungsauftrag (Geschäftsfall Kündigung) an.
Ergebnis	Das Produkt wurde gekündigt und deaktiviert.

Ablauf

Img

src

Bitbucket file macro

url

https://www.plantuml.com/plantuml/png/hLDDQp8n4BxlhnWywS7bVJtq85JyS0k5RjMwz9xD3Z4qcuJPIQl_ll63ujg2M9h343BFnpm36JSiY4Dj4X7OsL2NI4dfjZ0DktZpiQcbzi8ob20Qw2oeGj9MTHBOdmDsZSOWGP4_t0q6BOvt1zAIN1Ka7xXVHEYFzlqXB1Vh0iuXNIaObQCTtCCS3JBs4k_w_L4PqOD__s56615LLyWtwpuCLWghNc8T8v1M6nv2aQrEFiVgtTwk_C7ig9Mze-LkxofwpH4ysmYhJXGX9Ng-j5zbqwjI4sRIPM1y5IQqDDjQcAeqrgr76NrchlPn8zhPUPpazdcrZMr5s3HjbyaqlrrC7eUvJ9-zFEL_7D-VCHyPw_Jqa39IhQtu_KAaSSst0Cz5depHLl5ZV080

Codeblock

language	text
collapse	true

@startuml
autonumber
box Buyer
participant b as "Ordering"
    
box Seller TMF622
participant po as "ProductOrder"
    
b -> po : POST ProductOrder(category = Delete)
po-->b : 201 Created(acknowledged)
note right: TEQ
    
    
po -> b: POST ProductOrderCreateEvent()
    
po -> b: POST ProductOrderStateChangeEvent(accepted)
note right: QEB
    
po -> b: POST ProductOrderAttributeValueChangeEvent()
note right: e.g.: expectedCompletionDate
    
po -> b: POST ProductOrderStateChangeEvent(inProgress)
note right: ABM
    
po -> b: POST ProductOrderStateChangeEvent(completed)
note right: ERLM
    
po -> b: POST ProductOrderAttributeValueChangeEvent()
note right: e.g.: productOrderItem/product.terminationDate
    
po -> b: POST ProductOrderStateChangeEvent(closed)
note right: ENTM
@enduml

Beispieldaten

ProductOrder (Kündigung)

Stashincludebyfilepath

repoSlug	fit-root
branchId	refs/heads/main
projectKey	TFIT
filepath	tmf622/examples/ftth-no-opts/bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/UC_KUE-KD.puml
syntaxHighlighting	PlantUML

Beispieldaten

POST ProductOrder Kündigung AG (1)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-0-create.json
showLineNumbers	true
progLang	plain
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting	JSON

ProductOrder.requestedCompletionTimePeriod

fachliche Felder	Daten	API FelderBemerkung
technische Daten
fachliches Bestelldatum des AG	2022-05-11T10:30:00+02:00	orderPostedDate
Geschäftsfall Name	"terminationByBuyer"	category
Produktdaten
Aktion	Geschäftsfall	delete	productOrderItem.action
Identifikation des Inventars Produkt Identifier (ODER ALTWELT) Einzelvertragsnummer (ODER) 555001Vertragsnummer bei Telekom bzw. NGAB: LINE-ID	388a4963-f168-4603-99e8-477200099d91 3091231119	Product.id (ODER)Product.singleContractId Annahme = Identifikation des Inventars über Product.id
Auftragsdaten
Kündigungswunschtermin	2022-12-01T12:00:00+01:00 (Uhrzeit fachlich nicht relevant, aber technisch erforderlich)	ProductOrder.requestedCompletionDate	Kündigungswunschtermin	01.12.2022
Auftraggeberdaten
Leistungs-Nummer	500012	Agreement.businessId (agreementType = BuyerServiceContract)
Auftraggeber-Nummer	500011	Agreement.engagedParty.businessId
Externe Auftragsnr	1000111	externalIdenitifier.id

ProductOrderStateChangeEvent:

...

Accepted (4)

Bitbucket file macro

cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-1-state-change-event-acknowledgedaccepted.json
showLineNumbers	true
progLang	plain
collapsible	true
applicationLink	syntaxHighlighting	JSON

OrderstatusChangeDate31technisches EventDatum32eventTime

fachliche Felder	Daten	API Felder
Orderstatus	acknowledged	state
technisches EventDatum	2022-05-11T10:	32:00+01:00	stateChangeDate	eventTime
Orderstatus	accepted	state
OrderstatusChangeDate	2022-05-11T10:	31:00+01:00	stateChangeDate
Grund der Änderung	0000 "Keine Änderung zum Auftrag"	stateChangeReason.code stateChangeReason.description

ProductOrderAttributeValueChange (setzen von Auftragsmanagment & VLT)

...

(5)

Bitbucket file macro

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-2-attribute-value-change-event-supplierseller-contact.json
showLineNumbers	true
progLang	plain
collapsible	true
applicationLink	cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting	JSON

orderManagementSupplierContact

fachliche Felder	Daten	API Felder
technisches EventDatum	2022-05-11T10:32:00	eventTimePointer auf die gemachte Änderung	/relatedParty/ /expectedCompletionTimePeriod/	fieldPath.path fieldPath.typeOfChange = add
Verbindlicher Kündigungstermin	2022-12-01T12:00:00+01:00 (Uhrzeit fachlich nicht relevant, aber technisch erforderlich)	ProductOrder.expectedCompletionDate
Verbindlicher Kündigungstermin	01.12.2022	ProductOrder.expectedCompletionTimePeriod
Rolle	Auftragsmanagment
Rolle	orderManagementSellerContact	relatedParty.role
Anrede	Frau	relatedParty.salutation (Ms)
Vorname	Lisa	relatedParty.givenName
Nachname	Bach	relatedParty.familyName
Telefonnummer	0221/789456	relatedParty/contactMedium.mediumType = phone"PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "fixed" relatedParty/contactMedium/characteristic.phoneNumber
Mobilfunknummer	0178/78787878	relatedParty/contactMedium.mediumType = phone "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "mobile" relatedParty/contactMedium/characteristic.phoneNumber	Faxnummer
Email-adresseAdresse	l.bach@example.net	relatedParty/contactMedium.mediumType = email"EmailContactMedium" relatedParty/contactMedium/characteristic.contactType = "email" relatedParty/contactMedium/characteristic.emailAddress="l.bach@example.net"

ProductOrderStateChangeEvent: inProgress

...

(6)

Bitbucket file macro

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

fachliches Änderungsdatum technisches EventDatumeventTime

2022-05-11T10:31:00+01:00

0000

"Keine Änderung zum Auftrag"

fachliche Felder	Daten	API Felder
Orderstatus	inProgress	state
technisches EventDatum	2022-05-20T10:40:00+01:00	stateChangeDate	eventTime
Orderstatus	inProgress	state
fachliches Änderungsdatum	2022-05-20T10:40:00+01:00	stateChangeDate
Grund der Änderung	0000 "Keine Änderung zum Auftrag"	stateChangeReason.code stateChangeReason.description	Historisierung acknowledged fachliches Änderungsdatum Grund der Änderung	stateChangeHistory.@type = StateChange stateChangeHistory.changeDate stateChangeHistory.changeReason.code stateChangeHistory.changeReason.description

ProductOrderStateChangeEvent: completed

...

ProductOrderStateChangeEvent: completed (7)

Bitbucket file macro

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

technisches EventDatumeventTime

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

0000

"Keine Änderung zum Auftrag"

fachliche Felder	Daten	API Felder
Orderstatus	completed	state
fachliches Änderungsdatum	technisches EventDatum	2022-12-16T10:45:00+01:00	stateChangeDate		eventTime
Orderstatus	completed	state
fachliches Änderungsdatum	2022-12-16T10:45:00+01:00	stateChangeDate
Grund der Änderung	0010 "Auftrag ausgeführt."	stateChangeReason.code stateChangeReason.description	Historisierung inProgress fachliches Änderungsdatum Grund der Änderung	stateChangeHistory.@type = StateChange stateChangeHistory.changeDate stateChangeHistory.changeReason.code stateChangeHistory.changeReason.description

ProductOrderAttributeValueChange

...

(setzen von terminationDate)

...

(8)

Bitbucket file macro

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

fachliche Felder

Daten

API Felder

technisches EventDatum

2022-12-16T10:45:30+01:00

eventTimePointer auf die gemachte Änderung

/terminationDate/

fieldPath.path

fieldPath.typeOfChange = add

Nutzungsdatum

2022-12-16T10:45:00+01:00

product.terminationDate

ProductOrderStateChangeEvent:

...

closed (9)

Bitbucket file macro

cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-6-state-change-event-closed.json
showLineNumbers	true
progLang	plain
collapsible	true
applicationLink	syntaxHighlighting	JSON

technisches EventDatumeventTime.description

2022-05-20T10:45:30+01:00

0000

"Keine Änderung zum Auftrag"

stateChangeHistory.@type = StateChange

stateChangeHistory.changeDate

stateChangeHistory.changeReason.code

stateChangeHistory.changeReason

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

Version	Alte Version 27	Neue Version Aktuell
Änderungen wurden vorgenommen von	Former user	Stephan Braune
Gespeichert am	Juli 30, 2024	Dez. 19, 2024

Versionen im Vergleich

Schlüssel

Ablauf

Beispieldaten

ProductOrder (Kündigung)

Beispieldaten

POST ProductOrder Kündigung AG (1)

ProductOrderStateChangeEvent:

Accepted (4)

ProductOrderAttributeValueChange (setzen von Auftragsmanagment & VLT)

(5)

ProductOrderStateChangeEvent: inProgress

(6)

ProductOrderStateChangeEvent: completed

ProductOrderStateChangeEvent: completed (7)

ProductOrderAttributeValueChange

(setzen von terminationDate)

(8)

ProductOrderStateChangeEvent:

closed (9)

Seitenvergleich

Versionen im Vergleich

Schlüssel

Ablauf

Beispieldaten

ProductOrder (Kündigung)

Beispieldaten

POST ProductOrder Kündigung AG (1)

ProductOrderStateChangeEvent:

Accepted (4)

ProductOrderAttributeValueChange (setzen von Auftragsmanagment & VLT)

(5)

ProductOrderStateChangeEvent: inProgress

(6)

ProductOrderStateChangeEvent: completed

ProductOrderStateChangeEvent: completed (7)

ProductOrderAttributeValueChange

(setzen von terminationDate)

(8)

ProductOrderStateChangeEvent:

closed (9)