Document toolboxDocument toolbox

Auftrag (Providerwechsel / Verbundleistung) anlegen

Beschreibung

TitelAuftrag (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 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.

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:

  1. Die Vorabstimmung
  2. Die Durchführung
Vorbedingung
  • Rahmenverträge und Dienstverträge sind vorhanden
  • Der Auftraggeber hat die Verfügbarkeit des Produktes geprüft
  • Mindestens alle Pflichtfelder für eine Product Order im Anwendungsfall PV oder VBL sind laut Auftrags-/Meldungsstruktur (download) gefüllt.
  • Es liegt kein anderer offener Auftrag zum betroffenen Bestand (z.B. für den Anschluss oder dem Übertragungsweg) für den Wechselauftrag vor.
AuslöserDer 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 RespondProviderChange)

Ablauf

Durchführung der Vorabstimmung

Die Vorabstimmung wird unter Verwendung der 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 Produktbeauftragung 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) (1)

Post ProductOrder (providerChange)

fachliche FelderDaten API Felder
Auftragsdaten

fachliches Bestelldatum des AG2022-05-11T10:30:00+01:00productOrder.orderPostedDate
GeschäftsfallproviderChangeproductOrder.category
Kundendaten
Kundenwunschtermin2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

LageTAE_ONTFlur

product.networkTerminationLocation

HomeIDa12d5a4545

productOrderItem/product.homeID 

SeriennummerONT1515515155115

additionalOrderInformation.hardwareIdType = "OntSerialNumber"

additionalOrderInformation.hardwareIdValue = "1234567890"

Anschlussadresse
RolelocationAproductOrderIteam/product/place.role
StraßennameBiberwegproductOrderIteam/product/place.streetName
Hausnummer2productOrderIteam/product/place.streetNr
HausnummernzusatzaproductOrderIteam/product/place.streetNrSuffix
GebäudeteilEinfamilienhausproductOrderIteam/product/place.geographicSubAddress.buildingName
LandDEUproductOrderIteam/product/place.country
Postleitzahl59055productOrderIteam/product/place.postcode
OrtsnameRheinhausenproductOrderIteam/product/place.city
zur Anschlussadresse gehörender Name ("Klingelschild")
RolelocationAContactrelatedParty.role
AnredeHerrrelatedParty.salutation
VornameMaximilianrelatedParty.givenName
NachnameMüllerrelatedParty.familyName
Vorabstimmungsdaten
VA-IDDEU.1UND1.V012345678

ProductOrder/agreement.businessId = "DEU.VFD.V012345678"

ProductOrder/agreement.agreementType="providerChangeAgreement"

ProductOrder/agreement.name ="providerChangeAgreement"

Installationskontakt
RoleinstallationContactrelatedParty.role
AnredeHerrrelatedParty.salutation
VornameAlexanderrelatedParty.givenName
NachnameFischerrelatedParty.familyName
Telefonnummer0221/145155

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "fixed"

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer17878878788

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "mobile"

relatedParty/contactMedium/characteristic.phoneNumber 

Email-Adressea.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)
ID1productOrderItem.id
GeschäftsfalladdproductOrderItem.action
ProduktnameFTTH L2 PON 1000 500productOrderItem/productOffering.name
Beziehung

productOrderItem.orderItemRelationship.id = 2

productOrderItem.orderItemRelationship.relationshipType = "migrateFrom"

orderItem 2 (wegfallendes Produkt des abgebenden Anbieters)
ID2productOrderItem.id
GeschäftsfalltransferproductOrderItem.action

Identifikation des Inventars

Produkt Identifier


388a4963-f168-4603-99e8-477200099d91


Product.id

Auftraggeberdaten
Auftraggeber

Leistungs-Nummer500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="buyerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

Besteller

Leistungs-Nummer500013

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
RoleorderManagementBuyerContactrelatedParty.role
AnredeHerrrelatedParty.salutation
TitelCaptainrelatedParty.title
VornameJames T.relatedParty.givenName
NachnameKirkrelatedParty.familyName
Telefonnummer0221 456789

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "fixed"

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer017754545454

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "mobile"

relatedParty/contactMedium/characteristic.phoneNumber 

Email-Adressej.kirk@example.net

relatedParty/contactMedium.mediumType = "EmailContactMedium"

relatedParty/contactMedium/characteristic.contactType = "email"

