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 Auftrags-/Meldungsstruktur (download) 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)