Beschreibung

Titel	Auftrag (Providerwechsel / Verbundleistung) anlegen
Kurzbeschreibung	Folgender Ablauf beschreibt die typischen API Interaktionen zwischen dem aufnehmenden Auftrageber (EKPauf und TNBauf, aka AGauf), dem Leistungserbringer (LE, aka ANE) und dem abgebenden Auftraggeber (EKPab und TNBab, aka ABab) für die Anwendungsfälle "Auftrag (Providerwechsel / Verbundleistung) anlegen - Gutfall". Zu diesen Anwendungsfall sind zwei Sequenzen relevant: Die Vorabstimmung Die Durchführung
Vorbedingung	Rahmenverträge und Dienstverträge sind vorhanden Der Auftraggeber hat die Verfügbarkeit des Produktes geprüft der AGab hat sich beim LE für Kündigungen durch den Leistungserbringer registriert (siehe Auftrag (Kündigung durch LE) anlegen)
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

Ablauf

Durchführung der Vorabstimmung

Die Vorabstimmung wird von der WBCI übernommen.

Sie wird zwischen EKPauf und EKPab durchgeführt und dient der

Ermittlung des Wechseldatums
Ermittlung der WITA Vertragsnummer
Ermittlung der VorabstimmungsID
Klärung, ob die Ressource übernommen werden soll

Vorabstimmung

@startuml
autonumber
box WBCI
participant eauf as "EKP auf"
participant eab as "EKP ab"

eauf -> eab: VA-KUE-MRN
eauf <- eab: REUM-VA
eauf -> eab: AK-MTR

Produktbeauftragung

Die Produtbeauftragung gliedert sich in zwei Abschnitte

Die Product Order mit der Category "Providerwechsel" bzw. "Verbundleistung", welche vom AGauf an den LE gestellt wird
Die Product Order mit der Category Kündigung durch "Leistungserbringer", 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.

Produktbeauftragung

@startuml
autonumber
   
box Product Order vom Typ PV (PO)
participant eauf as "EKP auf + TNB auf (AG auf)"
participant tauf as "ANE (LEauf)"
   
box  (Sub)Product Order vom Typ KUE-LE (PO2)
participant leab as "ANE (LEab)"
participant tab as "TNB ab + EKPab (AG ab)"
   
   
eauf -> tauf: POST ProductOrder(productOrderItemCreate, VAId)
note right: PV
alt Fehlschlag Kaufmännische Validierung
  eauf <- tauf: ProductOrderStatusChangeEvent(PO, Rejected)
