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 - Schlechtfall Negative RespondProviderChange (RUEM-PV)". 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 abgebende Auftraggeber hat sich beim LE Leistungserbringer für Kündigungen durch den Leistungserbringer registriert (siehe Auftrag (Kündigung durch LE, GF PV/VBL) anlegen )
Auslöser	Der aufnehmende Auftraggeber legt einen Auftrag für den Providerwechsel bzw. die Verbundleistung beim Leistungserbringer (ANE) an. Schlechtfall: Der abgebende Provider Auftraggeber lehnt die Anfrage zum Providerwechsel ab (im Beispiel mit der Begründung: falsche Vorabstimmungs-ID)
Ergebnis	Nach Eingang der negativen RespondProviderChange (RUEM-PV) wird der Auftag wird seitens des Leistungserbringers abgebrochen - Status Rejected Der Leistungserbringer sendet an den aufnehmenden Provider Auftraggeber ein StateChangeEvend "Rejected" (ABBM) Der Leistungserbringer sendet an den abgebenden Provider Auftraggeber ein StateChangeEvend "Rejected" (ABBM-PV)

Ablauf

Img

src

Bitbucket file macro

url

https://wwwbitbucket.plantuml.com/plantuml/png/dLHDSzem4BtxLsWumGpqWqCFJDC9f7I6IJCuG7oNhSLHAqkkl4hAlw-G4M59dGxb1jxtyTuklcwGMtILIhX3ersLWqrO-2Iv-SqsTzy-ZSSijKQu0jdI2h13Ld24qjZTLPgzpsRVazfpo4BMN2C3xhQCDwmtSpkmp6oPXcUcf8P92vUwx144HiGQb3g7KEbUycBjNzusO2kfEKgZ_SYJz4-9h0AUdyaQ9JfagT-S1Wmm6Z1s6DeOVGaP9onThZUHEOpswvCl2uJgnW976B9ikX235lrvD3h0nny-idP0z7dnKvjd1Q84FwWD0hEoV4Glakt58xQ54j4rSdJDpIFN9SoVG6C_NGxPj2YWndEo-_aimJP3A6p2_5EvtTq-p9DGuF7taEtjS5z10SB9Yl3rYbfRWmDvPE-EpeZTpVm-X8_MaESq-u4ZnXuF4Z_YQph8dDS45xJKnJD5j39t21bNxenmF6Gr2RxGMpDamYiFI8YtdGMY5BJmfqUTJM_lHcdMJRNNirNOm0f-EMb1d58IRojedC9tlDvRvcfmR3gSsV46_5XjjA3ObizIXgijLmrGmwk7-T7nA3hkFdmIxA_ABsN5Q79_RANtqX3y1LiZbZjQ8Xd_owSm6lObNte8A_W1nQiRdSvceLXitmlatvnc4NFnQwDRBBa6BLob_W00

Codeblock

language	text
collapse	true

@startuml
autonumber
      
box TMF622 Product Order, category=PV/VBL
participant eauf as "Buyer of new line: Ordering"
participant tauf as "Seller of new line:  Product Order"
     
box  TMF622 Product Order, category=TerminationProvider
participant leab as "Seller of old line:  Product Order"
participant tab as "Buyer of old line: Ordering"
      
eauf -> tauf: POST ProductOrder(productOrderItemCreate, VAId)
eauf <-- tauf: 201 Created(acknowledged)
note right: PV
   
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Accepted)
note right: QEB
tauf -> leab: notifyKUE
leab -> leab: POST  ProductOrder(productOrderItemDelete, category=terminationProviderChange)
leab --> leab: 201 Created(acknowledged) 
note right: TEQ
   
