Versionen im Vergleich

Version Alte Version 58 Neue Version Aktuell
Änderungen wurden vorgenommen von

Former user

Stephan Braune

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Beschreibung

TitelAuftrag (Änderung) anlegen
Kurzbeschreibung

Folgender Ablauf beschreibt für den Gut-Fall die typischen Interaktionen zwischen Auftrageber und Leistungserbringer im Anwendungsfall "Auftrag (Änderung) anlegen" von der Anlage des Auftrags bis zu seinem Abschluss.

Dieser Anwendungsfall behandelt die Änderung eines Produktes durch den Auftraggeber. Änderung steht hier als Überbegriff für die Geschäftsfälle Leistungsänderung (LAE), Leistungsmerkmal-Änderungen (LMAE), Produktgruppenwechsel (PGW) und Portwechsel. 

Die gewünschte Änderung muss sich auf ein im Bestand des jeweiligen Auftraggebers befindliches Produkt beziehen. Eine Änderung 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). 

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 ändernde Produkt befindet sich im Bestand des Auftraggebers
  • Der Auftraggeber hat die Verfügbarkeit des neuen Produktes bzw. der Änderung des Produktes geprüft.
  • Es liegen keine offenen Aufträge zum Produkt vorbetroffenen Bestand (z.B. für den Anschluss oder dem Übertragungsweg) vor.
  • Mindestens alle Pflichtfelder für eine Product Order im Anwendungsfall Änderung sind laut Auftrags-/Meldungsstruktur (download) gefüllt.
Auslöser

Der Auftraggeber legt einen Änderungsauftrag an.

Ergebnis

Das Produkt wurde geändert

Ablauf

tmf622/documentation
Stashincludebyfilepath
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepath
Bitbucket file macro
urlhttps://bitbucket.org/fit-api/fit-api/src/main/resourcestmf622/docs/diagramsassets/UC_AEN.puml
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

Auftrag Produktänderung - Strukturelle Darstellung

Wechselgeschäftsfälle - Beispiele

...

VDSL-SA 25 Mbit/s

Express-Entstörung Wholesale

...

VDSL-SA 25 Mbit/s

Express-Entstörung Wholesale

...

VDSL-SA 25 Mbit/s

...

TAL; CuDA 4 Draht hbr (HVt)

H03

...

TAL; CuDA 4 Draht hbr (HVt)

H06

...

VDSL-SA 50 Mbit/s

Express-Entstörung Wholesale

...

VDSL-SA 25 Mbit/s

Dienstvertrag: 0815

Provider: A

...

FTTH 50000

Dienstvertrag: 0816

Provider: A

...

VDSL-SA 25 Mbit/s

Dienstvertrag: 0814

Provider: A

...

VDSL-SA 25 Mbit/s

Dienstvertrag: 0815

Provider: A

...

Dienstvertrag ändert sich bei gleichbleibender Produktvariante

(Wechsel Dienstvertrag z. B. bei Wechsel von L3 auf L2)

...

VDSL-SA 25 Mbit/s

Dienstvertrag: 0814

Provider: A

...

VDSL-SA 50 Mbit/s

Dienstvertrag: 0815

Provider: A

...

VDSL-SA 25 Mbit/s

Provider A

...

VDSL-SA 25 Mbit/s

Provider B

...

VDSL-SA 25 Mbit/s

Provider A

...

VDSL-SA 50 Mbit/s

Provider B

...

VDSL-SA 25 Mbit/s

Provider A

Dienstvertrag: 0815

...

FTTH 50000

Provider B

Dienstvertrag: 1815

...

Telekom-Produkt

Provider A

...

FTTH 50000

Provider B

Dienstvertrag: 1815

...

TAL; CuDA 2 Draht hbr (HVt)

...

TAL; CuDA 2 Draht hbr (HVt)

...

Beispiele Auftrag (Änderung) - Wechselgeschäftsfälle LAE, LMAE & PGW

...

syntaxHighlightingPlantUML

Anwendungsfälle für Geschäftsfälle LAE, LMAE, PGW & Portwechsel

Auftragsstruktur 


Drawio
bordertrue
diagramNameAuftragsstruktur LAE, LMAE, PGW
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth10411035
revision1216

Begleitende Auftragsinformationen

Referenz Beispieldaten für Auftragsinformationen: aktualisierte Beispieldaten

...

Beispieldaten

Leistungsänderung

...


...

Beispieldaten für ausgewählte Fälle (1)

A) Leistungsmerkmaländerung: Zubuchung Expressentstörung

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-lmae-express-0-create.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

Kundenwunschtermin

productOrderItem.requestedTimeSlot.startDateTime

