Versionen im Vergleich

Version Alte Version 31 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 API- Interaktionen zwischen Auftraggeber Auftrageber und Leistungserbringer im Anwendungsfall "Änderung durch Auftraggeber/Kunde"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 Leistungs-die Geschäftsfälle Leistungsänderung (LAE), Leistungsmerkmal-Änderungen und (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). Voraussetzung für den Geschäftsfall Änderung durch Auftraggeber ist ein bestehender Rahmenvertrag zwischen dem Auftraggeber und dem Leistungserbringer sowie die Angabe aller ausführungsrelevanten Daten. 

Entsprechung: LAE, AEN-LMAE & PGW in WITA/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 ä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 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 Änderung sind laut Auftrags-/Meldungsstruktur (download) gefüllt.
Auslöser

Der Auftraggeber legt einen Änderungsauftrag an.

Ergebnis

Das Produkt wurde geändert

Ablauf

...

Auftrag Produktänderung - Strukturelle Darstellung

Bitbucket file macro
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/UC_AEN.puml
syntaxHighlightingPlantUML

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

Auftragsstruktur 


Drawio
bordertrue
diagramNameÄnderungsauftrag StrukturAuftragsstruktur LAE, LMAE, PGW
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth8591035
revision11

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

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

Auftragsstruktur LAE, LMAE & PGW

Drawio
bordertrue
diagramNameAuftragsstruktur LAE, LMAE, PGW
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1042
revision7

Begleitende Auftragsinformationen

Referenz Beispieldaten für Auftragsinformationen: aktualisierte Beispieldaten 30.09.2022

...

Beispieldaten

Leistungsänderung

Stashincludebyfilepath
repoSlugtmf622-product-order
branchIdrefs/heads/main
projectKeyTFIT
filepathsrc/test/examples/ftth-no-opts16


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
syntaxHighlightingJSON

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.

1000222

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)
Auftragsposition1ProductOrderItem.id
AktionscodenoChangeProductOrderItem.action

Identifizierung des Hauptproduktes

922ebf01-e930-47a0-842e-059d1f188a16ProductOrderItem/product.id
neu zugebuchtes Produkt
Auftragsposition2ProductOrderItem.id
AktionscodeaddProductOrderItem.action
ProduktnameExpressentstörungProductOrderItem/productOffering.name
Beziehung zum zweiten ProductOrderItem1ProductOrderItem/productOrderItemRelationship.id
dependsOnProductOrderItem/productOrderItemRelationship.relationshipType

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-trans-method-0-create.json
syntaxHighlightingJSON

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

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

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

Produkt
Auftragsposition1ProductOrderItem.id
AktionscodemodifyProductOrderItem.action

Identifizierung des Produktes

922ebf01-e930-47a0-842e-059d1f188a17ProductOrderItem/product.id
geändertes ÜbertragungsverfahrenH04ProductOrderItem/product.transmissionMethod
geänderter Übergabeverteiler0401ProductOrderItem/product.uevt
geänderter Endverschluss16ProductOrderItem/product.evs
geänderte Doppelader01ProductOrderItem/product.copperPairId

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-lae-0-create.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinksyntaxHighlightingJSON

fachliche FelderDaten API Felder
technische Daten
fachliches Bestelldatum des AG2022-06-12T10:30:00+01:00ProductOrder.orderPostedDate
Kategorie (Leistungsänderung)productChange
Geschäftsfall NameproductModificationProductOrder.category
Kundendaten
Kundenwunschtermin2022-12-
01T08
01T12:00:00+01:00
requestedCompletionTimePeriod.startDateTime

(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

Auftraggeberdaten

Auftraggeber
Leistungs-Nummer500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="

customerServiceContract

buyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

ProductOrder/agreement.engagedParty.role="customer"

Externe Auftragsnr.
Externe Auftragsnr.
1000222

1000223

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner Auftragsmanagement

Role
orderManagementCustomerContact
orderManagementBuyerContactrelatedParty.role
AnredeHerrrelatedParty.salutation
TitelCaptainrelatedParty.title
VornameJames T.relatedParty.givenName
NachnameKirkrelatedParty.familyName
Telefonnummer0221 456789

relatedParty/contactMedium

.mediumType = phone

/characteristic.phoneNumber 

relatedParty/contactMedium.contactType = fixedPhone

relatedParty/contactMedium/characteristic.contactType = fixed

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer017754545454

relatedParty/contactMedium.mediumType = phone

relatedParty/contactMedium/characteristic.contactType = mobile

relatedParty/contactMedium/characteristic.phoneNumber 

Email-
adresse
Adressej.kirk@example.net

relatedParty/contactMedium.mediumType = email

relatedParty/contactMedium/characteristic.contactType = email

relatedParty/contactMedium/characteristic.emailAddress

Produktdaten

neues Produkt
Auftragsposition1ProductOrderItem.id
AktionscodeaddProductOrderItem.action
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

(tbd)

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


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