Document toolboxDocument toolbox

Auftrag (Kündigung durch AG) anlegen

Beschreibung

TitelAuftrag (Kündigung durch AG) anlegen
Kurzbeschreibung

Folgender Ablauf beschreibt für den Gut-Fall die typischen Interaktionen zwischen Auftrageber und Leistungserbringer im Anwendungsfall "Auftrag (Kündigung durch 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). 

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 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

Beispieldaten

POST ProductOrder Kündigung AG (1)

fachliche FelderDaten API Felder
technische Daten
fachliches Bestelldatum des AG2022-05-11T10:30:00+02:00orderPostedDate
Geschäftsfall Name"terminationByBuyer"category
Produktdaten
AktiondeleteproductOrderItem.action

Identifikation des Inventars

  • Produkt Identifier

 (ODER ALTWELT)

  • Vertragsnummer bei Telekom bzw. NGAB: LINE-ID


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


  • 3091231119


  • Product.id


  • Product.id
Auftragsdaten
Kündigungswunschtermin 2022-12-01T12:00:00+01:00
(Uhrzeit fachlich nicht relevant, aber technisch erforderlich)

ProductOrder.requestedCompletionDate

Auftraggeberdaten
Leistungs-Nummer500012

Agreement.businessId (agreementType = BuyerServiceContract)

Auftraggeber-Nummer
500011Agreement.engagedParty.businessId
Externe Auftragsnr1000111externalIdenitifier.id 

ProductOrderStateChangeEvent: Accepted (4)

fachliche FelderDaten API Felder
technisches EventDatum2022-05-11T10:32:00+01:00eventTime
Orderstatus acceptedstate 
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)

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
NachnameBachrelatedParty.familyName
Telefonnummer0221/789456

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "fixed"

relatedParty/contactMedium/characteristic.phoneNumber 

Mobilfunknummer0178/78787878

relatedParty/contactMedium.mediumType = "PhoneContactMedium"

relatedParty/contactMedium/characteristic.contactType = "mobile"

relatedParty/contactMedium/characteristic.phoneNumber 

Email-Adressel.bach@example.net

relatedParty/contactMedium.mediumType = "EmailContactMedium"

relatedParty/contactMedium/characteristic.contactType = "email"

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

ProductOrderStateChangeEvent: inProgress (6)

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)

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)

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

ProductOrderStateChangeEvent: closed (9)

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