productOrderItem.requestedTimeSlot.endDateTime
fachliche FelderDaten API Felder
technische Daten
fachliches Bestelldatum des AG2022-06-12T10:30:00+01:00ProductOrder.orderPostedDate
Kategorie (Leistungsmerkmaländerung)Geschäftsfall NameproductModificationProductOrder.category
Kundendaten
Kundenwunschtermin2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

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

requestedCompletionTimePeriod.startDateTime

Auftraggeberdaten

Auftraggeber
Leistungs-Nummer500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="buyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

Externe Auftragsnr.
Externe Auftragsnr.

10002231000222

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner Auftragsmanagement

RoleorderManagementBuyerContactrelatedParty.role
AnredeHerrrelatedParty./party/salutation
TitelCaptainrelatedParty./party/title
VornameJames T.relatedParty./party/givenName
NachnameKirkrelatedParty./party/familyName
Telefonnummer0221



456789

+49221456789

relatedParty/party/contactMedium/characteristic.phoneNumber @Type = PhoneContactMedium

relatedParty/party/contactMedium.contactType = fixedPhone

relatedParty/contactMedium/characteristic.contactType = fixedrelatedParty/contactMedium/characteristicparty/contactMedium.phoneNumber 

Mobilfunknummer017754545454



+4917754545454

relatedParty/party/contactMedium.mediumType @Type = phonePhoneContactMedium

relatedParty/party/contactMedium/characteristic.contactType = mobilemobilePhone

relatedParty/party/contactMedium/characteristic.phoneNumber 

Email-adressej.kirk@example.net

relatedParty/party/contactMedium.mediumType @Type = emailEmailContactMedium

relatedParty/party/contactMedium/characteristic.contactType = email

relatedParty/party/contactMedium/characteristic.emailAddressemailAddress 

Produktdaten

neues ProduktHauptprodukt (ändert sich nicht)
Auftragsposition1ProductOrderItem.id
AktionscodeaddnoChangeProductOrderItem.action
ProduktnameFTTH L2 PON 100 50

Identifizierung des Hauptproduktes

922ebf01-e930-47a0-842e-059d1f188a16ProductOrderItem/productOfferingproduct.nameidWunschzeitfenster

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

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

neu zugebuchtes Produkt
Auftragsposition2ProductOrderItem.id
AktionscodeaddProductOrderItem.action
ProduktnameExpressentstörungProductOrderItem/productOffering.name
Beziehung zum zweiten ProductOrderItem21ProductOrderItem/productOrderItemRelationship.id
migrateFromdependsOnProductOrderItem/productOrderItemRelationship.relationshipType
altes Produkt
Auftragsposition2ProductOrderItem.id
AktionscodedeleteProductOrderItem.action
Identifizierung des Altproduktes922ebf01-e930-47a0-842e-059d1f188a15ProductOrderItem/product.id

Leistungsmerkmaländerung: Zubuchung Expressentstörung

...

C) Leistungsmerkmaländerung: Änderung des Übertragungsverfahrens mit Änderung des
Verbindungskabels zum Übergabeverteiler

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-lmae-expresstrans-method-0-create.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

2022-12-01T08:00:00+01:00
fachliche FelderDaten API Felder
technische Daten
fachliches Bestelldatum des AG2022-06-12T10:30:00+01:00ProductOrder.orderPostedDate
Kategorie (Leistungsänderung)Geschäftsfall NameproductModificationProductOrder.category
Kundendaten
Kundenwunschtermin2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

Kundenwunschtermin

requestedCompletionTimePeriod.startDateTime

Auftraggeberdaten

Auftraggeber
Leistungs-Nummer500012500013

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="buyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

Externe Auftragsnr.
Externe Auftragsnr.

10002221000223

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner Auftragsmanagement

RoleorderManagementBuyerContactrelatedParty.role
AnredeHerrrelatedParty/party/salutation
TitelCaptainrelatedParty/party/title
VornameJames T.relatedParty/party/givenName
NachnameKirkrelatedParty./party/familyName
Telefonnummer



+49221456789

relatedParty/party/contactMedium.@Type = PhoneContactMedium

relatedParty/party/contactMedium.contactType = fixedPhone

relatedParty/party/contactMedium.phoneNumber 

Mobilfunknummer



+4917754545454

relatedParty/party/contactMedium.@Type = PhoneContactMedium

relatedParty/party/contactMedium.contactType = mobilePhone

relatedParty/party/contactMedium.phoneNumber 

Email-adressej.kirk@example.net

relatedParty/party/contactMedium.@Type = EmailContactMedium

relatedParty/party/contactMedium.contactType = email

relatedParty/party/contactMedium.emailAddress 