leab -> tab: ProductOrderCreatedEvent(PO2)
tab <- leab: ProductOrderStateChangeEvent(PO, Accepted)
note right: QEB
tab <- leab: ProductOrderAttributeValueChangeEvent(PO2, providerChangeInfo, date)
leab -> tab: ProductOrderStateChangeEvent(PO2, Pending)
note right: AKM-PV
leab -> tab: ProductOrderInformationRequiredEvent(PO2, ProviderChangeResult.approval)
   
leab <- tab: POST RespondProviderChange(PO2, result.approval=false)
note right: RUEM-PV
leab--> tab: 201 Created(acknowledged)
leab -> tab: RespondProviderChangeStateChangedEvent(inProgress)
leab -> tab: ProductOrderAttributeValueChangeEvent(PO2)
note right: ProviderChangeResult.approval=false
leab -> tab: RespondProviderChangeStateChangedEvent(done)
  
leab -> tab: ProductOrderStateChangeEvent(PO2, Rejected)
note right: ABBM-PV
tauf <- leab: notifyPVRejected
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Rejected)
note right: ABBM
@enduml

bisherige Darstellung

Codeblock

language	text
collapse	true

@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
  
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Accepted)
tauf -> leab: notifyKUE
leab -> leab: POST  ProductOrder(productOrderItemDelete, category=terminationProviderChange)
  
leab -> tab: ProductOrderCreatedEvent(PO2)
tab <- leab: ProductOrderStateChangeEvent(PO, Accepted)
tab <- leab: ProductOrderAttributeValueChangeEvent(PO2, providerChangeInfo, date)
leab -> tab: ProductOrderStateChangeEvent(PO2, Pending)
note right: AKM-PV
leab -> tab: ProductOrderInformationRequiredEvent(PO2, fieldPath=productOrder.ProviderChangeResult.approval)
  
leab <- tab: POST RespondProviderChange(PO2, result.approval=false)
note right: RUEM-PV
leab -> tab: RespondProviderChangeStateChangedEvent(acknowledged)
leab -> tab: RespondProviderChangeStateChangedEvent(inProgress)
leab -> tab: ProductOrderAttributeValueChangeEvent(PO2, productOrder.ProviderChangeResult.approval=false)
leab -> tab: RespondProviderChangeStateChangedEvent(done)
 
leab -> tab: ProductOrderStateChangeEvent(PO2, Rejected)
note right: ABBM-PV
tauf <- leab: notifyPVRejected
eauf <- tauf: ProductOrderStatusChangeEvent(PO, Rejected)
note right: ABBM
@enduml

Img

src

http://www.plantuml.com/plantuml/png/dPHHRzem58NVyokk-aGqw0EFrPWQkcX2T2K2cdSxle2tnCwSQpR-_Hn7MN5fLb5U2C7dtEySExblY1coLHanIrhPYgE9eFr4NF-1p6XX2uAL4MZWg2lOdch8SXXbgpYgdLGMicQA09dT0MlW9brcq5v_WktJt5-Dac_jTtmJ2AWN94yfZ1vJl-9iD8msbiTl0ooVqybZsa9CGueI6GzC-SNKxd_FnXsamsMyG-J_vlimao-UyGworMRRD-4vHlNPZmLXzM2G4OuXJnOYZfGc12Ft1tBQFEhzFaywly1gGuniyt1WQe_f4HMvJ6D8YW9hGkT57OaFTWVEMUvEBdtaW_RtEyB_8tx54bl4WX7kjJdD24qb5IEfbHCUfLlNOSGjSUzFZ8V0NLJHiqvRHEwoUPBBR3WORLYN41d9BM7EIllAO3g6Eg1Tg9qUWs24yJ1qJn8QPQY4LFjmmvBbzqcM3rkryqpbQrlZBoiDYZFBdSHIP8mEi_F-RyE2rzZOacvPtIPXvKlV_eJqs-bMrLg9KDfDCQ71RCVA1iCOw-VqCiURbY_Tz4bOyLFftoKAToV-a8DiZzJUOJQX_ifjVhV0CFz7I8LMJWdN7fqr_i22KBmwE_EvBvswnpruQBEyrrpzDXWU5jsZ4hOg_m80org/fit-api/fit-api/src/main/tmf622/assets/ProviderChange_NegativeRespondProviderChange.puml

