...
| 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:
|
| Vorbedingung |
|
| 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 | ||
|
| Codeblock | ||||
|---|---|---|---|---|
| ||||
@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 | ||||
|---|---|---|---|---|
| ||||
@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 | ||||
|---|---|---|---|---|
|
Beispieldaten (linker Block, TNBauf ↔ ANE)
...
| Erweitern | ||
|---|---|---|
| ||
siehe Auftrag (Providerwechsel / Verbundleistung) anlegen , Abschnitt "Beispieldaten (linker Block, TNBauf ↔ ANE)", Kapitel "ProductOrderStateChangeEvent: Accepted" |
ProductOrderAttributeValueChange
...
(19)
| Bitbucket file macro | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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 = phone "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "fixed" relatedParty/contactMedium/characteristic.phoneNumber |
| Mobilfunknummer | 0178/78787878 | relatedParty/contactMedium.mediumType = phone "PhoneContactMedium" relatedParty/contactMedium/characteristic.contactType = "mobile" relatedParty/contactMedium/characteristic.phoneNumber |
| Email-adresseAdresse | l.bach@example.net | relatedParty/contactMedium.mediumType = email "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[0].code |
| Antworttext | Vorabstimmungs-ID fehlerhaft | productOrder/providerChangeInfo.responseReason[0].description |
| ||
| ||
|
| |
| ||
ProductOrderStateChangeEvent: rejected
...
ProductOrderStateChangeEvent: rejected (19+1)
| Bitbucket file macro | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| 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 |
...