Versionen im Vergleich

Version Alte Version 35 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

Drawio
bordertrue
diagramNameÄnderungsauftrag Struktur
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth859
revision13

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

...

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
diagramNameAuftragsstruktur LAE, LMAE, PGW
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth10421035
revision816

Begleitende Auftragsinformationen

Referenz Beispieldaten für Auftragsinformationen: aktualisierte Beispieldaten 30.09.2022

...

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
showLineNumberssyntaxHighlightingtrue
progLangplain
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

neues
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-01T0801T12:00:00+01:00
requestedCompletionTimePeriod.startDateTime(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

Auftraggeberdaten

Auftraggeber
Leistungs-Nummer500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="customerServiceContractbuyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

ProductOrder/agreement.engagedParty.role="customer"

Externe Auftragsnr.
Externe Auftragsnr.

10002231000222

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner Auftragsmanagement

RoleorderManagementCustomerContactorderManagementBuyerContactrelatedParty.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.emailAddress

Produktdaten

emailAddress 

Produktdaten

Hauptprodukt (ändert sich nicht)
Auftragsposition1ProductOrderItem.id
AktionscodenoChangeProductOrderItem.action

Identifizierung des Hauptproduktes

922ebf01-e930-47a0-842e-059d1f188a16ProductOrderItem/product.id
neu zugebuchtes Produkt
Auftragsposition12ProductOrderItem.id
AktionscodeaddProductOrderItem.action
ProduktnameFTTH L2 PON 100 50Expressentstö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

...

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
Kategorie (Leistungsänderung)
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-Nummer
500012
500013

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/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
Aktionscode
noChange
modifyProductOrderItem.action

Identifizierung des

Hauptproduktes

Produktes

922ebf01-e930-47a0-842e-
059d1f188a16
059d1f188a17ProductOrderItem/product.id
neu zugebuchtes ProduktAuftragsposition2
geändertes ÜbertragungsverfahrenH04ProductOrderItem/product.
id
transmissionMethod
Aktionscode
geänderter Übergabeverteiler
add
0401ProductOrderItem/product.
action
uevt
Produktname
geänderter Endverschluss
Expressentstörung
16ProductOrderItem/
productOffering
product.
nameBeziehung zum zweiten ProductOrderItem1
evs
geänderte Doppelader01ProductOrderItem/
productOrderItemRelationship.iddependsOnProductOrderItem/productOrderItemRelationship.relationshipType

...

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
syntaxHighlightingJSON

ProductOrderItem/product.transmissionMethod
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-01T0801T12:00:00+01:00
requestedCompletionTimePeriod.startDateTime(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

Auftraggeberdaten

Auftraggeber
Leistungs-Nummer500013500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="customerServiceContractbuyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

ProductOrder/agreement.engagedParty.role="customer"

Externe Auftragsnr.
Externe Auftragsnr.

1000223

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner Auftragsmanagement

RoleorderManagementCustomerContactorderManagementBuyerContactrelatedParty.role
AnredeHerrrelatedParty/party/.salutation
TitelCaptainrelatedParty/party/.title
VornameJames T.relatedParty/party/.givenName
NachnameKirkrelatedParty./party/familyName
Telefonnummer+492214567890221 456789

relatedParty/party/contactMedium/characteristic.phoneNumber 

relatedParty/contactMedium.@Type contactType = PhoneContactMediumfixedPhone

relatedParty/partycontactMedium/contactMediumcharacteristic.contactType = fixedPhonefixed

relatedParty/partycontactMedium/contactMediumcharacteristic.phoneNumber 

Mobilfunknummer+4917754545454017754545454

relatedParty/party/contactMedium.@Type mediumType = PhoneContactMediumphone

relatedParty/partycontactMedium/contactMediumcharacteristic.contactType = mobilePhonemobile

relatedParty/partycontactMedium/contactMediumcharacteristic.phoneNumber 

Email-adresseAdressej.kirk@example.net

relatedParty/party/contactMedium.@Type mediumType = EmailContactMediumemail

relatedParty/partycontactMedium/contactMediumcharacteristic.contactType = email

relatedParty/partycontactMedium/contactMediumcharacteristic.emailAddress emailAddress

Produktdaten

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

Produktes

Altproduktes

922ebf01-e930-47a0-842e-059d1f188a17059d1f188a15ProductOrderItem/product.idneues ÜbertragungsverfahrenH05


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