Product Inventory Open API

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 26 Minuten Lesedauer

    • Die Product Inventory Open API bietet Endpunkte zum Erstellen und Abrufen von Produktbeständen.

    Verwenden Sie diese API, um Produktbestandsinformationen zwischen externen Systemen und Now Platformzu verwalten.

    Diese API ist in der Anwendung Product Inventory Advanced enthalten, die unter ServiceNow Storeverfügbar ist.

    Diese API wird im Namespace sn_prd_invt bereitgestellt.

    Der anrufende Benutzer muss über die Rolle sn_prd_invt.product_inventory_integrator verfügen.

    Diese API erstellt und aktualisiert Daten in den folgenden Tabellen.
    • Produktmerkmale [sn_prd_invt_product_features]
    • Produktbestand [sn_prd_invt_product_inventory]
    • Produktmodell [cmdb_model]
    • Produktmodellmerkmal [sn_prd_pm_product_model_charakteristik]

    Die Product Inventory Open API ist eine ServiceNow® -Implementierung der REST-Spezifikation der TM Forum Product Inventory Management API. Diese Implementierung basiert auf der REST-Spezifikation TMF637 Product Inventory Management API Release 19, August 2019. Die Product Inventory Open API besitzt eine Konformitätszertifizierung durch das TM Forum.

    TMF-Konformitätslogo

    Product Inventory Open API – GET /sn_prd_invt/product

    Ruft eine Liste aller Produktbestände ab.

    URL-Format

    Standard-URL: api/sn_prd_invt/product

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    Keine
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    Kunde Produktbestände nach Kunden filtern. In der Antwort werden nur Produktangebote mit einer Kunden-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Kunden filtern.
    Felder Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Gibt alle Felder zurück.
    limit Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter offset, um den Datensatzabruf zu paginieren.

    Datentyp: Zahl

    Standard: 20

    Maximum: 100
    Offset Startindex, ab dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze.

    Datentyp: Zahl

    Standard: 0
    Ort Filtern Sie Produktbestände nach Ort. In der Antwort werden nur Produktangebote mit einer sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Ort filtern.
    status Produktbestände nach Status filtern. In der Antwort werden nur Produktbestände zurückgegeben, deren Status dem Wert dieses Parameters entspricht.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Status filtern.
    Tabelle : 3. Parameter des Anforderungstexts (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
    Keine
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Inhaltsbereich Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird.

    Beispiel: Wenn Offset=2 und Limit=3, ist der Wert des Content-Range -Headers Elemente 3-5.
    Inhaltstyp Datenformat des Antworttexts. Unterstützt nur application/json.
    Verknüpfung Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse.
    • zuerst
    • letzte
    • Weiter
    • vorheriger
    X-Gesamtzahl Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an.

    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-Antwortcodes der REST-API.

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Anforderung erfolgreich verarbeitet. Vollständige Ressource, die als Antwort zurückgegeben wird (keine Paginierung).
    206 Teilressource, die als Antwort zurückgegeben wird (mit Paginierung).
    400
    Ungültige Anforderung. Mögliche Gründe:
    • Ungültiger Pfadparameter
    • Ungültiger URI
    404 Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen.

    Parameter des Antwort-Haupttexts (JSON)

    Name Beschreibung
    href Relativer Link zum Produktbestandsdatensatz.

    Datentyp: Zeichenfolge
    id Sys_id des Produktbestands.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    name Name des Produktbestands.

    Datentyp: Zeichenfolge
    Ort Ort, der dem Produkt zugeordnet ist.

    Datentyp: Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array von Objekten

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristic.name Name des Merkmals.

    Datentyp: Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge
    productOffering Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
   "id": "String",
   "internalId": "String",
   "internalVersion": "String",
   "name": "String",
   "version": "String"
}
    productOffering.id Anfangsversion oder externe ID des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld initial_version oder external_id der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    productOffering.internalId Anfangsversion des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld „internal_version“ des Produktangebots [sn_prd_pm_product_offering]
    Produktangebot.interneVersion Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    productOffering.name Name des Produktangebots

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    Produktangebot.Version Externe Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktangebot“ [sn_prd_pm_product_offering]
    ProduktPreis Gibt ein leeres Array zurück.

    Datentyp: Array
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Beziehungstyp.

    Datentyp: Zeichenfolge
    Produktspezifikation Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "version": "String"
}
    productSpecification.id Anfangsversion oder externe ID der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld „internal_version“ oder „external_id“ der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.interneID Anfangsversion der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld initial_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.interneVersion Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.Version Externe Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    realisierendeRessource Ressource, die das Produkt realisiert. Die implementierende Ressource ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    realizationService Service, der das Produkt realisiert. Der implementierende Service ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realizingService.id Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    relatedParty.id Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • Kundenkontakt

    Datentyp: Zeichenfolge
    state Aktueller Status des Produkts.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    In diesem Beispiel werden alle Produktbestände abgerufen.

    curl --location --request GET "https://instance.service-now.com/api/sn_prd_invt/product" \
