Versionen im Vergleich

Alte Version 18

changes.mady.by.user Thomas Dominikowski

Gespeichert am

verglichen mit

Neue Version Aktuell

changes.mady.by.user Stephan Braune

Gespeichert am

Schlüssel

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

...

Titel

Auftrag (Neu) anlegen

Kurzbeschreibung

Folgender Ablauf beschreibt für den Gut-Fall die typischen Interaktionen zwischen Auftrageber und Leistungserbringer im Anwendungsfall "Auftrag (NEU) anlegen" von der Anlage des Auftrags bis zu seinem Abschluss.

Dabei werden die für diesen Ablauf erforderlichen Auftrags-Status durchlaufen und die für diesen Ablauf relevanten Informationen übermittelt.

Vorbedingung

  • Rahmenverträge und Dienstverträge sind vorhanden

  • Der Auftraggeber hat die Verfügbarkeit des Produktes geprüft

  • Mindestens alle Pflichtfelder für eine Product Order im Anwendungsfall Neu sind laut Auftragsmedestruktur gefüllt. Auftrags-/Meldungsstruktur (download) gefüllt.

  • Es liegen keine offenen Aufträge oder Bestand für die betroffene technischen Infrastruktur (z.B. dem Anschluss oder dem Übertragungsweg) vor. Dies gilt auch für den Fall, dass für die technische Infrastruktur eine Kündigung vorliegt.

Auslöser

Auftraggeber legt einen Auftrag für die Erstbereitstellung eines Produktes (Geschäftsfall Neu) an.

Ergebnis

Das Produkt wurde erfolgreich bereitgestellt und aktiviert.

...

Der Payload der ProductOrderAttributeValueChangeEvents ist der Auftrags-Meldungs-Struktur/Meldungsstruktur (download) zu entnehmen. "expectedCompletionDate" und "startDate" sind hier nur als Beispiele genannt.

...

fachliche Felder

Daten 

API Felder

technische Daten

fachliches Bestelldatum des AG

2022-05-11T10:30:00+01:00

orderPostedDate

Geschäftsfall Name

"new"

category

Kundendaten

Kundenwunschtermin

2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

requestedCompletionDate

LageTAE_ONT

Flur 3.OG

productOrderItem/product.networkTerminationUnitLocation

HomeID

a12d5a4545

productOrderItem/product.homeID 

HardwareID (hier: ONT-Seriennummer)

1234567890

additionalOrderInformation.hardwareIdType = "OntSerialNumber"

additionalOrderInformation.hardwareIdValue = "1234567890"

Montagehinweis

"zweimal klingeln"

note.text = "zweimal klingeln"

note.@type = "InstallationInstruction"

Anschlussadresse

Rolle

locationA

productOrderItem/product/relatedPlace.role

Straßenname

Biberweg

productOrderItem/product/relatedPlace.place.streetName

Hausnummer

2

productOrderItem/product/relatedPlace.place.streetNr

Hausnummernzusatz

a

productOrderItem/product/relatedPlace.place.streetNrSuffix

Gebäudeteil

Einfamilienhaus

productOrderItem/product/relatedPlace.place.geographicSubAddress.buildingName

Land

DEU

productOrderItem/product/relatedPlace.place.country

Postleitzahl

59055

productOrderItem/product/relatedPlace.place.postcode

Ortsname

Rheinhausen

productOrderItem/product/relatedPlace.place.city

Ortsteil

Nordstadt

productOrderItem/product/relatedPlace.place.locality

zur Anschlussadresse gehörender Name (Anschlussinhaber)

Rolle

locationAContact

relatedParty.role

Typ

Individual

relatedParty/partyOrPartyRole.@type

Anrede

Herr

relatedParty/partyOrPartyRole.salutation

Vorname

Maximilian

relatedParty.partyOrPartyRole.givenName

Nachname

Müller

relatedParty.

partyOrPartyRole.familyName

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/partyOrPartyRole.contactMedium.contactType="fixed"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+49221145155"

Mobilfunknummer

+4917878878788

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="mobile"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+4917878878788"

Email-adresse

a.fischer@example.net

relatedParty/partyOrPartyRole.contactMedium.@type="EmailContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="email"

relatedParty/partyOrPartyRole.contactMedium.emailAddress="a.fischer@example.net"

Produktdaten

Aktion

add

productOrderItem.action

Produktname in Replikat oder Produktbezeichnerliste

FTTH 250000

productOrderItem/productOffering.name

Wunsch-Datum und -Zeitfenster für Endkundentermin

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

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

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

productOrderItem.requestedTimeSlot.validFor.startDateTime

productOrderItem.requestedTimeSlot.validFor.endDateTime