syntaxHighlighting

PlantUML

Beispieldaten (linker Block, TNBauf ↔ ANE)

...

ProductOrderAttributeValueChange (19)

Stashincludebyfilepath

repoSlug

fit-root

branchId

refs/heads/main

projectKey

TFIT

filepath

Bitbucket file macro

cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

collapsible	true
url	https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/ftth-no-opts/product-order-provider-change-2b-attribute-value-change-event-failed-validation.json
showLineNumbers	true
progLang	plain
collapsible	true
applicationLink	syntaxHighlighting	JSON

Farbcodierung:

rote Schriftfarbe = Abweichungen im Vergleich zum Event ProductOrderAttributeValueChange aus dem Gutfall im Vorfeld des ProductOrderStateChange inProgress

fachliche Felder	Daten	API Felder
technisches EventDatum	2022-05-11T10:33:00+01:00	eventTime
Supplier-Daten
Rolle	orderManagementSupplierContactorderManagementSellerContact	relatedParty.role
Anrede	Frau	relatedParty.salutation
Vorname	Lisa	relatedParty.givenName
Nachname	Bach	relatedParty.familyName
Telefonnummer	0221/789456	relatedParty/contactMedium.mediumType = "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "fixed" relatedParty/contactMedium/characteristic.phoneNumber
Mobilfunknummer	0178/78787878	relatedParty/contactMedium.mediumType = "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "mobile" relatedParty/contactMedium/characteristic.phoneNumber
Email-adresseAdresse	l.bach@example.net	relatedParty/contactMedium.mediumType = "EmailContactMedium" 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	FALSE	productOrder/providerChangeInfo.approval
Antwortcode	KVE	productOrder/providerChangeInfo.responseReason.code
Antworttext	Vorabstimmungs-ID fehlerhaft	productOrder/providerChangeInfo.responseReason.description

ProductOrderStateChangeEvent: rejected (19+1)

...

Bitbucket file macro
cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
collapsible true
url https://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-3b-state-change-event-rejected.json
showLineNumbers true
progLang plain
collapsible true
applicationLink syntaxHighlighting JSON
ProductOrderStateChangeEvent: rejected
fachliche Felder Daten API Felder
Orderstatus rejected state
fachliches Änderungsdatum 2022-05-20T10:40:00+01:00 stateChangeDate
technisches EventDatum 2022-05-20T10:40:00+01:00 eventTime
Grund der Änderung
0041
"Der abgebende Provider hat die Kündigung seines Bestandes abgelehnt."
stateChangeReason.code
stateChangeReason.description
...

Versionen im Vergleich

Alte Version 31

Neue Version Aktuell

Schlüssel

Ablauf

bisherige Darstellung

Beispieldaten (linker Block, TNBauf ↔ ANE)

ProductOrderAttributeValueChange (19)

ProductOrderStateChangeEvent: rejected (19+1)

ProductOrderStateChangeEvent: rejected
fachliche Felder	Daten	API Felder
Orderstatus	rejected	state
fachliches Änderungsdatum	2022-05-20T10:40:00+01:00	stateChangeDate
technisches EventDatum	2022-05-20T10:40:00+01:00	eventTime
Grund der Änderung	0041 "Der abgebende Provider hat die Kündigung seines Bestandes abgelehnt."	stateChangeReason.code stateChangeReason.description

Seitenvergleich

Versionen im Vergleich

Alte Version 31

Neue Version Aktuell

Schlüssel

Ablauf

bisherige Darstellung

Beispieldaten (linker Block, TNBauf ↔ ANE)

ProductOrderAttributeValueChange (19)

ProductOrderStateChangeEvent: rejected (19+1)