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
Beispieldaten
POST ProductOrder (Kündigung)
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 |
Entgelttermin | 01.12.2022 | Product.terminationDate | |
Auftragsdaten | |||
Kündigungswunschtermin | 01.12.2022 | ProductOrder.requestedCompletionTimePeriod | |
Verbindlicher Liefertermin | 01.12.2022 | ProductOrder.expectedCompletionTimePeriod | |
Auftraggeberdaten | |||
Leistungs-Nummer | 500012 | Agreement.businessId (agreementType = ServiceContract) | |
Auftraggeber-Nummer | 500011 | Agreement.engagedParty.businessId | |
Externe Auftragsnr | 1000111 | externalIdenitifier.id | |
Ansprechpartner / Auftragsmanagement | |||
Role | Auftragsmanagement | relatedParty (role = Auftragsmanagement) | |
Anrede | Herr | ||
Titel | Captain | ||
Vorname | James T. | ||
Nachname | Kirk | ||
Telefonnummer | 0221 456789 | ||
Mobilfunknummer | 017754545454 | ||
Faxnummer | |||
Email-adresse | j.kirk@example.net |
fachliche Felder | Daten | API Felder |
---|---|---|
technische Daten | ||
fachliches Bestelldatum des AG | 2022-05-11T10:30:00+01:00 | orderPostedDate |
Kundendaten | ||
Kundenwunschtermin | 01.12.2022 | requestedCompletionTimePeriod.startDateTime requestedCompletionTimePeriod.endDateTime |
LageTAE_ONT | Flur | productOrderItem/productCharacteristic.value productOrderItem/productCharacteristic.name = positionTae_Ont |
HomeID | a12d5a4545 | productOrderItem/realizingResource.value productOrderItem/realizingResource.@referredType = homeId |
SeriennummerONT | 1515515155115 | productOrderItem/realizingResource.value productOrderItem/realizingResource.@referredType = ont |
Anschlussadresse | ||
Role | locationA | productOrderIteam/product/place.role |
Straßenname | Biberweg | productOrderIteam/product/place.streetName |
Hausnummer | 2 | productOrderIteam/product/place.streetNr |
Hausnummernzusatz | a | productOrderIteam/product/place.streetNrSuffix |
Gebäudeteil | Einfamilienhaus | productOrderIteam/product/place.geographicSubAddress.buildingName |
Land | DEU | productOrderIteam/product/place.country |
Postleitzahl | 59055 | productOrderIteam/product/place.postcode |
Ortsname | Rheinhausen | productOrderIteam/product/place.city |
zur Anschlussadresse gehörender Name ("Klingelschild") | ||
Role | locationAContact | relatedParty.role |
Anrede | Herr | relatedParty.salutation |
Vorname | Maximilian | relatedParty.givenName |
Nachname | Müller | relatedParty.familyName |
Vormieterdaten | ||
Ressource = Vormieterdaten | accessLine | product/realizingResource.name |
Vorname | Hans | product/realizingResource/resourceCharacteristic.value; product/realizingResource/resourceCharacteristic.name="previousTenantGivenName" |
Nachname | Bieber | product/realizingResource/resourceCharacteristic.value; product/realizingResource/resourceCharacteristic.name="previousTenantFamilyName" |
ONKZ | 221 | product/realizingResource/resourceCharacteristic.value; product/realizingResource/resourceCharacteristic.name="previousTenantAreaCode" |
Rufnummer | 234567 | product/realizingResource/resourceCharacteristic.value; product/realizingResource/resourceCharacteristic.name="preiviousTenantSubscriberNumer" |
Installationskontakt | ||
Role | installationContact | relatedParty.role |
Anrede | Herr | relatedParty.salutation |
Vorname | Alexander | relatedParty.givenName |
Nachname | Fischer | relatedParty.familyName |
Telefonnummer | 0221/145155 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = fixed relatedParty/contactMedium/characteristic.phoneNumber |
Mobilfunknummer | 17878878788 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = mobile relatedParty/contactMedium/characteristic.phoneNumber |
Faxnummer | ||
Email-adresse | a.fischer@example.net | relatedParty/contactMedium.mediumType = email relatedParty/contactMedium/characteristic.contactType = email relatedParty/contactMedium/characteristic.emailAddress |
Produktdaten | ||
Geschäftsfall | new | productOrderItem.action |
Produktname im Replikat | FTTH L2 PON 1000 500 | productOrderItem/productOffering.name |
Auftraggeberdaten | ||
Auftraggeber | ||
Leistungs-Nummer | 500012 | ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="customerServiceContract" |
Auftraggeber-Nummer | 500011 | ProductOrder/agreement.engagedParty.businessId ProductOrder/agreement.engagedParty.role="customer" |
Besteller | ||
Leistungs-Nummer | 500013 | 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 | ||
Role | orderManagementCustomerContact | relatedParty.role |
Anrede | Herr | relatedParty.salutation |
Titel | Captain | relatedParty.title |
Vorname | James T. | relatedParty.givenName |
Nachname | Kirk | relatedParty.familyName |
Telefonnummer | 0221 456789 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = fixed relatedParty/contactMedium/characteristic.phoneNumber |
Mobilfunknummer | 017754545454 | relatedParty/contactMedium.mediumType = phone relatedParty/contactMedium/characteristic.contactType = mobile relatedParty/contactMedium/characteristic.phoneNumber |
Faxnummer | ||
Email-adresse | j.kirk@example.net | relatedParty/contactMedium.mediumType = email relatedParty/contactMedium/characteristic.contactType = email relatedParty/contactMedium/characteristic.emailAddress |
Vorabstimmungsdaten (Vorschlag, noch nicht beschlossen) | ||
VorabstimmungsId | DEU.DTAG.V012345678 | ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="preAgreement" |
verschiedene Kenner | ||
Projektkenner | AB1234 | ProductOrder/agreement.businessId ProductOrder/agreement.agreementType="projectIdentifier" |
Kopplungskenner | QW567 | ProductOrder/productOrderCharacteristic.value ProductOrder/productOrderCharacteristic.name="couplingIdentifier" |
Auftragsklammer | AK45678 | ProductOrder/productOrderCharacteristic.value ProductOrder/productOrderCharacteristic.name="orderBindingElement" |
Anzahl Aufträge | 5 | ProductOrder/productOrderCharacteristic.value ProductOrder/productOrderCharacteristic.name="numberOfOrders" |