Versionen im Vergleich

Version Alte Version 69 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.

...

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 Neu Änderung sind laut Auftragsmedestruktur 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
cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
urlhttps://bitbucket.org/fit-api/fit-api/src/main/resourcestmf622/docsassets/diagrams/UC_AEN.pumlapplicationLink
syntaxHighlightingPlantUML

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

...

Drawio
bordertrue
diagramNameAuftragsstruktur LAE, LMAE, PGW
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1035
revision16


Beispieldaten

...

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

A)

...

Leistungsmerkmaländerung: Zubuchung Expressentstörung

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

productOrderItem.requestedTimeSlot.startDateTime

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

requestedCompletionDate

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 = fixedrelatedPartyparty/contactMedium/characteristic.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/productOffering.name

Wunschzeitfenster

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

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

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

product.id
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 Altproduktes

(ODER ALTWELT)

  • Vertragsnummer bei Telekom bzw. NGAB: LINE-ID
922ebf01-e930-47a0-842e-059d1f188a15ProductOrderItem/product.id

Leistungsmerkmaländerung: Zubuchung Expressentstörung (1)

...

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

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

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

requestedCompletionDate

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

(ODER ALTWELT)

Vertragsnummer bei Telekom bzw. NGAB: LINE-ID

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.nameBeziehung zum zweiten ProductOrderItem1evs
geänderte Doppelader01ProductOrderItem/productOrderItemRelationshipproduct.idcopperPairId
dependsOnProductOrderItem/productOrderItemRelationship.relationshipType

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

...

D) Leistungsänderung

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

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

requestedCompletionDate

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 Produktes

(ODER ALTWELT)

  • Vertragsnummer bei Telekom bzw. NGAB: LINE-ID
922ebf01-e930-47a0-842e-059d1f188a17ProductOrderItem/product.idgeändertes ÜbertragungsverfahrenH04ProductOrderItem/product.transmissionMethodgeänderter Übergabeverteiler0401ProductOrderItem/product.uevtgeänderter Endverschluss16ProductOrderItem/product.evsgeänderte Doppelader01ProductOrderItem/product.copperPairId
ProduktnameFTTH L2 PON 100 50ProductOrderItem/productOffering.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

Beziehung zum zweiten ProductOrderItem2ProductOrderItem/productOrderItemRelationship.id
migrateFromProductOrderItem/productOrderItemRelationship.relationshipType
altes Produkt
Auftragsposition2ProductOrderItem.id
AktionscodedeleteProductOrderItem.action

Identifizierung des Altproduktes

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


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