Produktdaten

Hauptprodukt (ändert sich nicht)Produkt
Auftragsposition1ProductOrderItem.id
AktionscodenoChangemodifyProductOrderItem.action

Identifizierung des

Hauptproduktes

Produktes

922ebf01-e930-47a0-842e-059d1f188a16059d1f188a17ProductOrderItem/product.id
neu zugebuchtes Produkt
Auftragsposition2geändertes ÜbertragungsverfahrenH04ProductOrderItem/product.idtransmissionMethod
Aktionscodegeänderter Übergabeverteileradd0401ProductOrderItem/product.actionuevt
Produktnamegeänderter EndverschlussExpressentstörung16ProductOrderItem/productOfferingproduct.nameevs
Wunschzeitfenster

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

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

productOrderItem.requestedTimeSlot.startDateTime

productOrderItem.requestedTimeSlot.endDateTime

Beziehung zum zweiten ProductOrderItem1ProductOrderItem/productOrderItemRelationship.id
dependsOnProductOrderItem/productOrderItemRelationship.relationshipType

Leistungsmerkmaländerung: Änderung des Übertragungsverfahrens mit Änderung des
Verbindungskabels zum Übergabeverteiler

...

geänderte Doppelader01ProductOrderItem/product.copperPairId

D) Leistungsänderung

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-lae-0-create.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

fachliche FelderDaten API Felder
technische Daten
fachliches Bestelldatum des AG2022-06-12T10:30:00+01:00ProductOrder.orderPostedDate
Kategorie (Leistungsänderung)
Geschäftsfall NameproductModificationProductOrder.category
Kundendaten
Kundenwunschtermin2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

Kundenwunschtermin

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

requestedCompletionTimePeriod.startDateTime

Auftraggeberdaten

Auftraggeber
Leistungs-Nummer
500013
500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="buyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

Externe Auftragsnr.
Externe Auftragsnr.

1000223

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner Auftragsmanagement

RoleorderManagementBuyerContactrelatedParty.role
AnredeHerrrelatedParty
/party/
.salutation
TitelCaptainrelatedParty
/party/
.title
VornameJames T.relatedParty
/party/
.givenName
NachnameKirkrelatedParty.
/party/
familyName
Telefonnummer
+49221456789
0221 456789

relatedParty

/party

/contactMedium/characteristic.phoneNumber 

relatedParty/contactMedium.

@Type

contactType =

PhoneContactMedium

fixedPhone

relatedParty/

party

contactMedium/

contactMedium

characteristic.contactType =

fixedPhone

fixed

relatedParty/

party

contactMedium/

contactMedium

characteristic.phoneNumber 

Mobilfunknummer
+4917754545454
017754545454

relatedParty

/party

/contactMedium.

@Type

mediumType =

PhoneContactMedium

phone

relatedParty/

party

contactMedium/

contactMedium

characteristic.contactType =

mobilePhone

mobile

relatedParty/

party

contactMedium/

contactMedium

characteristic.phoneNumber 

Email-
adresse
Adressej.kirk@example.net

relatedParty

/party

/contactMedium.

@Type

mediumType =

EmailContactMedium

email

relatedParty/

party

contactMedium/

contactMedium

characteristic.contactType = email

relatedParty/

party

contactMedium/

contactMedium

characteristic.

emailAddress 

emailAddress

Produktdaten

neues Produkt
Auftragsposition1ProductOrderItem.id
Aktionscode
modify
addProductOrderItem.action
Identifizierung des Produktes922ebf01-e930-47a0-842e-059d1f188a17
ProduktnameFTTH L2 PON 100 50ProductOrderItem/
product
productOffering.
id
name

Wunschzeitfenster

(wenn erforderlich, z.B. bei Technikertermin beim Endkunden)

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

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

productOrderItem.requestedTimeSlot.startDateTime

productOrderItem.requestedTimeSlot.endDateTime

geändertes ÜbertragungsverfahrenH04

Beziehung zum zweiten ProductOrderItem2ProductOrderItem/productOrderItemRelationship.id
migrateFromProductOrderItem/
product.transmissionMethodgeänderter Übergabeverteiler0401ProductOrderItem/product.uevtgeänderter Endverschluss16ProductOrderItem/product.evsgeänderte Doppelader01
productOrderItemRelationship.relationshipType
altes Produkt
Auftragsposition2ProductOrderItem.id
AktionscodedeleteProductOrderItem.action

Identifizierung des Altproduktes

922ebf01-e930-47a0-842e-059d1f188a15ProductOrderItem/product.
copperPairId
id


Die weitere Sequenzen und Beispieldaten entsprechen den Use Case Auftrag (Neu) anlegen