Versionen im Vergleich

Version Alte Version 13 Neue Version Aktuell
Änderungen wurden vorgenommen von

Former user

Stephan Braune

Gespeichert am

Schlüssel

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

Beschreibung

TitelAuftrag (Kündigung durch AG) anlegen
Kurzbeschreibung

Folgender Ablauf beschreibt für den Gut-Fall die typischen API- Interaktionen zwischen Auftraggeber Auftrageber und Leistungserbringer im Anwendungsfall "Auftrag (Kündigung durch Auftraggeber/Kunde"AG) anlegen" von der Anlage des Auftrags bis zu seinem Abschluss.

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

 

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

Vorbedingung
  • Rahmenvertrag ist vorhanden
  • Das zu kündigende Produkt befindet sich im Bestand des Auftraggebers
  • Es liegen keine offenen Aufträge zum
Produkt vor
  • betroffenen Bestand (z.B. für den Anschluss oder dem Übertragungsweg) vor.
  • Mindestens alle Pflichtfelder für eine Product Order im Anwendungsfall KUE-AG sind laut Auftrags-/Meldungsstruktur (download) gefüllt.
Auslöser

Der Auftraggeber legt einen Kündigungsauftrag (Geschäftsfall Kündigung) an.

Ergebnis

Das Produkt wurde gekündigt und deaktiviert.

Ablauf

5
Drawio
bordertrue
diagramNameKuendigung
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
diagramWidth1044
revision
Bitbucket file macro
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/assets/UC_KUE-KD.puml
syntaxHighlightingPlantUML

Beispieldaten

POST ProductOrder Kündigung AG (

...

1)

src/test/examples/ftth-no-opts
Stashincludebyfilepath
repoSlugtmf622-product-order
branchIdrefs/heads/main
projectKeyTFIT
filepath
Bitbucket file macro
cbfa78ef-cb5e-30f5-8b3b-ec5f9d824e1d
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-0-create.json
showLineNumberstrue
progLangplain
collapsibletrue
applicationLinksyntaxHighlightingJSON

fachliche FelderDaten API FelderBemerkung
technische Daten
fachliches Bestelldatum des AG2022-05-11T10:30:00+02:00orderPostedDateProduktdaten
LineId (identifizierung der zu Kündigenden Leitung)DEU.DTAG.12324ProductOrderItem.accessLineIDIst nicht im Modell ProductOrder Resource Model sichtbar. 
GeschäftsfallGeschäftsfall Name"terminationByBuyer"category
Produktdaten
AktiondeleteproductOrderItem.action

Identifikation des Inventars

  • Produkt Identifier

 (ODER ALTWELT)

  • Einzelvertragsnummer
  • (ODER)
  • 555001Vertragsnummer bei Telekom bzw. NGAB: LINE-ID


  • 388a4963-f168-4603-99e8-477200099d91


  • 3091231119


  • Product.id (ODER)
  • Product.singleContractId
Annahme =


Identifikation des Inventars über
  • Product.id
Entgelttermin01.12.2022

Product.terminationDate

Auftragsdaten
Kündigungswunschtermin 01.12.2022ProductOrder.requestedCompletionTimePeriodVerbindlicher Liefertermin01.12.2022ProductOrder.expectedCompletionTimePeriod2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

ProductOrder.requestedCompletionDate

Auftraggeberdaten
Leistungs-Nummer500012

Agreement.businessId (agreementType = ServiceContractBuyerServiceContract)

Auftraggeber-Nummer
500011Agreement.engagedParty.businessId
Externe Auftragsnr1000111externalIdenitifier.id Ansprechpartner / Auftragsmanagement
RoleAuftragsmanagementrelatedParty (role = Auftragsmanagement)AnredeHerrTitelCaptainVornameJames T.NachnameKirkTelefonnummer0221 456789Mobilfunknummer017754545454FaxnummerEmail-adressej.kirk@example.net

ProductOrderStateChangeEvent: Accepted (4)

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

