Beschreibung
| Titel | Auftrag (Änderung) anlegen |
|---|---|
| Kurzbeschreibung | Folgender Ablauf beschreibt die typischen API-Interaktionen zwischen Auftraggeber und Leistungserbringer im Anwendungsfall "Änderung durch Auftraggeber/Kunde". Dieser Anwendungsfall behandelt die Änderung eines Produktes durch den Auftraggeber. Änderung steht hier als Überbegriff für Leistungs-, Leistungsmerkmal-Änderungen und Produktgruppenwechsel. 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 |
| Vorbedingung |
|
| Auslöser | Der Auftraggeber legt einen Änderungsauftrag an. |
| Ergebnis | Das Produkt wurde geändert |
Ablauf
Auftrag Produktänderung - Strukturelle Darstellung
Wechselgeschäftsfälle - Beispiele
| Use Case | Produkt alt | Produkt neu | Beschreibung | Hinweis |
|---|---|---|---|---|
| NEU | VDSL-SA 25 Mbit/s | |||
| KUE | VDSL-SA 25 Mbit/s | |||
| LMAE - xDSL/FTTH | VDSL-SA 25 Mbit/s | VDSL-SA 25 Mbit/s Express-Entstörung Wholesale | Leistungsmerkmal kommt hinzu | |
VDSL-SA 25 Mbit/s Express-Entstörung Wholesale | VDSL-SA 25 Mbit/s | Leistungsmerkmal fällt weg | ||
| LMAE - TAL | TAL; CuDA 4 Draht hbr (HVt) H03 | TAL; CuDA 4 Draht hbr (HVt) H06 | Änderung des Übertragungsverfahrens TAL | |
| LAE | VDSL-SA 25 Mbit/s | VDSL-SA 50 Mbit/s | Produktvariante ändert sich | |
| VDSL-SA 25 Mbit/s | VDSL-SA 50 Mbit/s Express-Entstörung Wholesale | Produktvariante ändert sich und ein Leistungsmerkmal kommt hinzu | ||
| PGW | VDSL-SA 25 Mbit/s Dienstvertrag: 0815 Provider: A | FTTH 50000 Dienstvertrag: 0816 Provider: A | Produktgruppe ändert sich | ggf. kommen hier noch weitere Leistungsmerkmale hinzu |
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) | ggf. kommen hier noch weitere Leistungsmerkmale hinzu | |
VDSL-SA 25 Mbit/s Dienstvertrag: 0814 Provider: A | VDSL-SA 50 Mbit/s Dienstvertrag: 0815 Provider: A | Dienstvertrag und Produktvariante ändert sich | ggf. kommen hier noch weitere Leistungsmerkmale hinzu | |
| PV | VDSL-SA 25 Mbit/s Provider A | VDSL-SA 25 Mbit/s Provider B | Provider ändert sich unter Beibehaltung der Produktvariante | ggf. kommen hier noch weitere Leistungsmerkmale hinzu |
VDSL-SA 25 Mbit/s Provider A | VDSL-SA 50 Mbit/s Provider B | Provider und Produktvariante ändert sich | ggf. kommen hier noch weitere Leistungsmerkmale hinzu | |
| VBL | VDSL-SA 25 Mbit/s Provider A Dienstvertrag: 0815 | FTTH 50000 Provider B Dienstvertrag: 1815 | Produktgruppe und Provider ändern sich | ggf. kommen hier noch weitere Leistungsmerkmale hinzu |
Telekom-Produkt Provider A | FTTH 50000 Provider B Dienstvertrag: 1815 |
Beispiele Auftrag (Änderung) - Wechselgeschäftsfälle LAE, LMAE & PGW
Auftragsstruktur LAE, LMAE & PGW
Begleitende Auftragsinformationen
Referenz Beispieldaten für Auftragsinformationen: aktualisierte Beispieldaten
| AuftragsInformation | LMAE - xDSL/FTTH1 | LMAE - xDSL/FTTH2 | LMAE - TAL | LAE1 | LAE2 | PGW1 | PGW2 | PGW3 |
|---|---|---|---|---|---|---|---|---|
| fachliches Bestelldatum des AG | X | X | X | X | X | X | X | X |
| Kundenwunschtermin | X | X | X | X | X | X | X | X |
| LageTAE_ONT | - | - | - | - | - | - | - | - |
| HomeID | - | - | - | - | - | - | - | - |
| SeriennummerONT | - | - | - | - | - | - | - | - |
| Anschlussadresse | - | - | - | - | - | - | - | - |
| zur Anschlussadresse gehörender Name ("Klingelschild") | - | - | - | - | - | - | - | - |
| Vormieterdaten | - | - | - | - | - | - | - | - |
| Installationskontakt | - | - | - | - | - | - | - | - |
| Auftraggeber | X | X | X | X | X | X | X | X |
| Besteller | X | X | X | X | X | X | X | X |
| Externe Auftragsnr. | X | X | X | X | X | X | X | X |
| Ansprechpartner / Auftragsmanagement | X | X | X | X | X | X | X | X |
| VorabstimmungsId | - | - | - | - | - | - | - | - |
| Projektkenner | X | X | X | X | X | X | X | X |
| Kopplungskenner | X | X | X | X | X | X | X | X |
| Auftragsklammer | X | X | X | X | X | X | X | X |
| Anzahl Aufträge | X | X | X | X | X | X | X | X |
Beispieldaten
Leistungsänderung
| fachliche Felder | Daten | API Felder |
|---|---|---|
| technische Daten | ||
| fachliches Bestelldatum des AG | 2022-06-12T10:30:00+01:00 | ProductOrder.orderPostedDate |
| Kategorie (Leistungsmerkmaländerung) | productModification | ProductOrder.category |
| Kundendaten | ||
| Kundenwunschtermin | 2022-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 | 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 | ||
| Role | orderManagementBuyerContact | relatedParty.role |
| Anrede | Herr | relatedParty.salutation |
| Titel | Captain | relatedParty.title |
| Vorname | James T. | relatedParty.givenName |
| Nachname | Kirk | relatedParty.familyName |
| Telefonnummer | 0221 456789 | relatedParty/contactMedium/characteristic.phoneNumber relatedParty/contactMedium.contactType = fixedPhone relatedParty/contactMedium/characteristic.contactType = fixed relatedParty/contactMedium/characteristic.phoneNumber |
| Mobilfunknummer | 017754545454 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = mobile relatedParty/contactMedium/characteristic.phoneNumber |
| Email-adresse | j.kirk@example.net | relatedParty/contactMedium.mediumType = email relatedParty/contactMedium/characteristic.contactType = email relatedParty/contactMedium/characteristic.emailAddress |
| Produktdaten | ||
| neues Produkt | ||
| Auftragsposition | 1 | ProductOrderItem.id |
| Aktionscode | add | ProductOrderItem.action |
| Produktname | FTTH L2 PON 100 50 | ProductOrderItem/productOffering.name |
| Wunschzeitfenster | 2022-12-01T08:00:00+01:00 2022-12-01T12:00:00+01:00 | productOrderItem.requestedTimeSlot.startDateTime productOrderItem.requestedTimeSlot.endDateTime |
| Beziehung zum zweiten ProductOrderItem | 2 | ProductOrderItem/productOrderItemRelationship.id |
| migrateFrom | ProductOrderItem/productOrderItemRelationship.relationshipType | |
| altes Produkt | ||
| Auftragsposition | 2 | ProductOrderItem.id |
| Aktionscode | delete | ProductOrderItem.action |
| Identifizierung des Altproduktes | 922ebf01-e930-47a0-842e-059d1f188a15 | ProductOrderItem/product.id |
Leistungsmerkmaländerung: Zubuchung Expressentstörung
| fachliche Felder | Daten | API Felder |
|---|---|---|
| technische Daten | ||
| fachliches Bestelldatum des AG | 2022-06-12T10:30:00+01:00 | ProductOrder.orderPostedDate |
| Kategorie (Leistungsänderung) | productModification | ProductOrder.category |
| Kundendaten | ||
| Kundenwunschtermin | 2022-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 | 500012 | 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 | ||
| Role | orderManagementBuyerContact | relatedParty.role |
| Anrede | Herr | relatedParty/party/salutation |
| Titel | Captain | relatedParty/party/title |
| Vorname | James T. | relatedParty/party/givenName |
| Nachname | Kirk | relatedParty./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-adresse | j.kirk@example.net | relatedParty/party/contactMedium.@Type = EmailContactMedium relatedParty/party/contactMedium.contactType = email relatedParty/party/contactMedium.emailAddress |
| Produktdaten | ||
| Hauptprodukt (ändert sich nicht) | ||
| Auftragsposition | 1 | ProductOrderItem.id |
| Aktionscode | noChange | ProductOrderItem.action |
| Identifizierung des Hauptproduktes | 922ebf01-e930-47a0-842e-059d1f188a16 | ProductOrderItem/product.id |
| neu zugebuchtes Produkt | ||
| Auftragsposition | 2 | ProductOrderItem.id |
| Aktionscode | add | ProductOrderItem.action |
| Produktname | Expressentstörung | ProductOrderItem/productOffering.name |
| Wunschzeitfenster | 2022-12-01T08:00:00+01:00 2022-12-01T12:00:00+01:00 | productOrderItem.requestedTimeSlot.startDateTime productOrderItem.requestedTimeSlot.endDateTime |
| Beziehung zum zweiten ProductOrderItem | 1 | ProductOrderItem/productOrderItemRelationship.id |
| dependsOn | ProductOrderItem/productOrderItemRelationship.relationshipType | |
Leistungsmerkmaländerung: Änderung des Übertragungsverfahrens mit Änderung des
Verbindungskabels zum Übergabeverteiler
| fachliche Felder | Daten | API Felder |
|---|---|---|
| technische Daten | ||
| fachliches Bestelldatum des AG | 2022-06-12T10:30:00+01:00 | ProductOrder.orderPostedDate |
| Kategorie (Leistungsänderung) | productModification | ProductOrder.category |
| Kundendaten | ||
| Kundenwunschtermin | 2022-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 | 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 | ||
| Role | orderManagementBuyerContact | relatedParty.role |
| Anrede | Herr | relatedParty/party/salutation |
| Titel | Captain | relatedParty/party/title |
| Vorname | James T. | relatedParty/party/givenName |
| Nachname | Kirk | relatedParty./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-adresse | j.kirk@example.net | relatedParty/party/contactMedium.@Type = EmailContactMedium relatedParty/party/contactMedium.contactType = email relatedParty/party/contactMedium.emailAddress |
| Produktdaten | ||
| Produkt | ||
| Auftragsposition | 1 | ProductOrderItem.id |
| Aktionscode | modify | ProductOrderItem.action |
| Identifizierung des Produktes | 922ebf01-e930-47a0-842e-059d1f188a17 | ProductOrderItem/product.id |
| Wunschzeitfenster | 2022-12-01T08:00:00+01:00 2022-12-01T12:00:00+01:00 | productOrderItem.requestedTimeSlot.startDateTime productOrderItem.requestedTimeSlot.endDateTime |
| geändertes Übertragungsverfahren | H04 | ProductOrderItem/product.transmissionMethod |
| geänderter Übergabeverteiler | 0401 | ProductOrderItem/product.uevt |
| geänderter Endverschluss | 16 | ProductOrderItem/product.evs |
| geänderte Doppelader | 01 | ProductOrderItem/product.copperPairId |