Servicevertrag-API

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 87 Minuten Lesedauer
  • Die Servicevertrags- API bietet Endpunkte zum Erstellen und Abrufen von Servicevertragsdatensätzen.

    Hinweis:
    Diese API dient zum Erstellen von Daten in den Tabellen für die Anwendung Kundenverträge und Berechtigungen. Es handelt sich nicht um eine Allzweck-API.
    Für den Zugriff auf diese API müssen die folgenden Plugins in der zugehörigen Instanz aktiviert werden:
    • Kundenverträge und Berechtigungen (com.sn_pss_core)
    • Installationsbasisverwaltung für Kundenservice (com.snc.install)
    • Product Catalog Management Core (com.sn_prd)

    Um diese API erfolgreich aufzurufen, benötigen Sie außerdem die Rolle sn_pss_core.pss_integrator. Diese API wird im Namespace sn_pss_core ausgeführt.

    Bevor Sie diese API verwenden, müssen in den folgenden Tabellen Daten zugeordnet sein. Weitere Informationen finden Sie unter Create service contracts.

    • Account [customer_account]
    • Verbraucher [csm_consumer]
    • Haushalt [csm_household]
    • Installationsbasis [sn_install_base_item]
    • Produktangebot [sn_prd_pm_product_offering]
    • Produktmodell [cmdb_model]
    • Verkauftes Produkt [sn_install_base_sold_product]

    Servicevertrag – GET /sn_pss_core/servicecontract/{id}

    Ruft einen angegebenen Servicevertrags-Datensatz ab.

    Dieser Endpunkt ruft bei der Verarbeitung der Anforderung Daten in den folgenden Tabellen ab:
    • Merkmal [sn_pss_core_entitlement_charakteristik]
    • Berechtigung [service_entitlement]
    • Berechtigungsnutzung [sn_pss_core_entitlement_usage]
    • Abgedeckte verkaufte Produkte [sn_install_base_m2m_contract_sold_product]: Diese Tabelle enthält Informationen zu abgedeckten verkauften Produkten und abgedeckten Installationsbasiselementen.
    • Servicevertrag [sn_pss_core_service_contract]
    • Servicevertragsposition [sn_pss_core_service_contract_line]

    URL-Format

    URL mit Versionsnummer: /api/sn_pss_core/v1/servicecontract/{id}

    Standard-URL: /api/sn_pss_core/servicecontract/{id}

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge

    id Sys_id des abzurufenden Servicevertrags. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    display_value Typ der zurückzugebenden Daten.
    Gültige Werte:
    • „falsch“: Gibt den Wert für alle Felder zurück. Beispiel: „state":"draft“.
    • „wahr“: Gibt den Anzeigewert für alle Felder zurück. Beispiel: „state":"Draft“
    • all: Gibt alle Informationen für alle Felder zurück.
      "state": { 
        "name": "state",
        "label": "State",
        "value": "draft",
        "display_value": "Draft",
        "type": "string"
      }

    Datentyp: Zeichenfolge

    Standardwert: false

    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Keine

    Kopfzeilen

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    403 Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    Account
    Sys_id des Account-Datensatzes, zu dem der Servicevertrag gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    consumer
    Sys_id des Verbraucherdatensatzes, zu dem der Servicevertrag gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    endet
    Datum, an dem der Servicevertrag endet.

    Datentyp: Zeichenfolge

    ​Haushalt
    Sys_id des Haushalts, der dem Servicevertrag zugeordnet ist. Unter „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    install_base_items_covered Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    install_base_items_covered.​hinzugefügt
    Datum, ab dem die Abdeckung des Installationsbasiselements durch den zugeordneten Servicevertrag beginnt.

    Datentyp: Zeichenfolge

    install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    Berechtigung „install_base_items_covered.​“ Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    install_base_items_covered.​entfernt
    Datum, an dem die Abdeckung des Installationsbasiselements durch den zugeordneten Servicevertrag endet.

    Datentyp: Zeichenfolge

    install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    Nummer Automatisch generierte Servicevertragsnummer.

    Datentyp: Zeichenfolge

    service_contract_lines Liste der Servicevertragspositionen (Services), die dem Servicevertrag zugeordnet sind.

    Datentyp: Array von Objekten

    "service_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionen, die der Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionen, die der untergeordneten Servicevertragsposition zugeordnet sind. Identische Parameter wie in child_contract_lines.
    service_contract_lines.​child_contract_lines.​contract Sys_id des Servicevertrags, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​ends Datum, an dem die untergeordnete Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​child_contract_lines.​Berechtigungen Liste der Berechtigungen, die der untergeordneten Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String"
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​berechtigungen.​account
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Verbraucher
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Vertrag Sys_id des Vertragsdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​Merkmal
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_features.​entitlement Sys_id des Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage Liste der Nutzungswerte für das zugeordnete Produkt.

    Datentyp: Array von Objekten

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​entitlement_usage.​entitlement Sys_id des Berechtigungsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​entitlement_usage.​entitlement_feature Sys_id des Berechtigungsmerkmalsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​entitlement_usage.​period_end Enddatum, ab dem die Berechtigungsnutzung nicht mehr nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​entitlement_usage.​period_start Startdatum, ab dem die Nutzung der Berechtigung nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​entitlement_usage.​service_contract_line Sys_id der Servicevertragsposition, zu der die aktuelle Berechtigungsnutzung gehört.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​entitlement_usage.​sys_created_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_characterifics.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_characterities.​entitlement_usage.​sys_updated_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_characterists.​entitlement_usage.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    Service_Contract_lines Gesamtabdeckungswert des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    Service_Contract_lines Anzahl der vom Account oder Verbraucher verwendeten Einheiten zwischen period_start und period_end.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Berechtigungsmerkmale.​service_contract_line Untergeordnete Vertragsposition, zu der das aktuelle Berechtigungsmerkmal gehört.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Berechtigungsmerkmale.​sys_created_by Name des Benutzers, der das Berechtigungsmerkmal erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​sys_id Sys_id des Berechtigungsmerkmals-Datensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Berechtigungsmerkmale.​sys_updated_by Name des Benutzers, der das Berechtigungsmerkmal zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​entitlement_features.​value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Haushalt
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered Liste der Installationsbasiselemente, die unter der untergeordneten Servicevertragsposition abgedeckt sind. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​hinzugefügt
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​product Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​added
    Datum, ab dem das Produkt durch den zugeordneten Servicevertrag abgedeckt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​berechtigungen.​sold_products_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​removed
    Datum, an dem die Abdeckung des zugehörigen Produkts durch den zugehörigen Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​sold_product Sys_id des vom Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​sys_updated_on Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​start_date
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Status
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​sys_created_by Name des Benutzers, der den Berechtigungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​sys_id Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sys_updated_by Name des Benutzers, der den Berechtigungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sys_updated_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlement_features.​merkmal
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​entitlement Sys_id des Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem Berechtigungsmerkmal zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​sys_created_by Name des Benutzers, der den Datensatz mit den Berechtigungsmerkmalen erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​sys_updated_by Name des Benutzers, der den Datensatz der Berechtigungsmerkmale zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered Liste der Installationsbasiselemente, die unter der untergeordneten Servicevertragsposition abgedeckt sind. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​install_base_items_covered.​hinzugefügt
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​name Name der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​parent_contract_line Sys_id des übergeordneten Vertragspositionsdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​product_model Sys_id des Produkts, das der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​product_offering Sys_id des Produktangebotdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_product Sys_id des Datensatzes des verkauften Produkts, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​sold_products_covered.​added
    Datum, ab dem das Produkt durch den zugeordneten Servicevertrag abgedeckt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​sold_products_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​removed
    Datum, an dem die Abdeckung des zugehörigen Produkts durch den zugehörigen Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sold_product Sys_id des vom Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_updated_on Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​starts Startdatum der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​child_contract_lines.​sys_created_by Name des Benutzers, der den untergeordneten Datensatz der Servicevertragsposition erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sys_id Sys_id eines untergeordneten Servicevertrags-Positionsdatensatzes. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sys_updated_by Name des Benutzers, der den Datensatz der untergeordneten Servicevertragsposition zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​contract
    Sys_id des Servicevertrags, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​ends Datum, an dem die Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​entitlements Liste der Berechtigungen, die dem Servicevertrag zugeordnet sind. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​entitlements.​account
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​consumer
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​contract Sys_id des Vertragsdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​entitlements.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array]
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​entitlements.​entitlement_features.feature
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage Liste der Nutzungswerte für das zugeordnete Produkt.

    Datentyp: Array von Objekten

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​entitlement Sys_id des Berechtigungsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​entitlement_feature Sys_id des Berechtigungsmerkmalsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​period_end Enddatum, ab dem die Berechtigungsnutzung nicht mehr nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​period_start Startdatum, ab dem die Nutzung der Berechtigung nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_created_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_updated_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_charakteristik.​entitlement_usage.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​total_units Gesamtabdeckungswert des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​used_units Anzahl der vom Account oder Verbraucher verwendeten Einheiten zwischen period_start und period_end.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem Berechtigungsmerkmal zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​sys_created_by Name des Benutzers, der den Datensatz mit den Berechtigungsmerkmalen erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​sys_updated_by Name des Benutzers, der den Datensatz der Berechtigungsmerkmale zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​household
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​entitlements.​install_base_items_covered.​added Datum, an dem das zugehörige Installationsbasiselement der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​removed Datum, an dem das zugehörige Installationsbasiselement aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​product Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​entitlements.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​entitlements.​sold_products_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.removed Datum, an dem das zugeordnete verkaufte Produkt aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​entitlements.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​sold_product Sys_id des Produkts, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des verkauften Produkts.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​start_date
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​entitlements.​state
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sys_created_by Name des Benutzers, der den Berechtigungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sys_id Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sys_updated_by Name des Benutzers, der den Berechtigungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sys_updated_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features Liste der Merkmale, die der Servicevertragsposition zugeordnet sind. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​entitlement_features.feature
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​entitlement Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​entitlement_usage Liste der Nutzungswerte für das zugeordnete Produkt.

    Datentyp: Array von Objekten

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String", 
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    service_contract_lines.​entitlement_features.​entitlement_usage.​entitlement Sys_id des Berechtigungsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​entitlement_usage.​entitlement_feature Sys_id des Berechtigungsmerkmalsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​period_end Enddatum, ab dem die Berechtigungsnutzung nicht mehr nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​period_start Startdatum, ab dem die Nutzung der Berechtigung nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​sys_created_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​entitlement_usage.​sys_updated_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_charakteristik.​entitlement_usage.​total_units Gesamtanzahl der gekauften Einheiten.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​entitlement_usage.​used_units Anzahl der verwendeten Einheiten.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem Berechtigungsmerkmal zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​sys_created_by Name des Benutzers, der den Datensatz mit den Berechtigungsmerkmalen erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​sys_updated_by Name des Benutzers, der den Datensatz der Berechtigungsmerkmale zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​install_base_items_covered.​added
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    service_contract_lines.​name
    Name der Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​parent_contract_line Sys_id der Servicevertragsposition, der die aktuelle Servicevertragsposition untergeordnet ist.

    NULL für die Vertragspositionen, die unter einem Vertrag erstellt wurden.

    Datentyp: Zeichenfolge

    service_contract_lines.​product_model Sys_id des Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​product_offering Sys_id des Produktangebotdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_product Sys_id des Datensatzes des verkauften Produkts, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    service_contract_lines.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​sold_products_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered. entitlement Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.removed Datum, an dem das zugehörige verkaufte Produkt aus der Servicevertragsposition entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.​sold_product Sys_id des Produkts, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des verkauften Produkts.

    Datentyp: Zeichenfolge

    service_contract_lines.​starts
    Startdatum der Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​state
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    service_contract_lines.​sys_created_by Name des Benutzers, der den Datensatz der Servicevertragsposition erstellt hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes der Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​sys_id Sys_id eines Servicevertrags-Positionsdatensatzes. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​sys_updated_by Name des Benutzers, der den Datensatz der Servicevertragsposition zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    service_contract_lines.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes der Servicevertragsposition.

    Datentyp: Zeichenfolge

    short_description
    Kurze Beschreibung oder Name des Servicevertrags.

    Datentyp: Zeichenfolge

    „sold_products_covered“ Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    „sold_products_covered.​added“. Datum, an dem das zugehörige verkaufte Produkt dem Vertrag hinzugefügt wurde.

    Datentyp: Zeichenfolge

    „sold_products_covered.​contract“ Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    Berechtigung „sold_products_covered.​entitlement“ Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    „sold_products_covered“ wurde entfernt Datum, an dem das zugehörige verkaufte Produkt aus dem Vertrag entfernt wurde.

    Datentyp: Zeichenfolge

    „sold_products_covered.​service_line_contract“ Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    „sold_products_covered“.​sold_product Sys_id des vom Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_created_by“ Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_created_on“ Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_id“ Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_updated_by“ Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_updated_on“ Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des verkauften Produkts.

    Datentyp: Zeichenfolge

    beginnt
    Datum, an dem der Servicevertrag beginnt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Startet, sobald genehmigt wurde.

    Staat
    Aktueller Status des Servicevertrags.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen

    Datentyp: Zeichenfolge

    sys_created_by Name des Benutzers, der den Servicevertrags-Datensatz erstellt hat.

    Datentyp: Zeichenfolge

    sys_created_on Datum und Uhrzeit der Erstellung des Servicevertragsdatensatzes.

    Datentyp: Zeichenfolge

    sys_id Sys_id des Servicevertragsdatensatzes. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    sys_updated_by Name des Benutzers, der den Servicevertrags-Datensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Servicevertragsdatensatzes.

    Datentyp: Zeichenfolge

    vendor_contract
    Eindeutiger Bezeichner für einen zugeordneten externen Vertrag.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract/fc73d2de89226110f877430a4e008add" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    Antwort:

    {
        "result": {
            "sys_id": "d8641151d1f53110f8776589fa411fde",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:27:29",
            "sys_updated_on": "2023-10-09 11:27:29",
            "account": "4c325111d1f53110f8776589fa411f3d",
            "consumer": null,
            "household": null,
            "number": "CNTR0010004",
            "state": "active",
            "starts": "2022-12-03",
            "ends": "",
            "short_description": null,
            "vendor_contract": "External Reference",
            "service_contract_lines": [
                {
                    "sys_id": "d4641d91d1f53110f8776589fa411fbb",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "name": "CLI",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "parent_contract_line": null,
                    "sold_product": null,
                    "starts": "2022-12-03",
                    "ends": "",
                    "product_offering": null,
                    "product_model": null,
                    "child_contract_lines": [
                        {
                            "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "name": "Child CLI",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "parent_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "sold_product": null,
                            "starts": "2022-12-03",
                            "ends": "",
                            "product_offering": null,
                            "product_model": null,
                            "child_contract_lines": [],
                            "entitlements": [
                                {
                                    "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "entitlement_name": "Child CLI - ENTL",
                                    "account": "4c325111d1f53110f8776589fa411f3d",
                                    "consumer": null,
                                    "household": null,
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                                    "state": "active",
                                    "product_offering": null,
                                    "sold_entitlement": null,
                                    "product": null,
                                    "start_date": "2022-12-03",
                                    "end_date": "",
                                    "entitlement_characteristics": [],
                                    "sold_products_covered": [],
                                    "install_base_items_covered": []
                                }
                            ],
                            "sold_products_covered": [
                                {
                                    "sys_id": "dfb62e9c4c6843009be02a68f65b9118",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": null,
                                    "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
                                    "added": "2023-12-03",
                                    "removed": "2023-12-03"
                                }
                            ],
                            "install_base_items_covered": [
                                {
                                    "sys_id": "2583912e81964501b52a2e44d4797a28",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": null,
                                    "install_base": "a1731551d1f53110f8776589fa411f8d",
                                    "added": "2023-12-03",
                                    "removed": "2023-12-03"
                                }
                            ],
                            "entitlement_characteristics": [
                                {
                                    "sys_id": "3a00c975bb49412cae169200c7f6236e",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": null,
                                    "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                                    "value": "5",
                                    "characteristic": "63418db7539e61106bfcddeeff7b1238",
                                    "type": "coverage"
                                }
                            ]
                        }
                    ],
                    "entitlements": [
                        {
                            "sys_id": "a8641d91d1f53110f8776589fa411fc0",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "entitlement_name": "ENTL",
                            "account": "4c325111d1f53110f8776589fa411f3d",
                            "consumer": null,
                            "household": null,
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "state": "active",
                            "product_offering": null,
                            "sold_entitlement": null,
                            "product": null,
                            "start_date": "2022-12-03",
                            "end_date": "",
                            "sold_products_covered": [
                                {
                                    "sys_id": "a0641d91d1f53110f8776589fa411fc2",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                    "sold_product": "da23d151d1f53110f8776589fa411f27",
                                    "added": "",
                                    "removed": ""
                                }
                            ],
                            "install_base_items_covered": [
                                {
                                    "sys_id": "e0641d91d1f53110f8776589fa411fc3",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "contract": "d8641151d1f53110f8776589fa411fde",
                                    "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                                    "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                    "install_base": "43739151d1f53110f8776589fa411fc1",
                                    "added": "2023-12-03",
                                    "removed": "2023-12-03"
                                }
                            ],
                            "entitlement_characteristics": [
                                {
                                    "sys_id": "a8641d91d1f53110f8776589fa411fd0",
                                    "sys_created_by": "admin",
                                    "sys_updated_by": "admin",
                                    "sys_created_on": "2023-10-09 11:27:29",
                                    "sys_updated_on": "2023-10-09 11:27:29",
                                    "service_contract_line": null,
                                    "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                    "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                                    "value": "5",
                                    "characteristic": "63418db7539e61106bfcddeeff7b1238",
                                    "type": "coverage_and_usage",
                                    "entitlement_usage": [
                                        {
                                            "sys_id": "a8641d91d1f53110f8776589fa411fd1",
                                            "sys_created_by": "admin",
                                            "sys_updated_by": "admin",
                                            "sys_created_on": "2023-10-09 11:27:29",
                                            "sys_updated_on": "2023-10-09 11:27:29",
                                            "entitlement": "a8641d91d1f53110f8776589fa411fc0",
                                            "service_contract_line": null,
                                            "entitlement_characteristic": "a8641d91d1f53110f8776589fa411fd0",
                                            "period_start": "2022-12-03",
                                            "period_end": "",
                                            "total_units": "5",
                                            "used_units": "3"
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "sold_products_covered": [
                        {
                            "sys_id": "98641d91d1f53110f8776589fa411fbc",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "entitlement": null,
                            "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "install_base_items_covered": [
                        {
                            "sys_id": "58641d91d1f53110f8776589fa411fbd",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "entitlement": null,
                            "install_base": "a1731551d1f53110f8776589fa411f8d",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "entitlement_characteristics": [
                        {
                            "sys_id": "e0641d91d1f53110f8776589fa411fbf",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "service_contract_line": "d4641d91d1f53110f8776589fa411fbb",
                            "entitlement": null,
                            "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                            "value": "5",
                            "characteristic": "63418db7539e61106bfcddeeff7b1238",
                            "type": "coverage"
                        }
                    ]
                },
                {
                    "sys_id": "e4641d91d1f53110f8776589fa411fd2",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "name": "CLI 2",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "parent_contract_line": null,
                    "sold_product": null,
                    "starts": "2022-12-03",
                    "ends": "",
                    "product_offering": null,
                    "product_model": null,
                    "child_contract_lines": [],
                    "entitlements": [],
                    "sold_products_covered": [
                        {
                            "sys_id": "e8641d91d1f53110f8776589fa411fd3",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "e4641d91d1f53110f8776589fa411fd2",
                            "entitlement": null,
                            "sold_product": "7f23995dd1b53110f8776589fa411f66",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "install_base_items_covered": [
                        {
                            "sys_id": "a8641d91d1f53110f8776589fa411fd4",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "contract": "d8641151d1f53110f8776589fa411fde",
                            "service_contract_line": "e4641d91d1f53110f8776589fa411fd2",
                            "entitlement": null,
                            "install_base": "a483d951d1f53110f8776589fa411fad",
                            "added": "2023-12-03",
                            "removed": "2023-12-03"
                        }
                    ],
                    "entitlement_characteristics": [
                        {
                            "sys_id": "a8641d91d1f53110f8776589fa411fd5",
                            "sys_created_by": "admin",
                            "sys_updated_by": "admin",
                            "sys_created_on": "2023-10-09 11:27:29",
                            "sys_updated_on": "2023-10-09 11:27:29",
                            "service_contract_line": "e4641d91d1f53110f8776589fa411fd2",
                            "entitlement": null,
                            "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                            "value": "5",
                            "characteristic": "63418db7539e61106bfcddeeff7b1238",
                            "type": "coverage"
                        }
                    ]
                }
            ],
            "sold_products_covered": [
                {
                    "sys_id": "9c641d91d1f53110f8776589fa411fb9",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "service_contract_line": null,
                    "entitlement": null,
                    "sold_product": "0df21151d1f53110f8776589fa411f1b",
                    "added": "2023-12-03",
                    "removed": "2023-12-03"
                }
            ],
            "install_base_items_covered": [
                {
                    "sys_id": "d8641d91d1f53110f8776589fa411fba",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:27:29",
                    "sys_updated_on": "2023-10-09 11:27:29",
                    "contract": "d8641151d1f53110f8776589fa411fde",
                    "service_contract_line": null,
                    "entitlement": null,
                    "install_base": "e2639951d1f53110f8776589fa411f2b",
                    "added": "2023-12-03",
                    "removed": "2023-12-03"
                }
            ]
        }
    }

    Servicevertrag – GET /sn_pss_core/servicecontract/contractline/{id}

    Ruft den Datensatz einer angegebenen Servicevertragsposition ab.

    Dieser Endpunkt ruft bei der Verarbeitung der Anforderung Daten in den folgenden Tabellen ab:
    • Merkmal [sn_pss_core_entitlement_charakteristik]
    • Berechtigung [service_entitlement]
    • Berechtigungsnutzung [sn_pss_core_entitlement_usage]
    • Abgedeckte verkaufte Produkte [sn_install_base_m2m_contract_sold_product]: Diese Tabelle enthält Informationen zu abgedeckten verkauften Produkten und abgedeckten Installationsbasiselementen.
    • Servicevertragsposition [sn_pss_core_service_contract_line]

    URL-Format

    URL mit Versionsnummer: /api/sn_pss_core/v1/servicecontract/contractline/{id}

    Standard-URL: /api/sn_pss_core/servicecontract/contractline/{id}

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge

    id Sys_id des abzurufenden Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    display_value Typ der zurückzugebenden Daten.
    Gültige Werte:
    • „falsch“: Gibt den Wert für alle Felder zurück. Beispiel: „state":"draft“.
    • „wahr“: Gibt den Anzeigewert für alle Felder zurück. Beispiel: „state":"Draft“
    • all: Gibt alle Informationen für alle Felder zurück.
      "state": { 
        "name": "state",
        "label": "State",
        "value": "draft",
        "display_value": "Draft",
        "type": "string"
      }

    Datentyp: Zeichenfolge

    Standardwert: false

    Tabelle : 9. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Keine

    Kopfzeilen

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    403 Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    child_contract_lines Liste der untergeordneten Servicevertragspositionen, die der Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_update_on": "String"
      }
    ]
    child_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der untergeordneten Servicevertragsposition erstellt wurden. Die Objekte in diesem Array haben die gleichen Elemente wie die Objekte im Parameter child_contract_lines.

    Datentyp: Array von Objekten

    child_contract_lines.​contract Sys_id des Servicevertrags, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​ends Datum, an dem die untergeordnete Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    „child_contract_lines.​Berechtigungen“ Liste der Berechtigungen, die der untergeordneten Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String"
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.​entitlements.​account
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​consumer
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​contract Sys_id des Vertragsdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    child_contract_lines.​entitlements.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.​entitlements.​entitlement_features.​feature
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement Sys_id des Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage Liste der Berechtigungsnutzungen, die dem Berechtigungsmerkmal zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​entitlement Sys_id des Berechtigungsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​entitlement_feature Sys_id des Berechtigungsmerkmalsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    cchild_contract_lines.​entitlements.​entitlement_characterists.​entitlement_usage.​period_end Enddatum, ab dem die Berechtigungsnutzung nicht mehr nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​period_start Startdatum, ab dem die Nutzung der Berechtigung nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​service_contract_line Sys_id der Servicevertragsposition, zu der die aktuelle Berechtigungsnutzung gehört.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_created_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_updated_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​total_units Gesamtabdeckungswert des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​used_units Anzahl der vom Account oder Verbraucher verwendeten Einheiten zwischen period_start und period_end.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.​value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​household
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered Liste der Installationsbasiselemente, die unter der untergeordneten Servicevertragsposition abgedeckt sind. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.​entitlements.​install_base_items_covered.​added
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​entitlements.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​entitlements.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​product Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.​entitlements.​sold_products_covered.​added
    Datum, ab dem das Produkt durch den zugeordneten Servicevertrag abgedeckt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​entitlements.​sold_products_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​removed
    Datum, an dem die Abdeckung des zugehörigen Produkts durch den zugehörigen Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​entitlements.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​sold_product Sys_id des vom Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered.​sys_updated_on Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​start_date
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​entitlements.​state
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sys_created_by Name des Benutzers, der den Berechtigungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sys_id Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sys_updated_by Name des Benutzers, der den Berechtigungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sys_updated_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    „child_contract_lines.​entitlement_features“ Liste der Merkmale, die der Berechtigung zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.​entitlement_features.​Merkmal
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement Sys_id des Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage Liste der Berechtigungsnutzungen, die dem Berechtigungsmerkmal zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": "String",
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    child_contract_lines.​entitlement_features.​entitlement_usage.​entitlement Sys_id des Berechtigungsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​entitlement_feature Sys_id des Berechtigungsmerkmalsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​period_end Enddatum, ab dem die Berechtigungsnutzung nicht mehr nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​entitlement_features.​entitlement_usage.​period_start Startdatum, ab dem die Nutzung der Berechtigung nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​entitlement_features.​entitlement_usage.​service_contract_line Sys_id der Servicevertragsposition, zu der die aktuelle Berechtigungsnutzung gehört.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​sys_created_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​sys_updated_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​total_units Gesamtabdeckungswert des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage.​used_units Anzahl der vom Account oder Verbraucher verwendeten Einheiten zwischen period_start und period_end.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem Berechtigungsmerkmal zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​sys_created_by Name des Benutzers, der den Datensatz mit den Berechtigungsmerkmalen erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​sys_updated_by Name des Benutzers, der den Datensatz der Berechtigungsmerkmale zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered Liste der Installationsbasiselemente, die unter der untergeordneten Servicevertragsposition abgedeckt sind. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.​install_base_items_covered.​added
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    child_contract_lines.​name Name der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    child_contract_lines.​parent_contract_line Sys_id des übergeordneten Vertragspositionsdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist.

    Datentyp: Zeichenfolge

    „child_contract_lines.​product_model“ Sys_id des Produkts, das der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    child_contract_lines.​product_offering Sys_id des Produktangebotdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    „child_contract_lines.​sold_product“ Sys_id des Datensatzes des verkauften Produkts, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    „child_contract_lines.​sold_products_covered“ Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    child_contract_lines.​sold_products_covered.​added
    Datum, ab dem das Produkt durch den zugeordneten Servicevertrag abgedeckt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​sold_products_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    „child_contract_lines.​sold_products_covered.​entitlement“ Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​removed
    Datum, an dem die Abdeckung des zugehörigen Produkts durch den zugehörigen Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​sold_product Sys_id des vom Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​sold_products_covered.​sys_updated_on Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​starts Startdatum der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​state
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    child_contract_lines.​sys_created_by Name des Benutzers, der den untergeordneten Datensatz der Servicevertragsposition erstellt hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    child_contract_lines.​sys_id Sys_id eines untergeordneten Servicevertrags-Positionsdatensatzes. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    child_contract_lines.​sys_updated_by Name des Benutzers, der den Datensatz der untergeordneten Servicevertragsposition zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    child_contract_lines.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    contract
    Sys_id des Servicevertrags, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    endet Datum, an dem die Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    Berechtigungen Liste der Berechtigungen, die der Servicevertragsposition zugeordnet sind. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "account": "String",
        "consumer": "String",
        "contract": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "service_contract_line": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    Berechtigungen.​Account
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    Berechtigungen.​Verbraucher
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    Berechtigungen.​Vertrag Sys_id des Vertragsdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    entitlements.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    Berechtigungen. entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "entitlement_usage": [Array],
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    Berechtigungen. entitlement_features.feature
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    Berechtigungen Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage

    Datentyp: Array von Objekten

    "entitlement_usage": [
      {
        "entitlement": "String",
        "entitlement_characteristic": [Array],
        "period_end": "String",
        "period_start": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "total_units": "String",
        "used_units": "String"
      }
    ]
    Berechtigungen Sys_id des Berechtigungsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    Berechtigungen Sys_id des Berechtigungsmerkmalsdatensatzes, der der Berechtigungsnutzung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​period_end Enddatum, ab dem die Berechtigungsnutzung nicht mehr nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    entitlements.​entitlement_features.​entitlement_usage.​period_start Startdatum, ab dem die Nutzung der Berechtigung nachverfolgt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    entitlements.​entitlement_features.​entitlement_usage.​service_contract_line Servicevertragsposition, zu der die aktuelle Berechtigungsnutzung gehört.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​sys_created_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​sys_updated_by Name des Benutzers, der den Berechtigungsnutzungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Berechtigungsnutzungsdatensatzes.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​total_units Gesamtabdeckungswert des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​entitlement_usage.​used_units Anzahl der vom Account oder Verbraucher verwendeten Einheiten zwischen period_start und period_end.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem Berechtigungsmerkmal zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​sys_created_by Name des Benutzers, der den Datensatz mit den Berechtigungsmerkmalen erstellt hat.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​sys_updated_by Name des Benutzers, der den Datensatz der Berechtigungsmerkmale zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    Berechtigungen. entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    Berechtigungen.​Haushalt
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    entitlements.​install_base_items_covered.​added Datum, an dem das zugehörige Installationsbasiselement der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered.​entitlement Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    Berechtigungen.​install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    Berechtigungen.​install_base_items_covered.​entfernt Datum, an dem das zugehörige Installationsbasiselement aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Berechtigungen.​install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    Berechtigungen.​install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    Berechtigungen.​Produkt Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    entitlements.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    entitlements.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    Berechtigungen.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    entitlements.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    Berechtigungen.​sold_products_covered.​Vertrag Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    Berechtigungen. sold_products_covered. Berechtigung Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.removed Datum, an dem das zugeordnete verkaufte Produkt aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    entitlements.​sold_products_covered.​service_contract_line Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.​sold_product Sys_id des Produkts, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.​sys_created_by Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.​sys_id Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.​sys_updated_by Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des verkauften Produkts.

    Datentyp: Zeichenfolge

    Berechtigungen.​start_date
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Berechtigungen.​Status
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    Berechtigungen.sys_created_by Name des Benutzers, der den Berechtigungsdatensatz erstellt hat.

    Datentyp: Zeichenfolge

    entitlements.​sys_created_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    Berechtigungen.​sys_id Sys_id des zugeordneten Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    Berechtigungen.sys_updated_by Name des Benutzers, der den Berechtigungsdatensatz zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    Berechtigungen.​sys_updated_on Datum und Uhrzeit der Erstellung des Berechtigungsdatensatzes.

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale Liste der Berechtigungsmerkmale, die der Servicevertragsposition zugeordnet sind. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String",
        "type": "String",
        "value": "String"
      }
    ]
    Berechtigungsmerkmale.​Merkmal
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.​Merkmale_Option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    Berechtigung – Merkmale. Berechtigung Sys_id des Berechtigungsdatensatzes. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.​Service_Vertragszeile Sys_id des Datensatzes der Servicevertragsposition, der dem Berechtigungsmerkmal zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.​sys_created_by Name des Benutzers, der den Datensatz mit den Berechtigungsmerkmalen erstellt hat.

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.sys_updated_by Name des Benutzers, der den Datensatz der Berechtigungsmerkmale zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale Typ Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale.​Wert
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    install_base_items_covered Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "install_base": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    install_base_items_covered.​hinzugefügt
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    install_base_items_covered.​contract Sys_id des Servicevertragsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    Berechtigung „install_base_items_covered.​“ Sys_id des Berechtigungsdatensatzes, der dem Installationsbasiselement zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    install_base_items_covered.​entfernt
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    install_base_items_covered.​service_contract_line Sys_id des zugehörigen Datensatzes der Servicevertragsposition. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_created_by Name des Benutzers, der den Datensatz des Installationsbasiselements erstellt hat.

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_updated_by Name des Benutzers, der den Datensatz des Installationsbasiselements zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    install_base_items_covered.​sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des Installationsbasiselements.

    Datentyp: Zeichenfolge

    name
    Name der Servicevertragsposition.

    Datentyp: Zeichenfolge

    parent_contract_line Sys_id der Servicevertragsposition, der die aktuelle Servicevertragsposition untergeordnet ist.

    NULL für die Vertragspositionen, die unter einem Vertrag erstellt wurden.

    Datentyp: Zeichenfolge

    product_model Sys_id des Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    product_offering Sys_id des Produktangebotdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    „sold_product“ Sys_id des Datensatzes des verkauften Produkts, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    „sold_products_covered“ Liste der abgedeckten Produkte. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "contract": "String",
        "entitlement": "String",
        "removed": "String",
        "service_contract_line": "String",
        "sold_product": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    „sold_products_covered.​added“. Datum, an dem das zugehörige verkaufte Produkt der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    „sold_products_covered.​contract“ Sys_id des Servicevertragsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    Berechtigung „sold_products_covered.​entitlement“ Sys_id des Berechtigungsdatensatzes, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    „sold_products_covered.removed“ Datum, an dem das zugehörige verkaufte Produkt aus der Servicevertragsposition entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    „sold_products_covered.​service_contract_line“ Sys_id des Datensatzes der Servicevertragsposition, der dem verkauften Produkt zugeordnet ist. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    „sold_products_covered“.​sold_product Sys_id des Produkts, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_created_by“ Name des Anwenders, der den Datensatz des abgedeckten verkauften Produkts erstellt hat.

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_created_on“ Datum und Uhrzeit der Erstellung des Datensatzes „Verkauftes Produkt abgedeckt“

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_id“ Sys_id des von diesem Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_updated_by“ Name des Anwenders, der den Datensatz des verkauften Produkts zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    „sold_products_covered.​sys_updated_on“ Datum und Uhrzeit der letzten Aktualisierung des Datensatzes des verkauften Produkts.

    Datentyp: Zeichenfolge

    beginnt
    Startdatum der Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Staat
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    sys_created_by Name des Benutzers, der den Datensatz der Servicevertragsposition erstellt hat.

    Datentyp: Zeichenfolge

    sys_created_on Datum und Uhrzeit der Erstellung des Datensatzes der Servicevertragsposition.

    Datentyp: Zeichenfolge

    sys_id Sys_id eines Servicevertrags-Positionsdatensatzes. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    sys_updated_by Name des Benutzers, der den Datensatz der Servicevertragsposition zuletzt aktualisiert hat.

    Datentyp: Zeichenfolge

    sys_updated_on Datum und Uhrzeit der letzten Aktualisierung des Datensatzes der Servicevertragsposition.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract/contractline/fc73d2de89226110f877430a4e008add" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    Antwort:

    {
      "result": {
        "sys_id": "16e451d1d1f53110f8776589fa411f80",
        "sys_created_by": "admin",
        "sys_updated_by": "admin",
        "sys_created_on": "2023-10-09 11:29:47",
        "sys_updated_on": "2023-10-09 11:29:47",
        "name": "CLI",
        "contract": "a4b415d1d1f53110f8776589fa411f20",
        "parent_contract_line": null,
        "sold_product": null,
        "starts": "2022-12-03",
        "ends": "",
        "product_offering": null,
        "product_model": null,
        "child_contract_lines": [
          {
            "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:27:29",
            "sys_updated_on": "2023-10-09 11:27:29",
            "name": "Child CLI",
            "contract": "a4b415d1d1f53110f8776589fa411f20",
            "parent_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "sold_product": null,
            "starts": "2022-12-03",
            "ends": "",
            "product_offering": null,
            "product_model": null,
            "child_contract_lines": [],
            "entitlements": [
              {
                "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "entitlement_name": "Child CLI - ENTL",
                "account": "4c325111d1f53110f8776589fa411f3d",
                "consumer": null,
                "household": null,
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "state": "active",
                "product_offering": null,
                "sold_entitlement": null,
                "product": null,
                "start_date": "2022-12-03",
                "end_date": "",
                "entitlement_characteristics": [],
                "sold_products_covered": [],
                "install_base_items_covered": []
              }
            ],
            "sold_products_covered": [
              {
                "sys_id": "dfb62e9c4c6843009be02a68f65b9118",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "entitlement": null,
                "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
                "added": "2023-12-03",
                "removed": "2023-12-03"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "2583912e81964501b52a2e44d4797a28",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "entitlement": null,
                "install_base": "a1731551d1f53110f8776589fa411f8d",
                "added": "2023-12-03",
                "removed": "2023-12-03"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "3a00c975bb49412cae169200c7f6236e",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:27:29",
                "sys_updated_on": "2023-10-09 11:27:29",
                "service_contract_line": "3a39ecdc01154f4ab782da0169c9c922",
                "entitlement": null,
                "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                "value": "5",
                "characteristic": "63418db7539e61106bfcddeeff7b1238",
                "type": "coverage"
              }
            ]
          }
        ],
        "entitlements": [
          {
            "sys_id": "16e419d1d1f53110f8776589fa411f3c",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:29:48",
            "sys_updated_on": "2023-10-09 11:29:48",
            "entitlement_name": "ENTL 2",
            "account": "4c325111d1f53110f8776589fa411f3d",
            "consumer": null,
            "household": null,
            "contract": "a4b415d1d1f53110f8776589fa411f20",
            "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "state": "active",
            "product_offering": null,
            "sold_entitlement": null,
            "product": null,
            "start_date": "2022-12-03",
            "end_date": "",
            "sold_products_covered": [
              {
                "sys_id": "1ae419d1d1f53110f8776589fa411f3d",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:29:48",
                "sys_updated_on": "2023-10-09 11:29:48",
                "contract": "a4b415d1d1f53110f8776589fa411f20",
                "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
                "entitlement": "16e419d1d1f53110f8776589fa411f3c",
                "sold_product": "da23d151d1f53110f8776589fa411f27",
                "added": "",
                "removed": ""
              }
            ],
            "install_base_items_covered": [],
            "entitlement_characteristics": [
              {
                "sys_id": "1ae419d1d1f53110f8776589fa411f3e",
                "sys_created_by": "admin",
                "sys_updated_by": "admin",
                "sys_created_on": "2023-10-09 11:29:48",
                "sys_updated_on": "2023-10-09 11:29:48",
                "service_contract_line": null,
                "entitlement": "16e419d1d1f53110f8776589fa411f3c",
                "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                "value": "5",
                "characteristic": "63418db7539e61106bfcddeeff7b1238",
                "type": "coverage_and_usage",
                "entitlement_usage": [
                  {
                    "sys_id": "56e419d1d1f53110f8776589fa411f3f",
                    "sys_created_by": "admin",
                    "sys_updated_by": "admin",
                    "sys_created_on": "2023-10-09 11:29:48",
                    "sys_updated_on": "2023-10-09 11:29:48",
                    "entitlement": "16e419d1d1f53110f8776589fa411f3c",
                    "service_contract_line": null,
                    "entitlement_characteristic": "1ae419d1d1f53110f8776589fa411f3e",
                    "period_start": "2022-12-03",
                    "period_end": "",
                    "total_units": "5",
                    "used_units": "2"
                  }
                ]
              }
            ]
          }
        ],
        "sold_products_covered": [
          {
            "sys_id": "5ae451d1d1f53110f8776589fa411f81",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:29:47",
            "sys_updated_on": "2023-10-09 11:29:47",
            "contract": "a4b415d1d1f53110f8776589fa411f20",
            "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "entitlement": null,
            "sold_product": "0df21151d1f53110f8776589fa411f1b",
            "added": "2023-12-03",
            "removed": "2023-12-03"
          }
        ],
        "install_base_items_covered": [],
        "entitlement_characteristics": [
          {
            "sys_id": "dae451d1d1f53110f8776589fa411f82",
            "sys_created_by": "admin",
            "sys_updated_by": "admin",
            "sys_created_on": "2023-10-09 11:29:47",
            "sys_updated_on": "2023-10-09 11:29:47",
            "service_contract_line": "16e451d1d1f53110f8776589fa411f80",
            "entitlement": null,
            "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
            "value": "5",
            "characteristic": "63418db7539e61106bfcddeeff7b1238",
            "type": "coverage"
          }
        ]
      }
    }

    Servicevertrag: POST /sn_pss_core/servicecontract

    Erstellt einen Servicevertragsdatensatz und alle zugehörigen Entitäten aus einer angegebenen Nutzlast.

    Die Servicevertrags- API speichert Daten in verschiedenen Tabellen. Im Folgenden finden Sie die Liste der Tabellen, in denen Datensätze bei der Erstellung eines Servicevertrags von diesem Endpunkt erstellt werden:
    • Merkmal [sn_pss_core_entitlement_charakteristik]
    • Berechtigung [service_entitlement]
    • Berechtigungsnutzung [sn_pss_core_entitlement_usage]
    • Abgedeckte verkaufte Produkte [sn_install_base_m2m_contract_sold_product]: Diese Tabelle enthält Informationen zu abgedeckten verkauften Produkten und abgedeckten Installationsbasiselementen.
    • Servicevertrag [sn_pss_core_service_contract]
    • Servicevertragsposition [sn_pss_core_service_contract_line]

    Der Anforderungstext dieses Endpunkts verweist auf Felder in den folgenden Tabellen. Diese Informationen müssen Ihrer Instanz hinzugefügt werden, bevor Sie diese API verwenden können. Weitere Informationen finden Sie unter Create service contracts.

    • Account [customer_account]
    • Merkmalsoption [sn_prd_pm_charakteristik_option]
    • Verbraucher [csm_consumer]
    • Haushalt [csm_household]

    URL-Format

    URL mit Versionsnummer: /api/sn_pss_core/v1/servicecontract

    Standard-URL: /api/sn_pss_core/servicecontract

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge

    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 15. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Account Erforderlich, wenn der Parameter consumer nicht angegeben ist.
    Sys_id des Account-Datensatzes, zu dem der Servicevertrag gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    consumer Erforderlich, wenn der Parameter account nicht angegeben ist.
    Sys_id des Verbraucherdatensatzes, zu dem der Servicevertrag gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    endet
    Datum, an dem der Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    ​Haushalt Gilt nur für Verbraucherserviceverträge.
    Sys_id des Haushalts, der dem Servicevertrag zugeordnet ist. Unter „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    Standard: null (kein Haushalt)

    install_base_items_covered Liste der Installationsbasiselemente, die unter den Servicevertrag fallen. Die Daten in diesem Parameter werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Weitere Informationen zu Installationsbasiselementen finden Sie unter Configure install base.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    install_base_items_covered.added
    Datum, ab dem die Abdeckung des Installationsbasiselements durch den zugeordneten Servicevertrag beginnt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    install_base_items_covered.​install_base Sys_id des zugehörigen Datensatzes des Installationsbasiselements. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    install_base_items_covered.​entfernt
    Datum, an dem die Abdeckung des Installationsbasiselements durch den zugeordneten Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines Liste der Servicevertragspositionen, die dem Servicevertrag zugeordnet sind. Diese Daten werden in die Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line] eingefügt.

    Datentyp: Array von Objekten

    "service_contract_lines": [
      {
        "child_contract_lines": [Array],
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String"
      }
    ]
    service_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionen unter der Servicevertragsposition. Die Daten in diesem Parameter werden in die Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line] eingefügt.

    Datentyp: Array von Objekten

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der untergeordneten Servicevertragsposition erstellt werden sollen. Die Objekte in diesem Array haben die gleichen Elemente wie die Objekte im Parameter service_contract_lines.child_contract_lines.

    Datentyp: Array von Objekten

    service_contract_lines.​child_contract_lines.​ends Datum, an dem die Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​child_contract_lines.​Berechtigungen Liste der Berechtigungen, die mit der untergeordneten Servicevertragsposition verknüpft werden sollen. Diese Berechtigungen werden in die Tabelle „Berechtigung“ [service_entitlement] eingefügt.

    Datentyp: Array von Objekten

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​berechtigungen.​account
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Verbraucher
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​Berechtigungen.​Berechtigung_Merkmale.Merkmale Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Berechtigung_Merkmale.Merkmal_Option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_charakteristik.entitlement_usage Verwendeter Einheitenwert für das zugeordnete Berechtigungsmerkmal. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Übergeben Sie diesen Parameter nur, wenn sich die Berechtigungsmerkmale unter der Berechtigung befinden.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_charakteristik.entitlement_usage.​used_units Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.value Erforderlich, wenn der Parameter input_type, der in dem im Parameter entitlement_characteristics.characteristic angegebenen Datensatz enthalten ist, keine Auswahlmöglichkeitist.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​entitlement_name Erforderlich.
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Haushalt Wird nur übergeben, wenn die Haushalts-Plugins aktiv sind und der Parameter consumer übergeben wird.
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered
    Liste der Installationsbasiselemente, die unter der Berechtigung abgedeckt sind. Die Informationen in diesem Array werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​hinzugefügt Datum, an dem das zugehörige Installationsbasiselement der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​removed Datum, an dem das zugehörige Installationsbasiselement aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​berechtigungen.​product Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered Liste der verkauften Produkte, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​removed Datum, an dem das zugeordnete verkaufte Produkt aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​berechtigungen.​start_date Erforderlich.
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​child_contract_lines.​Berechtigungen.​Status Erforderlich.
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features Liste der Merkmale, die der Servicevertragsposition zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics" [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlement_features.feature Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.feature_option
    Sys_id des Merkmaloptionsdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.entitlement_usage Verwendeter Einheitenwert für das zugeordnete Merkmal der Servicevertragsposition. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.​child_contract_lines.​entitlement_features.entitlement_usage.​usage_units Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.type Typ des Merkmals der Servicevertragsposition.
    Gültige Werte:
    • Abdeckung
    • Abdeckung _and_usage (Abdeckung _and_usage)

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.value Erforderlich, wenn der Parameter entitlement_characteristics.type nicht übergeben wird.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered
    Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden. Die Daten in diesem Parameter werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​install_base_items_covered.​hinzugefügt
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​name
    Name der Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​product_model Sys_id des Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​product_offering Sys_id des Produktangebotdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_product Sys_id des Datensatzes des verkauften Produkts, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered
    Liste der Produkte, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​.sold_products_covered.​added Datum, ab dem die zugehörige Servicevertragsposition das zugehörige Produkt abdeckt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​child_contract_lines.​sold_products_covered.​removed Datum, an dem die Abdeckung des zugehörigen Produkts durch die zugehörige Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​child_contract_lines.​sold_products_covered.​sold_product
    Sys_id eines Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​starts Erforderlich.
    Startdatum der Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​child_contract_lines.​state Erforderlich.
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    service_contract_lines.ends Datum, an dem die Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.entitlements Liste der Berechtigungen, die mit der Servicevertragsposition verknüpft werden sollen. Diese Berechtigungen werden in die Tabelle „Berechtigung“ [service_entitlement] eingefügt.

    Datentyp: Array von Objekten

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    service_contract_lines.​entitlements.​account
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​consumer
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    service_contract_lines.​entitlements.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​entitlements.​entitlement_features.feature Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.entitlement_usage Verwendeter Einheitenwert für das zugeordnete Berechtigungsmerkmal. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Übergeben Sie diesen Parameter nur, wenn sich die Berechtigungsmerkmale unter der Berechtigung befinden.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.​entitlements.​entitlement_features.entitlement_usage.​usage_units Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.value Erforderlich, wenn der Parameter input_type, der in dem im Parameter entitlement_characteristics.characteristic angegebenen Datensatz enthalten ist, keine Auswahlmöglichkeitist.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_name Erforderlich.
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​household Wird nur übergeben, wenn die Haushalts-Plugins aktiv sind und der Parameter consumer übergeben wird.
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered
    Liste der Installationsbasiselemente, die unter der Berechtigung abgedeckt sind. Die Informationen in diesem Array werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.​entitlements.​install_base_items_covered.​added Datum, an dem das zugehörige Installationsbasiselement der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​entitlements.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered.​removed Datum, an dem das zugehörige Installationsbasiselement aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​entitlements.​product Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered Liste der verkauften Produkte, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.​entitlements.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​entitlements.​sold_products_covered.​removed Datum, an dem das zugeordnete verkaufte Produkt aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​entitlements.​sold_products_covered.​sold_product Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​start_date Erforderlich.
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​entitlements.​state Erforderlich.
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features Liste der Merkmale, die der Servicevertragsposition zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics" [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    service_contract_lines.​entitlement_features.​Merkmal Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​feature_option
    Sys_id des Merkmaloptionsdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​entitlement_usage Verwendeter Einheitenwert für das zugeordnete Merkmal der Servicevertragsposition. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    service_contract_lines.​entitlement_features.​entitlement_usage.​usage_units Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​type Typ des Merkmals der Servicevertragsposition.
    Gültige Werte:
    • Abdeckung
    • Abdeckung _and_usage (Abdeckung _and_usage)

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlement_features.​value Erforderlich, wenn der Parameter entitlement_characteristics.type nicht übergeben wird.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered
    Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden. Die Daten in diesem Parameter werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    service_contract_lines.​install_base_items_covered.​added
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    service_contract_lines.​install_base_items_covered.​removed
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​name
    Name der Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​product_model Sys_id des Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    service_contract_lines.​product_offering Sys_id des Produktangebotdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_product Sys_id des Datensatzes des verkauften Produkts, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​sold_products_covered
    Liste der Produkte, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    service_contract_lines.​sold_products_covered.​added Datum, ab dem die zugehörige Servicevertragsposition das zugehörige Produkt abdeckt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    service_contract_lines.​sold_products_covered.​removed Datum, an dem die Abdeckung des zugehörigen Produkts durch die zugehörige Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    service_contract_lines.​sold_products_covered.​sold_product
    Sys_id eines Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​starts Erforderlich.
    Startdatum der Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    service_contract_lines.​state Erforderlich.
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    short_description
    Kurze Beschreibung oder Name des Servicevertrags.

    Datentyp: Zeichenfolge

    Standard: NULL (leere Zeichenfolge)

    „sold_products_covered“ Erforderlich, wenn der Parameter install_base_items_covered nicht angegeben ist.
    Liste der vom Servicevertrag abgedeckten Produkte. Die Daten in diesem Parameter werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    „sold_products_covered.added“
    Datum, ab dem das Produkt durch den zugeordneten Servicevertrag abgedeckt wird.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    „sold_products_covered.removed“
    Datum, an dem die Abdeckung des zugehörigen Produkts durch den zugehörigen Servicevertrag endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    „sold_products_covered.sold_product“ Sys_id des vom Servicevertrag abgedeckten Produkts. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    beginnt Erforderlich.
    Datum, an dem der Servicevertrag beginnt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Staat Erforderlich.
    Aktueller Status des Servicevertrags.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen

    Datentyp: Zeichenfolge

    vendor_contract Erforderlich.
    Eindeutiger Bezeichner für einen zugeordneten externen Vertrag.

    Datentyp: Zeichenfolge

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Content-Type Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Tabelle : 17. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 18. Statuscodes
    Statuscode Beschreibung
    201 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet, und die Datensätze wurden erstellt.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    403 Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die vom Servicevertrag abgedeckt sind.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    Nummer Automatisch generierte Servicevertragsnummer.

    Datentyp: Zeichenfolge

    service_contract_lines Liste der Servicevertragspositionen, die dem Servicevertrag zugeordnet sind.

    Datentyp: Array von Objekten

    "service_contract_lines": [
      {
        "child_contract_lines": [Array],
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der Servicevertragsposition erstellt wurden.

    Datentyp: Array von Objekten

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "sold_products_covered": [Array],
        "sys_id" "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der untergeordneten Servicevertragsposition erstellt wurden. Die Objekte in diesem Array haben die gleichen Elemente wie der Parameter service_contract_lines.child_contract_lines.

    Datentyp: Array von Objekten

    service_contract_lines.​child_contract_lines.​Berechtigungen Liste der Berechtigungen, die der untergeordneten Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "entitlement_name": "String",
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​berechtigungen.​entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features Liste der Berechtigungsmerkmalobjekte, die unter der Berechtigung erstellt wurden.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​Berechtigungen.​entitlement_features.​sys_id Sys_id eines Berechtigungsmerkmals-Datensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlements.​install_base_items_covered.​sys_id Sys_id eines Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered Liste der sys_ids der von der Berechtigung abgedeckten Produkte.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlements.​sold_products_covered.​sys_id Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​berechtigungen.​sys_id Sys_id des Berechtigungsdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features Liste der Merkmale, die der Vertragsposition „Chile“ zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​entitlement_features.​entitlement_usage Berechtigungsnutzungsobjekt unter „entitlement_charakter“ eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "sys_id": "String"
    }
    service_contract_lines.​child_contract_lines.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​entitlement_features.​sys_id Sys_id eines Berechtigungsmerkmals-Datensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die von der untergeordneten Vertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​name Name der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sold_products_covered Liste der sys_ids der Produkte, die von der untergeordneten Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​child_contract_lines.​sold_products_covered.​sys_id Sys_id eines Produkts, das von der untergeordneten Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​child_contract_lines.​sys_id Sys_id eines untergeordneten Servicevertrags-Positionsdatensatzes. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements Liste der Berechtigungen, die dem Servicevertrag zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlements" [
      {
        "entitlement_name": "String",
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    service_contract_lines.​entitlements.​entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features Liste der Berechtigungsmerkmalobjekte, die unter der Berechtigung erstellt wurden.

    Datentyp: Array von Objekten

    "entitlement_characteristics" [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage Berechtigungsnutzungsobjekt unter „entitlement_charakter“ eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "sys_id": "String"
    }
    service_contract_lines.​entitlements.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​entitlement_features.​sys_id Sys_id eines Berechtigungsmerkmals-Datensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​entitlements.​install_base_items_covered.​sys_id Sys_id eines Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sold_products_covered Liste der sys_ids der von der Berechtigung abgedeckten Produkte.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    service_contract_lines.​entitlements.​sold_products_covered.​sys_id Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    service_contract_lines.​entitlements.​sys_id Sys_id des Berechtigungsdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    short_description
    Kurze Beschreibung oder Name des Servicevertrags.

    Datentyp: Zeichenfolge

    „sold_products_covered“ Liste der sys_ids der vom Servicevertrag abgedeckten Produkte.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    „sold_products_covered.​sys_id“ Sys_id eines Produkts, das vom Servicevertrag abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    sys_id Sys_id des Servicevertragsdatensatzes. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Im Folgenden finden Sie ein Codebeispiel, das zeigt, wie Sie diesen Endpunkt aufrufen und einen Servicevertrag mit einem Datensatz verkaufter Produkte, einem Datensatz abgedeckter Installationsbasiselemente und zwei Servicevertragspositionen erstellen.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract" \
    --request POST \
    --header "Accept:application/json" \
    --data
    {
      "state": "active",
      "account": "4c325111d1f53110f8776589fa411f3d",
      "vendor_contract": "External Reference",
      "starts": "2022-12-03",
      "service_contract_lines": [
        {
          "state": "active",
          "name": "CLI",
          "starts": "2022-12-03",
          "child_contract_lines": [
            {
              "state": "active",
              "name": "Child CLI",
              "starts": "2022-12-03",
              "entitlements": [
                {
                  "state": "active",
                  "entitlement_name": "Child CLI - ENTL",
                  "start_date": "2022-12-03"
                }
              ],
              "sold_products_covered": [
                {
                  "sold_product": "8db4258949f14ef7b90d90822dfc5800",
                  "added": "2023-12-03",
                  "removed": "2023-12-03"
                }
              ],
              "install_base_items_covered": [
                {
                  "install_base": "2f270832699b46e78aa899a5a5dc6682",
                  "added": "2023-12-03",
                  "removed": "2023-12-03"
                }
              ],
              "entitlement_characteristics": [
                {
                  "characteristic": "63418db7539e61106bfcddeeff7b1238",
                  "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                  "value": "20",
                  "type": "coverage"
                }
              ]
            }
          ],
          "entitlements": [
            {
              "state": "active",
              "entitlement_name": "ENTL",
              "start_date": "2022-12-03",
              "sold_products_covered": [
                {
                  "sold_product": "da23d151d1f53110f8776589fa411f27"
                }
              ],
              "install_base_items_covered": [
                {
                  "install_base": "43739151d1f53110f8776589fa411fc1",
                  "added": "2023-12-03",
                  "removed": "2023-12-03"
                }
              ],
              "entitlement_characteristics": [
                {
                  "characteristic": "63418db7539e61106bfcddeeff7b1238",
                  "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
                  "value": "20",
                  "type": "coverage_and_usage",
                  "entitlement_usage": {
                    "used_units": "3"
                  }
                }
              ]
            }
          ],
          "sold_products_covered": [
            {
              "sold_product": "ec235d9dd1b53110f8776589fa411fe2",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "install_base_items_covered": [
            {
              "install_base": "a1731551d1f53110f8776589fa411f8d",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage"
            }
          ]
        },
        {
          "state": "active",
          "name": "CLI 2",
          "starts": "2022-12-03",
          "sold_products_covered": [
            {
              "sold_product": "7f23995dd1b53110f8776589fa411f66",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "install_base_items_covered": [
            {
              "install_base": "a483d951d1f53110f8776589fa411fad",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage"
            }
          ]
        }
      ],
      "sold_products_covered": [
        {
          "sold_product": "0df21151d1f53110f8776589fa411f1b",
          "added": "2023-12-03",
          "removed": "2023-12-03"
        }
      ],
      "install_base_items_covered": [
        {
          "install_base": "e2639951d1f53110f8776589fa411f2b",
          "added": "2023-12-03",
          "removed": "2023-12-03"
        }
      ]
    } 
    --user "username":"password"

    Antwort:

    {
      "result": {
        "sys_id": "d8641151d1f53110f8776589fa411fde",
        "number": "CNTR0010004",
        "short_description": null,
        "service_contract_lines": [
          {
            "sys_id": "d4641d91d1f53110f8776589fa411fbb",
            "name": "CLI",
            "child_contract_lines": [
              {
                "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
                "name": "Child CLI",
                "child_contract_lines": [],
                "entitlements": [
                  {
                    "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                    "entitlement_name": "Child CLI - ENTL",
                    "sold_products_covered": [],
                    "install_base_items_covered": [],
                    "entitlement_characteristics": []
                  }
                ],
                "sold_products_covered": [
                  {
                    "sys_id": "dfb62e9c4c6843009be02a68f65b9118"
                  }
                ],
                "install_base_items_covered": [
                  {
                    "sys_id": "2583912e81964501b52a2e44d4797a28"
                  }
                ],
                "entitlement_characteristics": [
                  {
                    "sys_id": "3a00c975bb49412cae169200c7f6236e",
                    "entitlement_usage": {}
                  }
                ]
              }
            ],
            "entitlements": [
              {
                "sys_id": "a8641d91d1f53110f8776589fa411fc0",
                "entitlement_name": "ENTL",
                "sold_products_covered": [
                  {
                    "sys_id": "a0641d91d1f53110f8776589fa411fc2"
                  }
                ],
                "install_base_items_covered": [
                  {
                    "sys_id": "e0641d91d1f53110f8776589fa411fc3"
                  }
                ],
                "entitlement_characteristics": [
                  {
                    "sys_id": "a8641d91d1f53110f8776589fa411fd0",
                    "entitlement_usage": {
                      "sys_id": "a8641d91d1f53110f8776589fa411fd1"
                    }
                  }
                ]
              }
            ],
            "sold_products_covered": [
              {
                "sys_id": "98641d91d1f53110f8776589fa411fbc"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "58641d91d1f53110f8776589fa411fbd"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "e0641d91d1f53110f8776589fa411fbf",
                "entitlement_usage": {}
              }
            ]
          },
          {
            "sys_id": "e4641d91d1f53110f8776589fa411fd2",
            "name": "CLI 2",
            "child_contract_lines": [],
            "entitlements": [],
            "sold_products_covered": [
              {
                "sys_id": "e8641d91d1f53110f8776589fa411fd3"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "a8641d91d1f53110f8776589fa411fd4"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "a8641d91d1f53110f8776589fa411fd5",
                "entitlement_usage": {}
              }
            ]
          }
        ],
        "sold_products_covered": [
          {
            "sys_id": "9c641d91d1f53110f8776589fa411fb9"
          }
        ],
        "install_base_items_covered": [
          {
            "sys_id": "d8641d91d1f53110f8776589fa411fba"
          }
        ]
      }
    }

    Servicevertrag: POST /sn_pss_core/servicecontract/contractline

    Erstellt einen Vertragspositionsdatensatz und alle zugehörigen Entitäten.

    Dieser Endpunkt speichert bei der Verarbeitung der Anforderung Daten in den folgenden Tabellen:
    • Merkmal [sn_pss_core_entitlement_charakteristik]
    • Berechtigung [service_entitlement]
    • Berechtigungsnutzung [sn_pss_core_entitlement_usage]
    • Abgedeckte verkaufte Produkte [sn_install_base_m2m_contract_sold_product]: Diese Tabelle enthält Informationen zu abgedeckten verkauften Produkten und abgedeckten Installationsbasiselementen.
    • Servicevertragsposition [sn_pss_core_service_contract_line]

    URL-Format

    URL mit Versionsnummer: /api/sn_pss_core/v1/servicecontract/contractline

    Standard-URL: /api/sn_pss_core/servicecontract/contractline

    Unterstützte Anforderungsparameter

    Tabelle : 19. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge

    Tabelle : 20. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 21. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der Servicevertragsposition erstellt wurden. Diese Daten werden in den Servicevertrag [sn_pss_core_service_contract] eingefügt.

    Datentyp: Array von Objekten

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "contract": "String",
        "ends": "String",
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "parent_contract_line": "String",
        "product_model": "String",
        "product_offering": "String",
        "sold_product": "String",
        "sold_products_covered": [Array],
        "starts": "String",
        "state": "String"
      }
    ]
    child_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der untergeordneten Servicevertragsposition erstellt werden sollen. Die Objekte in diesem Array haben die gleichen Elemente wie die Objekte im Parameter child_contract_lines.

    Datentyp: Array von Objekten

    child_contract_lines.​contract Sys_id des Servicevertrags, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    child_contract_lines.​ends Datum, an dem die untergeordnete Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    „child_contract_lines.​Berechtigungen“ Liste der Berechtigungen, die der untergeordneten Servicevertragsposition zugeordnet sind. Diese Berechtigungen werden in die Tabelle „Berechtigung“ [service_entitlement] eingefügt.

    Datentyp: Array von Objekten

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    child_contract_lines.​entitlements.​account Erforderlich, wenn der Parameter consumer nicht übergeben wird.
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​consumer Erforderlich, wenn der Parameter account nicht übergeben wird.
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    child_contract_lines.​entitlements.​entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.​entitlements.​entitlement_features.feature Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features.entitlement_usage Verwendeter Einheitenwert für das zugeordnete Berechtigungsmerkmal. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Übergeben Sie diesen Parameter nur, wenn sich die Berechtigungsmerkmale unter der Berechtigung befinden.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    child_contract_lines.​entitlements.​entitlement_features.entitlement_usage.​used_units Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_charakteristik.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_charakteristik.wert Erforderlich, wenn der Parameter input_type, der in dem im Parameter entitlement_characteristics.characteristic angegebenen Datensatz enthalten ist, keine Auswahlmöglichkeitist.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_name Erforderlich.
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​household Wird nur übergeben, wenn die Haushalts-Plugins aktiv sind und der Parameter consumer übergeben wird.
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered
    Liste der Installationsbasiselemente, die unter der Berechtigung abgedeckt sind. Die Informationen in diesem Array werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    child_contract_lines.​entitlements.​install_base_items_covered.​added Datum, an dem das zugehörige Installationsbasiselement der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​entitlements.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered.​removed Datum, an dem das zugehörige Installationsbasiselement aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​entitlements.​product Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered Liste der verkauften Produkte, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    child_contract_lines.​entitlements.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​entitlements.​sold_products_covered.​removed Datum, an dem das zugeordnete verkaufte Produkt aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​entitlements.​sold_products_covered.​sold_product Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​start_date Erforderlich.
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​entitlements.​state Erforderlich.
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    „child_contract_lines.​entitlement_features“ Liste der Merkmale, die der Berechtigung zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    child_contract_lines.​entitlement_features.​Merkmal
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​feature_option Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​entitlement_usage Verwendeter Einheitenwert für das zugeordnete Berechtigungsmerkmal. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Übergeben Sie diesen Parameter nur, wenn sich die Berechtigungsmerkmale unter der Berechtigung befinden.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    child_contract_lines.​entitlement_features.​entitlement_usage.​used_units Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​value
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered
    Liste der Installationsbasiselemente, die unter der Berechtigung abgedeckt sind. Die Informationen in diesem Array werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    child_contract_lines.​install_base_items_covered.​added Datum, an dem das zugehörige Installationsbasiselement der untergeordneten Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der untergeordneten Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered.​removed Datum, an dem die Abdeckung des Installationsbasiselements durch die zugeordnete untergeordnete Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​name Name der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    child_contract_lines.​parent_contract_line Sys_id des übergeordneten Vertragspositionsdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist.

    Datentyp: Zeichenfolge

    „child_contract_lines.​product_model“ Sys_id des Produkts, das der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    child_contract_lines.​product_offering Sys_id des Produktangebotdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    „child_contract_lines.​sold_product“ Sys_id des Datensatzes des verkauften Produkts, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    „child_contract_lines.​sold_products_covered“ Liste der Produkte, die von der untergeordneten Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    child_contract_lines.​sold_products_covered.​added Datum, an dem die Abdeckung des zugehörigen Produkts durch die untergeordnete Servicevertragsposition beginnt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    child_contract_lines.​sold_products_covered.​removed Datum, an dem die Abdeckung des zugeordneten Produkts durch die zugeordnete untergeordnete Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    child_contract_lines.​sold_products_covered.​sold_product Sys_id eines Produkts, das der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​starts Startdatum der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    child_contract_lines.​state
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    contract
    Sys_id des Servicevertrags, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Servicevertrag“ [sn_pss_core_service_contract].

    Datentyp: Zeichenfolge

    endet Datum, an dem die Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    Berechtigungen Liste der Berechtigungen, die mit der Servicevertragsposition verknüpft werden sollen. Diese Berechtigungen werden in die Tabelle „Berechtigung“ [service_entitlement] eingefügt.

    Datentyp: Array von Objekten

    "entitlements:" [
      {
        "account": "String",
        "consumer": "String",
        "end_date": "String",
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "household": "String",
        "install_base_items_covered": [Array],
        "product": "String",
        "product_offering": "String",
        "sold_entitlement": "String",
        "sold_products_covered": [Array],
        "start_date": "String",
        "state": "String"
      }
    ]
    Berechtigungen.​Account Erforderlich, wenn der Parameter consumer nicht übergeben wird.
    Sys_id des Account-Datensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Account“ [customer_account].

    Datentyp: Zeichenfolge

    Berechtigungen.​Verbraucher Erforderlich, wenn der Parameter account nicht übergeben wird.
    Sys_id des Verbraucherdatensatzes, zu dem die Berechtigung gehört. Befindet sich in der Tabelle „Verbraucher“ [csm_consumer].

    Datentyp: Zeichenfolge

    entitlements.​end_date Enddatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Endet nie, bis sie manuell entfernt werden.

    Berechtigungen. entitlement_features Liste der Merkmale, die der Berechtigung zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    Berechtigungen. entitlement_features.feature Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    Berechtigungen Sys_id des Merkmalsoptionsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.entitlement_usage Verwendeter Einheitenwert für das zugeordnete Berechtigungsmerkmal. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Übergeben Sie diesen Parameter nur, wenn sich die Berechtigungsmerkmale unter der Berechtigung befinden.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    Berechtigungen Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.type Typ des Berechtigungsmerkmals.
    Gültige Werte:
    • Abdeckung
    • „Abdeckung_und_Nutzung“

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.value Erforderlich, wenn der Parameter input_type, der in dem im Parameter entitlement_characteristics.characteristic angegebenen Datensatz enthalten ist, keine Auswahlmöglichkeitist.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    Berechtigungen. entitlement_name Erforderlich.
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    Berechtigungen.​Haushalt Wird nur übergeben, wenn die Haushalts-Plugins aktiv sind und der Parameter consumer übergeben wird.
    Sys_id des Haushaltsdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Haushalt“ [csm_household].

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered
    Liste der Installationsbasiselemente, die unter der Berechtigung abgedeckt sind. Die Informationen in diesem Array werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    entitlements.​install_base_items_covered.​added Datum, an dem das zugehörige Installationsbasiselement der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    Berechtigungen.​install_base_items_covered.​entfernt Datum, an dem das zugehörige Installationsbasiselement aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    Berechtigungen.​Produkt Sys_id des Produktmodelldatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    entitlements.​product_offering Sys_id des Produktangebotdatensatzes, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    Berechtigungen.​sold_entitlement Sys_id des Datensatzes des verkauften Produkts, der der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered Liste der verkauften Produkte, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]
    entitlements.​sold_products_covered.​added Datum, an dem das zugehörige verkaufte Produkt der Berechtigung hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    entitlements.​sold_products_covered.​removed Datum, an dem das zugeordnete verkaufte Produkt aus der Berechtigung entfernt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    entitlements.​sold_products_covered.​sold_product Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    Berechtigungen.​start_date Erforderlich.
    Startdatum der Berechtigung.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Berechtigungen.​Status Erforderlich.
    Aktueller Status der Berechtigung.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale Liste der Merkmale, die der Servicevertragsposition zugeordnet sind. Die Daten in diesem Array werden in die Tabelle „Merkmal“ [sn_pss_core_entitlement_characterific] eingefügt.

    Datentyp: Array von Objekten

    "entitlement_characteristics" [
      {
        "characteristic": "String",
        "characteristic_option": "String",
        "entitlement_usage": {Object},
        "type": "String",
        "value": "String"
      }
    ]
    Berechtigungsmerkmale.​Merkmal Erforderlich.
    Sys_id des Merkmaldatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_prd_pm_charakteristik].

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.​Merkmale_Option Erforderlich, wenn der Parameter input_type, der in dem im Parameter entitlement_characteristics.characteristic angegebenen Datensatz enthalten ist, auf Auswahlfestgelegt ist.
    Sys_id des Merkmaloptionsdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmaloption“ [sn_prd_pm_characterist_option].

    Datentyp: Zeichenfolge

    Berechtigung_Merkmale.Berechtigung_Verwendung Verwendeter Einheitenwert für das zugeordnete Merkmal der Servicevertragsposition. Diese Daten werden in die Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage] eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "used_units": "String"
    }
    Berechtigung_Merkmale.​Berechtigung_Nutzung.​Verwendete_Einheiten Verwendung des zugeordneten Berechtigungsmerkmals.

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale Typ Typ des Merkmals der Servicevertragsposition.
    Gültige Werte:
    • Abdeckung
    • Abdeckung _and_usage (Abdeckung _and_usage)

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale.​Wert Erforderlich, wenn der Parameter entitlement_characteristics.type nicht übergeben wird.
    Wert des Merkmals.

    Datentyp: Zeichenfolge

    install_base_items_covered Erforderlich, wenn der Parameter sold_products_covered nicht übergeben wird.
    Liste der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden. Die Daten in diesem Parameter werden in die Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] eingefügt.

    Datentyp: Array von Objekten

     "install_base_items_covered": [ 
      {
        "added": "String",
        "install_base": "String",
        "removed": "String"
      }
    ]
    install_base_items_covered.​hinzugefügt
    Datum, an dem das zugehörige Installationsbasiselement der Servicevertragsposition hinzugefügt wurde.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    install_base_items_covered.​install_base Sys_id des Installationsbasiselements, das von der Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Installationsbasiselement“ [sn_install_base_item].

    Datentyp: Zeichenfolge

    install_base_items_covered.​entfernt
    Datum, an dem die zugehörige Servicevertragsposition die Abdeckung des Installationsbasiselements beendet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    name Erforderlich.
    Name der Servicevertragsposition.

    Datentyp: Zeichenfolge

    parent_contract_line Sys_id der Servicevertragsposition, der die aktuelle Servicevertragsposition untergeordnet ist.

    NULL für die Vertragspositionen, die unter einem Vertrag erstellt wurden.

    Datentyp: Zeichenfolge

    product_model Sys_id des Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktmodell“ [cmdb_model].

    Datentyp: Zeichenfolge

    product_offering Sys_id des Produktangebotdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].

    Datentyp: Zeichenfolge

    „sold_product“ Sys_id des Datensatzes des verkauften Produkts, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Verkaufte Produkte“ [sn_install_base_sold_product].

    Datentyp: Zeichenfolge

    „sold_products_covered“ Erforderlich, wenn der Parameter install_base_items_covered nicht übergeben wird.
    Liste der Produkte, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "added": "String",
        "removed": "String",
        "sold_product": "String"
      }
    ]

    Daten werden in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product] gespeichert.

    „sold_products_covered.​added“. Datum, ab dem die zugehörige Servicevertragsposition das zugehörige Produkt abdeckt.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Aktuelles Datum

    „sold_products_covered“ wurde entfernt Datum, an dem die Abdeckung des zugehörigen Produkts durch die zugehörige Servicevertragsposition endet.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Standard: Kein Enddatum

    „sold_products_covered“.​sold_product
    Sys_id eines Produkts, das der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    beginnt Erforderlich.
    Startdatum der Servicevertragsposition.

    Datentyp: Zeichenfolge

    Format: jjjj-mm-tt

    Staat Erforderlich.
    Aktueller Status der Vertragsposition.
    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • aktiv
    • Abgebrochen
    • Entwurf
    • abgelaufen
    • ausgesetzt

    Datentyp: Zeichenfolge

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 22. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Content-Type Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Tabelle : 23. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.

    Tabelle : 24. Statuscodes
    Statuscode Beschreibung
    201 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet, und die Datensätze wurden erstellt.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    403 Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der Servicevertragsposition erstellt wurden.

    Datentyp: Array von Objekten

    "child_contract_lines": [
      {
        "child_contract_lines": [Array],
        "entitlements": [Array],
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "name": "String",
        "sold_products_covered": [Array],
        "sys_id" "String"
      }
    ]
    child_contract_lines.​child_contract_lines Liste der untergeordneten Servicevertragspositionsobjekte, die unter der untergeordneten Servicevertragsposition erstellt wurden. Die Objekte in diesem Array haben die gleichen Elemente wie der Parameter child_contract_lines.

    Datentyp: Array von Objekten

    „child_contract_lines.​Berechtigungen“ Liste der Berechtigungen, die der untergeordneten Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "entitlement_name": "String",
        "entitlement_characteristics": [Array],
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    child_contract_lines.​entitlements.​entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​entitlement_features Liste der Berechtigungsmerkmalobjekte, die unter der Berechtigung erstellt wurden.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.​entitlements.​entitlement_features.​sys_id Sys_id eines Berechtigungsmerkmals-Datensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.​entitlements.​install_base_items_covered.​sys_id Sys_id eines Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sold_products_covered Liste der sys_ids der von der Berechtigung abgedeckten Produkte.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.​entitlements.​sold_products_covered.​sys_id Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlements.​sys_id Sys_id des Berechtigungsdatensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    „child_contract_lines.​entitlement_features“ Liste der Merkmale, die der Vertragsposition „Chile“ zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlement_characteristics": [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    child_contract_lines.​entitlement_features.​entitlement_usage Berechtigungsnutzungsobjekt unter „entitlement_charakter“ eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "sys_id": "String"
    }
    child_contract_lines.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    child_contract_lines.​entitlement_features.​sys_id Sys_id eines Berechtigungsmerkmals-Datensatzes, der der untergeordneten Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Merkmal“ [sn_pss_core_entitlement_charakteristik].

    Datentyp: Zeichenfolge

    child_contract_lines.​install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die von der untergeordneten Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.​install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​name Name der untergeordneten Servicevertragsposition.

    Datentyp: Zeichenfolge

    „child_contract_lines.​sold_products_covered“ Liste der sys_ids der Produkte, die von der untergeordneten Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    child_contract_lines.​sold_products_covered.​sys_id Sys_id eines Produkts, das von der untergeordneten Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    child_contract_lines.​sys_id Sys_id eines Produkts, das vom untergeordneten Vertragselement abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    Berechtigungen Liste der Berechtigungen, die der Servicevertragsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "entitlements": [
      {
        "entitlement_characteristics": [Array],
        "entitlement_name": "String",
        "install_base_items_covered": [Array],
        "sold_products_covered": [Array],
        "sys_id": "String"
      }
    ]
    Berechtigungen. entitlement_features Liste der Berechtigungsmerkmalobjekte, die unter der Berechtigung erstellt wurden.

    Datentyp: Array von Objekten

    "entitlement_characteristics" [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    entitlements.​entitlement_features.​entitlement_usage Berechtigungsnutzungsobjekt unter „entitlement_charakter“ eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "sys_id": "String"
    }
    entitlements.​entitlement_features.​entitlement_usage.​sys_id Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    entitlements.​entitlement_features.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    Berechtigungen. entitlement_name
    Name der Berechtigung.

    Datentyp: Zeichenfolge

    entitlements.​install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die unter der Berechtigung enthalten sind.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    entitlements.​install_base_items_covered.​sys_id Sys_id eines Installationsbasiselements, das von der Berechtigung abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    entitlements.​sold_products_covered Liste der sys_ids der von der Berechtigung abgedeckten Produkte.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    entitlements.​sold_products_covered.​sys_id Sys_id eines Produkts, das der Berechtigung zugeordnet ist. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    Berechtigungen.​sys_id Sys_id des Berechtigungsdatensatzes, der der Servicevertragsposition zugeordnet ist. Befindet sich in der Tabelle „Berechtigung“ [service_entitlement].

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale Liste der Berechtigungsmerkmalsobjekte, die unter der Servicevertragsposition erstellt wurden.

    Datentyp: Array von Objekten

    "entitlement_characteristics" [
      {
        "entitlement_usage": {Object},
        "sys_id": "String"
      }
    ]
    Berechtigung_Merkmale.Berechtigung_Verwendung Berechtigungsnutzungsobjekt unter „entitlement_charakter“ eingefügt.

    Datentyp: Objekt

    "entitlement_usage": {
        "sys_id": "String"
    }
    Berechtigung_Merkmale.​Berechtigung_Verwendung.​Sys_ID Sys_id des Berechtigungsnutzungsdatensatzes. Befindet sich in der Tabelle „Berechtigungsnutzung“ [sn_pss_core_entitlement_usage].

    Datentyp: Zeichenfolge

    Berechtigungsmerkmale.​sys_id Sys_id des Datensatzes mit Berechtigungsmerkmalen.

    Datentyp: Zeichenfolge

    install_base_items_covered Liste der sys_ids der Installationsbasiselemente, die von der Servicevertragsposition abgedeckt werden.

    Datentyp: Array von Objekten

    "install_base_items_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    install_base_items_covered.​sys_id Sys_id des abgedeckten Installationsbasiselements. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    name
    Name der Servicevertragsposition.

    Datentyp: Zeichenfolge

    „sold_products_covered“ Liste der sys_ids der von der Servicevertragsposition abgedeckten Produkte.

    Datentyp: Array von Objekten

    "sold_products_covered": [ 
      {
        "sys_id": "String"
      }
    ]
    „sold_products_covered.​sys_id“ Sys_id eines Produkts, das von der Servicevertragsposition abgedeckt wird. Befindet sich in der Tabelle „Abgedeckte verkaufte Produkte“ [sn_install_base_m2m_contract_sold_product].

    Datentyp: Zeichenfolge

    sys_id Sys_id eines Servicevertrags-Positionsdatensatzes. Befindet sich in der Tabelle „Servicevertragsposition“ [sn_pss_core_service_contract_line].

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Im Folgenden finden Sie ein Codebeispiel, das zeigt, wie dieser Endpunkt aufgerufen und ein Datensatz für eine Servicevertragsposition erstellt wird.

    curl "https://instance.servicenow.com/api/sn_pss_core/servicecontract/contractline" \
    --request POST \
    --header "Accept:application/json" \
    --data
    {
      "state": "active",
      "contract": "a4b415d1d1f53110f8776589fa411f20",
      "parent_contract_line": null,
      "name": "CLI",
      "starts": "2022-12-03",
      "child_contract_lines": [
        {
          "state": "active",
          "name": "Child CLI",
          "starts": "2022-12-03",
          "entitlements": [
            {
              "state": "active",
              "entitlement_name": "Child CLI - ENTL",
              "start_date": "2022-12-03"
            }
          ],
          "sold_products_covered": [
            {
              "sold_product": "8db4258949f14ef7b90d90822dfc5800",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "install_base_items_covered": [
            {
              "install_base": "2f270832699b46e78aa899a5a5dc6682",
              "added": "2023-12-03",
              "removed": "2023-12-03"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage"
            }
          ]
        }
      ],
      "entitlements": [
        {
          "state": "active",
          "entitlement_name": "ENTL 1",
          "start_date": "2022-12-03",
          "sold_products_covered": [
            {
              "sold_product": "ec235d9dd1b53110f8776589fa411fe2"
            }
          ],
          "entitlement_characteristics": [
            {
              "characteristic": "63418db7539e61106bfcddeeff7b1238",
              "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
              "value": "20",
              "type": "coverage_and_usage",
              "entitlement_usage": {
                "used_units": "3"
              }
            }
          ]
        }
      ],
      "sold_products_covered": [
        {
          "sold_product": "0df21151d1f53110f8776589fa411f1b",
          "added": "2023-12-03",
          "removed": "2023-12-03"
        }
      ],
      "entitlement_characteristics": [
        {
          "characteristic": "63418db7539e61106bfcddeeff7b1238",
          "characteristic_option": "495149b7539e61106bfcddeeff7b1262",
          "value": "tyfy6h",
          "type": "coverage"
        }
      ]
    }

    Antwort:

    {
      "result": {
        "sys_id": "16e451d1d1f53110f8776589fa411f80",
        "name": "CLI",
        "child_contract_lines": [
          {
            "sys_id": "3a39ecdc01154f4ab782da0169c9c922",
            "name": "Child CLI",
            "child_contract_lines": [],
            "entitlements": [
              {
                "sys_id": "7439fd84c2494ba6951e58f333cfe8d4",
                "entitlement_name": "Child CLI - ENTL",
                "sold_products_covered": [],
                "install_base_items_covered": [],
                "entitlement_characteristics": []
              }
            ],
            "sold_products_covered": [
              {
                "sys_id": "dfb62e9c4c6843009be02a68f65b9118"
              }
            ],
            "install_base_items_covered": [
              {
                "sys_id": "2583912e81964501b52a2e44d4797a28"
              }
            ],
            "entitlement_characteristics": [
              {
                "sys_id": "3a00c975bb49412cae169200c7f6236e",
                "entitlement_usage": {}
              }
            ]
          }
        ],
        "entitlements": [
          {
            "sys_id": "9ee451d1d1f53110f8776589fa411f83",
            "entitlement_name": "ENTL 1",
            "sold_products_covered": [
              {
                "sys_id": "92e451d1d1f53110f8776589fa411f85"
              }
            ],
            "install_base_items_covered": [],
            "entitlement_characteristics": [
              {
                "sys_id": "92e451d1d1f53110f8776589fa411f86",
                "entitlement_usage": {
                  "sys_id": "dee451d1d1f53110f8776589fa411f86"
                }
              }
            ]
          }
        ],
        "sold_products_covered": [
          {
            "sys_id": "5ae451d1d1f53110f8776589fa411f81"
          }
        ],
        "install_base_items_covered": [],
        "entitlement_characteristics": [
          {
            "sys_id": "dae451d1d1f53110f8776589fa411f82",
            "entitlement_usage": {}
          }
        ]
      }
    }