--user 'username':'password'

    Antworttext.

    [
   {
      "id": "037fd87ec3603010abc8b5183c40ddf2",
      "relatedParty": [
         {
            "id": "ffc68911c35420105252716b7d40dd55",
            "name": "Example Company",
            "@type": "RelatedParty",
            "@referredType": "Customer"
         },
         {
            "id": "eaf68911c35420105252716b7d40ddde",
            "name": "Sally Thomas",
            "@type": "RelatedParty",
            "@referredType": "CustomerContact"
         }
      ],
      "name": "Routing and Configuration PI0000318",
      "productSpecification": {
         "id": "aec57e981bb420106ba59acf034bcb08",
         "name": "Routing and Configuration",
         "version": "",
         "internalVersion": "1",
         "internalId": "aec57e981bb420106ba59acf034bcb08"
      },
      "status": "Active",
      "productOffering": {
         "id": "69017a0f536520103b6bddeeff7b127d",
         "name": "Premium SD-WAN Offering",
         "version": "",
         "internalVersion": "1",
         "internalId": "69017a0f536520103b6bddeeff7b127d"
      },
      "product": "ce0b52c7532520103b6bddeeff7b12f5",
      "place": {
         "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
         "name": "100 South Charles Street, Baltimore,MD"
      },
      "productCharacteristic": [],
      "productRelationship": [],
      "realizingService": [],
      "realizingResource": [
         {
            "id": "9b2fa60b536520103b6bddeeff7b1233",
            "name": "Route Target"
         }
      ],
      "productPrice": [],
      "href": "/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2",
      "billingAccount": "Not Specified."
   }
]

    Product Inventory Open API – GET /sn_prd_invt/product/{id}

    Ruft einen angegebenen Produktbestandsdatensatz ab.

    URL-Format

    Standard-URL: /api/sn_prd_invt/product/{id}

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    id Sys_id des abzurufenden Produktbestands.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    Kunde Produktbestände nach Kunden filtern. In der Antwort werden nur Produktangebote mit einer Kunden-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge

    Standard: „J-Kunde nicht hinterlegen“.
    Felder Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle zurückgegebenen Felder.
    Ort Filtern Sie Produktbestände nach Ort. In der Antwort werden nur Produktangebote mit einer Orts-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Ort filtern.
    status Produktbestände nach Status filtern. In der Antwort werden nur Produktbestände zurückgegeben, deren Status dem Wert dieses Parameters entspricht.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Status filtern.
    Tabelle : 9. Parameter des Anforderungstexts (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
    Keine
    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Antworttexts. Unterstützt nur application/json.

    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-Antwortcodes der REST-API.

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    200 Anforderung erfolgreich verarbeitet.
    400
    Ungültige Anforderung. Kann einer der folgenden Gründe sein:
    • Ungültiger Pfadparameter
    • Ungültiger URI
    404 Datensatz nicht gefunden Der der ID zugeordnete Datensatz wurde in der Tabelle nicht gefunden.

    Parameter des Antwort-Haupttexts (JSON)

    Name Beschreibung
    href Relativer Link zum Produktbestandsdatensatz.

    Datentyp: Zeichenfolge
    id Sys_id des Produktbestands

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    name Name des Produktbestands.

    Datentyp: Zeichenfolge
    Ort Ort, der dem Produkt zugeordnet ist.

    Datentyp: Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array von Objekten

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristic.name Name des Merkmals.

    Datentyp: Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge
    productOffering Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
   "id": "String",
   "internalId": "String",
   "internalVersion": "String",
   "name": "String",
   "version": "String"
}
    productOffering.id Anfangsversion oder externe ID des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld initial_version oder external_id der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    productOffering.internalId Anfangsversion des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld „internal_version“ des Produktangebots [sn_prd_pm_product_offering]
    Produktangebot.interneVersion Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    productOffering.name Name des Produktangebots

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    Produktangebot.Version Externe Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktangebot“ [sn_prd_pm_product_offering]
    ProduktPreis Gibt ein leeres Array zurück.

    Datentyp: Array
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Datentyp: Zeichenfolge
    Produktspezifikation Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "version": "String"
}
    productSpecification.id Anfangsversion oder externe ID der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld „internal_version“ oder „external_id“ der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.interneID Anfangsversion der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld initial_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.interneVersion Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.Version Externe Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    realisierendeRessource Ressource, die das Produkt realisiert. Die implementierende Ressource ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    realizationService Service, der das Produkt realisiert. Der implementierende Service ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realizingService.id Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    relatedParty.id Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden

    Datentyp: Zeichenfolge
    state Aktueller Status des Produkts.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    In diesem Beispiel wird ein angegebener Produktbestand abgerufen.

    curl -X GET 'https://instance.service-now.com/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2' \