fachliche FelderDaten API Felder
technische Datenfachliches Bestelldatum des AG
technisches EventDatum2022-05-11T10:
30
32:00+01:00eventTime
orderPostedDate
Orderstatus accepted
Kundendaten
state 
Kundenwunschtermin01.12.2022

requestedCompletionTimePeriod.startDateTime

requestedCompletionTimePeriod.endDateTime

LageTAE_ONTFlur

productOrderItem/productCharacteristic.value 

productOrderItem/productCharacteristic.name = positionTae_Ont

HomeIDa12d5a4545

productOrderItem/realizingResource.value 

productOrderItem/realizingResource.@referredType = homeId

SeriennummerONT1515515155115

productOrderItem/realizingResource.value

productOrderItem/realizingResource.@referredType = ont

Anschlussadresse
RolelocationAproductOrderIteam/product/place.roleStraßennameBiberwegproductOrderIteam/product/place.streetNameHausnummer2productOrderIteam/product/place.streetNrHausnummernzusatzaproductOrderIteam/product/place.streetNrSuffixGebäudeteilEinfamilienhausproductOrderIteam/product/place.geographicSubAddress.buildingNameLandDEUproductOrderIteam/product/place.countryPostleitzahl59055productOrderIteam/product/place.postcodeOrtsnameRheinhausenproductOrderIteam/product/place.cityzur Anschlussadresse gehörender Name ("Klingelschild")RolelocationAContactrelatedParty.roleAnredeHerrrelatedParty.salutationVornameMaximilianrelatedParty.givenNameNachnameMüllerrelatedParty.familyNameVormieterdatenRessource = VormieterdatenaccessLineproduct/realizingResource.name VornameHans 

product/realizingResource/resourceCharacteristic.value;

product/realizingResource/resourceCharacteristic.name="previousTenantGivenName"

NachnameBieber

product/realizingResource/resourceCharacteristic.value;

product/realizingResource/resourceCharacteristic.name="previousTenantFamilyName"

ONKZ221

product/realizingResource/resourceCharacteristic.value;

product/realizingResource/resourceCharacteristic.name="previousTenantAreaCode"

Rufnummer234567

product/realizingResource/resourceCharacteristic.value;

product/realizingResource/resourceCharacteristic.name="preiviousTenantSubscriberNumer"

Installationskontakt
RoleinstallationContactrelatedParty.roleAnredeHerrrelatedParty.salutationVornameAlexander
OrderstatusChangeDate2022-05-11T10:31:00+01:00stateChangeDate 
Grund der Änderung

0000

"Keine Änderung zum Auftrag"

stateChangeReason.code

stateChangeReason.description

ProductOrderAttributeValueChange (setzen von Auftragsmanagment & VLT) (5)

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

fachliche FelderDatenAPI Felder
technisches EventDatum 2022-05-11T10:32:00eventTime
Verbindlicher Kündigungstermin2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

ProductOrder.expectedCompletionDate

Auftragsmanagment
 
Rolle orderManagementSellerContactrelatedParty.role
AnredeFraurelatedParty.salutation (Ms)
VornameLisarelatedParty.givenName
Nachname
Fischer
BachrelatedParty.familyName
Telefonnummer0221/
145155
789456

relatedParty/contactMedium.mediumType =

phone

"PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "fixed"

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer
17878878788
0178/78787878

relatedParty/contactMedium.mediumType =

phone

"PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "mobile"

relatedParty/contactMedium/characteristic.phoneNumber 

Faxnummer
Email-
adresse
Adresse
a
l.
fischer@example
bach@example.net

relatedParty/contactMedium.mediumType =

email

"EmailContactMedium"

relatedParty/contactMedium/characteristic.contactType = "email"

relatedParty/contactMedium/characteristic.emailAddress

Produktdaten
GeschäftsfallnewproductOrderItem.actionProduktname im ReplikatFTTH L2 PON 1000 500productOrderItem/productOffering.nameAuftraggeberdaten
AuftraggeberLeistungs-Nummer500012

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="customerServiceContract"

Auftraggeber-Nummer
500011

ProductOrder/agreement.engagedParty.businessId

ProductOrder/agreement.engagedParty.role="customer"

