Beschreibung
Titel | Auftrag (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:
|
Vorbedingung |
|
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 einen neuen Termin an (Status "Pending" - Information Required (TAM)) Der Leistungserbringer sendet an den abgebenden Provider eine Verzögerungsmeldung (ProcessingMessage "OrderDelay", (VZM-PV)) Nach erfolgter Terminverschiebung durch den aufnehmenden Provider sendet der Leistungserbringer an den abgebenden Provider eine Information über den neuen Bereitstellungstermin: ProcessingMessage "orderConfirmationUpdate", (erneute ABM-PV) Der weitere Verlauf wird hier nicht mehr betrachtet. |
Ablauf
Variante erfolgreiche Schaltung nach Terminanforderung
Beispieldaten (linker Block, TNBauf ↔ ANE)
8) ProductOrderStateChangeEvent: pending
ProductOrderStateChangeEvent: pending | ||
fachliche Felder | Daten | API Felder |
Orderstatus | pending | state |
fachliches Änderungsdatum | 2022-12-16T11:30:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-12-16T11:30:00+01:00 | eventTime |
Grund der Änderung | 6001 "Endkunde nicht angetroffen" | stateChangeReason.code stateChangeReason.description |
11) ProductOrderInformationRequiredEvent
fachliche Felder | Daten | API Felder |
---|---|---|
Feld, zu dem eine Information benötigt wird | /requestedCompletionDate replace | fieldPath.path fieldPath.typeOfChange |
12) POST RescheduleProductOrder
fachliche Felder | Daten | API 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 |
13a) POST RescheduleProductOrderStateChangeEvent: accepted
fachliche Felder | Daten | API Felder |
---|---|---|
technisches EventDatum | 2022-12-16T11:40:00+01:00 | eventTime |
Orderstatus | accepted | event.rescheduleProductOrder.state |
Orderstatus Änderungsdatum | 2022-12-16T11:40:00+01:00 | event.rescheduleProductOrder.stateChangeDate |
13b) POST RescheduleProductOrderStateChangeEvent: inProgress
fachliche Felder | Daten | API Felder |
---|---|---|
technisches EventDatum | 2022-12-16T11:40:10+01:00 | eventTime |
Orderstatus | inProgress | event.rescheduleProductOrder.state |
Orderstatus Änderungsdatum | 2022-12-16T11:40:10+01:00 | event.rescheduleProductOrder.stateChangeDate |
14) POST ProductOrderAttributeValueChangeEvent
fachliche Felder | Daten | API Felder |
---|---|---|
technisches EventDatum | 2022-12-16T11:40:20+01:00 | eventTime |
Kundenwunschtermin | 2022-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 |
15) POST RescheduleProductOrderStateChangeEvent: done
fachliche Felder | Daten | API Felder |
---|---|---|
technisches EventDatum | 2022-12-16T11:40:20+01:00 | eventTime |
Orderstatus | done | event.rescheduleProductOrder.state |
Orderstatus Änderungsdatum | 2022-12-16T11:40:20+01:00 | event.rescheduleProductOrder.stateChangeDate |
16) ProductOrderAttributeValueChangeEvent
fachliche Felder | Daten | API Felder |
---|---|---|
technisches EventDatum | 2022-12-16T11:40:25+01:00 | eventTime |
Verbindlicher Liefertermin | 2022-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 |
17) ProductOrderStateChangeEvent: inProgress
ProductOrderStateChangeEvent: inProgress | ||
fachliche Felder | Daten | API Felder |
Orderstatus | inProgress | state |
fachliches Änderungsdatum | 2022-12-16T11:40:30+01:00 | stateChangeDate |
technisches EventDatum | 2022-12-16T11:40:30+01:00 | eventTime |
Grund der Änderung | 0011 "Montage beim Endkunden erforderlich." | stateChangeReason.code stateChangeReason.description |
21) ProductOrderStateChangeEvent: completed
ProductOrderStateChangeEvent: completed | ||
fachliche Felder | Daten | API Felder |
Orderstatus | completed | state |
fachliches Änderungsdatum | 2022-12-19T10:00:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-12-19T10:00:00+01:00 | eventTime |
Grund der Änderung | 0010 "Auftrag ausgeführt." | stateChangeReason.code stateChangeReason.description |
vor 24) ProductOrderAttributeValueChange
ProductOrderAttributeValueChange (setzen von startDate) | ||
fachliche Felder | Daten | API Felder |
technisches EventDatum | 2022-12-19T10:00:30+01:00 | eventTime |
Nutzungsdatum | 2022-12-19T10:00:00+01:00 | product.startDate |
24) ProductOrderStateChangeEvent: closed
ProductOrderStateChangeEvent: closed | ||
fachliche Felder | Daten | API Felder |
Orderstatus | closed | state |
fachliches Änderungsdatum | 2022-12-19T10:01:00+01:00 | stateChangeDate |
technisches EventDatum | 2022-12-19T10:01:00+01:00 | eventTime |
Grund der Änderung | 0010 "Auftrag ausgeführt." | stateChangeReason.code stateChangeReason.description |
Variante LineInUse
→ gemäß Absprache in UAG01: hierzu wird kein Beispiel erzeugt
Variante Cancel
→ gemäß Absprache in UAG01: hierzu wird kein Beispiel erzeugt