--user 'username':'password'

    Ausgabe:

    {
   "id": "037fd87ec3603010abc8b5183c40ddf2",
   "relatedParty": [
      {
         "id": "ffc68911c35420105252716b7d40dd55",
         "name": "Example Company",
         "@type": "RelatedParty",
         "@referredType": "Customer"
      },
      {
         "id": "eaf68911c35420105252716b7d40ddde",
         "name": "Sally Thomas",
         "@type": "RelatedParty",
         "@referredType": "CustomerContact"
      }
   ],
   "name": "Routing and Configuration PI0000318",
   "productSpecification": {
      "id": "aec57e981bb420106ba59acf034bcb08",
      "name": "Routing and Configuration",
      "version": "",
      "internalVersion": "1",
      "internalId": "aec57e981bb420106ba59acf034bcb08"
   },
   "status": "Active",
   "productOffering": {
      "id": "69017a0f536520103b6bddeeff7b127d",
      "name": "Premium SD-WAN Offering",
      "version": "",
      "internalVersion": "1",
      "internalId": "69017a0f536520103b6bddeeff7b127d"
   },
   "product": "ce0b52c7532520103b6bddeeff7b12f5",
   "place": {
      "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
      "name": "100 South Charles Street, Baltimore,MD"
   },
   "productCharacteristic": [],
   "productRelationship": [],
   "realizingService": [],
   "realizingResource": [
      {
         "id": "9b2fa60b536520103b6bddeeff7b1233",
         "name": "Route Target"
      }
   ],
   "productPrice": [],
   "href": "/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2",
   "billingAccount": "Not Specified."
}

    Product Inventory Open API – GET /sn_prd_invt/productinventory

    Ruft eine Liste aller Produktbestände ab.

    Wichtig:
    Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist Product Inventory Open API – GET /sn_prd_invt/product.

    URL-Format

    Standard-URL: api/sn_prd_invt/productinventory

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    Name Beschreibung
    Keine
    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Kunde Produktbestände nach Kunden filtern. In der Antwort werden nur Produktangebote mit einer Kunden-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Kunden filtern.
    Felder Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Es werden alle Felder zurückgegeben.
    limit Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter offset, um den Datensatzabruf zu paginieren.

    Datentyp: Zahl

    Standard: 20

    Maximum: 100
    Offset Startindex, ab dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze.

    Datentyp: Zahl

    Standard: 0
    Ort Filtern Sie Produktbestände nach Ort. In der Antwort werden nur Produktangebote mit einer Orts-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Ort filtern.
    status Produktbestände nach Status filtern. In der Antwort werden nur Produktbestände zurückgegeben, deren Status dem Wert dieses Parameters entspricht.

    Datentyp: Zeichenfolge

    Standard: Nicht nach Bestandsstatus filtern.
    Tabelle : 15. Parameter des Anforderungstexts (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 : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Keine
    Tabelle : 17. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Inhaltsbereich Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird.

    Beispiel: Wenn Offset=2 und Limit=3, ist der Wert des Content-Range -Headers Elemente 3-5.
    Inhaltstyp Datenformat des Antworttexts. Unterstützt nur application/json.
    Verknüpfung Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse.
    • zuerst
    • letzte
    • Weiter
    • vorheriger
    X-Gesamtzahl Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an.

    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-Antwortcodes der REST-API.

    Tabelle : 18. Statuscodes
    Statuscode Beschreibung
    200 Anforderung erfolgreich verarbeitet. Vollständige Ressource, die als Antwort zurückgegeben wird (keine Paginierung).
    206 Teilressource, die als Antwort zurückgegeben wird (mit Paginierung).
    400
    Ungültige Anforderung. Mögliche Gründe:
    • Ungültiger Pfadparameter
    • Ungültiger URI
    404 Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen.

    Parameter des Antwort-Haupttexts (JSON)

    Name Beschreibung
    id Sys_id des Produktbestands.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    name Name des Produktbestands.

    Datentyp: Zeichenfolge
    Ort Ort, der dem Produkt zugeordnet ist.

    Datentyp: Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array von Objekten

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristic.name Name des Merkmals.

    Datentyp: Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge
    productOffering Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
  "id": "String",
  "name": "String"
}
    productOffering.id Sys_id des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productOffering.name Name des Produktangebots

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Datentyp: Zeichenfolge
    Produktspezifikation Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String"
}
    productSpecification.id Sys_id der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Produktspezifikation [sn_prd_pm_product_specification]
    realisierendeRessource Ressource wird realisiert.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Datentyp: Zeichenfolge
    realizationService Service umsetzen.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realizingService.id Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    relatedParty.id Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • CustomerContact

    Datentyp: Zeichenfolge
    state Aktueller Status des Produkts.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    In diesem Beispiel werden alle Produktbestände abgerufen.

    curl "https://instance.servicenow.com/api/sn_prd_invt/productinventory" \
