Versionen im Vergleich

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

...

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

...

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

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

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)

...

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

...

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

...