Auftraggeberdaten

Auftraggeber

Leistungs-Nummer

500012

ProductOrder/agreement.businessId = "500012"

ProductOrder/agreement.agreementType="buyerServiceContract"

ProductOrder/agreement.name="buyerServiceContract"

Auftraggeber-Nummer

500011

ProductOrder/agreement.engagedParty.businessId

Besteller (im Namen Dritter)

Leistungs-Nummer

500013

ProductOrder/agreement.businessId = "500013"

ProductOrder/agreement.agreementType="ordererServiceContract"

ProductOrder/agreement.name="ordererServiceContract"

Auftraggeber-Nummer

500014

ProductOrder/agreement.engagedParty.businessId

Extrerne Autftragsnr.

 

 

Externe Auftragsnr.

1000111

ProductOrder/externalId.id = "1000111"

ProductOrder/externalId.externalIdentifierType = "ProductOrder"

Ansprechpartner / Auftragsmanagement

Rolle

orderManagementBuyerContact

relatedParty.role

Anrede

Herr

relatedParty/partyOrPartyRole.salutation

Titel

Captain

relatedParty/partyOrPartyRole.title

Vorname

James T.

relatedParty/partyOrPartyRole.givenName

Nachname

Kirk

relatedParty/partyOrPartyRole.familyName

Telefonnummer

+49221456789

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="fixed"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+49221456789"

Mobilfunknummer

+4917754545454

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="mobile"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+4917754545454"

Email-adresse

j.kirk@example.net

relatedParty/partyOrPartyRole.contactMedium.@type="EmailContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="email"

relatedParty/partyOrPartyRole.contactMedium.emailAddress=""j.kirk@example.net

Vorabstimmungsdaten

VorabstimmungsId

DEU.VFD.V012345678

ProductOrder/agreement.businessId = "DEU.VFD.V012345678"

ProductOrder/agreement.agreementType="providerChangeAgreement"

ProductOrder/agreement.name ="providerChangeAgreement"

verschiedene Kenner

Projektkenner

AB1234

additionalOrderInformation.projectIdentifier

Kopplungskenner

QW567

additionalOrderInformation.couplingIdentifier

Auftragsklammer

AK45678

additionalOrderInformation.orderBindingId

Anzahl Aufträge

5

additionalOrderInformation.orderBindingNumberOfOrders

Maßnahmenkenner

PromotionFiber

additionalOrderInformation.campaignIdentifier

Response (2)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-1.json
syntaxHighlightingJSON

...

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-2-attribute-value-change-event-supplierseller-contact.json
syntaxHighlightingJSON

ProductOrderAttributeValueChange (setzen von Auftragsmanagment)

fachliche Felder

Daten

API Felder

technisches EventDatum 

2022-05-11T10:32:00

eventTime

Rolle 

orderManagementSupplierContactorderManagementSellerContact

relatedParty.role

Anrede

Frau

relatedParty./partyOrPartyRole.salutation

Vorname

Lisa

relatedParty./partyOrPartyRolegivenName

Nachname

Bach

relatedParty./partyOrPartyRolefamilyName

Telefonnummer

+49221789456

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="fixed"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+49221789456"

Mobilfunknummer

+4917878787878

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="mobile"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+4917878787878"

Email-adresse

l.bach@example.net

relatedParty/partyOrPartyRole.contactMedium.@type="EmailContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="email"

relatedParty/partyOrPartyRole.contactMedium.emailAddress="l.bach@example.net"

...

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-fttc-2-attribute-value-change-event-supplierseller-contact.json
syntaxHighlightingJSON

ProductOrderAttributeValueChange (setzen von Auftragsmanagment)

fachliche Felder

Daten

API Felder

technisches EventDatum 

2022-05-11T10:32:00

eventTime

Rolle 

orderManagementSupplierContactorderManagementSellerContact

relatedParty.role

Anrede

Frau

relatedParty./partyOrPartyRole.salutation

Vorname

Lisa

relatedParty./partyOrPartyRolegivenName

Nachname

Bach

relatedParty./partyOrPartyRolefamilyName

Telefonnummer

+49221789456

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="fixed"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+49221789456"

Mobilfunknummer

+4917878787878

relatedParty/partyOrPartyRole.contactMedium.@type="PhoneContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="mobile"

relatedParty/partyOrPartyRole.contactMedium.phoneNumber="+4917878787878"

Email-adresse

l.bach@example.net

relatedParty/partyOrPartyRole.contactMedium.@type="EmailContactMedium"

relatedParty/partyOrPartyRole.contactMedium.contactType="email"

relatedParty/partyOrPartyRole.contactMedium.emailAddress="l.bach@example.net"

...