Versionen im Vergleich

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 hat sich beim LE 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:Am Schalttag kann die Bereitstellung nicht erfolgen. 

Ergebnis

Der Leistungserbringer fordert beim aufnehmenden Provider Auftraggeber einen neuen Termin an (Status "Pending" - Information Required (TAM))

Der Leistungserbringer sendet an den abgebenden Provider Auftraggeber eine Verzögerungsmeldung (ProcessingMessage JeopardyMessage "OrderDelayorderDelay", (VZM-PV))

Nach erfolgter Terminverschiebung durch den aufnehmenden Provider Auftraggeber sendet der Leistungserbringer an den abgebenden Provider Auftraggeber eine Information über den neuen Bereitstellungstermin: ProcessingMessage MilestoneEvent "orderConfirmationUpdate", (erneute ABM-PV)

Der weitere Verlauf wird hier nicht mehr betrachtet.

...

Erweitern
title5) ProductOrderStateChangeEvent: inProgress - identisch zu Gutfall und Geschäftsfall Neu

...

ProductOrderStateChangeEvent: pending

...

(11)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-4c-state-change-event-pending.json
showLineNumberstrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

ProductOrderStateChangeEvent: pending
fachliche FelderDaten API Felder
Orderstatus pendingstate 
fachliches Änderungsdatum 2022-12-16T11:30:00+01:00stateChangeDate 
technisches EventDatum2022-12-16T11:30:00+01:00eventTime
Grund der Änderung

6001

"Endkunde nicht angetroffen"

stateChangeReason.code

stateChangeReason.description

11) ProductOrderInformationRequiredEvent

...

ProductOrderInformationRequiredEvent (14)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-5b-information-required-event-requested-completion-date.json
showLineNumberssyntaxHighlightingtrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

fachliche FelderDatenAPI Felder
Feld, zu dem eine Information benötigt wird

/requestedCompletionDate

replace

fieldPath.path

fieldPath.typeOfChange

...

POST RescheduleProductOrder

...

(15)

Bitbucket file macro
cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/reschedule-product-order-provider-change-0.json
showLineNumberstrue
collapsibletrue
applicationLinksyntaxHighlightingJSON

fachliche FelderDatenAPI Felder
Verschobener Kundenwunschtermin

2022-12-19T12:00:00+01:00

rescheduledRequestedCompletionDate

Wunschzeitfenster

2022-12-19T08:00:00+01:00

2022-12-19T12:00:00+01:00


productOrderItem.requestedTimeSlot.validFor.startDateTime

productOrderItem.requestedTimeSlot.validFor.endDateTime

...

POST RescheduleProductOrderStateChangeEvent:

...

inProgress (17)

Bitbucket file macro
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

...

13b) POST RescheduleProductOrderStateChangeEvent: inProgress

Stashincludebyfilepath
tmf622/examples/ftth-no-opts/cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepathurlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/reschedule-product-order-provider-change-2-state-change-event-in-progress.json
showLineNumberstrue
collapsibletrue
applicationLinksyntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches EventDatum2022-12-16T11:40:10+01:00eventTime
OrderstatusinProgressevent.rescheduleProductOrder.state
Orderstatus Änderungsdatum 2022-12-16T11:40:10+01:00event.rescheduleProductOrder.stateChangeDate

...

POST ProductOrderAttributeValueChangeEvent

...

(18)

Bitbucket file macro
cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-6b-attribute-value-change-event-requested-completion-date.json
showLineNumberstrue
collapsibletrue
applicationLinksyntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches EventDatum2022-12-16T11:40:20+01:00eventTime
Kundenwunschtermin2022-12-19T12:00:00+01:00

event.productOrder.requestedCompletionDate

Wunschzeitfenster

2022-12-19T08:00:00+01:00

2022-12-19T12:00:00+01:00

event.productOrder.productOrderItem.requestedTimeSlot.validFor.startDateTime

event.productOrder.productOrderItem.requestedTimeSlot.validFor.endDateTime

...

POST RescheduleProductOrderStateChangeEvent: done

...

(19)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/reschedule-product-order-provider-change-3-state-change-event-done.json
showLineNumberstrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches EventDatum2022-12-16T11:40:20+01:00eventTime
Orderstatusdoneevent.rescheduleProductOrder.state
Orderstatus Änderungsdatum 2022-12-16T11:40:20+01:00event.rescheduleProductOrder.stateChangeDate

16) ProductOrderAttributeValueChangeEvent

...

ProductOrderAttributeValueChangeEvent (20)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-7-attribute-value-change-event-expected-completion-date.json
showLineNumberssyntaxHighlightingtrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

fachliche FelderDatenAPI Felder
technisches EventDatum2022-12-16T11:40:25+01:00eventTime
Verbindlicher Liefertermin2022-12-19T12:00:00+01:00

event.productOrder.expectedCompletionDate

Vereinbartes Zeitfenster

2022-12-19T08:00:00+01:00

2022-12-19T12:00:00+01:00

event.productOrder.productOrderItem.appointment.validFor.startDateTime

event.productOrder.productOrderItem.appointment.validFor.endDateTime

...

ProductOrderStateChangeEvent: inProgress

...

(21)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-8-state-change-event-in-progress.json
showLineNumberssyntaxHighlightingtrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

ProductOrderStateChangeEvent: inProgress
fachliche FelderDaten API Felder
Orderstatus inProgressstate 
fachliches Änderungsdatum 2022-12-16T11:40:30+01:00stateChangeDate 
technisches EventDatum2022-12-16T11:40:30+01:00eventTime
Grund der Änderung

0011

"Montage beim Endkunden erforderlich."

stateChangeReason.code

stateChangeReason.description

...

ProductOrderStateChangeEvent: completed

...

(25)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-9-state-change-event-completed.json
showLineNumberssyntaxHighlightingtrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

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

0010

"Auftrag ausgeführt."

stateChangeReason.code

stateChangeReason.description

vor 24) ProductOrderAttributeValueChange

...

ProductOrderAttributeValueChange (28)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-10-attribute-value-change-event-start-date.json
showLineNumberssyntaxHighlightingtrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
JSON

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

...

ProductOrderStateChangeEvent: closed

...

(29)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-provider-change-11-state-change-event-closed.json
showLineNumberstrue
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

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

0010

"Auftrag ausgeführt."

stateChangeReason.code

stateChangeReason.description

Variante LineInUse

tmf622/documentation
Stashincludebyfilepath
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepath
Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/resourcestmf622/docs/diagramsassets/ProviderChange_FailedOnSwitchDay_WithLineInUse.puml
progLangsyntaxHighlightingplantuml
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
→ gemäß Absprache in UAG01:
PlantUML

hierzu wird kein Beispiel erzeugt

Variante Cancel

tmf622/documentation
Stashincludebyfilepath
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepath
Bitbucket file macro
urlhttps://bitbucket.org/fit-api/fit-api/src/main/resourcestmf622/docsassets/diagrams/ProviderChange_FailedOnSwitchDay_WithCancel.puml
progLangsyntaxHighlightingplantuml
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
→ gemäß Absprache in UAG01:
PlantUML

hierzu wird kein Beispiel erzeugt

...