--request GET \
--user 'username':'password'

    Antworttext.

    [
   {
      "id": "075072aec3a83010abc8b5183c40dd44",
      "relatedParty": [
         {
            "id": "ffc68911c35420105252716b7d40dd55",
            "name": "Funco Intl",
            "@type": "RelatedParty",
            "@referredType": "Customer"
         },
         {
            "id": "eaf68911c35420105252716b7d40ddde",
            "name": "Sally Thomas",
            "@type": "RelatedParty",
            "@referredType": "CustomerContact"
         }
      ],
      "name": "Firewall Administration PI0000300",
      "productSpecification": {
         "id": "31c5caff07266010a7955b7e0ad3006b",
         "name": "Firewall Administration"
      },
      "status": "Active",
      "productOffering": {
         "id": "",
         "name": ""
      },
      "place": {
         "id": "920cf6ac73d423002728660c4cf6a799",
         "name": "200 South James street,Atlanta, GA"
      },
      "productCharacteristic": [
         {
            "name": "Firewall Administration CPE Type",
            "valueType": "Choice",
            "value": "Physical"
         },
         {
            "name": "Configuration and Policy backup",
            "valueType": "Choice",
            "value": ""
         },
         {
            "name": "Firewall Administration CPE ID",
            "valueType": "Single Line Text",
            "value": "CPE123456789"
         },
         {
            "name": "Remote CLI troubleshoot support",
            "valueType": "Choice",
            "value": ""
         },
         {
            "name": "Firewall Administration CPE Model",
            "valueType": "Choice",
            "value": "9300 series"
         }
      ],
      "productRelationship": [],
      "realizingService": [],
      "realizingResource": [
         {
            "id": "3546463307666010a7955b7e0ad3005d",
            "name": "Cisco Firewall Management system"
         }
      ]
   },
   {
      "id": "0303a8ea74418510f877ca57242ff96d",
      "relatedParty": [
         {
            "id": "ffc68911c35420105252716b7d40dd55",
            "name": "Funco Intl",
            "@type": "RelatedParty",
            "@referredType": "Customer"
         },
         {
            "id": "eaf68911c35420105252716b7d40ddde",
            "name": "Sally Thomas",
            "@type": "RelatedParty",
            "@referredType": "CustomerContact"
         }
      ],
      "name": "SD-WAN Edge Device PI0001114",
      "productSpecification": {
         "id": "39b627aa53702010cd6dddeeff7b1202",
         "name": "SD-WAN Edge Device"
      },
      "status": "Installation Pending",
      "productOffering": {
         "id": "69017a0f536520103b6bddeeff7b127d",
         "name": "Premium SD-WAN Offering"
      },
      "place": "",
      "productCharacteristic": [],
      "productRelationship": [],
      "realizingService": [
         {
            "id": "bf65eadc1b7420106ba59acf034bcb57",
            "name": "SD-WAN Routing"
         },
         {
            "id": "16d79ec3532520103b6bddeeff7b12a6",
            "name": "SD WAN Optimization Service"
         },
         {
            "id": "16d79ec3532520103b6bddeeff7b12a6",
            "name": "SD WAN Optimization Service"
         },
         {
            "id": "bf65eadc1b7420106ba59acf034bcb57",
            "name": "SD-WAN Routing"
         },
         {
            "id": "bf65eadc1b7420106ba59acf034bcb57",
            "name": "SD-WAN Routing"
         },
         {
            "id": "bf65eadc1b7420106ba59acf034bcb57",
            "name": "SD-WAN Routing"
         }
      ],
      "realizingResource": [
         {
            "id": "493fa60b536520103b6bddeeff7b12b6",
            "name": "Customer Premise SD-WAN Router"
         }
      ]
   }
]

    Product Inventory Open API – GET /sn_prd_invt/productinventory/{inventoryId}

    Ruft einen Produktbestand ab.

    Wichtig:
    Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist Product Inventory Open API – GET /sn_prd_invt/product/{id}.

    URL-Format

    Standard-URL: /api/sn_prd_invt/productinventory/{inventoryId}

    Unterstützte Anforderungsparameter

    Tabelle : 19. Pfadparameter
    Name Beschreibung
    inventoryId Sys_id des abzurufenden Produktbestands.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    Tabelle : 20. Abfrageparameter
    Name Beschreibung
    Kunde Produktbestände nach Kunden filtern. In der Antwort werden nur Produktangebote mit einer Kunden-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge
    Felder Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle zurückgegebenen Felder.
    Ort Filtern Sie Produktbestände nach Ort. In der Antwort werden nur Produktangebote mit einer Orts-sys_id oder einer externen ID zurückgegeben, die dem Wert dieses Parameters entsprechen.

    Datentyp: Zeichenfolge
    status Produktbestände nach Status filtern. In der Antwort werden nur Produktbestände zurückgegeben, deren Status dem Wert dieses Parameters entspricht.

    Datentyp: Zeichenfolge
    Tabelle : 21. Parameter des Anforderungstexts (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 : 22. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Keine
    Tabelle : 23. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Antworttexts. Unterstützt nur application/json.

    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-Antwortcodes der REST-API.

    Tabelle : 24. Statuscodes
    Statuscode Beschreibung
    200 Anforderung erfolgreich verarbeitet.
    400 Ungültige Anforderung. Kann einer der folgenden Gründe sein:
    • Ungültiger Pfadparameter
    • Ungültiger URI
    404 Datensatz nicht gefunden Der der ID zugeordnete Datensatz wurde in der Tabelle nicht gefunden.

    Parameter des Antwort-Haupttexts (JSON)

    Name Beschreibung
    id Sys_id des Produktbestands

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    name Name des Produktbestands.

    Datentyp: Zeichenfolge
    Ort Ort, der dem Produkt zugeordnet ist.

    Datentyp: Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array von Objekten

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristic.name Name des Merkmals.

    Datentyp: Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge
    productOffering Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
  "id": "String",
  "name": "String"
}
    productOffering.id Sys_id des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productOffering.name Name des Produktangebots

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Datentyp: Zeichenfolge
    Produktspezifikation Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String"
}
    productSpecification.id Sys_id der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Produktspezifikation [sn_prd_pm_product_specification]
    realisierendeRessource Ressource wird realisiert.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Datentyp: Zeichenfolge
    realizationService Service umsetzen.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realizingService.id Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    relatedParty.id Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • Kundenkontakt

    Datentyp: Zeichenfolge
    state Aktueller Status des Produkts.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    In diesem Beispiel wird ein Produktbestand für ein SD-WAN-Servicepaket abgerufen.

    curl --location --request GET 'https:// instance.servicenow.com/api/sn_prd_invt/productinventory/074450fc74918d10f877ca57242ff9e3' \
