Versionen im Vergleich

Alte Version 53

changes.mady.by.user Ernest Astfalk

Gespeichert am

verglichen mit

Neue Version Aktuell

changes.mady.by.user Stephan Braune

Gespeichert am

Schlüssel

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

...

TitelKundentermin anfordern
Kurzbeschreibung

Folgender Ablauf beschreibt die typischen Interaktionen zwischen Auftraggeber und Leistungserbringer im Anwendungsfall "Kundentermin anfordern".

  • Der Leistungserbringer teilt dem Auftraggeber mit, dass für seinen Bereitstellungsauftrag ein neuer Termin mit dem Endkunden erforderlich ist.
  • Falls der Auftraggeber nicht innerhalb von 11 Werktagen auf die Terminanforderung reagiert, sendet der Leistungserbringer eine Mahnterminanforderung 

Der Auftraggeber hat folgende Möglichkeiten, um auf eine Terminanforderung bzw. eine Mahnterminanforderung zu antworten:

  • Terminverschiebung mit neuem Endkundentermin (siehe Anwendungsfall Liefertermin verschieben)

  • Stornierung des Auftrags, wenn Endkunde die Bereitstellung nicht mehr wünscht (siehe Anwendungsfall Auftrag stornieren)

  • Anfrage den Auftrag abzuschließen, wenn nach Aussage des Endkunden die Bereitstellung bereits umgesetzt ist (Teil dieses Use Cases). 

Wenn auf die Mahnterminanforderung keine Reaktion durch den Auftraggeber erfolgt, wird der Auftrag am 22. Werktag durch den Leistungserbringer abgebrochen. Dabei kann ggf. ein Storno-Entgelt fällig werden (Teil dieses Use Cases).

Es werden die für diesen Ablauf erforderlichen Auftrags-Status durchlaufen und die für diesen Ablauf relevanten Informationen übermittelt.

Vorbedingung

Der Auftrag befindet sich in der Realisierung und im Status "inProgress".

Auslöser

Ein (neuer) Kundentermin ist erforderlich und wird vom Leistungserbringer durch einen Statusübergang in "pending" signalisiert.

Ergebnis

Der Anwendungsfall hat folgende mögliche Ergebnisse:

  • Ein neuer Kundentermin konnte ermittelt werden. Somit kann der Auftrag weiter bearbeitet werden
  • Der Auftrag wurde auf Anfrage (CancelProductOrder) oder wegen fehlender Antwort des Auftraggebers storniert
  • Der Auftrag wurde auf Anfrage des Auftraggebers geschlossen (CloseProductOrder)

Ablauf

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

Beispieldaten

...

ProductOrderStateChange: pending (1)

StashincludebyfilepathrepoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepath

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/
ftth-no-opts/
product-order-4f-state-change-event-pending.json
showLineNumbersprogLangplaincollapsibletrueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting
true
JSON

fachliche FelderDatenAPI Felder
technisches Event Datum2022-05-11T10:30:00+01:00eventTime
Status"pending"ProductOrder.State
Meldungscode6000ProductOrder.stateChangeReason.code
Meldungstext

"Endkunde hat Herstellung zurückgestellt/verweigert."

ProductOrder.stateChangeReason.description

ProductOrderInformationRequiredEvent (2)

...


Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-4g-information-required-event-requested-completion-date.json
showLineNumberstrueprogLangplaincollapsibletrueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches Event Datum2022-05-11T10:31:00+01:00                       EventTime
fieldPathrequestedCompletionDate

productOrderItem.requestedTimeSlot.validFor.startDateTime

productOrderItem.requestedTimeSlot.validFor.endDateTime

ProductOrderJeporadyAlertEvent (3)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-4d-jeopardy-event-reschedule-reminder.json
syntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches Event Datum2022-05-11T10:31:00+01:00EventTime
Bezeichnung des AlertsrescheduleReminderJeopardyAlert.name
Meldungscode

6000

JeopardyAlert.JeopardyAlertMessage.code
Meldungstext

"Endkunde hat Herstellung zurückgestellt/verweigert."

JeopardyAlert.JeopardyAlertMessage.text

POST CloseProductOrder (5)

Stashincludebyfilepath
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepathtmf622/examples/ftth-no-opts/close-product-order-0-create.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

StashincludebyfilepathrepoSlugfit-rootbranchIdrefs/heads/mainprojectKeyTFITfilepathtmf622/examples/ftth-no-opts

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/close-product-order-
1
0-create.json
showLineNumbersprogLangplaincollapsibletrueapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
syntaxHighlighting
true
JSON

fachliche FelderDatenAPI Felder
technisches Event Datum2022-05-11T10:31:00+01:00EventTime
Datum des Versands der TaskRessource2022-05-11T10:31:00+01:00CloseProductOrder.requestedPostedDate

...

Response (

...

6)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/close-product-order-1.json
syntaxHighlightingJSON

CloseProductOrderStateChangeEvent: rejected (8)

...

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

...

syntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches Event Datum2022-05-12T11:33:00EventTime
Status"rejected"CloseProductOrder.state
Meldungscode9999
CloseProductOrder.stateChangeReason.code
Meldungstext"tbd - zurueckgewiesen"CloseProductOrder.stateChangeReason.description

...

Sequenz 9 bis 13 entspricht in Teilen dem Ablauf Auftrag (Neu) anlegen und wird nicht erneut mit Beispieldaten dargestellt.

ProductOrderAttributeValueChange (orderIsChargingRelevant) (14)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-4h-attribute-value-change-event-order-is-charging-after-pending.json
syntaxHighlightingJSON

fachliche FelderDaten API Felder

technisches Event Datum

2022-05-12T11:33:00

EventTime

Typ der Meldung:

ProductOrderAttributeValueChangeEvent

ProductOrderAttributeValueChangeEvent/@type@type@type

Kostenpflichtiger Vorgang:

True

ProductOrder.orderIsChargingRelevant

Eventdate:

2022-05-12T11:33:00

ProductOrderAttributeValueChangeEvent.eventTime

...

ProductOrderStateChange: cancelled (15)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-4i-state-change-event-cancelled-after-pending.json
syntaxHighlightingJSON

fachliche FelderDaten API Felder

technisches Event Datum

2022-05-12T11:34:00+02:00

EventTime

Typ der Meldung:

Status:

Eventdate:

Meldecode:

Meldetext:

ProductOrderStateChangeEvent

cancelled

2022-05-12T11:34:00+02:00

"0017"

"Stornierung durchgeführt."

ProductOrderStateChangeEvent/@type

ProductOrder.state

ProductOrder.stateChangeDate

ProductOrder.stateChangeReason.code

ProductOrder.stateChangeReason.description

...