Versionen im Vergleich

Version Alte Version 7 Neue Version Aktuell
Änderungen wurden vorgenommen von

Former user

Stephan Braune

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

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

Der Leistungserbringer sendet an den aufnehmenden Provider Auftraggeber ein StateChangeEvend "FailedRejected" (ABBM)

Der Leistungserbringer sendet an den abgebenden Provider Auftraggeber ein StateChangeEvend "FailedRejected" (ABBM-PV), hier nicht dargestellt

...

Ablauf

Bitbucket file macro
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/ProviderChange_NegativeRespondProviderChange.puml
syntaxHighlightingPlantUML

Beispieldaten (linker Block, TNBauf ↔ ANE)

...

Erweitern
titleProductOrderStateChangeEvent: Acknowledged Accepted - identisch zum Gutfall

siehe Auftrag (Providerwechsel / Verbundleistung) anlegen , Abschnitt "Beispieldaten (linker Block, TNBauf ↔ ANE)", Kapitel "ProductOrderStateChangeEvent: AcknowledgedAccepted"

Erweitern
titleProductOrderAttributeValueChange - identisch zum Gutfall

siehe Auftrag (Providerwechsel / Verbundleistung) anlegen , Abschnitt "Beispieldaten (linker Block, TNBauf ↔ ANE)", Kapitel "ProductOrderAttributeValueChange"

ProductOrderStateChangeEvent: inProgress

...

ProductOrderAttributeValueChange (19)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-2b-attribute-value-change-event-failed-validation.json
syntaxHighlightingJSON

Farbcodierung:

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

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 = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "fixed"

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer0178/78787878

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "mobile"

relatedParty/contactMedium/characteristic.phoneNumber 

Email-Adressel.bach@example.net

relatedParty/contactMedium.mediumType = "EmailContactMedium"

relatedParty/contactMedium/characteristic.contactType = "email"

relatedParty/contactMedium/characteristic.emailAddress

Daten vom abgebenden Provider
RollehandingOverProvider

relatedParty.role

Providername

1&1 Internet AG

relatedParty.name

Zustimmung ProviderwechselFALSE

productOrder/providerChangeInfo.approval

AntwortcodeKVE

productOrder/providerChangeInfo.responseReason.code

AntworttextVorabstimmungs-ID fehlerhaft

productOrder/providerChangeInfo.responseReason.description

ProductOrderStateChangeEvent: rejected (19+1)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-3b-state-change-event-rejected.json
syntaxHighlightingJSON

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

0041

"

Keine Änderung zum Auftrag

Der abgebende Provider hat die Kündigung seines Bestandes abgelehnt."

stateChangeReason.code

stateChangeReason

.description

Historisierung acknowledged

fachliches Änderungsdatum 

Grund der Änderung

2022-05-11T10:31:00+01:00

0000

"Keine Änderung zum Auftrag"

stateChangeHistory.@type = StateChange

stateChangeHistory.changeDate

stateChangeHistory.changeReason.code

stateChangeHistory.changeReason

.description