else Happy Path
  eauf <- tauf: ProductOrderStatusChangeEvent(PO, Acknowleged)
  tauf -> leab: notifyKUE
  note over leab, tab: Die Sequenz [[https://confluence.t-systems-mms.eu/pages/viewpage.action?pageId=547957140 Auftrag (Kündigung durch LE, GF PV/VBL) anlegen]] hier wird includiert
  leab ->tauf:notifyRUEM-PV(approval, reason)
  alt negative RUEM-PV
    note over eauf, tauf: Siehe [[https://confluence.t-systems-mms.eu/pages/viewpage.action?pageId=587837181 1) Negative RespondProviderChange (RUEM-PV)]] 
  else Happy Path 
    alt Fehlschlag  + Technische Validierung + Erteilung
      eauf <- tauf: ProductOrderStatusChangeEvent(PO, Rejected)
      tauf -> leab: notifyRejected
      leab -> tab: ProductOrderStatusChangeEvent(PO2, Rejected)
    else Happy Path  
      eauf <- tauf: ProductOrderStateChangeEvent(PO,InProgress)
      tauf -> leab:notifyInProgress
      leab -> tab: ProductOrderStatusChangeEvent(PO2, InProgress)
      note right: ABM-PV
      alt Fehlschlag während der Realisierung
        note over eauf, tauf: Siehe [[https://confluence.t-systems-mms.eu/display/tfit/2%29+Fehlschlag+beim+Leistungserbringer 2) Fehlschlag beim Leistungserbringer]] 
      else Happy Path
        alt Fehlschlag am Schalttag
          note over eauf, tauf: Siehe [[https://confluence.t-systems-mms.eu/display/tfit/3%29+Fehlschlag+am+Schalttag 3) Fehlschlag am Schalttag]] 
        else Happy Path
          eauf <- tauf: ProductOrderStateChangeEvent(PO,Completed)
          tauf -> leab:notifyInCompleted
          leab -> tab: ProductOrderStatusChangeEvent(PO2, Completed)
          note right: ERLM-PV
          eauf <- tauf: ProductOrderStateChangeEvent(PO,Closed)
          tauf -> leab:notifyInClosed
          leab -> tab: ProductOrderStatusChangeEvent(PO2, Closed)
          note right: ENTM-PV
        end
      end
    end
  end
end
@enduml

ToDos:

Resourcenmodell erweitern (siehe GF Providerwechsel / Verbundleistung)

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
Kategorie = Providerwechsel	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/realizingResource.value productOrderItem/realizingResource.@referredType = homeId
SeriennummerONT	1515515155115	productOrderItem/realizingResource.value productOrderItem/realizingResource.@referredType = ont
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 productOrder/agreement/agreementType="preAgreement"
Installationskontakt
Role	installationContact	relatedParty.role
Anrede	Herr	relatedParty.salutation
Vorname	Alexander	relatedParty.givenName
Nachname	Fischer	relatedParty.familyName
Telefonnummer	0221/145155	relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = fixed relatedParty/contactMedium/characteristic.phoneNumber
Mobilfunknummer	17878878788	relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = mobile relatedParty/contactMedium/characteristic.phoneNumber
Email-adresse	a.fischer@example.net	relatedParty/contactMedium.mediumType = email 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"
Wunschzeitfenster	2022-12-01T08:00:00+01:00 2022-12-01T12:00:00+01:00	productOrderItem.requestedTimeSlot.startDateTime productOrderItem.requestedTimeSlot.endDateTime
orderItem 2 (wegfallendes Produkt des abgebenden Anbieters)
ID	2	productOrderItem.id
Geschäftsfall	transfer	productOrderItem.action
Produkt-ID	922ebf01-e930-47a0-842e-059d1f188a15	ProductOrderItem/product.id
Href	...	ProductOrderItem/product.href
Auftraggeberdaten
Auftraggeber
Leistungs-Nummer	500012	ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="customerServiceContract"
Auftraggeber-Nummer	500011	ProductOrder/agreement.engagedParty.businessId ProductOrder/agreement.engagedParty.role="customer"
Besteller
Leistungs-Nummer	500013	ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="ordererServiceContract"
Auftraggeber-Nummer	500014	ProductOrder/agreement.engagedParty.businessId ProductOrder/agreement.engagedParty.role="orderer"
Extrerne Autftragsnr.
Externe Auftragsnr.	1000111 DEU.VFD	ProductOrder/externalIdentifier.id ProductOrder/externalIdentifer.owner (=ITU-Kennung) ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder
Ansprechpartner / Auftragsmanagement
Role	orderManagementCustomerContact	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 = phone 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

ProductOrderStateChangeEvent: Acknowledged

fachliche Felder	Daten	API Felder
Orderstatus	acknowledged	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 ProductOrder/agreement.agreementType="singleContract"
verbindlicher Liefertermin (Datum)	2022-12-16T12:00:00+01:00 (Uhrzeit fachlich nicht relevant, aber technisch erforderlich)	expectedCompletionDate
verbindlicher Liefertermin (Zeitfenster)	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.customerAppointmentIsNecessary
Anschluss (a10nsp)	4711	productOrderItem/product.transportInterconnectionPoint
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

Auftrag (Providerwechsel / Verbundleistung) anlegen