BestellerLeistungs-Nummer500013

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="ordererServiceContract"

Auftraggeber-Nummer
500014

ProductOrder/agreement.engagedParty.businessId

ProductOrder/agreement.engagedParty.role="orderer"

Extrerne Autftragsnr.Externe Auftragsnr.

1000111

DEU.VFD

ProductOrder/externalIdentifier.id

ProductOrder/externalIdentifer.owner (=ITU-Kennung)

ProductOrder/externalIdentifer.externalIdentifierType =ProductOrder

Ansprechpartner / Auftragsmanagement
RoleorderManagementCustomerContactrelatedParty.roleAnredeHerrrelatedParty.salutation TitelCaptainrelatedParty.titleVornameJames T.relatedParty.givenName NachnameKirkrelatedParty.familyNameTelefonnummer0221 456789

relatedParty/contactMedium.mediumType = phone

relatedParty/contactMedium/characteristic.contactType = fixed

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer017754545454

relatedParty/contactMedium.mediumType = phone

relatedParty/contactMedium/characteristic.contactType = mobile

relatedParty/contactMedium/characteristic.phoneNumber 

FaxnummerEmail-adressej.kirk@example.net

relatedParty/contactMedium.mediumType = email

relatedParty/contactMedium/characteristic.contactType = email

relatedParty/contactMedium/characteristic.emailAddress

Vorabstimmungsdaten (Vorschlag, noch nicht beschlossen)
VorabstimmungsIdDEU.DTAG.V012345678

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="preAgreement"

verschiedene Kenner
ProjektkennerAB1234

ProductOrder/agreement.businessId

ProductOrder/agreement.agreementType="projectIdentifier"

KopplungskennerQW567

ProductOrder/productOrderCharacteristic.value

ProductOrder/productOrderCharacteristic.name="couplingIdentifier"

AuftragsklammerAK45678

ProductOrder/productOrderCharacteristic.value

ProductOrder/productOrderCharacteristic.name="orderBindingElement"

Anzahl Aufträge5

ProductOrder/productOrderCharacteristic.value

ProductOrder/productOrderCharacteristic.name="numberOfOrders"

="l.bach@example.net"

ProductOrderStateChangeEvent: inProgress (6)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-3-state-change-event-in-progress.json
syntaxHighlightingJSON

fachliche FelderDaten API Felder
technisches EventDatum2022-05-20T10:40:00+01:00eventTime
Orderstatus inProgressstate 
fachliches Änderungsdatum 2022-05-20T10:40:00+01:00stateChangeDate 
Grund der Änderung

0000

"Keine Änderung zum Auftrag"

stateChangeReason.code

stateChangeReason.description

ProductOrderStateChangeEvent: completed (7)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-4-state-change-event-completed.json
syntaxHighlightingJSON

fachliche FelderDaten API Felder
technisches EventDatum2022-12-16T10:45:00+01:00eventTime
Orderstatus completedstate 
fachliches Änderungsdatum 2022-12-16T10:45:00+01:00stateChangeDate 
Grund der Änderung

0010

"Auftrag ausgeführt."

stateChangeReason.code

stateChangeReason.description

ProductOrderAttributeValueChange (setzen von terminationDate) (8)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-5-attribute-value-change-event-termination-date.json
syntaxHighlightingJSON

fachliche FelderDatenAPI Felder
technisches EventDatum 2022-12-16T10:45:30+01:00eventTime
Nutzungsdatum 2022-12-16T10:45:00+01:00product.terminationDate

ProductOrderStateChangeEvent: closed (9)

Bitbucket file macro
collapsibletrue
urlhttps://bitbucket.org/fit-api/fit-api/src/main/tmf622/examples/product-order-delete-6-state-change-event-closed.json
syntaxHighlightingJSON

fachliche FelderDaten API Felder
technisches EventDatum2022-12-16T10:46:00+01:00eventTime
Orderstatus closedstate 
fachliches Änderungsdatum 2022-12-16T10:46:00+01:00stateChangeDate 
Grund der Änderung

0010

"Auftrag ausgeführt."

stateChangeReason.code

stateChangeReason.description