DokumentationExperience PlatformHandbuch zum Experience-Datenmodell (XDM)

Datentyp TelekomAbonnement

Letzte Aktualisierung: 31. Dezember 2024
  • Themen:

Erstellt für:

  • Entwickler

Telekom-Abonnement ist ein standardmäßiger Experience-Datenmodell (XDM)-Datentyp, der Details für bestimmte Telekommunikationsabonnementtypen wie Internet, Mobile, Medien oder Festnetz beschreibt.

NOTE
In diesem Dokument wird der Datentyp beschrieben. Informationen zur Feldergruppe mit demselben Namen finden Sie im Referenzhandbuch Telekom-Abonnement Feldergruppe.
Wenn Sie einen Abonnementtyp beschreiben, der nicht mit der Telekommunikationsbranche verbunden ist, verwenden Sie stattdessen den generischen Abonnement-Datentyp.

Telekom-Abonnementstruktur

EigenschaftDatentypBeschreibung
devicesArray von ObjektenBeschreibt eine Liste von Geräten und/oder Zubehör, die mit dem Plan verbunden sind. Siehe Abschnitt unten für Details zur erwarteten Struktur der einzelnen Array-Elemente.
subscriberPersonBeschreibt den Inhaber des Abonnements.
IDStringEine eindeutige Kennung für die Abonnementinstanz.
billingPeriodStringDie Zeitdauer zwischen Rechnungen.
billingStartDateDatumDas Datum, an dem der Abrechnungszeitraum beginnt. Das Datumsformat (ohne Zeit) sollte dem Standard RFC 3339, Abschnitt 5.6 entsprechen.
chargeMethodStringDie Art und Weise, wie die Abrechnung eingerichtet wird, um den Kunden zu belasten.
contractIDStringDie eindeutige ID für den Vertrag, der für dieses Abonnement gilt.
countryStringDas Land, in dem die Vertragsbedingungen des Abonnements ihren Ursprung haben.
endDateDatumDas Datum, an dem die aktuelle Abonnementlaufzeit endet. Das Datumsformat (ohne Zeit) sollte dem Standard RFC 3339, Abschnitt 5.6 entsprechen.
paymentDueDateDatumDas Datum, an dem die Abonnementzahlung fällig ist. Das Datumsformat (ohne Zeit) sollte dem Standard RFC 3339, Abschnitt 5.6 entsprechen.
paymentMethodStringDie Zahlungsmethode für wiederkehrende Zahlungen.
paymentStatusStringDie Zahlungsfähigkeit des Kontos.
planNameStringDer für Menschen lesbare Name des Abonnements.
reasonStringDie allgemeine Absicht, die der Abonnent mit der Verwendung des Abonnements verfolgt.
renewStringDie vereinbarte Art und Weise, wie das Abonnement nach dem Enddatum fortgesetzt werden kann.
startDateDatumDas Datum, an dem das Abonnement beginnt. Das Datumsformat (ohne Zeit) sollte dem Standard RFC 3339, Abschnitt 5.6 entsprechen.
statusStringDer aktuelle Status des Abonnements.
subscriptionCategoryStringDie wichtigste, übergeordnete Kategorisierung dieses Abonnementtyps.
subscriptionSKUStringDie Lagerhaltungseinheit (SKU) für das Abonnement.
subscriptionSubCategoryStringDie spezifische Unterkategorie des Abonnements.
termGanzzahlDer numerische Wert der Abonnementbedingung.
termUnitOfTimeStringDie Zeiteinheit für den Zeitraum.
topUpStringBeschreibt die vereinbarten Bedingungen für den Rückkauf verbrauchbarer Aspekte eines Abonnements während eines Abrechnungszeitraums.
typeStringDer Umfang der Berechtigungen in Bezug auf die Anzahl der Personen, die im Abonnement enthalten sind.

Weitere Informationen zum Datentyp finden Sie im öffentlichen XDM-Repository:

  • Ausgefülltes Beispiel
  • Vollständiges Schema

devices

devices ist ein Array von Objekten, wobei jedes Objekt ein Gerät oder ein Zubehör beschreibt, das mit dem Abonnement verknüpft ist.

Geräte-Array-Struktur

EigenschaftDatentypBeschreibung
deviceFeesObjekt

Ein Objekt, das alle Gerätegebühren für Elemente wie Router, Modems und Empfänger erfasst. Erwartet die folgenden Eigenschaften:

  • amount: Der Geldbetrag in der Form, in der der currencyCode dargestellt wird.
  • conversionDate: Das Datum, an dem die Währungsumrechnung vorgenommen wurde.
  • currencyCode: Der ISO 4217-Währungscode für die amount.
IDStringEine eindeutige ID für das Gerät.
OSStringDas Gerätebetriebssystem.
deviceInsuranceStringZeigt an, ob ein Kunde sich für eine Versicherung für dieses Gerät entschieden hat.
manufacturerStringDer Gerätehersteller.
nameStringEin Name für das Gerät.
paymentOptionsStringZeigt an, ob das Gerät in Raten oder zum vollen Verkaufspreis bezahlt wird.
serialNumberStringDie Seriennummer des Geräts.
statusStringDer Gerätestatus.
storageCapacityStringDie Speicherkapazität des Geräts.
typeStringDer Gerätetyp.
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07