Beschreibung
| Titel | Auftrag (Kündigung) anlegen |
|---|---|
| Kurzbeschreibung | Folgender Ablauf beschreibt die typischen API-Interaktionen zwischen Auftraggeber und Leistungserbringer im Anwendungsfall "Kündigung durch Auftraggeber/Kunde". Dieser Anwendungsfall behandelt die Kündigung eines Produktes durch den Auftraggeber. Die Kündigung muss sich auf ein im Bestand des jeweiligen Auftraggebers befindliches Produkt beziehen. Eine Kündigung ist nur dann möglich, wenn keine weiteren offenen Aufträge zum Bestand des Auftraggebers vorliegen. Dies gilt sowohl für Aufträge des bestandsführenden Auftraggebers als auch von anderen Auftraggebern (z.B. beim Geschäftsfall Providerwechsel). Voraussetzung für den Geschäftsfall Kündigung durch Auftraggeber ist ein bestehender Rahmenvertrag zwischen dem Auftraggeber und dem Leistungserbringer sowie die Angabe aller ausführungsrelevanten Daten. Entsprechung: KUE/KD in WITA, KUE/AG in SPRI |
| Vorbedingung | Rahmenvertrag ist vorhanden Das zu kündigende Produkt befindet sich im Bestand des Auftraggebers Es liegen keine offenen Aufträge zum Produkt vor |
| Auslöser | Der Auftraggeber legt einen Kündigungsauftrag an. |
| Ergebnis | Das Produkt wurde gekündigt |
Ablauf
| Drawio | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Beispieldaten
ProductOrder (Kündigung)
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| fachliche Felder | Daten | API Felder | Bemerkung |
|---|---|---|---|
| technische Daten | |||
| fachliches Bestelldatum des AG | 2022-05-11T10:30:00+02:00 | orderPostedDate | |
| Produktdaten | |||
| Geschäftsfall | delete | productOrderItem.action | |
Identifikation des Inventars
|
|
| Annahme = Identifikation des Inventars über Product.id |
| Auftragsdaten | |||
| Kündigungswunschtermin | 01.12.2022 | ProductOrder.requestedCompletionTimePeriod | |
| Auftraggeberdaten | |||
| Leistungs-Nummer | 500012 | Agreement.businessId (agreementType = ServiceContract) | |
| Auftraggeber-Nummer | 500011 | Agreement.engagedParty.businessId | |
| Externe Auftragsnr | 1000111 | externalIdenitifier.id | |
ProductOrderStateChangeEvent: Acknowledged
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| fachliche Felder | Daten | API Felder |
| Orderstatus | acknowledged | state |
| OrderstatusChangeDate | 2022-05-11T10:31:00+01:00 | stateChangeDate |
| technisches EventDatum | 2022-05-11T10:32:00+01:00 | eventTime |
| Grund der Änderung | 0000 "Keine Änderung zum Auftrag" | stateChangeReason.code stateChangeReason.description |
ProductOrderAttributeValueChange (setzen von Auftragsmanagment & VLT)
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| fachliche Felder | Daten | API Felder |
| technisches EventDatum | 2022-05-11T10:32:00 | eventTime |
| Pointer auf die gemachte Änderung | /relatedParty/ /expectedCompletionTimePeriod/ | fieldPath.path fieldPath.typeOfChange = add |
| Verbindlicher Liefertermin | 01.12.2022 | ProductOrder.expectedCompletionTimePeriod |
| Rolle | orderManagementSupplierContact | relatedParty.role |
| Anrede | Frau | relatedParty.salutation (Ms) |
| Vorname | Lisa | relatedParty.givenName |
| Nachname | Bach | relatedParty.familyName |
| Telefonnummer | 0221/789456 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = fixed relatedParty/contactMedium/characteristic.phoneNumber |
| Mobilfunknummer | 0178/78787878 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = mobile relatedParty/contactMedium/characteristic.phoneNumber |
| Faxnummer | ||
| Email-adresse | l.bach@example.net | relatedParty/contactMedium.mediumType = email relatedParty/contactMedium/characteristic.contactType = email relatedParty/contactMedium/characteristic.emailAddress |
ProductOrderStateChangeEvent: inProgress
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| fachliche Felder | Daten | API Felder |
| Orderstatus | inProgress | state |
| fachliches Änderungsdatum | 2022-05-20T10:40:00+01:00 | stateChangeDate |
| technisches EventDatum | 2022-05-20T10:40:00+01:00 | eventTime |
| Grund der Änderung | 0000 "Keine Änderung zum Auftrag" | stateChangeReason.code stateChangeReason.description |
Historisierung acknowledged fachliches Änderungsdatum Grund der Änderung | 2022-05-11T10:31:00+01:00 0000 "Keine Änderung zum Auftrag" | stateChangeHistory.@type = StateChange stateChangeHistory.changeDate stateChangeHistory.changeReason.code stateChangeHistory.changeReason.description |
ProductOrderStateChangeEvent: completed
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| fachliche Felder | Daten | API Felder |
| Orderstatus | completed | state |
| fachliches Änderungsdatum | 2022-12-16T10:45:00+01:00 | stateChangeDate |
| technisches EventDatum | 2022-12-16T10:45:00+01:00 | eventTime |
| Grund der Änderung | 0010 "Auftrag ausgeführt." | stateChangeReason.code stateChangeReason.description |
Historisierung inProgress fachliches Änderungsdatum Grund der Änderung | 2022-05-20T10:40:00+01:00 0000 "Keine Änderung zum Auftrag" | stateChangeHistory.@type = StateChange stateChangeHistory.changeDate stateChangeHistory.changeReason.code stateChangeHistory.changeReason.description |
ProductOrderAttributeValueChange (setzen von terminationDate)
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| fachliche Felder | Daten | API Felder |
| technisches EventDatum | 2022-12-16T10:45:30+01:00 | eventTime |
| Pointer auf die gemachte Änderung | /terminationDate/ | fieldPath.path fieldPath.typeOfChange = add |
| Nutzungsdatum | 2022-12-16T10:45:00+01:00 | product.terminationDate |
ProductOrderStateChangeEvent: closed
| Stashincludebyfilepath | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...