Beschreibung
Titel | Auftrag (Providerwechsel / Verbundleistung) anlegen |
---|---|
Kurzbeschreibung | Folgender Ablauf beschreibt die typischen Interaktionen zwischen dem aufnehmenden Auftrageber (EKPauf und TNBauf, im zweiten Sequenzdiagramm "Buyer of new line" bezeichnet), dem Leistungserbringer (LE, im zweiten Sequenzdiagramm "Seller of new line" bzw. "Seller of old line" bezeichnet) und dem abgebenden Auftraggeber (EKPab und TNBab, im zweiten Sequenzdiagramm "Buyer of old line" bezeichnet) im Anwendungsfall "Auftrag (Providerwechsel / Verbundleistung) anlegen" von der Anlage des Auftrags bis zu seinem Abschluss. Ein Providerwechsel / Verbundleistung sind 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. Dabei werden die für diesen Ablauf erforderlichen Auftrags-Status durchlaufen und die für diesen Ablauf relevanten Informationen übermittelt. Zu diesen Anwendungsfall sind die zwei folgenden Sequenzen relevant:
|
Vorbedingung |
|
Auslöser | Der aufnehmende Auftraggeber legt einen Auftrag für den Providerwechsel bzw. die Verbundleistung beim Leistungserbringer (ANE) an. |
Ergebnis | Das Produkt wurde erfolgreich bereitgestellt. Voraussetzung für eine erfolgreiche Bereitstellung des Produktes durch den EKPauf ist die Zustimmung des TNBab zum Wechsel des EKP (siehe /wiki/spaces/tfit/pages/233282053) |
Ablauf
Durchführung der Vorabstimmung
Die Vorabstimmung wird durch die WBCI Schnittstelle zwischen EKPauf und EKPabg durchgeführt.
Der Auftrag enthält als wesentliches Kennzeichen die VorabstimmungsID des EKPauf. Folgende Informationen werden in Bezug auf die Ressource und für die Übernahme für den daraufolgenden Providerwechsel / Verbundleistung Auftrag ausgetauscht.
- Ermittlung des Wechseldatums durch den EKPabg
- Ermittlung der WITA Vertragsnummer (Telekom) bzw LINE-ID (NGAB) , sowie der Technologie der Ressource durch den EKPabg
- Klärung, ob die Ressource übernommen werden soll durch den EKPauf
Produktbeauftragung
Die Produtbeauftragung gliedert sich in zwei Abschnitte
- Die Product Order mit der Category "providerChange" bzw. "providerTechnologyChange", welche vom AGauf an den LE gestellt wird
- Die Product Order mit der Category "terminationProviderChange", welche der LE einstellt.
Während der AGauf die üblichen Möglichkeiten zur Steuerung der ersten Product Order hat (Stornierung, Terminverschiebung etc.), hat der AGab nur am Anfang die Möglichkeit, dem Wechsel zu widersprechen.
Darüber hinausgehende, technisch denkbare Möglichketen der Einflussnahme durch dem AGab (Stornierung, Terminverschiebung etc.) müssen vom LE abgewiesen werden.
Beispieldaten (linker Block, TNBauf ↔ ANE)
Post ProductOrder (providerChange)
fachliche Felder | Daten | API Felder |
---|---|---|
Auftragsdaten | ||
fachliches Bestelldatum des AG | 2022-05-11T10:30:00+01:00 | productOrder.orderPostedDate |
Geschäftsfall | providerChange | productOrder.category |
Kundendaten | ||
Kundenwunschtermin | 2022-12-01T12:00:00+01:00 (Uhrzeit fachlich nicht relevant, aber technisch erforderlich) | requestedCompletionDate |
LageTAE_ONT | Flur | product.networkTerminationLocation |
HomeID | a12d5a4545 | productOrderItem/product.homeID |
SeriennummerONT | 1515515155115 | additionalOrderInformation.hardwareIdType = "OntSerialNumber" additionalOrderInformation.hardwareIdValue = "1234567890" |
Anschlussadresse | ||
Role | locationA | productOrderIteam/product/place.role |
Straßenname | Biberweg | productOrderIteam/product/place.streetName |
Hausnummer | 2 | productOrderIteam/product/place.streetNr |
Hausnummernzusatz | a | productOrderIteam/product/place.streetNrSuffix |
Gebäudeteil | Einfamilienhaus | productOrderIteam/product/place.geographicSubAddress.buildingName |
Land | DEU | productOrderIteam/product/place.country |
Postleitzahl | 59055 | productOrderIteam/product/place.postcode |
Ortsname | Rheinhausen | productOrderIteam/product/place.city |
zur Anschlussadresse gehörender Name ("Klingelschild") | ||
Role | locationAContact | relatedParty.role |
Anrede | Herr | relatedParty.salutation |
Vorname | Maximilian | relatedParty.givenName |
Nachname | Müller | relatedParty.familyName |
Vorabstimmungsdaten | ||
VA-ID | DEU.1UND1.V012345678 | ProductOrder/agreement.businessId = "DEU.VFD.V012345678" ProductOrder/agreement.agreementType="providerChangeAgreement" ProductOrder/agreement.name ="providerChangeAgreement" |
Installationskontakt | ||
Role | installationContact | relatedParty.role |
Anrede | Herr | relatedParty.salutation |
Vorname | Alexander | relatedParty.givenName |
Nachname | Fischer | relatedParty.familyName |
Telefonnummer | 0221/145155 | relatedParty/contactMedium.mediumType = "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "fixed" relatedParty/contactMedium/characteristic.phoneNumber |
Mobilfunknummer | 17878878788 | relatedParty/contactMedium.mediumType = "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "mobile" relatedParty/contactMedium/characteristic.phoneNumber |
Email-Adresse | a.fischer@example.net | relatedParty/contactMedium.mediumType = "EmailContactMedium" relatedParty/contactMedium/characteristic.contactType = email relatedParty/contactMedium/characteristic.emailAddress |
Produktdaten | ||
orderItem 1 (im Rahmen des Providerwechsel bestelltes Produkt) | ||
ID | 1 | productOrderItem.id |
Geschäftsfall | add | productOrderItem.action |
Produktname | FTTH L2 PON 1000 500 | productOrderItem/productOffering.name |
Beziehung | productOrderItem.orderItemRelationship.id = 2 productOrderItem.orderItemRelationship.relationshipType = "migrateFrom" | |
orderItem 2 (wegfallendes Produkt des abgebenden Anbieters) | ||
ID | 2 | productOrderItem.id |
Geschäftsfall | transfer | productOrderItem.action |
Identifikation des Inventars Produkt Identifier | 388a4963-f168-4603-99e8-477200099d91 | Product.id |
Auftraggeberdaten | ||
Auftraggeber | ||
Leistungs-Nummer | 500012 | ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="buyerServiceContract" |
Auftraggeber-Nummer | 500011 | ProductOrder/agreement.engagedParty.businessId |
Besteller | ||
Leistungs-Nummer | 500013 | ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="ordererServiceContract" |
Auftraggeber-Nummer | 500014 | ProductOrder/agreement.engagedParty.businessId |
Extrerne Autftragsnummer |
| |
Externe Auftragsnr. | 1000111 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.mediumType = "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "fixed" relatedParty/contactMedium/characteristic.phoneNumber |
Mobilfunknummer | 017754545454 | relatedParty/contactMedium.mediumType = "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "mobile" relatedParty/contactMedium/characteristic.phoneNumber |
Email-Adresse | j.kirk@example.net | relatedParty/contactMedium.mediumType = "EmailContactMedium" relatedParty/contactMedium/characteristic.contactType = "email" relatedParty/contactMedium/characteristic.emailAddress |
Response (2)
ProductOrderStateChangeEvent: Accepted
fachliche Felder | Daten | API Felder |
Orderstatus | accepted | state |
OrderstatusChangeDate | 2022-05-11T10:31:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-05-11T10:32:00+01:00 | eventTime |
Grund der Änderung | 0000 "Keine Änderung zum Auftrag" | stateChangeReason.code stateChangeReason.description |
ProductOrderAttributeValueChange
fachliche Felder | Daten | API Felder |
technisches EventDatum | 2022-05-11T10:33:00+01:00 | eventTime |
Supplier-Daten | ||
Rolle | orderManagementSupplierContact | relatedParty.role |
Anrede | Frau | relatedParty.salutation |
Vorname | Lisa | relatedParty.givenName |
Nachname | Bach | relatedParty.familyName |
Telefonnummer | 0221/789456 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = fixed relatedParty/contactMedium/characteristic.phoneNumber |
Mobilfunknummer | 0178/78787878 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = mobile relatedParty/contactMedium/characteristic.phoneNumber |
Email-Adresse | l.bach@example.net | relatedParty/contactMedium.mediumType = email relatedParty/contactMedium/characteristic.contactType = email relatedParty/contactMedium/characteristic.emailAddress |
Daten vom abgebenden Provider | ||
Rolle | handingOverProvider | relatedParty.role |
Providername | 1&1 Internet AG | relatedParty.name |
Zustimmung Providerwechsel | TRUE | productOrder/providerChangeInfo.approval |
Antwortcode | 0000 | productOrder/providerChangeInfo.responseReason[0].code |
Antworttext | "keine Anmerkungen" | productOrder/providerChangeInfo.responseReason[0].description |
weitere Daten | ||
Vertragsnummer | 555001 | ProductOrder/agreement.businessId |
verbindlicher Liefertermin (Datum) | 2022-12-16T12:00:00+01:00 (Uhrzeit fachlich nicht relevant, aber technisch erforderlich) | expectedCompletionDate |
Datum+Zeitfenster (wenn erforderlich, z.B. bei Technikertermin beim Endkunden) | 2022-12-16T08:00:00+01:00 2022-12-16T12:00:00+01:00 | productOrderItem.appointment.validFor.startDateTime productOrderItem.appointment.validFor.endDateTime |
Termin beim Endkunden erforderlich | TRUE | ProductOrderItem.endUserAppointmentIsNecessary |
Anschluss (a10nsp) | 4711 | productOrderItem/product.enni |
Anschluss (port) | 4 | productOrderItem/product.port |
Anschluss (s-vlan) | 3120 | productOrderItem/product.svlan |
Anschluss (c-vlan) | 7 | productOrderItem/product.cvlan |
Anschluss (lineId) | DEU.DTAG.FTYLIQ7PFT | productOrderItem/product.accessLineId |
Anschluss (uebergabepunktKunde) | TAE | product.accessTerminationInterface |
ProductOrderStateChangeEvent: inProgress (identisch zu Geschäftsfall Neu)
ProductOrderStateChangeEvent: inProgress | ||
fachliche Felder | Daten | API Felder |
Orderstatus | inProgress | state |
fachliches Änderungsdatum | 2022-05-20T10:40:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-05-20T10:40:00+01:00 | eventTime |
Grund der Änderung | 0000 "Keine Änderung zum Auftrag" | stateChangeReason.code stateChangeReason.description |
ProductOrderStateChangeEvent: completed (identisch zu Geschäftsfall Neu)
ProductOrderStateChangeEvent: completed | ||
fachliche Felder | Daten | API Felder |
Orderstatus | completed | state |
fachliches Änderungsdatum | 2022-12-16T10:45:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-12-16T10:45:00+01:00 | eventTime |
Grund der Änderung | 0010 "Auftrag ausgeführt." | stateChangeReason.code stateChangeReason.description |
ProductOrderAttributeValueChange (identisch zu Geschäftsfall Neu)
ProductOrderAttributeValueChange (setzen von startDate) | ||
fachliche Felder | Daten | API Felder |
technisches EventDatum | 2022-12-16T10:45:30+01:00 | eventTime |
Nutzungsdatum | 2022-12-16T10:45:00+01:00 | product.startDate |
ProductOrderStateChangeEvent: closed (identisch zu Geschäftsfall Neu)
ProductOrderStateChangeEvent: closed | ||
fachliche Felder | Daten | API Felder |
Orderstatus | closed | state |
fachliches Änderungsdatum | 2022-12-16T10:46:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-12-16T10:46:00+01:00 | eventTime |
Grund der Änderung | 0010 "Auftrag ausgeführt." | stateChangeReason.code stateChangeReason.description |