Versionen im Vergleich

Schlüssel

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

Beschreibung

Folgende Abläufe beschreiben die typischen API-Interaktionen zwischen Auftraggeber und Leistungserbringer im Anwendungsfall "Erneute Auftragsbestätigung versenden". Die fachliche Analyse hat ergeben, dass sich dieser Anwendungsfall in 2 Szenarien aufteilen lassen kann (siehe : GF_Zweite ABM)

  • Neuen verbindlichen Liefertermin versenden 

    • Terminverschiebung: Änderung Kundenwunschtermin durch Auftraggeber (Liefertermin verschieben)
    • Unvorhersehbares Ereignis während der Auftragsrealisierung

  • Neue / ergänzende Anschlussinformationen versenden

Bemerkung: der identifizierte Fall "Zweite ABM im Rahmen eines Konnektivitätsauftrages" wird mit der Abbildung des Konnektivitätsauftrages betrachtet / vervollständigt 

TitelErneute Auftragsbestätigung versenden
Kurzbeschreibung

Folgender Ablauf beschreibt die typischen API- Interaktionen zwischen Auftraggeber und Leistungserbringer im Anwendungsfall "Erneute Auftragsbestätigung versenden".

Eine erneute Auftragsbestätigung kann in folgenden Szenarien vorkommen:

  • Neuer verbindlicher Liefertermin 
    • Terminverschiebung als Ergebnis eines geänderten Kundenwunschtermines durch Auftraggeber (Liefertermin verschieben)
    • Wegen eines unvorhersehbaren Ereignisses beim Leistungserbringer während der Auftragsrealisierung
  • Neue / ergänzende Anschlussinformationen

Bemerkung: der identifizierte Fall "Erneute Auftragsbestätigung im Rahmen eines Konnektivitätsauftrages" wird mit der Abbildung des Konnektivitätsauftrages betrachtet / vervollständigt Dabei 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, das heißt, die erste Auftragsbestätigung wurde bereits versandt.

Auslöser

Ein neuer verbindlicher Liefertermin bzw. neue / ergänzende Anschlussinformationen sind vorhanden 

Ergebnis

Eine erneute Auftragsbestätigung wurde versendet

Ablauf

tmf622/documentation
Stashincludebyfilepath
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepath
Bitbucket file macro
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/ResendABM.puml
syntaxHighlightingPlantUML

Beispieldaten

ProductOrderAttributeValueChangeEvent (1)

...

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/
resources
tmf622/
docs/diagrams/ResendABM.pumlapplicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

Handet es sich bei dem Auftrag um die Category Providerwechsel oder Verbundleistung, muss der LE im Falle einer erneute Auftragsbestätigung nach Versenden der ProcessingMessage an den AGauf analog gegenüber dem AGab vorgehen.

Beispieldaten

examples/product-order-4a-attribute-value-change-event-multiple-values.json
syntaxHighlightingJSON

Technikereinsatz
Felderaktualisierte DatenAPI Feld
Eventdate technisches EventDatum2022-05-20T10:45:00 
Anschluss (lineId)DEU.DTAG.FTYLIQ7PTFproductOrderItem.accessLineId
eventTime
verbindlicher Liefertermin (Datum)2022-12-19T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

expectedCompletionDate

Datum+Zeitfenster (wenn erforderlich, z.B. bei Technikertermin beim Endkunden)

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

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

productOrderItem.appointment.validFor.startDateTime

productOrderItem.appointment.validFor.endDateTime

Termin beim Endkunden erforderlichTRUE

 ProductOrderItem.endUserAppointmentIsNecessary

Beispiel:

Stashincludebyfilepath
repoSlugfit-root
branchIdrefs/heads/main
projectKeyTFIT
filepathtmf622/examples/ftth-no-opts/product-order-4a-attribute-value-change-event-multiple-values.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinkcbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d

...

ProductOrderMilestoneEvent (2)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-4b-milestone-event-order-confirmation-update.json
syntaxHighlightingJSON

...

Felderaktualisierte DatenAPI Feld
processingMessageTypeTyp des Product Order Milestone EventsorderConfirmationUpdateprocessingMessageDatename
Datum und Uhrzeit des Milestones2022-05-20T10:46:00processingMessageReason0005processingMessageTextmilestoneDate
Meldecode des Milestones0015milestoneMessage.code
Meldungstext des MilestonesDer Ausführungstermin wurde vom Leistungserbringer manuell geändert

...

milestoneMessage.text