relatedParty/contactMedium/characteristic.emailAddress

Response (2)

ProductOrderStateChangeEvent: Accepted (4)

fachliche FelderDaten API Felder
Orderstatus acceptedstate 
OrderstatusChangeDate2022-05-11T10:31:00+01:00stateChangeDate 
technisches EventDatum2022-05-11T10:32:00+01:00eventTime
Grund der Änderung

0000

"Keine Änderung zum Auftrag"

stateChangeReason.code

stateChangeReason.description

ProductOrderAttributeValueChange (10)

fachliche FelderDatenAPI Felder
technisches EventDatum 2022-05-11T10:33:00+01:00eventTime
Supplier-Daten
Rolle orderManagementSellerContactrelatedParty.role
AnredeFraurelatedParty.salutation
VornameLisarelatedParty.givenName
NachnameBachrelatedParty.familyName
Telefonnummer0221/789456

relatedParty/contactMedium.mediumType = phone

relatedParty/contactMedium/characteristic.contactType = fixed

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer0178/78787878

relatedParty/contactMedium.mediumType = phone

relatedParty/contactMedium/characteristic.contactType = mobile

relatedParty/contactMedium/characteristic.phoneNumber 

Email-Adressel.bach@example.net

relatedParty/contactMedium.mediumType = email

relatedParty/contactMedium/characteristic.contactType = email

relatedParty/contactMedium/characteristic.emailAddress

Daten vom abgebenden Provider
RollehandingOverProvider

relatedParty.role

Providername
1&1 Internet AG

relatedParty.name

Zustimmung ProviderwechselTRUE

productOrder/providerChangeInfo.approval

Antwortcode0000

productOrder/providerChangeInfo.responseReason[0].code

Antworttext"keine Anmerkungen"

productOrder/providerChangeInfo.responseReason[0].description

weitere Daten
Vertragsnummer 555001

ProductOrder/agreement.businessId













ProductOrder/agreement.agreementType="singleContract"

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 erforderlichTRUE

ProductOrderItem.endUserAppointmentIsNecessary

Anschluss (a10nsp)4711productOrderItem/product.enni
Anschluss (port)4productOrderItem/product.port
Anschluss (s-vlan)3120productOrderItem/product.svlan
Anschluss (c-vlan)7productOrderItem/product.cvlan
Anschluss (lineId)DEU.DTAG.FTYLIQ7PFTproductOrderItem/product.accessLineId
Anschluss (uebergabepunktKunde)TAEproduct.accessTerminationInterface

ProductOrderStateChangeEvent: inProgress (identisch zu Geschäftsfall Neu) (11)

ProductOrderStateChangeEvent: inProgress
fachliche FelderDaten API Felder
Orderstatus inProgressstate 
fachliches Änderungsdatum 2022-05-20T10:40:00+01:00stateChangeDate 
technisches EventDatum2022-05-20T10:40:00+01:00eventTime
Grund der Änderung

0000

"Keine Änderung zum Auftrag"

stateChangeReason.code

stateChangeReason.description

ProductOrderStateChangeEvent: completed (identisch zu Geschäftsfall Neu) (15)

ProductOrderStateChangeEvent: completed
fachliche FelderDaten API Felder
Orderstatus completedstate 
fachliches Änderungsdatum 2022-12-16T10:45:00+01:00stateChangeDate 
technisches EventDatum2022-12-16T10:45:00+01:00eventTime
Grund der Änderung

0010

"Auftrag ausgeführt."

stateChangeReason.code

stateChangeReason.description

ProductOrderAttributeValueChange (identisch zu Geschäftsfall Neu) (18)

ProductOrderAttributeValueChange (setzen von startDate)
fachliche FelderDatenAPI Felder
technisches EventDatum 2022-12-16T10:45:30+01:00eventTime
Nutzungsdatum 2022-12-16T10:45:00+01:00product.startDate

ProductOrderStateChangeEvent: closed (identisch zu Geschäftsfall Neu) (19)

ProductOrderStateChangeEvent: closed
fachliche FelderDaten API Felder
Orderstatus closedstate 
fachliches Änderungsdatum 2022-12-16T10:46:00+01:00stateChangeDate 
technisches EventDatum2022-12-16T10:46:00+01:00eventTime
Grund der Änderung

0010

"Auftrag ausgeführt."

stateChangeReason.code

stateChangeReason.description