Beschreibung
| Titel | Zusatzinfo melden oder aktualisieren |
|---|---|
| Kurzbeschreibung | Folgender Ablauf beschreibt die typischen Interaktionen zwischen Auftrageber und Leistungserbringer im Anwendungsfall "Zusatzinfo melden oder aktualisieren". Die Zusatzinfo ist entweder ein Montagehinweis oder ein Ansprechpartner. Dabei werden die für diesen Ablauf erforderlichen Auftrags-Status durchlaufen und die für diesen Ablauf relevanten Informationen übermittelt. Hinweis: Die Taskresource wird syntaktisch synchron validiert: Pflichtparameter gesetzt etc. (Folge-Zustand Achnowledged) Danach wurde sie fachlich validiert: PO existiert und im richtigen Zustand (Folge-Zustand InProgress) Schließlich erfolgt die Aktualisierung der Product Order (Folge-Zustand done) |
| Vorbedingung | Die dazugehörige Product Order muss existieren und kaufmännisch validiert sein, so dass sich der Auftrag mindestens im Status accepted befindet. (nicht abgebrochen oder beendet) Darüber hinaus darf sich die dazugehörige Product Order nicht in den Zuständen Closed oder Completed befinden. Mindestens alle Pflichtfelder für die Meldung eines Montagehinweises sind laut Auftragsmedestruktur gefüllt. |
| Auslöser | Auftraggeber möchte dem Leistungserbringer einen Montagehinweis oder Ansprechpartner, durch Erzeugung einer Task Resource vom Typ AddProductOrderInformation, übermitteln bzw aktualisieren. |
| Ergebnis | Der Montagehinweis oder Ansprechpartner wurde im Auftag erfolgreich gespeichert. |
Ablauf
Beispieldaten
Der Montagehinweis oder Ansprechpartner wird in der TaskRessource in der gleichen Syntax mitgegeben (1) , wie diese in der PO (siehe Beispieldaten) entsprechend abgebildet sind.
Post AddProductOrderInformation (1)
| AddProdu | ||
| fachliche Felder | Daten | API Felder |
| technisches EventDatum | 2024-10-24T10:32:00 | eventTime |
| zu erweiternde Order | 388a4963-f168-4603-99e8-477200099d91 | productOrder.id |
Montagehinweis | ||
| Montagehinweis | "zweimal klingeln" | note.text = "zweimal klingeln" note.@type = "InstallationInstruction" |
| Installationskontakt Endkunde | ||
| Rolle | installationContact | relatedParty.role |
| Typ | Individual | relatedParty/partyOrPartyRole.@type |
| Anrede | Herr | relatedParty/partyOrPartyRole.salutation |
| Vorname | Alexander | relatedParty/partyOrPartyRole.givenName |
| Nachname | Fischer | relatedParty/partyOrPartyRole.familyName |
| Telefonnummer | +49221145155 | relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium" relatedParty/partyOrPartyRolec.ontactMedium.contactType="fixed" relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+49221145155" |
| Mobilfunknummer | +4917878878788 | relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium" relatedParty/partyOrPartyRolec.ontactMedium.contactType="mobile" relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+4917878878788" |
| Email-Adresse | a.fischer@example.net | relatedParty/partyOrPartyRole.contactMedium.@type="EmailContactMedium" relatedParty/partyOrPartyRolec.ontactMedium.contactType="email" relatedParty/partyOrPartyRole.contactMedium.emailAddress="a.fischer@example.net" |
Response (2)
AddProductOrderInformationStateChangeEvent: inProgress (3)
| fachliche Felder | Daten | API Felder |
|---|---|---|
technisches Event Datum | 2022-05-12T11:30:00+02:00 | EventTime |
Status: Eventdate: | inProgress 2022-05-11T11:30:00+02:00 | AddProductOrderInformation.state AddProductOrderInformation.stateChangeDate |
AddProductOrderInformation erfolgreich
ProductOrderAttributeValueChange (setzen Montagehinweis oder Ansprechpartner) (4)
Analog:
| ProductOrderAttributeValueChange | ||
| fachliche Felder | Daten | API Felder |
| technisches EventDatum | 2024-10-24T10:32:00 | eventTime |
Montagehinweis | ||
| Montagehinweis | "zweimal klingeln" | note.text = "zweimal klingeln" note.@type = "InstallationInstruction" |
| Installationskontakt Endkunde | ||
| Rolle | installationContact | relatedParty.role |
| Typ | Individual | relatedParty/partyOrPartyRole.@type |
| Anrede | Herr | relatedParty/partyOrPartyRole.salutation |
| Vorname | Alexander | relatedParty/partyOrPartyRole.givenName |
| Nachname | Fischer | relatedParty/partyOrPartyRole.familyName |
| Telefonnummer | +49221145155 | relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium" relatedParty/partyOrPartyRolec.ontactMedium.contactType="fixed" relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+49221145155" |
| Mobilfunknummer | +4917878878788 | relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium" relatedParty/partyOrPartyRolec.ontactMedium.contactType="mobile" relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+4917878878788" |
| Email-Adresse | a.fischer@example.net | relatedParty/partyOrPartyRole.contactMedium.@type="EmailContactMedium" relatedParty/partyOrPartyRolec.ontactMedium.contactType="email" relatedParty/partyOrPartyRole.contactMedium.emailAddress="a.fischer@example.net" |
AddProductOrderInformationStateChangeEvent: done (5)
| fachliche Felder | Daten | API Felder |
|---|---|---|
technisches Event Datum | 2022-05-12T11:32:00+02:00 | EventTime |
Status: Eventdate: | done 2022-05-11T11:32:00+02:00 | AddProductOrderInformation.state AddProductOrderInformation.stateChangeDate |