--user 'username':'password'

    Ausgabe:

    {
   "id": "074450fc74918d10f877ca57242ff9e3",
   "relatedParty": [
      {
         "id": "ffc68911c35420105252716b7d40dd55",
         "name": "Funco Intl",
         "@type": "RelatedParty",
         "@referredType": "Customer"
      },
      {
         "id": "eaf68911c35420105252716b7d40ddde",
         "name": "Sally Thomas",
         "@type": "RelatedParty",
         "@referredType": "CustomerContact"
      }
   ],
   "name": "SD-WAN Service Package PI0001576",
   "productSpecification": {
      "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
      "name": "SD-WAN Service Package"
   },
   "status": "Installation Pending",
   "productOffering": {
      "id": "69017a0f536520103b6bddeeff7b127d",
      "name": "Premium SD-WAN Offering"
   },
   "place": "",
   "productCharacteristic": [],
   "productRelationship": [
      {
         "id": "a74490fc74918d10f877ca57242ff942",
         "name": "SD-WAN Edge Device PI0001582",
         "relationshipType": "Bundles"
      },
      {
         "id": "b85414fc74918d10f877ca57242ff90e",
         "name": "SD-WAN Controller PI0001602",
         "relationshipType": "Bundles"
      },
      {
         "id": "d74490fc74918d10f877ca57242ff907",
         "name": "SD-WAN Security PI0001577",
         "relationshipType": "Bundles"
      }
   ],
   "realizingService": [],
   "realizingResource": []
}

    Product Inventory Open API – POST /sn_prd_invt/product

    Erstellt einen Produktbestandsdatensatz.

    URL-Format

    Standard-URL: /api/sn_prd_invt/product

    Unterstützte Anforderungsparameter

    Tabelle : 25. Pfadparameter
    Name Beschreibung
    Keine
    Tabelle : 26. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 27. Parameter des Anforderungstexts (JSON)
    Name Beschreibung
    name Erforderlich. Name des Produktbestands.

    Datentyp: Zeichenfolge
    pid Eindeutiger Bezeichner für den Produktbestand aus dem externen System.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array

    "productCharacteristic": [
   {
      "name": "String",
      "value": "String"
   }
]
    productCharacteristic.name Name des Merkmals.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    productOffering Erforderlich. Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
   "id": "String",
   "internalVersion": "String",
   "name": "String",
   "version": "String"
}
    productOffering.id Erforderlich. Initial_version oder external_id des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    Produktangebot.interneVersion Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    productOffering.name Name des Produktangebots

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    Produktangebot.Version Externe Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktangebot“ [sn_prd_pm_product_offering]
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Erforderlich, wenn der Parameter productRelationship verwendet wird. Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Der einzige gültige Wert ist untergeordnet.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Produktspezifikation Erforderlich. Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String",
  "internalVersion": "String",
  "version": "String"
}
    productSpecification.id Erforderlich. Initial_version oder external_id der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Produktspezifikation [sn_prd_pm_product_specification]
    Produktspezifikation.interneVersion Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.Version Externe Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    realisierendeRessource Ressource, die das Produkt realisiert. Die implementierende Ressource ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Erforderlich, wenn der Parameter realizingResource verwendet wird. Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge
    realizationResource.type Typ der implementierenden Ressource.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    realizationService Service, der das Produkt realisiert. Der implementierende Service ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realizingService.id Erforderlich, wenn der Parameter realizingService verwendet wird. Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge
    realizationService.type Typ des implementierenden Service.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    relatedParty.id Erforderlich, wenn der Parameter relatedParty verwendet wird. Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • Customer_contact

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    state Aktueller Status des Produkts.
    Mögliche Werte:
    • aktiv
    • change_pending
    • inactivation_pending
    • Inaktiv
    • „installation_pending“

    Datentyp: Zeichenfolge

    Standard: „installation_pending“.

    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 : 28. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 29. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Antworttexts. Unterstützt nur application/json.

    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-Antwortcodes der REST-API.

    Tabelle : 30. Statuscodes
    Statuscode Beschreibung
    201 Anforderung erfolgreich verarbeitet.
    400 Ungültige Anforderung. Kann einer der folgenden Gründe sein:
    • Leere Nutzlast.
    • Ungültige Nutzlast. Pflichtfeld fehlt:<field name>

    Parameter des Antwort-Haupttexts (JSON)

    Name Beschreibung
    href Relativer Link zum Produktbestandsdatensatz.

    Datentyp: Zeichenfolge
    id Sys_id des Produktbestands.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    name Name des Produktbestands.

    Datentyp: Zeichenfolge
    pid Eindeutiger Bezeichner für den Produktbestand aus dem externen System.

    Datentyp: Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array von Objekten

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    Produktmerkmal.Name Name des Merkmals.

    Datentyp: Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge
    productOffering Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
   "id": "String",
   "internalId": "String",
   "internalVersion": "String",
   "name": "String",
   "version": "String"
}
    productOffering.id Anfangsversion oder externe ID des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld initial_version oder external_id der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    productOffering.internalId Anfangsversion des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld „internal_version“ des Produktangebots [sn_prd_pm_product_offering]
    Produktangebot.interneVersion Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktangebot“ [sn_prd_pm_product_offering].
    Produktangebot.Name Name des Produktangebots

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    Produktangebot.Version Externe Version des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktangebot“ [sn_prd_pm_product_offering]
    ProduktPreis Gibt ein leeres Array zurück.

    Datentyp: Array
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Datentyp: Zeichenfolge
    Produktspezifikation Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "version": "String"
}
    productSpecification.id Anfangsversion oder externe ID der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld „internal_version“ oder „external_id“ der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.interneID Anfangsversion der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld initial_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.interneVersion Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Versionsfeld der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    Produktspezifikation.Version Externe Version der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld external_version der Tabelle „Produktspezifikation“ [sn_prd_pm_product_specification]
    realisierendeRessource Ressource, die das Produkt realisiert. Die implementierende Ressource ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    realizationService Service, der das Produkt realisiert. Der implementierende Service ist ein untergeordneter Produktbestand dieses Produktbestands.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realizingService.id Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Gültiger Wert: untergeordnet

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    Zugehörigepartei.id Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • Kundenkontakt

    Datentyp: Zeichenfolge
    state Aktueller Status des Produkts.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    In diesem Beispiel wird ein Produktbestand für eine Voice over IP-Lösung für einen Benutzer erstellt.

    curl -X POST "https://instance.service-now.com/api/sn_prd_invt/product" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data "[
   {
      "pid": "PO-456",
      "description": "inventory description",
      "isBundle": false,
      "name": "Voice Over IP Basic instance for Jean",
      "productOffering": {
         "@referredType": "ProductOffering",
         "name": "Premium SD-WAN Offering",
         "id": "69017a0f536520103b6bddeeff7b127d"
      },
      "productCharacteristic": [],
      "productRelationship": [
         {
            "productId": "fa6d13f45b5620102dff5e92dc81c77f",
            "relationshipType": "child"
         }
      ],
      "realizingService": {
         "id": "fe6d13f45b5620102dff5e92dc81c786",
         "relationshipType": "child"
      },
      "realizingResource": {
         "id": "326d13f45b5620102dff5e92dc81c78c",
         "relationshipType": "child"
      },
      "relatedParty": [
         {
            "@referredType": "CustomerContact",
            "@type": "RelatedParty",
            "name": "Sally Thomas",
            "id": "eaf68911c35420105252716b7d40ddde"
         },
         {
            "@referredType": "Customer",
            "@type": "RelatedParty",
            "name": "Funco Intl",
            "id": "ffc68911c35420105252716b7d40dd55"
         }
      ],
      "productSpecification": {
         "@referredType": "ProductSpecification",
         "@type": null,
         "name": null,
         "id": "3ee1fdb1c3331010d216b5183c40dd81",
         "internalVersion": "1"
      },
      "bundle": false
   }
]"

    Antworttext.

    {
   "pid": "PO-456",
   "description": "inventory description",
   "isBundle": false,
   "name": "Voice Over IP Basic instance for Jean",
   "productOffering": {
      "@referredType": "ProductOffering",
      "name": "Premium SD-WAN Offering",
      "id": "69017a0f536520103b6bddeeff7b127d",
      "internalVersion": "1",
      "version": null,
      "status": "published",
      "internalId": "69017a0f536520103b6bddeeff7b127d"
   },
   "productCharacteristic": [],
   "productRelationship": [
      {
         "productId": "fa6d13f45b5620102dff5e92dc81c77f",
         "relationshipType": "child"
      }
   ],
   "realizingService": {
      "id": "fe6d13f45b5620102dff5e92dc81c786",
      "relationshipType": "child"
   },
   "realizingResource": {
      "id": "326d13f45b5620102dff5e92dc81c78c",
      "relationshipType": "child"
   },
   "relatedParty": [
      {
         "@referredType": "CustomerContact",
         "@type": "RelatedParty",
         "name": "Sally Thomas",
         "id": "eaf68911c35420105252716b7d40ddde"
      },
      {
         "@referredType": "Customer",
         "@type": "RelatedParty",
         "name": "Example Company",
         "id": "ffc68911c35420105252716b7d40dd55"
      }
   ],
   "productSpecification": {
      "@referredType": "ProductSpecification",
      "@type": null,
      "name": null,
      "id": "3ee1fdb1c3331010d216b5183c40dd81",
      "internalVersion": "1",
      "version": null,
      "status": "published",
      "internalId": "3ee1fdb1c3331010d216b5183c40dd81"
   },
   "bundle": false,
   "productPrice": [],
   "id": "25b07475471789108761b955d36d439d",
   "href": "/api/sn_prd_invt/product/25b07475471789108761b955d36d439d"
}

    Product Inventory Open API – POST /sn_prd_invt/productinventory

    Erstellt einen Produktbestand.

    Wichtig:
    Ab Release Tokyo ist dieser Endpunkt veraltet. Die neue Version dieses Endpunkts ist Product Inventory Open API – POST /sn_prd_invt/product.

    URL-Format

    Standard-URL: /api/sn_prd_invt/productinventory

    Unterstützte Anforderungsparameter

    Tabelle : 31. Pfadparameter
    Name Beschreibung
    Keine
    Tabelle : 32. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 33. Parameter des Anforderungstexts (JSON)
    Name Beschreibung
    name Erforderlich. Name des Produktbestands.

    Datentyp: Zeichenfolge
    pid Eindeutiger Bezeichner für den Produktbestand aus dem externen System.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array

    "productCharacteristic": [
   {
      "name": "String",
      "value": "String"
   }
]
    productCharacteristic.name Name des Merkmals.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    productOffering Erforderlich. Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
   "id": "String",
   "name": "String"
}
    productOffering.id Erforderlich. Sys_id des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productOffering.name Name des Produktangebots

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Erforderlich, wenn der Parameter productRelationship verwendet wird. Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Der einzige gültige Wert ist untergeordnet.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Produktspezifikation Erforderlich. Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String"
}
    productSpecification.id Erforderlich. Sys_id der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Produktspezifikation [sn_prd_pm_product_specification]
    realisierendeRessource Ressource wird realisiert.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realizingResource.id Erforderlich, wenn der Parameter realizingResource verwendet wird. Sys_id der implementierenden Ressource.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Der einzige gültige Wert ist untergeordnet.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    realizationService Service umsetzen.

    Datentyp: Objekt

    "realizingService": {
      "id": "String",
      "type": "String"
}
    realizingService.id Erforderlich, wenn der Parameter realizingService verwendet wird. Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Der einzige gültige Wert ist untergeordnet.

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    relatedParty.id Erforderlich, wenn der Parameter relatedParty verwendet wird. Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_Consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • Customer_contact

    Datentyp: Zeichenfolge

    Standard: Leere Zeichenfolge
    state Aktueller Status des Produkts.
    Mögliche Werte:
    • aktiv
    • change_pending
    • inactivation_pending
    • Inaktiv
    • „installation_pending“

    Datentyp: Zeichenfolge

    Standard: „installation_pending“.

    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 : 34. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 35. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Antworttexts. Unterstützt nur application/json.

    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-Antwortcodes der REST-API.

    Tabelle : 36. Statuscodes
    Statuscode Beschreibung
    201 Anforderung erfolgreich verarbeitet.
    400 Ungültige Anforderung. Kann einer der folgenden Gründe sein:
    • Leere Nutzlast.
    • Ungültige Nutzlast. Pflichtfeld fehlt:<field name>

    Parameter des Antwort-Haupttexts (JSON)

    Name Beschreibung
    id Sys_id des Produktbestands.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    name Name des Produktbestands.

    Datentyp: Zeichenfolge
    pid Eindeutiger Bezeichner für den Produktbestand aus dem externen System.

    Datentyp: Zeichenfolge
    Produktmerkmal Liste der Produkteigenschaften.

    Datentyp: Array von Objekten

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    Produktmerkmal.Name Name des Merkmals.

    Datentyp: Zeichenfolge
    Produktmerkmal.Wert Wert des Merkmals.

    Datentyp: Zeichenfolge
    productOffering Produktangebot, dem der Produktbestand zugeordnet ist.

    Datentyp: Objekt

    "productOffering": {
   "id": "String",
   "name": "String"
}
    productOffering.id Sys_id des Produktangebots.

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    Produktangebot.Name Name des Produktangebots

    Datentyp: Zeichenfolge

    Tabelle: Produktangebot [sn_prd_pm_product_offering]
    productRelationship Liste der zugehörigen Produkte.

    Datentyp: Array von Objekten

    "productRelationship": [
  {
    "productId": "String",
    "relationshipType": "String"
  }
]
    Produktbeziehung.ProduktID Sys_id des zugehörigen Produkts.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    productRelationship.relationshipType Typ der Beziehung.

    Datentyp: Zeichenfolge
    Produktspezifikation Produktspezifikation für das Produkt.

    Datentyp: Objekt

    "productSpecification": {
  "id": "String"
}
    productSpecification.id Sys_id der Produktspezifikation.

    Datentyp: Zeichenfolge

    Tabelle: Produktspezifikation [sn_prd_pm_product_specification]
    realisierendeRessource Ressource wird realisiert.

    Datentyp: Objekt

    "realizingResource": {
  "id": "String",
  "type": "String"
}
    realisierendeRessource.id Sys_id der implementierenden Ressource

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationResource.type Typ der implementierenden Ressource.

    Datentyp: Zeichenfolge
    realizationService Service umsetzen.

    Datentyp: Objekt

    "realizingService": {
  "id": "String",
  "type": "String"
}
    realisingService.id Sys_id des implementierenden Service.

    Datentyp: Zeichenfolge

    Tabelle: Produktbestand [sn_prd_invt_product_inventory]
    realizationService.type Typ des implementierenden Service.

    Datentyp: Zeichenfolge
    Zugehörige Partei Liste der Parteien, die dem Ticket zugeordnet sind.

    Datentyp: Array von Objekten

    "relatedParty": [
  {
    "id": "String",
    "@referredType": "String"
  }
]
    Zugehörigepartei.id Sys_id des Accounts oder Kundenkontakts, der dem Ticket zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: Account [customer_account], Kontakt [customer_contact] oder Verbraucher [csm_consumer]
    zugehörigepartei.@referenztyp Typ des Kunden
    Mögliche Werte:
    • Verbraucher
    • Kunde
    • Kundenkontakt

    Datentyp: Zeichenfolge
    state Aktueller Status des Produkts.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    In diesem Beispiel wird ein Produktbestand für eine Voice over IP-Lösung für einen Benutzer erstellt.

    curl --location --request POST "https://instance.servicenow.com/api/sn_prd_invt/productinventory" \
--header "Content-Type: application/json" \
--data-raw '[
    {
        "pid": "demoInventory",
        "description": "inventory description",
        "isBundle": false,
        "name": "Voice Over IP Basic instance for Jean",
        "productOffering": {
            "id": "69017a0f536520103b6bddeeff7b127d",
            "name": "Premium SD-WAN Offering",
            "@referredType": "ProductOffering"
        },
        "productCharacteristic": [
            {
                "name": "CPE Type",
                "valueType": "choice",
                "value": "Virtual"
            },
            {
                "name":"Routing",
                "valueType": "choice",
                "value": "Premium"
            }
        ],
        "productRelationship": [
            {
                "productId": "7e6d13f45b5620102dff5e92dc81c787",
                "relationshipType": "child"
            }
        ],
        "relatedParty": [
            {
                "id": "eaf68911c35420105252716b7d40ddde",
                "name": "Sally Thomas",
                "role": "User",
                "@type": "RelatedParty",
                "@referredType": "CustomerContact"
            },
            {
                "id": "ffc68911c35420105252716b7d40dd55",
                "name": "Funco Intl",
                "@type": "RelatedParty",
                "@referredType": "Customer"
            }
        ],
        "productSpecification": {
            "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
            "@referredType": "ProductSpecification",
            "version": "1"
        }
    }
]'
--user 'username':'password'

    Antworttext.

    {
   "pid": "demoInventory",
   "description": "inventory description",
   "isBundle": false,
   "name": "Voice Over IP Basic instance for Jean",
   "productOffering": {
      "id": "69017a0f536520103b6bddeeff7b127d",
      "name": "Premium SD-WAN Offering",
      "@referredType": "ProductOffering"
   },
   "productCharacteristic": [
      {
         "name": "CPE Type",
         "valueType": "choice",
         "value": "Virtual"
      },
      {
         "name": "Routing",
         "valueType": "choice",
         "value": "Premium"
      }
   ],
   "productRelationship": [
      {
         "productId": "7e6d13f45b5620102dff5e92dc81c787",
         "relationshipType": "child"
      }
   ],
   "relatedParty": [
      {
         "id": "eaf68911c35420105252716b7d40ddde",
         "name": "Sally Thomas",
         "role": "User",
         "@type": "RelatedParty",
         "@referredType": "CustomerContact"
      },
      {
         "id": "ffc68911c35420105252716b7d40dd55",
         "name": "Funco Intl",
         "@type": "RelatedParty",
         "@referredType": "Customer"
      }
   ],
   "productSpecification": {
      "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
      "@referredType": "ProductSpecification",
      "version": "1"
   },
   "id": "3ac715c6745d8150f877ca57242ff97a"
}