---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Produktkatalog -- API öffnen

# Produktkatalog -- API öffnen {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 80 Minuten Lesedauer

Die Produktkatalog Geöffnet Die API stellt Endpunkte zum Erstellen und Abrufen von Produktkatalogen, Produktangeboten und Produktspezifikationen bereit.
Verwenden Sie diese API, um Produktkataloginformationen zwischen externen Systemen und zu verwalten Now Platform. Die Produktkatalog Geöffnet API ist ein ServiceNow®Implementierung der REST-Spezifikation der API für Produktkatalog-Verwaltung des TM-Forums. Diese Implementierung basiert auf [TMF620 -- API-REST-Spezifikation FÜR Produktkatalog-Verwaltung, Version 4](https://www.tmforum.org/resources/standard/tmf620-product-catalog-management-api-user-guide-v4-1-0/), April 2021.

Diese API ist in der erweiterten Anwendung „Produktkatalog" enthalten, die auf verfügbar ist ServiceNow Store.

Diese API wird in bereitgestellt `sn_tmf_api `Namespace.

Der aufrufende Anwender muss über die Rolle „sn_prd_pm_adv.catalog_integrator" verfügen.  
Diese API erstellt und aktualisiert Daten in den folgenden Tabellen.

* Merkmal \[sn_prd_pm_characteristic\]
* Merkmalsoption \[sn_prd_pm_characteristic_option\]
* Produktangebot \[sn_prd_pm_product_offering\]
* Produktangebotskatalog \[sn_prd_pm_product_offering_catalog\]
* Produktangebotsmerkmal \[sn_prd_pm_product_offering_characteristic\]
* Produktspezifikation \[sn_prd_pm_product_specification\]
* Spezifikationsbeziehung \[sn_prd_pm_specification_relationship\]
{#product-catalog-open-api__ul_fhn_pjj_hsb}

## Produktkatalog -- API öffnen -- /sn_tmf_api/catalogmanagement/productOffering/{ID} LÖSCHEN {#ariaid-title2}

Löscht das angegebene Produktangebot.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOffering/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-DELETE-prodOffer-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des zu löschenden Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
[Tabelle : 1. Pfad-Parameter]

{#tmf_prod_cat-DELETE-prodOffer-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#tmf_prod_cat-DELETE-prodOffer-id__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-DELETE-prodOffer-id__entry__14}{#tmf_prod_cat-DELETE-prodOffer-id__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#tmf_prod_cat-DELETE-prodOffer-id__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-DELETE-prodOffer-id__table_tmr_dgq_mbc__entry__2}{#tmf_prod_cat-DELETE-prodOffer-id__entry-200-status-code}{#tmf_prod_cat-DELETE-prodOffer-id__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
[Tabelle : 6. Statuscodes]

{#tmf_prod_cat-DELETE-prodOffer-id__table_tmr_dgq_mbc}

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_cat-DELETE-prodOffer-id__entry__28}

| Name | Beschreibung |
|-|-|
| Nachricht | Eine Fehler- oder Erfolgsmeldung zum Löschen oder Archivieren der Produktspezifikation. |
[ ]

### Curl-Anforderung

Im folgenden Beispiel wird das Produktangebot mit der ID d6f8d995b020210235d85cced81c7eb gelöscht.

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb" \ 
    --request DELETE\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Der Antworttext gibt eine Nachricht zum erfolgreichen Löschen zurück:

    "The product offering (d6f8d9995b020210235d85cced81c7eb) is successfully deleted"

## Produktkatalog -- API öffnen -- /sn_tmf_api/catalogmanagement/productOfferingPrice/{ID} LÖSCHEN {#ariaid-title3}

Deaktiviert eine Preislistenposition mit einer bestimmten sys_ID, löscht aber nicht
Um eine Preislistenposition auf einen inaktiven Status festzulegen, aktualisiert diese LÖSCHMETHODE das Enddatum der Preislistenposition auf das heutige Datum. Eine Preislistenposition mit einem Enddatum vor dem heutigen Datum wird ebenfalls als inaktiv betrachtet. Inaktive Preislistenpositionen können in zugehörigen ABRUFMETHODEN nicht abgerufen werden.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_order-DEL-prodoffprice-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID der zu löschenden Preislistenposition. Tabelle: Preislistenposition \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#tmf_prod_order-DEL-prodoffprice-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#tmf_prod_order-DEL-prodoffprice-id__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-DEL-prodoffprice-id__entry__14}{#tmf_prod_order-DEL-prodoffprice-id__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#tmf_prod_order-DEL-prodoffprice-id__entry__18}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 11. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-DEL-prodoffprice-id__table_onp_pnw_22c__entry__2}{#tmf_prod_order-DEL-prodoffprice-id__entry-200-status-code}{#tmf_prod_order-DEL-prodoffprice-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-DEL-prodoffprice-id__ul_qkg_2rv_22c} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 12. Statuscodes]

{#tmf_prod_order-DEL-prodoffprice-id__table_onp_pnw_22c}

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_order-DEL-prodoffprice-id__entry__30}

| Name | Beschreibung |
|-|-|
| Nachricht | Statuscode mit einer Nachricht über die erfolgreiche oder fehlgeschlagene Deaktivierung der Preislistenposition. |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie eine Preisliste der angegebenen sys_ID, 994d., erfolgreich deaktiviert oder gelöscht wird...

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" \
    --request DELETE\
    --user 'username':'password'

Antwort. Die Antwort gibt einen Statuscode 200 mit Details zur erfolgreichen Deaktivierung zurück.

    Status: 200 OK
    "The price list line (994d5d364f8b5210f899f61d20ce0b7c) is inactive successfully"

## Produktkatalog -- API öffnen -- /sn_tmf_api/catalogmanagement/Produktspezifikation/{ID} LÖSCHEN {#ariaid-title4}

Löscht oder archiviert die angegebene Produktspezifikation.
Beim Aufrufen dieser LÖSCHMETHODE kann eine Produktspezifikation je nach Status entweder gelöscht oder archiviert werden:

* Eine Produktspezifikation im Entwurfsstatus wurde erfolgreich gelöscht. Die Antwort gibt eine Erfolgsmeldung zurück.
* Eine Produktspezifikation im Status „archiviert" kann nicht gelöscht werden. Die Antwort gibt eine Nachricht zurück, dass die Spezifikation bereits archiviert ist.
* Eine Produktspezifikation, die sich nicht im Entwurfsstatus befindet und anderen Produktspezifikationen oder Angeboten zugeordnet ist, wird archiviert, aber nicht gelöscht. Die Antwort gibt eine Nachricht zurück, dass die Spezifikation von einem aktiven Status in einen archivierten Status verschoben wird.
* Eine Produktspezifikation, die einer aktiven Produktspezifikation oder einem aktiven Angebot zugeordnet ist, kann nicht gelöscht werden. Die Antwort gibt eine Fehlermeldung zurück.
{#tmf_prod_cat-DELETE-prodSpec-id__ul_rmw_mw4_4bc}

### URL-Format

Standard-URL: /sn_tmf_api/catalogmanagement/Produktspezifikation/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-DELETE-prodSpec-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID der zu löschenden Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
[Tabelle : 13. Pfad-Parameter]

{#tmf_prod_cat-DELETE-prodSpec-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

{#tmf_prod_cat-DELETE-prodSpec-id__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-DELETE-prodSpec-id__table_u3k_cgq_mbc__entry__2}{#tmf_prod_cat-DELETE-prodSpec-id__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen.]

{#tmf_prod_cat-DELETE-prodSpec-id__table_u3k_cgq_mbc} {#tmf_prod_cat-DELETE-prodSpec-id__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-DELETE-prodSpec-id__table_tmr_dgq_mbc__entry__2}{#tmf_prod_cat-DELETE-prodSpec-id__entry-200-status-code}{#tmf_prod_cat-DELETE-prodSpec-id__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
[Tabelle : 18. Statuscodes]

{#tmf_prod_cat-DELETE-prodSpec-id__table_tmr_dgq_mbc}

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_cat-DELETE-prodSpec-id__entry__28}

| Name | Beschreibung |
|-|-|
| Nachricht | Eine Fehler- oder Erfolgsmeldung zum Löschen oder Archivieren der Produktspezifikation. |
[ ]

### Curl-Anforderung

Das folgende Beispiel löscht die Produktspezifikation mit der ID 8ef57fa05b308210235d85cced81c7d8.

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/8ef57fa05b308210235d85cced81c7d8" \ 
    --request DELETE\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Der Antworttext gibt eine Erfolgs- oder Fehlermeldung zurück:

    "The product specification (8ef57fa05b308210235d85cced81c7d8) is successfully deleted"

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/catalog ab {#ariaid-title5}

Ruft eine Liste aller Produktangebotskataloge ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/catalog

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Pfad-Parameter]

{#tmf_prod_cat-GET-catalog__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgegeben. |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Standard: 20 Maximum: 100 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Datentyp: Zahl Standard: 0 |
[Tabelle : 20. Abfrageparameter]

{#tmf_prod_cat-GET-catalog__table_c3q_ylz_gsb} {#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-GET-catalog__table_gld_vkz_gsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-catalog__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 22. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-catalog__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb__entry__2}{#tmf_prod_cat-GET-catalog__content-range-row}{#tmf_prod_cat-GET-catalog__content-type-row}{#tmf_prod_cat-GET-catalog__links-pagination-row}{#tmf_prod_cat-GET-catalog__x-total-count-descr}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert von Content-RangeHeader ist `Elemente 3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Verknüpfen | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#tmf_prod_cat-GET-catalog__ul_zzk_sdm_lsb} |
| X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. |
[Tabelle : 23. Antwort-Header]

{#tmf_prod_cat-GET-catalog__table_nww_xgm_lsb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-catalog__table_v1h_tcm_lsb__entry__2}{#tmf_prod_cat-GET-catalog__tmf-get-status-200-p}{#tmf_prod_cat-GET-catalog__tmf-get-status-206-entry}{#tmf_prod_cat-GET-catalog__tmf-get-status-400-entry}{#tmf_prod_cat-GET-catalog__tmf-get-status-404-entry}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource in Antwort zurückgegeben (keine Paginierung). |
| 206 | In Antwort zurückgegebene Teilressource (mit Paginierung). |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-catalog__ul_rys_1gy_fsb} |
| 404 | Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen. |
[Tabelle : 24. Statuscodes]

{#tmf_prod_cat-GET-catalog__table_v1h_tcm_lsb}

### Antworttext-Parameter (JSON) {#tmf_prod_cat-GET-catalog__section_g2r_kmz_gsb}

{#tmf_prod_cat-GET-catalog__table_m2z_clz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung des Produktangebotskatalogs. Datentyp: Zeichenfolge |
| ID | SYS_ID des Produktangebotskatalogs. Datentyp: Zeichenfolge Tabelle: Produktangebotskatalog \[sn_prd_pm_product_offering_catalog\] |
| name | Name des Produktangebotskatalogs. Datentyp: Zeichenfolge |
[ ]

{#tmf_prod_cat-GET-catalog__table_m2z_clz_gsb}  

### Curl-Anforderung

Dieses Beispiel ruft alle Produktangebotskataloge ab.

    curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog" \
    --user 'username':'password'

Antworttext.

    [
        {
            "id": "SD-WAN1344314wrfw14345",
            "name": "New Catalog",
            "description": "New Catalog"
        },
        {
            "id": "9919291ac34c20105252716b7d40dd0f",
            "name": "Enterprise Mobile Plan",
            "description": " Product Catalog for Enterprise Mobile Plan"
        }
    ]

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/catalog/{ID} {#ariaid-title6}

Ruft einen Produktangebotskatalog ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/catalog/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des abzurufenden Produktangebotskatalogs. Datentyp: Zeichenfolge Tabelle: Produktangebotskatalog \[sn_prd_pm_product_offering_catalog\] |
[Tabelle : 25. Pfad-Parameter]

{#tmf_prod_cat-GET-catalog-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder. |
[Tabelle : 26. Abfrageparameter]

{#tmf_prod_cat-GET-catalog-id__table_l5k_tkz_gsb} {#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 27. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-GET-catalog-id__table_gld_vkz_gsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-catalog-id__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 28. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-catalog-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-catalog-id__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 29. Antwort-Header]

{#tmf_prod_cat-GET-catalog-id__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-catalog-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_cat-GET-catalog-id__entry-200-status-code}{#tmf_prod_cat-GET-catalog-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Kann einer der folgenden Gründe sein: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-catalog-id__ul_rys_1gy_fsb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 30. Statuscodes]

{#tmf_prod_cat-GET-catalog-id__table_nxj_ykz_gsb}

### Antworttext-Parameter (JSON)

{#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung des Produktangebotskatalogs. Datentyp: Zeichenfolge |
| ID | SYS_ID des Produktangebotskatalogs. Datentyp: Zeichenfolge Tabelle: Produktangebotskatalog \[sn_prd_pm_product_offering_catalog\] |
| name | Name des Produktangebotskatalogs. Datentyp: Zeichenfolge |
[ ]

{#tmf_prod_cat-GET-catalog-id__table_m2z_clz_gsb}  

### Curl-Anforderung

Dieses Beispiel ruft einen Produktangebotskatalog für einen mobilen Enterprise-Plan ab.

    curl --location --request GET "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog/9919291ac34c20105252716b7d40dd0f" \
    --user 'username':'password'

Antworttext.

    {
       "id": "9919291ac34c20105252716b7d40dd0f",
       "name": "Enterprise Mobile Plan",
       "description": " Product Catalog for Enterprise Mobile Plan"
    }

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title7}

Ruft alle Produktangebote ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOffering

### Unterstützte Anforderungsparameter {#tmf_prod_cat-GET-prodoffering__section_fcz_2t1_jsb}

{#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 31. Pfad-Parameter]

{#tmf_prod_cat-GET-prodoffering__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Gültige Felder: * Kategorie * Kanal * Beschreibung * externalId * ID * internalId * InternalVersion * LastUpdate * name * Produktmerkmal * ProductOfferingPreis * ProductOfferingTerm * Produktspezifikation * ProdSpecCharValueVerwenden * ValidiertFür * Version {#tmf_prod_cat-GET-prodoffering__ul_irb_sdg_5tb} Datentyp: Zeichenfolge Standard: Alle Felder werden zurückgegeben. |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Standard: 20 Maximum: 100 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Datentyp: Zahl Standard: 0 |
| Spezifikation | Produktangebote nach Produktspezifikation sys_ID filtern Nur Produktangebote mit der angegebenen Produktspezifikation sys_ID werden in der Antwort zurückgegeben. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| Staat | Filtern Sie Produktangebote nach Status. Nur Produktangebote im angegebenen Status werden in der Antwort zurückgegeben. Gültige Werte: * archiviert * Entwurf * Veröffentlicht * Stillgelegt {#tmf_prod_cat-GET-prodoffering__ul_ndy_pcb_ccc} Datentyp: Zeichenfolge |
[Tabelle : 32. Abfrageparameter]

{#tmf_prod_cat-GET-prodoffering__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 33. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-GET-prodoffering__table_gld_vkz_gsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodoffering__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 34. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-prodoffering__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb__entry__2}{#tmf_prod_cat-GET-prodoffering__content-range-row}{#tmf_prod_cat-GET-prodoffering__content-type-row}{#tmf_prod_cat-GET-prodoffering__links-pagination-row}{#tmf_prod_cat-GET-prodoffering__x-total-count-descr}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert von Content-RangeHeader ist `Elemente 3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Verknüpfen | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#tmf_prod_cat-GET-prodoffering__ul_zzk_sdm_lsb} |
| X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. |
[Tabelle : 35. Antwort-Header]

{#tmf_prod_cat-GET-prodoffering__table_ug4_sgm_lsb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodoffering__table_qhs_scm_lsb__entry__2}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-200-p}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-206-entry}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-400-entry}{#tmf_prod_cat-GET-prodoffering__tmf-get-status-404-entry}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource in Antwort zurückgegeben (keine Paginierung). |
| 206 | In Antwort zurückgegebene Teilressource (mit Paginierung). |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-prodoffering__ul_rys_1gy_fsb} |
| 404 | Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen. |
[Tabelle : 36. Statuscodes]

{#tmf_prod_cat-GET-prodoffering__table_qhs_scm_lsb}

### Antworttext-Parameter (JSON) {#tmf_prod_cat-GET-prodoffering__section_qqr_2s1_jsb}

{#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb__entry__2}

| Name | Beschreibung |
|-|-|
| Kategorie | Liste der Kategorien, zu denen das Produkt gehört. Datentyp: Array von Objekten "category:" [ { "id": "String", "name": "String" } ] |
| Kategorie.ID | ID der Kategorie. Datentyp: Zeichenfolge |
| category.name | Name der Kategorie. Datentyp: Zeichenfolge |
| Kanal | Kanäle, die für den Verkauf des Produktangebots verwendet werden sollen. Datentyp: Array von Objekten "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | Beschreibung des Kanals. Datentyp: Zeichenfolge |
| Kanal.ID | SYS_ID des Kanals. Datentyp: Zeichenfolge Tabelle: Verteilungskanal \[sn_prd_pm_distribution_channel\] |
| channel.name | Name des Kanals. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Produktangebots. Datentyp: Zeichenfolge |
| externalId | Externe ID des Produktangebots Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktangebot \[sn_prd_pm_product_offering\]". |
| internalId | Anfangsversion des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| InternalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| LastUpdate | Datum, an dem das Produktangebot zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus des Produktangebots. Gültige Werte: * Aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Produktmerkmal | Liste der Produktmerkmale. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.Wert | Wert des Merkmals. Datentyp: Zeichenfolge |
| ProductOfferingPreis | Preisinformationen für das Produktangebot. Datentyp: Array von Objekten "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| ProduktAngebotPreis.Preis | Preisinformationen für das Produktangebot. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| ProduktangebotPreis.Preis.taxIncludedAmount | Preisinformationen für das Produktangebot. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": "String" } |
| ProduktAngebotPreis.Preis.taxIncludedAmount.unit | Währungscode für den Produktangebotspreis. Datentyp: Zeichenfolge |
| ProduktangebotPreis.Preis.taxIncludedAmount.value | Preis des Produktangebots einschließlich Steuer. Datentyp: Zeichenfolge |
| ProductOfferingPreis.priceType | Typ des Produktangebotspreises, einmalige oder wiederkehrende Zahlung. Gültige Werte: * Nicht wiederkehrend (einmalig) * Wiederkehrend Datentyp: Zeichenfolge |
| ProductOfferingTerm | Gültige Vertragslaufzeit für das Produktangebot. Datentyp: Zeichenfolge |
| Produktspezifikation | Produktspezifikation für das Produkt. Datentyp: Objekt "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalId | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| Produktspezifikation.Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProdSpecCharValueVerwenden | Produktangebotsmerkmale. Datentyp: Array von Objekten "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.name | Name des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProdSpecCharValueVerwenden.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueUse.valueType | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. |
| ValidiertFür | Datumsbereich, für den das Produktangebot gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum des Produktangebots. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum des Produktangebots. Datentyp: Zeichenfolge |
| Version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[ ]

{#tmf_prod_cat-GET-prodoffering__table_rqr_2s1_jsb}  

### Curl-Anforderung

Dieses Beispiel ruft alle Produktangebote ab.

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

Antworttext:

    [
       {
          "id": "24413",
          "name": "Premium SD-WAN Offering New",
          "version": "",
          "internalVersion": "1",
          "internalId": "0199f8e65b430110235d85cced81c7d2",
          "description": "Premium SD-WAN Offering",
          "lastUpdate": "2022-01-27 05:41:16",
          "validFor": {
             "startDateTime": "2021-08-05",
             "endDateTime": "2026-09-04"
          },
          "productOfferingTerm": "not_applicable",
          "productOfferingPrice": [
             {
                "priceType": "recurring",
                "price": {
                   "taxIncludedAmount": {
                      "unit": "JPY",
                      "value": 984.0913
                   }
                }
             },
             {
                "priceType": "nonRecurring",
                "price": {
                   "taxIncludedAmount": {
                      "unit": "GBP",
                      "value": 2434
                   }
                }
             }
          ],
          "productSpecification": {
             "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
             "name": "SD-WAN Service Package",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
          },
          "prodSpecCharValueUse": [
             {
                "name": "Routing",
                "description": "Routing",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:08:20"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Premium",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Base",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Advance",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "WAN Optimization",
                "description": "WAN Optimization",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:10:28"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Base",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Advance",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Premium",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "CPE Model",
                "description": "CPE Model",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:11:54"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "ISR",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "ASR",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "Security Type",
                "description": "Security Type",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-30 12:51:13"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Premium",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Advance",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Base",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "a6514bd3534560102f18ddeeff7b1247",
                   "name": "SD-WAN Security",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "a6514bd3534560102f18ddeeff7b1247"
                }
             },
             {
                "name": "CPE Type",
                "description": "CPE Type",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:11:16"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Virtual",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Physical",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "39b627aa53702010cd6dddeeff7b1202",
                   "name": "SD-WAN Edge Device",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "39b627aa53702010cd6dddeeff7b1202"
                }
             },
             {
                "name": "Tenancy",
                "description": "Tenancy",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2021-12-15 21:04:24"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "Advance (50 site)",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Base (10 site)",
                      "validFor": {
                         "startDateTime": ""
                      }
                   },
                   {
                      "value": "Premium (>50 sites)",
                      "validFor": {
                         "startDateTime": ""
                      }
                   }
                ],
                "productSpecification": {
                   "id": "216663aa53702010cd6dddeeff7b12b5",
                   "name": "SD-WAN Controller",
                   "version": "v1",
                   "internalVersion": "1",
                   "internalId": "216663aa53702010cd6dddeeff7b12b5"
                }
             }
          ],
          "channel": [
             {
                "id": "e561aae4c3e710105252716b7d40dd8f",
                "name": "Web"
             }
          ],
          "category": {
             "id": "c0ed043653b02010cd6dddeeff7b1277",
             "name": "SD-WAN"
          }
       }
    ]

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/productOffering/{ID} {#ariaid-title8}

Ruft ein Produktangebot ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOffering/{ID}

### Unterstützte Anforderungsparameter {#tmf_prod_cat-GET-prodoffering-id__section_jjg_dr1_jsb}

{#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| ID | Anfängliche Version des abzurufenden Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[Tabelle : 37. Pfad-Parameter]

{#tmf_prod_cat-GET-prodoffering-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Gültige Felder: * Kategorie * Kanal * Beschreibung * externalId * ID * internalId * InternalVersion * LastUpdate * name * Produktmerkmal * ProductOfferingPreis * ProductOfferingTerm * Produktspezifikation * ProdSpecCharValueVerwenden * ValidiertFür * Version {#tmf_prod_cat-GET-prodoffering-id__ul_irb_sdg_5tb} Datentyp: Zeichenfolge Standard: Alle Felder werden zurückgegeben. |
| Spezifikation | Produktangebote nach Produktspezifikation sys_ID filtern Nur Produktangebote mit der angegebenen Produktspezifikation sys_ID werden in der Antwort zurückgegeben. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| Staat | Filtern Sie Produktangebote nach Status. Nur Produktangebote im angegebenen Status werden in der Antwort zurückgegeben. Gültige Werte: * archiviert * Entwurf * Veröffentlicht * Stillgelegt {#tmf_prod_cat-GET-prodoffering-id__ul_ndy_pcb_ccc} Datentyp: Zeichenfolge |
[Tabelle : 38. Abfrageparameter]

{#tmf_prod_cat-GET-prodoffering-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 39. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-GET-prodoffering-id__table_gld_vkz_gsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 40. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-prodoffering-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 41. Antwort-Header]

{#tmf_prod_cat-GET-prodoffering-id__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodoffering-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_cat-GET-prodoffering-id__entry-200-status-code}{#tmf_prod_cat-GET-prodoffering-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-prodoffering-id__ul_rys_1gy_fsb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 42. Statuscodes]

{#tmf_prod_cat-GET-prodoffering-id__table_nxj_ykz_gsb}

### Antworttext-Parameter (JSON) {#tmf_prod_cat-GET-prodoffering-id__section_qqr_2s1_jsb}

{#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb__entry__2}

| Name | Beschreibung |
|-|-|
| Kategorie | Liste der Kategorien, zu denen das Produkt gehört. Datentyp: Array von Objekten "category:" [ { "id": "String", "name": "String" } ] |
| Kategorie.ID | ID der Kategorie. Datentyp: Zeichenfolge |
| category.name | Name der Kategorie. Datentyp: Zeichenfolge |
| Kanal | Kanäle, die für den Verkauf des Produktangebots verwendet werden sollen. Datentyp: Array von Objekten "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | Beschreibung des Kanals. Datentyp: Zeichenfolge |
| Kanal.ID | SYS_ID des Kanals. Datentyp: Zeichenfolge Tabelle: Verteilungskanal \[sn_prd_pm_distribution_channel\] |
| channel.name | Name des Kanals. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Produktangebots. Datentyp: Zeichenfolge |
| externalId | Externe ID des Produktangebots Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktangebot \[sn_prd_pm_product_offering\]". |
| internalId | Anfangsversion des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| InternalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| LastUpdate | Datum, an dem das Produktangebot zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Gibt den aktuellen Lebenszyklusstatus des Produktangebots an. Akzeptierte Werte: * Aktiv * Inaktiv * Entwurf {#tmf_prod_cat-GET-prodoffering-id__ul_lj5_gg4_4bc} Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Produktmerkmal | Liste der Produktmerkmale. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.Wert | Wert des Merkmals. Datentyp: Zeichenfolge |
| ProductOfferingPreis | Preisinformationen für das Produktangebot. Datentyp: Array von Objekten "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| ProduktAngebotPreis.Preis | Preisinformationen für das Produktangebot. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| ProduktangebotPreis.Preis.taxIncludedAmount | Preisinformationen für das Produktangebot. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": "String" } |
| ProduktAngebotPreis.Preis.taxIncludedAmount.unit | Währungscode für den Produktangebotspreis. Datentyp: Zeichenfolge |
| ProduktangebotPreis.Preis.taxIncludedAmount.value | Preis des Produktangebots einschließlich Steuer. Datentyp: Zeichenfolge |
| ProductOfferingPreis.priceType | Gibt an, ob der Produktangebotspreis eine einmalige oder wiederkehrende Zahlung ist. Gültige Werte: * Nicht wiederkehrend * Wiederkehrend {#tmf_prod_cat-GET-prodoffering-id__ul_nl4_jqh_hsb} Datentyp: Zeichenfolge |
| ProductOfferingTerm | Gültige Vertragslaufzeit für das Produktangebot. Datentyp: Zeichenfolge |
| Produktspezifikation | Produktspezifikation für das Produkt. Datentyp: Objekt "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalId | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| Produktspezifikation.Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProdSpecCharValueVerwenden | Produktangebotsmerkmal. Datentyp: Array von Objekten "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.name | Name des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProdSpecCharValueVerwenden.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueUse.valueType | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ValidiertFür | Datumsbereich, für den das Produktangebot gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum des Produktangebots. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum des Produktangebots. Datentyp: Zeichenfolge |
| Version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[ ]

{#tmf_prod_cat-GET-prodoffering-id__table_rqr_2s1_jsb}  

### Curl-Anforderung

Dieses Beispiel ruft ein Produktangebot ab.

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering/24413" \
    --user 'username':'password'

Antworttext:

    {
       "id": "24413",
       "name": "Premium SD-WAN Offering New",
       "description": "Premium SD-WAN Offering",
       "lastUpdate": "2022-01-27 05:41:16",
       "version": "",
       "internalVersion": "2",
       "internalId": "69017a0f536520103b6bddeeff7b127d",
       "validFor": {
          "startDateTime": "2021-08-05",
          "endDateTime": "2026-09-04"
       },
       "productOfferingTerm": "not_applicable",
       "productOfferingPrice": [
          {
             "priceType": "recurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "JPY",
                   "value": 984.0913
                }
             }
          },
          {
             "priceType": "nonRecurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "GBP",
                   "value": 2434
                }
             }
          }
       ],
       "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "version": "v1",
          "internalVersion": "1",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
       },
       "prodSpecCharValueUse": [
          {
             "name": "Routing",
             "description": "Routing",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:08:20"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v2",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "WAN Optimization",
             "description": "WAN Optimization",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:10:28"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v2",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "CPE Model",
             "description": "CPE Model",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:11:54"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "ISR",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "ASR",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v2",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Security Type",
             "description": "Security Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-30 12:51:13"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": "abc",
                "internalVersion": "1",
                "internalId": "a6514bd3534560102f18ddeeff7b1247"
             }
          },
          {
             "name": "CPE Type",
             "description": "CPE Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:11:16"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Virtual",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Physical",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "",
                "internalVersion": "2",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Tenancy",
             "description": "Tenancy",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-12-15 21:04:24"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Advance (50 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base (10 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium (>50 sites)",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "216663aa53702010cd6dddeeff7b12b5",
                "name": "SD-WAN Controller",
                "version": "",
                "internalVersion": "1",
                "internalId": "216663aa53702010cd6dddeeff7b12b5"
             }
          }
       ],
       "channel": [
          {
             "id": "e561aae4c3e710105252716b7d40dd8f",
             "name": "Web"
          }
       ],
       "category": {
          "id": "c0ed043653b02010cd6dddeeff7b1277",
          "name": "SD-WAN"
       }
    }

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/productOfferingPrice {#ariaid-title9}

Ruft alle Preislistenpositionsdatensätze in der Instanz ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice

### Unterstützte Anforderungsparameter

{#tmf_prod_order-GET-prodOfferPrice__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 43. Pfad-Parameter]

{#tmf_prod_order-GET-prodOfferPrice__id_nzv_ycw_22c__entry__2}

| Name | Beschreibung |
|-|-|
| LastUpdate | Filtern Sie die Ergebnisse nach dem Datum, an dem die Preisposition zuletzt aktualisiert wurde. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| name | Filtern Sie Preislistenpositionen, die zum Namen einer bestimmten Preisliste gehören. Tabelle: Preislisten \[sn_csm_pricing_price_list\] Datentyp: Zeichenfolge |
| Preis.Wert | Filtern Sie Ergebnisse nach einem bestimmten Listenpreiswert. Datentyp: Zeichenfolge |
| priceList.id | Filtern Sie Ergebnisse, um nur eine Preisliste mit einer bestimmten sys_ID zurückzugeben Tabelle: Preislisten \[sn_csm_pricing_price_list\] Datentyp: Zeichenfolge |
| Preistyp | Filtern Sie Ergebnisse nach der Preisgestaltungsmethode des Produktangebots. Gültige Werte: * Wiederkehrend: Ermöglicht Unternehmen, wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit zu berechnen. * One_time: Unterstützt einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge |
| Produktangebot.ID | Filtern Sie die Preislistenposition nach der sys_ID des Produktangebots Tabelle: Produktangebot \[sn_prd_pm_product_offering\] Datentyp: Zeichenfolge |
| unitOfMeasure.id | Filtern Sie die Preislistenposition nach sys_ID der Maßeinheit. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| ValidFor.endDateTime | Filtern Sie die Preislistenposition nach einem bestimmten Enddatum und einer bestimmten Endzeit. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Preislistenposition nach einem bestimmten Startdatum und einer bestimmten Startzeit filtern. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
[Tabelle : 44. Abfrageparameter]

{#tmf_prod_order-GET-prodOfferPrice__id_nzv_ycw_22c} {#tmf_prod_order-GET-prodOfferPrice__entry__26}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 45. Anforderungstext-Parameter (XML oder JSON)]

### Header {#tmf_prod_order-GET-prodOfferPrice__section_opp_j5w_22c}

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-prodOfferPrice__table_ppp_j5w_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 46. Anforderungskopfzeilen.]

{#tmf_prod_order-GET-prodOfferPrice__table_ppp_j5w_22c} {#tmf_prod_order-GET-prodOfferPrice__table_qpp_j5w_22c__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 47. Antwort-Header]

{#tmf_prod_order-GET-prodOfferPrice__table_qpp_j5w_22c}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-GET-prodOfferPrice__table_fj4_nnw_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__entry-200-status-code}{#tmf_prod_order-GET-prodOfferPrice__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-GET-prodOfferPrice__ul_qkg_2rv_22c} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 48. Statuscodes]

{#tmf_prod_order-GET-prodOfferPrice__table_fj4_nnw_22c}

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_order-GET-prodOfferPrice__id_m5r_jdw_22c__entry__2}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-type}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-href}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-isBundle}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-lastUpdate}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-lifeCycleStatus}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price.units}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-price.value}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.name}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceList.type}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-priceType}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.internalVersion}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-productOffering.name}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-recurringChargePeriodType}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.amount}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.id}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-unitOfMeasure.units}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor.endDate}{#tmf_prod_order-GET-prodOfferPrice__prodOfferingPrice-response-validFor.startDate}

| Name | Beschreibung |
|-|-|
| @Typ | Typ der Preislistenposition. Immer ein Wert von `ProduktangebotPreis `. Datentyp: Zeichenfolge |
| href | URL zum Preislistenpositionsdatensatz in der Instanz. Datentyp: Zeichenfolge |
| ID | SYS_ID der Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| IsBündel | Kennzeichnung, die angibt, ob die Preislistenposition Teil eines einzelnen Produkts oder eines Produktpakets ist. Gültige Werte: * Wahr: Preislistenposition ist Teil eines Pakets. * Falsch: Preislistenposition ist nicht Teil eines Pakets. Datentyp: Boolescher Wert |
| LastUpdate | Datum und Uhrzeit der letzten Aktualisierung der Preislistenposition. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Preislistenposition. Gültige Werte: * Aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge |
| Preis | Listenpreisdetails der Preislistenposition. Datentyp: Objekt "price": { "units": "String", "value": "String" } |
| Preis.Einheiten | Währungscode des Preises. Beispiel: `USD `Oder `EUR `. Tabelle: Währung \[fx_currency\] Datentyp: Zeichenfolge |
| Preis.Wert | Wert des Preises. Datentyp: Zeichenfolge (dargestellt durch eine Zahl) |
| priceList | Preislisteninformationen, die der Preislistenposition zugeordnet sind. Datentyp: Objekt "priceList": { "id": "String", "name": "String", "@type": "String" } |
| Preisliste.ID | SYS_ID der Preisliste in der Preislistentabelle \[sn_csm_pricing_price_list\]. Datentyp: Zeichenfolge |
| priceList.name | Name der Preisliste. Datentyp: Zeichenfolge |
| Preisliste.@type | Der Typ der Preisliste. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Hat immer einen Wert von `Preisliste `. Datentyp: Zeichenfolge |
| Preistyp | Die Preisgestaltungsmethode des Produktangebots, das dieser Preislistenposition zugeordnet ist. Mögliche Werte: * Wiederkehrend: Berechnen Sie wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit. Der Wert von recurringChargePeriodTypeGibt die Häufigkeit der Ladung an. * One_time: Einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge |
| productOffering | Produktangebot, das der Preislistenposition zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } |
| Produktangebot.ID | SYS_ID des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.internalVersion | Interne Versionsnummer des Produktangebots. Beispiel: `PRDOF01024 `. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| RecurringChargePeriodType | Die Periodizität oder Häufigkeit des Produktangebots, das dieser Preislistenposition zugeordnet ist. Gibt einen Häufigkeitstyp zurück, wenn priceTypeWurde auf festgelegt `Wiederkehrend `, Gibt andernfalls eine leere Zeichenfolge zurück. Mögliche Werte: * Jährlich * monatlich Datentyp: Zeichenfolge |
| Einheit der Messung | Details zur Maßeinheit, die der Preislistenposition zugeordnet ist. Datentyp: Objekt "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } |
| EinheitenMessung.Betrag | Betrag der Maßeinheit. Datentyp: Zahl |
| EinheitenMessung.ID | SYS_ID der Maßeinheit. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| EinheitenMessung.Einheiten | Typ der Maßeinheit, die der Preislistenposition zugeordnet ist. Beispiel: `Jahr `Oder `Paket `. Datentyp: Zeichenfolge |
| ValidiertFür | Die Dauer, für die die Preislistenposition gültig ist. Datentyp: Objekt "validFor": { "endDate": "String", "startDate": "String" } |
| ValidFor.endDate | Enddatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.startDate | Startdatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
[ ]

{#tmf_prod_order-GET-prodOfferPrice__id_m5r_jdw_22c}  

### Curl-Anforderung

Das folgende Beispiel gibt alle zwei Preislistenpositionen zurück, die in der Instanz vorhanden sind.

    curl "http://instance.servicenow.com/api/sn_tmf_api/ catalogmanagement/productOfferingPrice " \
    --request GET\
    --user 'username':'password'

Antworttext.

    [
      {
        "id": "2c4628ac7f4f9e50f8994fa63c86653c",
        "name": "new Price list",
        "lastUpdate": "2025-01-08 19:57:28",
        "isBundle": false,
        "lifecycleStatus": "Draft",
        "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/2c4628ac7f4f9e50f8994fa63c86653c",
        "validFor": {
          "startDateTime": "2027-03-22 22:15:58",
          "endDateTime": ""
        },
        "productOffering": {
          "id": "f2c92ac6a5260210f8774c9b4be6ce56",
          "name": "Managed Connectivity Services Supreme Bundle",
          "internalVersion": "1"
        },
        "priceType": "one_time",
        "recurringChargePeriodType": "",
        "unitOfMeasure": {
          "id": "9a7a119953020110286eddeeff7b1238",
          "amount": 1,
          "units": "Month"
        },
        "price": {
          "units": "USD",
          "value": "800"
        },
        "priceList": {
          "id": "d653246c7f4f9e50f8994fa63c86655a",
          "name": "new Price list",
          "@type": "priceList"
        },
        "@type": "ProductOfferingPrice"
      },
      {
        "id": "dfb7ec607f8f9e50f8994fa63c866569",
        "name": "new Price list",
        "lastUpdate": "2025-01-08 19:57:46",
        "isBundle": false,
        "lifecycleStatus": "Draft",
        "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569",
        "validFor": {
          "startDateTime": "2026-05-28 22:15:58",
          "endDateTime": ""
        },
        "productOffering": {
          "id": "f2c92ac6a5260210f8774c9b4be6ce56",
          "name": "Managed Connectivity Services Supreme Bundle",
          "internalVersion": "1"
        },
        "priceType": "one_time",
        "recurringChargePeriodType": "",
        "unitOfMeasure": {
          "id": "1eaa559953020110286eddeeff7b12c7",
          "amount": 1,
          "units": "Year"
        },
        "price": {
          "units": "USD",
          "value": "800"
        },
        "priceList": {
          "id": "d653246c7f4f9e50f8994fa63c86655a",
          "name": "new Price list",
          "@type": "priceList"
        },
        "@type": "ProductOfferingPrice"
      }
    ]

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/productOfferingPrice/{ID} {#ariaid-title10}

Ruft Details zu einer bestimmten Preislistenposition ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-GET-prodofferprice-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | Erforderlich. SYS_ID der abzurufenden Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
[Tabelle : 49. Pfad-Parameter]

{#tmf_prod_cat-GET-prodofferprice-id__id_itn_xcw_22c__entry__2}

| Name | Beschreibung |
|-|-|
| LastUpdate | Filtern Sie die Ergebnisse nach dem Datum, an dem die Preisposition zuletzt aktualisiert wurde. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| name | Filtern Sie Preislistenpositionen, die zum Namen einer bestimmten Preisliste gehören. Tabelle: Preislisten \[sn_csm_pricing_price_list\] Datentyp: Zeichenfolge |
| Preis.Wert | Filtern Sie Ergebnisse nach einem bestimmten Listenpreiswert. Datentyp: Zeichenfolge |
| priceList.id | Filtern Sie Ergebnisse, um nur eine Preisliste mit einer bestimmten sys_ID zurückzugeben Tabelle: Preislisten \[sn_csm_pricing_price_list\] Datentyp: Zeichenfolge |
| Preistyp | Filtern Sie Ergebnisse nach der Preisgestaltungsmethode des Produktangebots. Gültige Werte: * Wiederkehrend: Ermöglicht Unternehmen, wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit zu berechnen. * One_time: Unterstützt einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge |
| Produktangebot.ID | Filtern Sie die Preislistenposition nach der sys_ID des Produktangebots Tabelle: Produktangebot \[sn_prd_pm_product_offering\] Datentyp: Zeichenfolge |
| unitOfMeasure.id | Filtern Sie die Preislistenposition nach sys_ID der Maßeinheit. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| ValidFor.endDateTime | Filtern Sie die Preislistenposition nach einem bestimmten Enddatum und einer bestimmten Endzeit. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Preislistenposition nach einem bestimmten Startdatum und einer bestimmten Startzeit filtern. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
[Tabelle : 50. Abfrageparameter]

{#tmf_prod_cat-GET-prodofferprice-id__id_itn_xcw_22c} {#tmf_prod_cat-GET-prodofferprice-id__entry__26}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 51. Anforderungstext-Parameter (XML oder JSON)]

### Header {#tmf_prod_cat-GET-prodofferprice-id__section_ert_35w_22c}

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodofferprice-id__table_frt_35w_22c__entry__2}{#tmf_prod_cat-GET-prodofferprice-id__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 52. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-prodofferprice-id__table_frt_35w_22c} {#tmf_prod_cat-GET-prodofferprice-id__table_grt_35w_22c__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 53. Antwort-Header]

{#tmf_prod_cat-GET-prodofferprice-id__table_grt_35w_22c}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodofferprice-id__entry__38}{#tmf_prod_cat-GET-prodofferprice-id__entry-200-status-code}{#tmf_prod_cat-GET-prodofferprice-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-prodofferprice-id__ul_qkg_2rv_22c} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 54. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_cat-GET-prodofferprice-id__id_ksw_ldw_22c__entry__2}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-type}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-href}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-isBundle}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-lastUpdate}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-lifeCycleStatus}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price.units}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-price.value}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.name}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceList.type}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-priceType}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.internalVersion}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-productOffering.name}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-recurringChargePeriodType}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.amount}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.id}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-unitOfMeasure.units}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor.endDate}{#tmf_prod_cat-GET-prodofferprice-id__prodOfferingPrice-response-validFor.startDate}

| Name | Beschreibung |
|-|-|
| @Typ | Typ der Preislistenposition. Immer ein Wert von `ProduktangebotPreis `. Datentyp: Zeichenfolge |
| href | URL zum Preislistenpositionsdatensatz in der Instanz. Datentyp: Zeichenfolge |
| ID | SYS_ID der Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| IsBündel | Kennzeichnung, die angibt, ob die Preislistenposition Teil eines einzelnen Produkts oder eines Produktpakets ist. Gültige Werte: * Wahr: Preislistenposition ist Teil eines Pakets. * Falsch: Preislistenposition ist nicht Teil eines Pakets. Datentyp: Boolescher Wert |
| LastUpdate | Datum und Uhrzeit der letzten Aktualisierung der Preislistenposition. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Preislistenposition. Gültige Werte: * Aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge |
| Preis | Listenpreisdetails der Preislistenposition. Datentyp: Objekt "price": { "units": "String", "value": "String" } |
| Preis.Einheiten | Währungscode des Preises. Beispiel: `USD `Oder `EUR `. Tabelle: Währung \[fx_currency\] Datentyp: Zeichenfolge |
| Preis.Wert | Wert des Preises. Datentyp: Zeichenfolge (dargestellt durch eine Zahl) |
| priceList | Preislisteninformationen, die der Preislistenposition zugeordnet sind. Datentyp: Objekt "priceList": { "id": "String", "name": "String", "@type": "String" } |
| Preisliste.ID | SYS_ID der Preisliste in der Preislistentabelle \[sn_csm_pricing_price_list\]. Datentyp: Zeichenfolge |
| priceList.name | Name der Preisliste. Datentyp: Zeichenfolge |
| Preisliste.@type | Der Typ der Preisliste. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Hat immer einen Wert von `Preisliste `. Datentyp: Zeichenfolge |
| Preistyp | Die Preisgestaltungsmethode des Produktangebots, das dieser Preislistenposition zugeordnet ist. Mögliche Werte: * Wiederkehrend: Berechnen Sie wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit. Der Wert von recurringChargePeriodTypeGibt die Häufigkeit der Ladung an. * One_time: Einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge |
| productOffering | Produktangebot, das der Preislistenposition zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } |
| Produktangebot.ID | SYS_ID des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.internalVersion | Interne Versionsnummer des Produktangebots. Beispiel: `PRDOF01024 `. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| RecurringChargePeriodType | Die Periodizität oder Häufigkeit des Produktangebots, das dieser Preislistenposition zugeordnet ist. Gibt einen Häufigkeitstyp zurück, wenn priceTypeWurde auf festgelegt `Wiederkehrend `, Gibt andernfalls eine leere Zeichenfolge zurück. Mögliche Werte: * Jährlich * monatlich Datentyp: Zeichenfolge |
| Einheit der Messung | Details zur Maßeinheit, die der Preislistenposition zugeordnet ist. Datentyp: Objekt "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } |
| EinheitenMessung.Betrag | Betrag der Maßeinheit. Datentyp: Zahl |
| EinheitenMessung.ID | SYS_ID der Maßeinheit. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| EinheitenMessung.Einheiten | Typ der Maßeinheit, die der Preislistenposition zugeordnet ist. Beispiel: `Jahr `Oder `Paket `. Datentyp: Zeichenfolge |
| ValidiertFür | Die Dauer, für die die Preislistenposition gültig ist. Datentyp: Objekt "validFor": { "endDate": "String", "startDate": "String" } |
| ValidFor.endDate | Enddatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.startDate | Startdatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
[ ]

{#tmf_prod_cat-GET-prodofferprice-id__id_ksw_ldw_22c}  

### Curl-Anforderung

Das folgende Beispiel gibt Details zum Produktangebotspreis mit der ID dfb7ec60 zurück...

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569" \
    --request GET\
    --user 'username':'password'

Antwort.

    {
      "id": "dfb7ec607f8f9e50f8994fa63c866569",
      "name": "new Price list",
      "lastUpdate": "2025-01-08 19:57:46",
      "isBundle": false,
      "lifecycleStatus": "Draft",
      "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/dfb7ec607f8f9e50f8994fa63c866569",
      "validFor": {
        "startDateTime": "2026-05-28 22:15:58",
        "endDateTime": ""
      },
      "productOffering": {
        "id": "f2c92ac6a5260210f8774c9b4be6ce56",
        "name": "Managed Connectivity Services Supreme Bundle",
        "internalVersion": "1"
      },
      "priceType": "one_time",
      "recurringChargePeriodType": "",
      "unitOfMeasure": {
        "id": "1eaa559953020110286eddeeff7b12c7",
        "amount": 1,
        "units": "Year"
      },
      "price": {
        "units": "USD",
        "value": "800"
      },
      "priceList": {
        "id": "d653246c7f4f9e50f8994fa63c86655a",
        "name": "new Price list",
        "@type": "priceList"
      },
      "@type": "ProductOfferingPrice"
    }

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/Produktspezifikation AB {#ariaid-title11}

Ruft alle Produktspezifikationen ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/Produktspezifikation

### Unterstützte Anforderungsparameter {#tmf_prod_cat-GET-prodspec__section_fcz_2t1_jsb}

{#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 55. Pfad-Parameter]

{#tmf_prod_cat-GET-prodspec__table_ofr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Gültige Felder: * Beschreibung * externalId * ID * internalId * InternalVersion * LastUpdate * name * Produktspezifikation * ProduktspezifikationBeziehung * ResourceSpecification * Servicespezifikation * ValidiertFür * Version {#tmf_prod_cat-GET-prodspec__ul_n1h_htz_54b} Datentyp: Zeichenfolge Standard: Alle Felder werden zurückgegeben. |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Standard: 20 Maximum: 100 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Datentyp: Zahl Standard: 0 |
| Staat | Produktspezifikationen nach Status filtern. Nur Produktspezifikationen im angegebenen Status werden in der Antwort zurückgegeben. Akzeptierte Werte: * archiviert * Entwurf * Veröffentlicht * Stillgelegt {#tmf_prod_cat-GET-prodspec__ul_ngb_qcb_ccc} Datentyp: Zeichenfolge |
[Tabelle : 56. Abfrageparameter]

{#tmf_prod_cat-GET-prodspec__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 57. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-GET-prodspec__table_gld_vkz_gsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodspec__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 58. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-prodspec__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb__entry__2}{#tmf_prod_cat-GET-prodspec__content-range-row}{#tmf_prod_cat-GET-prodspec__content-type-row}{#tmf_prod_cat-GET-prodspec__links-pagination-row}{#tmf_prod_cat-GET-prodspec__x-total-count-descr}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert von Content-RangeHeader ist `Elemente 3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Verknüpfen | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#tmf_prod_cat-GET-prodspec__ul_zzk_sdm_lsb} |
| X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. |
[Tabelle : 59. Antwort-Header]

{#tmf_prod_cat-GET-prodspec__table_pkr_rgm_lsb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodspec__table_xss_rcm_lsb__entry__2}{#tmf_prod_cat-GET-prodspec__tmf-get-status-200-p}{#tmf_prod_cat-GET-prodspec__tmf-get-status-206-entry}{#tmf_prod_cat-GET-prodspec__tmf-get-status-400-entry}{#tmf_prod_cat-GET-prodspec__tmf-get-status-404-entry}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung erfolgreich verarbeitet. Vollständige Ressource in Antwort zurückgegeben (keine Paginierung). |
| 206 | In Antwort zurückgegebene Teilressource (mit Paginierung). |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-prodspec__ul_rys_1gy_fsb} |
| 404 | Datensatz nicht gefunden In der Tabelle wurden keine Datensätze gefunden, die den Abfrageparametern entsprechen. |
[Tabelle : 60. Statuscodes]

{#tmf_prod_cat-GET-prodspec__table_xss_rcm_lsb}

### Antworttext-Parameter (JSON) {#tmf_prod_cat-GET-prodspec__section_ymb_ccb_jsb}

{#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Spezifikation. Datentyp: Zeichenfolge |
| externalId | Erforderlich. Externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| internalId | Erforderlich. Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| InternalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| IsBündel | Kennzeichnung, die angibt, ob productSpecificationStellt ein einzelnes Produkt oder ein Produktpaket dar. Gültige Werte: * Wahr: Die Produktspezifikation ist ein Produktpaket und enthält mehrere Produkte. * Falsch: Die Produktspezifikation enthält ein einzelnes Produkt. {#tmf_prod_cat-GET-prodspec__ul_rry_rz4_4bc} Datentyp: Boolescher Wert Standard: Falsch |
| LastUpdate | Datum, an dem die Spezifikation zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Produktspezifikation. Akzeptierte Werte: * Aktiv * Inaktiv * Entwurf {#tmf_prod_cat-GET-prodspec__ul_lj5_gg4_4bc} Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name der Spezifikation. Datentyp: Zeichenfolge |
| Produktspezifikation | Spezifikationsmerkmal. Datentyp: Array von Objekten "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Produktspezifikation.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| Produktspezifikation.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProduktSpecMerkmal.WertTyp | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung | Die Beziehungen dieser Spezifikation zu anderen Produktspezifikationen. Datentyp: Array von Objekten "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] |
| productSpecificationRelationship.id | ID der zugehörigen Spezifikation. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.type | Typ der Beziehung. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung.validFür | Datumsbereich, für den die Beziehung gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProductSpecificationRelationship.validFor.endDateTime | Enddatum der Beziehung. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.validFor.startDateTime | Startdatum der Beziehung. Datentyp: Zeichenfolge |
| ResourceSpecification | Liste der Ressourcenspezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | Anfangsversion oder externe ID der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalId | Anfangsversion der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalVersion | Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.name | Name der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Ressourcenspezifikation \[sn_prd_pm_resource_specification\] |
| ResourceSpecification.Version | Externe Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| Servicespezifikation | Liste der Servicespezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | Anfangsversion oder externe ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalId | Anfangsversion der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalVersion | Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Servicespezifikation \[sn_prd_pm_service_specification\] |
| ServiceSpecification.Version | Externe Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| ValidiertFür | Datumsbereich, für den die Spezifikation gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum der Spezifikation. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum der Spezifikation. Datentyp: Zeichenfolge |
| Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
[ ]

{#tmf_prod_cat-GET-prodspec__table_zmb_ccb_jsb}  

### Curl-Anforderung

Dieses Beispiel ruft alle Produktspezifikationen ab.

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

Antworttext:

    [
       {
          "id": "0c47f2257441c110f877ca57242ff9bd",
          "name": "SD-WAN My Device",
          "version": "v1",
          "internalVersion": "1",
          "internalId": "0c47f2257441c110f877ca57242ff9bd",
          "description": "This is my product specification ...",
          "lastUpdate": "2022-01-14 17:57:23",
          "validFor": {
             "startDateTime": "2022-01-11",
             "endDateTime": "2027-01-10"
          },
          "serviceSpecification": [
             {
                "id": "e23ae2d01bb420106ba59acf034bcb56",
                "name": "IP Sec Tunnel",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "e23ae2d01bb420106ba59acf034bcb56"
             }
          ],
          "productSpecificationRelationship": [
             {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": "1",
                "type": "Service",
                "validFor": {
                   "startDateTime": "2022-01-11",
                   "endDateTime": "2027-02-12"
                }
             }
          ],
          "resourceSpecification": [
             {
                "id": "493fa60b536520103b6bddeeff7b12b6",
                "name": "Customer Premise SD-WAN Router",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "493fa60b536520103b6bddeeff7b12b6"
             }
          ],
          "productSpecCharacteristic": [
             {
                "name": "New characteristic",
                "description": "This product has new spec characteristic.",
                "valueType": "choice",
                "validFor": {
                   "startDatetime": "2022-01-13 06:47:43"
                },
                "productSpecCharacteristicValue": [
                   {
                      "value": "TestValue",
                      "validFor": {
                         "startDateTime": "2022-01-11"
                      }
                   }
                ]
             }
          ]
       }
    ]

## Produktkatalog -- API öffnen -- GET /sn_tmf_api/catalogmanagement/Produktspezifikation/{ID} {#ariaid-title12}

Ruft eine angegebene Produktspezifikation ab.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/Produktspezifikation/{ID}

### Unterstützte Anforderungsparameter {#tmf_prod_cat-GET-prodspec-id__section_jjg_dr1_jsb}

{#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| SpezifikationId | Die initial_Version der abzurufenden Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
[Tabelle : 61. Pfad-Parameter]

{#tmf_prod_cat-GET-prodspec-id__table_apt_nkz_gsb} {#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb__entry__2}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Gültige Felder: * Beschreibung * externalId * ID * internalId * InternalVersion * LastUpdate * name * Produktspezifikation * ProduktspezifikationBeziehung * ResourceSpecification * Servicespezifikation * ValidiertFür * Version {#tmf_prod_cat-GET-prodspec-id__ul_n1h_htz_54b} Datentyp: Zeichenfolge Standard: Alle Felder werden zurückgegeben. |
| Staat | Produktspezifikationen nach Status filtern. Nur Produktspezifikationen im angegebenen Status werden in der Antwort zurückgegeben. Akzeptierte Werte: * archiviert * Entwurf * Veröffentlicht * Stillgelegt {#tmf_prod_cat-GET-prodspec-id__ul_ngb_qcb_ccc} Datentyp: Zeichenfolge |
[Tabelle : 62. Abfrageparameter]

{#tmf_prod_cat-GET-prodspec-id__table_pfr_vgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 63. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-GET-prodspec-id__table_gld_vkz_gsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 64. Anforderungskopfzeilen.]

{#tmf_prod_cat-GET-prodspec-id__table_kqy_wgy_fsb} {#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb__entry__2}{#tmf_prod_cat-GET-prodspec-id__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 65. Antwort-Header]

{#tmf_prod_cat-GET-prodspec-id__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-GET-prodspec-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_cat-GET-prodspec-id__entry-200-status-code}{#tmf_prod_cat-GET-prodspec-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_cat-GET-prodspec-id__ul_rys_1gy_fsb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 66. Statuscodes]

{#tmf_prod_cat-GET-prodspec-id__table_nxj_ykz_gsb}

### Antworttext-Parameter (JSON) {#tmf_prod_cat-GET-prodspec-id__section_ymb_ccb_jsb}

{#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Spezifikation. Datentyp: Zeichenfolge |
| externalId | Erforderlich. Externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| internalId | Erforderlich. Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| InternalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| IsBündel | Kennzeichnung, die angibt, ob productSpecificationStellt ein einzelnes Produkt oder ein Produktpaket dar. Gültige Werte: * Wahr: Die Produktspezifikation ist ein Produktpaket und enthält mehrere Produkte. * Falsch: Die Produktspezifikation enthält ein einzelnes Produkt. {#tmf_prod_cat-GET-prodspec-id__ul_rry_rz4_4bc} Datentyp: Boolescher Wert Standard: Falsch |
| LastUpdate | Datum, an dem die Spezifikation zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Produktspezifikation. Gültige Werte: * Aktiv * Entwurf * Inaktiv {#tmf_prod_cat-GET-prodspec-id__ul_lj5_gg4_4bc} Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name der Spezifikation. Datentyp: Zeichenfolge |
| Produktspezifikation | Spezifikationsmerkmale. Datentyp: Array von Objekten "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.productSpecCharacteristicValue | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Produktspezifikation.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| Produktspezifikation.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProduktSpecMerkmal.WertTyp | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung | Die Beziehungen dieser Spezifikation zu anderen Produktspezifikationen. Datentyp: Array von Objekten "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] |
| productSpecificationRelationship.id | ID der zugehörigen Spezifikation. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.type | Typ der Beziehung. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung.validFür | Datumsbereich, für den die Beziehung gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProductSpecificationRelationship.validFor.endDateTime | Enddatum der Beziehung. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.validFor.startDateTime | Startdatum der Beziehung. Datentyp: Zeichenfolge |
| ResourceSpecification | Liste der Ressourcenspezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | Anfangsversion oder externe ID der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalId | Anfangsversion der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalVersion | Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.name | Name der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Ressourcenspezifikation \[sn_prd_pm_resource_specification\] |
| ResourceSpecification.Version | Externe Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| Servicespezifikation | Liste der Servicespezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | Anfangsversion oder externe ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalId | Anfangsversion der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalVersion | Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Servicespezifikation \[sn_prd_pm_service_specification\] |
| ServiceSpecification.Version | Externe Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| ValidiertFür | Datumsbereich, für den die Spezifikation gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum der Spezifikation. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum der Spezifikation. Datentyp: Zeichenfolge |
| Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
[ ]

{#tmf_prod_cat-GET-prodspec-id__table_zmb_ccb_jsb}  

### Curl-Anforderung

Dieses Beispiel ruft eine Produktspezifikation ab.

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification/0c47f2257441c110f877ca57242ff9bd" \
    --user 'username':'password'

Antworttext:

    {
       "id": "0c47f2257441c110f877ca57242ff9bd",
       "name": "SD-WAN My Device",
       "version": "v1",
       "internalVersion": "1",
       "internalId": "0c47f2257441c110f877ca57242ff9bd",
       "description": "This is my product specification ...",
       "lastUpdate": "2022-01-14 17:57:23",
       "validFor": {
          "startDateTime": "2022-01-11",
          "endDateTime": "2027-01-10"
       },
       "serviceSpecification": [
          {
             "id": "e23ae2d01bb420106ba59acf034bcb56",
             "name": "IP Sec Tunnel",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "e23ae2d01bb420106ba59acf034bcb56"
          }
       ],
       "productSpecificationRelationship": [
          {
             "id": "a6514bd3534560102f18ddeeff7b1247",
             "name": "SD-WAN Security",
             "version": "v1",
             "internalVersion": "1",
             "internalId": " a6514bd3534560102f18ddeeff7b1247",
             "type": "Service",
             "validFor": {
                "startDateTime": "2022-01-11",
                "endDateTime": "2027-02-12"
             }
          }
       ],
       "resourceSpecification": [
          {
             "id": "493fa60b536520103b6bddeeff7b12b6",
             "name": "Customer Premise SD-WAN Router",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "493fa60b536520103b6bddeeff7b12b6"
          }
       ],
       "productSpecCharacteristic": [
          {
             "name": "New characteristic",
             "description": "This product has new spec characteristic.",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2022-01-13 06:47:43"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "TestValue",
                   "validFor": {
                      "startDateTime": "2022-01-11"
                   }
                }
             ]
          }
       ]
    }

## Produktkatalog -- API öffnen -- PATCH /sn_tmf_api/catalogmanagement/productOffering/{ID} {#ariaid-title13}

Aktualisiert das angegebene Produktangebot.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOffering/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-PATCH-prodOffering-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des zu aktualisierenden Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktangebot \[sn_prd_pm_product_offering\] |
[Tabelle : 67. Pfad-Parameter]

{#tmf_prod_cat-PATCH-prodOffering-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 68. Abfrageparameter]

{#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb__entry__2}

| Name | Beschreibung |
|-|-|
| Kategorie | Liste der Kategorien, zu denen das Produkt gehört. Datentyp: Array von Objekten "category:" [ { "id": "String", "name": "String" } ] Tabelle: Kategorie \[sc_category\] |
| Kategorie.ID | Erforderlich, wenn verwendet wird categoryParameter. ID der Kategorie. Datentyp: Zeichenfolge Tabelle: Kategorie \[sc_category\] |
| category.name | Name der Kategorie. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| Kanal | Erforderlich. Kanäle, die für den Verkauf des Produktangebots verwendet werden sollen. Datentyp: Array von Objekten "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | Beschreibung des Kanals. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| Kanal.ID | Erforderlich. SYS_ID des Kanals. Datentyp: Zeichenfolge Tabelle: Verteilungskanal \[sn_prd_pm_distribution_channel\] |
| channel.name | Name des Kanals. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| Beschreibung | Erforderlich. Beschreibung des Produktangebots. Datentyp: Zeichenfolge |
| externalId | Externe ID des Produktangebots Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ID | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktangebot \[sn_prd_pm_product_offering\]". |
| internalId | Anfangsversion des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| InternalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| LastUpdate | Datum, an dem das Produktangebot zuletzt aktualisiert wurde. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 Standard: Leere Zeichenfolge |
| name | Erforderlich. Name des Produktangebots. Datentyp: Zeichenfolge |
| Produktmerkmal | Liste der Produktmerkmale. Datentyp: Array von Objekten "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 |
| ProductOfferingPreis | Preisinformationen für das Produktangebot. Datentyp: Array von Objekten "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| ProduktAngebotPreis.Preis | Preisinformationen für das Produktangebot. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| ProduktangebotPreis.Preis.taxIncludedAmount | Preisinformationen für das Produktangebot. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": "String" } |
| ProduktAngebotPreis.Preis.taxIncludedAmount.unit | Währungscode für den Produktangebotspreis. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProduktangebotPreis.Preis.taxIncludedAmount.value | Preis des Produktangebots einschließlich Steuer. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProductOfferingPreis.priceType | Typ des Produktangebotstyps. Erforderlich, wenn verwendet wird productOfferingPriceParameter. Gültige Werte: * Nicht wiederkehrend (einmalig) * Wiederkehrend {#tmf_prod_cat-PATCH-prodOffering-id__ul_g3z_bcj_4bc} Datentyp: Zeichenfolge |
| ProductOfferingTerm | Gültige Vertragslaufzeit für Das Produktangebot. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| Produktspezifikation | Erforderlich. Produktspezifikation für das Produkt. Datentyp: Objekt "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | Erforderlich. Initial_Version oder external_ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
| productSpecification.internalId | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| Produktspezifikation.Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProdSpecCharValueVerwenden | Merkmale des Produktangebots. Datentyp: Array von Objekten "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "validFor": {Object}, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | Datum und Uhrzeit der Gültigkeit des Merkmals. Datentyp: Objekt "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | Startdatum und -Uhrzeit, zu der das Merkmal gültig ist. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| prodSpecCharValueUse.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.name | Erforderlich. Name des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProdSpecCharValueVerwenden.validFor.endDateTime | Enddatum und -Uhrzeit des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| ProdSpecCharValueVerwenden.validFor.startDateTime | Startdatum und -Uhrzeit des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| ProdSpecCharValueUse.valueType | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ValidiertFür | Erforderlich. Datumsbereich, für den das Produktangebot gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Erforderlich. Enddatum und -Uhrzeit des Produktangebots. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| ValidFor.startDateTime | Erforderlich. Startdatum und -Uhrzeit des Produktangebots. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| Version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[Tabelle : 69. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-PATCH-prodOffering-id__table_vxh_xvf_hsb}

### Antworttext-Parameter (JSON) {#tmf_prod_cat-PATCH-prodOffering-id__section_cjr_vbj_4bc}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-PATCH-prodOffering-id__entry__100}{#tmf_prod_cat-PATCH-prodOffering-id__accept-RESTAPI}{#tmf_prod_cat-PATCH-prodOffering-id__content_type-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 70. Anforderungskopfzeilen.]

{#tmf_prod_cat-PATCH-prodOffering-id__entry__106}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 71. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-PATCH-prodOffering-id__entry__110}{#tmf_prod_cat-PATCH-prodOffering-id__entry-200-status-code}{#tmf_prod_cat-PATCH-prodOffering-id__entry-400-status-code}{#tmf_prod_cat-PATCH-prodOffering-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 72. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc__entry__2}

| Name | Beschreibung |
|-|-|
| Kategorie | Liste der Kategorien, zu denen das Produkt gehört. Datentyp: Array von Objekten "category:" [ { "id": "String", "name": "String" } ] |
| Kategorie.ID | ID der Kategorie. Datentyp: Zeichenfolge |
| category.name | Name der Kategorie. Datentyp: Zeichenfolge |
| Kanal | Kanäle, die für den Verkauf des Produktangebots verwendet werden sollen. Datentyp: Array von Objekten "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | Beschreibung des Kanals. Datentyp: Zeichenfolge |
| Kanal.ID | SYS_ID des Kanals. Datentyp: Zeichenfolge Tabelle: Verteilungskanal \[sn_prd_pm_distribution_channel\] |
| channel.name | Name des Kanals. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Produktangebots. Datentyp: Zeichenfolge |
| externalId | Externe ID des Produktangebots Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktangebot \[sn_prd_pm_product_offering\]". |
| internalId | Anfangsversion des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| InternalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| LastUpdate | Datum, an dem das Produktangebot zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| LiftcycleStatus | Aktueller Lebenszyklusstatus. Akzeptierte Werte: * Aktiv * Entwurf * Inaktiv {#tmf_prod_cat-PATCH-prodOffering-id__ul_lj5_gg4_4bc} Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Produktmerkmal | Liste der Produktmerkmale. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.Wert | Wert des Merkmals. Datentyp: Zeichenfolge |
| ProductOfferingPreis | Preisinformationen für das Produktangebot. Datentyp: Array von Objekten "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| ProduktAngebotPreis.Preis | Preisinformationen für das Produktangebot. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| ProduktangebotPreis.Preis.taxIncludedAmount | Preisinformationen für das Produktangebot. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": "String" } |
| ProduktAngebotPreis.Preis.taxIncludedAmount.unit | Währungscode für den Produktangebotspreis. Datentyp: Zeichenfolge |
| ProduktangebotPreis.Preis.taxIncludedAmount.value | Preis des Produktangebots einschließlich Steuer. Datentyp: Zeichenfolge |
| ProductOfferingPreis.priceType | Produktangebotspreistyp, einmalige oder wiederkehrende Zahlung. Mögliche Werte: * Nicht wiederkehrend (einmalig) * Wiederkehrend {#tmf_prod_cat-PATCH-prodOffering-id__ul_cts_ybj_4bc} Datentyp: Zeichenfolge |
| ProductOfferingTerm | Gültige Vertragslaufzeit für das Produktangebot. Datentyp: Zeichenfolge |
| Produktspezifikation | Produktspezifikation für das Produkt. Datentyp: Objekt "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalId | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| Produktspezifikation.Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProdSpecCharValueVerwenden | Produktangebotsmerkmale. Datentyp: Array von Objekten "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "validFor": {Object}, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | Datum und Uhrzeit der Gültigkeit des Merkmals. Datentyp: Objekt "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | Startdatum und -Uhrzeit, zu der das Merkmal gültig ist. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| prodSpecCharValueUse.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.name | Name des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProdSpecCharValueVerwenden.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueUse.valueType | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ValidiertFür | Datumsbereich, für den das Produktangebot gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum des Produktangebots. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum des Produktangebots. Datentyp: Zeichenfolge |
| Version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[ ]

{#tmf_prod_cat-PATCH-prodOffering-id__table_bts_ybj_4bc}  

### Curl-Anforderung

Das folgende Beispiel aktualisiert das Produktangebot mit der ID d6f8d995b020210235d85cced81c7eb mit den im Anforderungstext angegebenen Informationen.

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb" \ 
    --request PATCH\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'
    --data '{
      "name": "Offering 1",
      "displayName": "Offering 1",
      "description": "Offering 1 desc",
      "lastUpdate": "2024-04-01 16:05:19",
      "version": "Offering 1 EXTV",
      "validFor": {
        "startDateTime": "2028-02-29",
        "endDateTime": "2033-03-30"
      },
      "productOfferingTerm": "12_months",
      "productOfferingPrice": [
        {
          "priceType": "recurring",
          "price": {
            "taxIncludedAmount": {
              "unit": "USD",
              "value": 632.1483
            }
          }
        },
        {
          "priceType": "nonRecurring",
          "price": {
            "taxIncludedAmount": {
              "unit": "USD",
              "value": 1264.2966
            }
          }
        }
      ],
      "productSpecification": {
        "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
        "name": "SD-WAN Service Package",
        "internalVersion": "3"
      },
      "prodSpecCharValueUse": [
        {
          "name": "Bandwidth",
          "description": "Bandwidth",
          "valueType": "choice",
          "validFor": {
            "startDatetime": "2026-12-06 02:32:11"
          },
          "productSpecCharacteristicValue": [
            {
              "value": "1 Gbps",
              "validFor": {
                "startDateTime": ""
              }
            },
            {
              "value": "5 Gbps",
              "validFor": {
                "startDateTime": ""
              }
            },
            {
              "value": "2 Gbps",
              "validFor": {
                "startDateTime": ""
              }
            },
            {
              "value": "500 Mbps",
              "validFor": {
                "startDateTime": ""
              }
            }
          ],
          "productSpecification": {
            "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
            "name": "SD-WAN Service Package",
            "internalVersion": "3"
          }
        }
      ],
      "channel": [
        {
          "id": "e561aae4c3e710105252716b7d40dd8f",
          "name": "Web"
        }
      ],
      "category": [
        {
          "id": "13e305a143b631105029d1529ab8f267",
          "name": "SD-WAN_all_offers"
        }
      ]
    }'

Antworttext:

    {
      "result": {
        "name": "Offering 1",
        "displayName": "Offering 1",
        "description": "Offering 1 desc",
        "lastUpdate": "2024-04-01 16:05:19",
        "version": "Offering 1 EXTV",
        "validFor": {
          "startDateTime": "2028-02-29",
          "endDateTime": "2033-03-30"
        },
        "productOfferingTerm": "12_months",
        "productOfferingPrice": [
          {
            "priceType": "recurring",
            "price": {
              "taxIncludedAmount": {
                "unit": "USD",
                "value": 632.1483
              }
            }
          },
          {
            "priceType": "nonRecurring",
            "price": {
              "taxIncludedAmount": {
                "unit": "USD",
                "value": 1264.2966
              }
            }
          }
        ],
        "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "internalVersion": "3",
          "sys_id": "79fa17da775131108e191e599a5a997b",
          "version": "",
          "status": "published",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
        },
        "prodSpecCharValueUse": [
          {
            "name": "Bandwidth",
            "description": "Bandwidth",
            "valueType": "choice",
            "validFor": {
              "startDatetime": "2026-12-06 02:32:11"
            },
            "productSpecCharacteristicValue": [
              {
                "value": "1 Gbps",
                "validFor": {
                  "startDateTime": ""
                }
              },
              {
                "value": "5 Gbps",
                "validFor": {
                  "startDateTime": ""
                }
              },
              {
                "value": "2 Gbps",
                "validFor": {
                  "startDateTime": ""
                }
              },
              {
                "value": "500 Mbps",
                "validFor": {
                  "startDateTime": ""
                }
              }
            ],
            "productSpecification": {
              "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
              "name": "SD-WAN Service Package",
              "internalVersion": "3",
              "version": "",
              "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
            }
          }
        ],
        "channel": [
          {
            "id": "e561aae4c3e710105252716b7d40dd8f",
            "name": "Web"
          }
        ],
        "category": [
          {
            "id": "13e305a143b631105029d1529ab8f267",
            "name": "SD-WAN_all_offers"
          }
        ],
        "href": "/api/sn_tmf_api/catalogmanagement/productOffering/d6f8d9995b020210235d85cced81c7eb"
      }
    }

## Produktkatalog -- API öffnen -- PATCH /sn_tmf_api/catalogmanagement/productOfferingPrice/{ID} {#ariaid-title14}

Aktualisiert einen Preislistenpositionsdatensatz mit einer bestimmten sys_ID in der Preislistenposition \[sn_csm_pricing_price_list_line\].

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_order-PATCH-prodoffprce-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | Erforderlich. SYS_ID der abzurufenden Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
[Tabelle : 73. Pfad-Parameter]

{#tmf_prod_order-PATCH-prodoffprce-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 74. Abfrageparameter]

{#tmf_prod_order-PATCH-prodoffprce-id__id_abw_fvw_22c__entry__2}

| Name | Beschreibung |
|-|-|
| @Typ | Erforderlich. Typ der Preislistenposition. Immer ein Wert von `ProduktangebotPreis `. Datentyp: Zeichenfolge |
| externalId | Die externe ID der Preislistenposition. Datentyp: Zeichenfolge |
| IsBündel | Kennzeichnung, die angibt, ob die Preislistenposition Teil eines einzelnen Produkts oder eines Produktpakets ist. Gültige Werte: * Wahr: Preislistenposition ist Teil eines Pakets. * Falsch: Preislistenposition ist nicht Teil eines Pakets. Datentyp: Boolescher Wert Standard: Falsch |
| LastUpdate | Erforderlich. Datum, an dem die Preisposition zuletzt aktualisiert wurde. FORMAT: JJJJ-MM-TT Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Erforderlich. Aktueller Lebenszyklusstatus der Produktlistenposition. Gültige Werte: * aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge Standard: Entwurf |
| name | Erforderlich. Name für die Preislistenposition. Datentyp: Zeichenfolge |
| Preis | Erforderlich. Listenpreisdetails der Preislistenposition. Datentyp: Objekt "price": { "unit": "String", "value": "String" } |
| Preis.Einheit | Erforderlich. Währungscode der Preislistenposition. Beispiel: `USD `Oder `EUR `. Tabelle: Tabelle „Währung \[fx_currency\]". Datentyp: Zeichenfolge |
| Preis.Wert | Erforderlich. Wert des Preises. Datentyp: Zeichenfolge (dargestellt durch eine Zahl. Beispiel: `„800" `.) |
| priceList | Erforderlich. Preislisteninformationen, die der Preislistenposition zugeordnet sind. Datentyp: Objekt "priceList": { "id": "String", "name": "String", "@type": "String" } |
| Preisliste.ID | Erforderlich. SYS_ID der Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| priceList.name | Name der Preislistenposition. Datentyp: Zeichenfolge |
| Preisliste.@type | Der Typ der Preislistenposition. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Wert ist immer `Preisliste `. Datentyp: Zeichenfolge |
| Preistyp | Erforderlich. Filtern Sie die Preislistenposition nach der Preismethode des Produktangebots. Gültige Werte: * Wiederkehrend: Berechnen Sie wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit. Die Häufigkeit wird in festgelegt recurringChargePeriodTypeParameter. * One_time: Unterstützt einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge Standard: Wiederkehrend |
| productOffering | Erforderlich. Produktangebot der Preislistenposition. Datentyp: Objekt "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } |
| Produktangebot.ID | Erforderlich. SYS_ID des Produktangebots. Tabelle: Produktangebot \[sn_prd_pm_product_offering\] Datentyp: Zeichenfolge |
| productOffering.internalVersion | Interne Versionsnummer des Produktangebots. Datentyp: Zeichenfolge (dargestellt durch eine Zahl. Beispiel: `„1" `.) |
| productOffering.name | Name des Produktangebots. Datentyp: Zeichenfolge |
| RecurringChargePeriodType | Erforderlich, wenn priceTypeIst wiederkehrend. Zusagebedingungen, die bei der Erstellung des Produktangebots ausgewählt werden. Gültige Werte: * Jährlich * monatlich Datentyp: Zeichenfolge |
| Einheit der Messung | Erforderlich. Details zur Maßeinheit, die der Preislistenposition zugeordnet ist. Datentyp: Objekt "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } |
| EinheitenMessung.Betrag | Betrag der Maßeinheit. Datentyp: Zahl |
| EinheitenMessung.ID | Erforderlich. SYS_ID der Maßeinheit in der Tabelle „Preispositionsliste". Tabelle: Preislistenposition \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| EinheitenMessung.Einheiten | Typ der Maßeinheit, die der Preislistenposition zugeordnet ist. Beispiel: `Jeweils `Oder `Paket `. Datentyp: Zeichenfolge |
| ValidiertFür | Erforderlich. Die Dauer, für die die Preislistenposition gültig ist. Datentyp: Objekt "validFor": { "endDate": "String", "startDate": "String" } |
| ValidFor.endDate | Enddatum, für das die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.endDateTime | Enddatum und -Uhrzeit, für die die Preislistenposition gültig ist. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge (Glide_date) |
| ValidFor.startDate | Startdatum, für das die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.startDateTime | Startdatum und -Uhrzeit, für die die Preislistenposition gültig ist. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge (Glide_date) |
[Tabelle : 75. Anforderungstext-Parameter (XML oder JSON)]

{#tmf_prod_order-PATCH-prodoffprce-id__id_abw_fvw_22c}

### Header {#tmf_prod_order-PATCH-prodoffprce-id__section_q1h_tvw_22c}

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-PATCH-prodoffprce-id__table_r1h_tvw_22c__entry__2}{#tmf_prod_order-PATCH-prodoffprce-id__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 76. Anforderungskopfzeilen.]

{#tmf_prod_order-PATCH-prodoffprce-id__table_r1h_tvw_22c} {#tmf_prod_order-PATCH-prodoffprce-id__table_s1h_tvw_22c__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 77. Antwort-Header]

{#tmf_prod_order-PATCH-prodoffprce-id__table_s1h_tvw_22c}

### Statuscodes {#tmf_prod_order-PATCH-prodoffprce-id__section_t1h_tvw_22c}

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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-PATCH-prodoffprce-id__table_onp_pnw_22c__entry__2}{#tmf_prod_order-PATCH-prodoffprce-id__entry-200-status-code}{#tmf_prod_order-PATCH-prodoffprce-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-PATCH-prodoffprce-id__ul_qkg_2rv_22c} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 78. Statuscodes]

{#tmf_prod_order-PATCH-prodoffprce-id__table_onp_pnw_22c}

### Antworttext-Parameter (JSON oder XML) {#tmf_prod_order-PATCH-prodoffprce-id__section_q3r_rvw_22c}

{#tmf_prod_order-PATCH-prodoffprce-id__table_r3r_rvw_22c__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID der Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| href | URL zum Preislistenpositionsdatensatz in der Instanz. Datentyp: Zeichenfolge |
| LastUpdate | Datum und Uhrzeit der letzten Aktualisierung der Preislistenposition. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| ValidiertFür | Die Dauer, für die die Preislistenposition gültig ist. Datentyp: Objekt "validFor": { "endDate": "String", "startDate": "String" } |
| ValidFor.endDate | Enddatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.startDate | Startdatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| IsBündel | Kennzeichnung, die angibt, ob die Preislistenposition Teil eines einzelnen Produkts oder eines Produktpakets ist. Gültige Werte: * Wahr: Preislistenposition ist Teil eines Pakets. * Falsch: Preislistenposition ist nicht Teil eines Pakets. Datentyp: Boolescher Wert |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Preislistenposition. Gültige Werte: * Aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge |
| productOffering | Produktangebot, das der Preislistenposition zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } |
| Produktangebot.ID | SYS_ID des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.internalVersion | Interne Versionsnummer des Produktangebots. Beispiel: `PRDOF01024 `. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| Preistyp | Die Preisgestaltungsmethode des Produktangebots, das dieser Preislistenposition zugeordnet ist. Mögliche Werte: * Wiederkehrend: Berechnen Sie wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit. Der Wert von recurringChargePeriodTypeGibt die Häufigkeit der Ladung an. * One_time: Einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge |
| RecurringChargePeriodType | Die Periodizität oder Häufigkeit des Produktangebots, das dieser Preislistenposition zugeordnet ist. Gibt einen Häufigkeitstyp zurück, wenn priceTypeWurde auf festgelegt `Wiederkehrend `, Gibt andernfalls eine leere Zeichenfolge zurück. Mögliche Werte: * Jährlich * monatlich Datentyp: Zeichenfolge |
| Einheit der Messung | Details zur Maßeinheit, die der Preislistenposition zugeordnet ist. Datentyp: Objekt "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } |
| EinheitenMessung.Betrag | Betrag der Maßeinheit. Datentyp: Zahl |
| EinheitenMessung.ID | SYS_ID der Maßeinheit. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| EinheitenMessung.Einheiten | Typ der Maßeinheit, die der Preislistenposition zugeordnet ist. Beispiel: `Jahr `Oder `Paket `. Datentyp: Zeichenfolge |
| Preis | Listenpreisdetails der Preislistenposition. Datentyp: Objekt "price": { "units": "String", "value": "String" } |
| Preis.Einheiten | Währungscode des Preises. Beispiel: `USD `Oder `EUR `. Tabelle: Währung \[fx_currency\] Datentyp: Zeichenfolge |
| Preis.Wert | Wert des Preises. Datentyp: Zeichenfolge (dargestellt durch eine Zahl) |
| priceList | Preislisteninformationen, die der Preislistenposition zugeordnet sind. Datentyp: Objekt "priceList": { "id": "String", "name": "String", "@type": "String" } |
| Preisliste.ID | SYS_ID der Preisliste in der Preislistentabelle \[sn_csm_pricing_price_list\]. Datentyp: Zeichenfolge |
| priceList.name | Name der Preisliste. Datentyp: Zeichenfolge |
| Preisliste.@type | Der Typ der Preisliste. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Hat immer einen Wert von `Preisliste `. Datentyp: Zeichenfolge |
| @Typ | Immer ein Wert von `ProduktangebotPreis `. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Datentyp: Zeichenfolge |
| Staat | Der Status der Preisliste, die dieser Preislistenposition zugeordnet ist. Datentyp: Zeichenfolge |
| externalId | Die externe ID dieser Preislistenposition. Datentyp: Zeichenfolge |
[ ]

{#tmf_prod_order-PATCH-prodoffprce-id__table_r3r_rvw_22c}  

### Curl-Anforderung

Das folgende Beispiel aktualisiert die Daten, wann der Produktangebotspreis mit der ID 3ddd0... Ist gültig für.

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c" \
    --request patch\
    --user 'username':'password'
    --data {
      "validFor": {
        "endDateTime": "2024-06-25 15:15:58"
      }
    }

Antworttext:

    {
      "validFor": {
        "endDateTime": "2024-06-25 15:15:58"
      },
      "id": "994d5d364f8b5210f899f61d20ce0b7c",
      "name": "new Price list",
      "lastUpdate": "2025-01-16 00:15:32",
      "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c",
      "lifecycleStatus": "Draft"
    }

## Produktkatalog -- API öffnen -- PATCH /sn_tmf_api/catalogmanagement/Produktspezifikation/{ID} {#ariaid-title15}

Aktualisiert die angegebene Produktspezifikation.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/Produktspezifikation/{ID}

### Unterstützte Anforderungsparameter

{#tmf_prod_order-PATCH-productSpec-id__entry__2}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des zu aktualisierenden Produktangebots. Datentyp: Zeichenfolge Tabelle: Produktspezifikation \[sn_prd_pm_product_specification\] |
[Tabelle : 79. Pfad-Parameter]

{#tmf_prod_order-PATCH-productSpec-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 80. Abfrageparameter]

{#tmf_prod_order-PATCH-productSpec-id__entry__10}

| Name | Beschreibung |
|-|-|
| Beschreibung | Erforderlich. Beschreibung der Spezifikation. Datentyp: Zeichenfolge |
| externalId | Erforderlich. Externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| ID | Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| internalId | Erforderlich. Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| InternalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| IsBündel | Kennzeichnung, die angibt, ob productSpecificationStellt ein einzelnes Produkt oder ein Produktpaket dar. Gültige Werte: * Wahr: Die Produktspezifikation ist ein Produktpaket und enthält mehrere Produkte. * Falsch: Die Produktspezifikation enthält ein einzelnes Produkt. {#tmf_prod_order-PATCH-productSpec-id__ul_rry_rz4_4bc} Datentyp: Boolescher Wert Standard: Falsch |
| LastUpdate | Datum, an dem die Spezifikation zuletzt aktualisiert wurde. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Erforderlich. Name der Spezifikation. Datentyp: Zeichenfolge |
| Produktspezifikation | Spezifikationsmerkmal. Datentyp: Array von Objekten "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.name | Erforderlich. Name des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "validFor": {Object}, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | Datum und Uhrzeit der Gültigkeit des Merkmals. Datentyp: Objekt "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | Startdatum und -Uhrzeit, zu der das Merkmal gültig ist. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| Produktmerkmal.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Produktspezifikation.validFor.endDateTime | Enddatum und -Uhrzeit des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| Produktspezifikation.validFor.startDateTime | Startdatum und -Uhrzeit des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| ProduktSpecMerkmal.WertTyp | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung | Details der Beziehungen der Spezifikation zu anderen Produktspezifikationen. Datentyp: Array von Objekten "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] |
| productSpecificationRelationship.id | ID der zugehörigen Spezifikation. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.type | Erforderlich, wenn verwendet wird productSpecificationRelationshipParameter. Typ der Beziehung. Gültige Werte: * Pakete * Composite_of {#tmf_prod_order-PATCH-productSpec-id__ul_kjr_xnx_fsb} Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung.validFür | Datumsbereich, für den die Beziehung gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProductSpecificationRelationship.validFor.endDateTime | Enddatum der Beziehung. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.validFor.startDateTime | Startdatum der Beziehung. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| ResourceSpecification | Erforderlich. Details der Ressourcenspezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | Erforderlich. Anfangsversion oder externe ID der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalId | Anfangsversion der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalVersion | Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.name | Name der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Ressourcenspezifikation \[sn_prd_pm_resource_specification\] |
| ResourceSpecification.Version | Externe Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| Servicespezifikation | Liste der Servicespezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | Anfangsversion oder externe ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalId | Anfangsversion der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalVersion | Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Servicespezifikation \[sn_prd_pm_service_specification\] |
| ServiceSpecification.Version | Externe Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| ValidiertFür | Erforderlich. Datumsbereich, für den die Spezifikation gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum und -Uhrzeit der Spezifikation. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum und -Uhrzeit der Spezifikation. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
[Tabelle : 81. Anforderungstext-Parameter (JSON)]

### Header {#tmf_prod_order-PATCH-productSpec-id__section_rbn_cdj_4bc}

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-PATCH-productSpec-id__table_kqy_wgy_fsb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 82. Anforderungskopfzeilen.]

{#tmf_prod_order-PATCH-productSpec-id__table_kqy_wgy_fsb} {#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 83. Antwort-Header]

{#tmf_prod_order-PATCH-productSpec-id__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-PATCH-productSpec-id__table_nxj_ykz_gsb__entry__2}{#tmf_prod_order-PATCH-productSpec-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Leere Nutzlast. * Ungültige Nutzlast. Pflichtfeld fehlt: \<field name\> {#tmf_prod_order-PATCH-productSpec-id__ul_rys_1gy_fsb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 84. Statuscodes]

{#tmf_prod_order-PATCH-productSpec-id__table_nxj_ykz_gsb}

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Spezifikation. Datentyp: Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge |
| ID | Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| internalId | Erforderlich. Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| InternalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| LastUpdate | Datum, an dem die Spezifikation zuletzt aktualisiert wurde. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| name | Name der Spezifikation. Datentyp: Zeichenfolge |
| Produktspezifikation | Merkmale der Spezifikation. Datentyp: Array von Objekten "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "validFor": {Object}, "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor | Datum und Uhrzeit der Gültigkeit des Merkmals. Datentyp: Objekt "validFor": { "startDateTime": "String" } |
| prodSpecCharValueUse.productSpecCharacteristicValue.validFor.startDateTime | Startdatum und -Uhrzeit, zu der das Merkmal gültig ist. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00 |
| Produktmerkmal.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Produktspezifikation.validFor.endDateTime | Enddatum und -Uhrzeit des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| Produktspezifikation.validFor.startDateTime | Startdatum und -Uhrzeit des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| ProduktSpecMerkmal.WertTyp | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung | Die Beziehungen dieser Spezifikation zu anderen Produktspezifikationen. Datentyp: Array von Objekten "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": {Object} } ] |
| ProduktspezifikationRelationship.ID | SYS_ID der zugehörigen Spezifikation. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.type | Typ der Beziehung. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung.validFür | Datumsbereich, für den die Beziehung gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProductSpecificationRelationship.validFor.endDateTime | Enddatum und Typ der Beziehung. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.validFor.startDateTime | Startdatum und Typ der Beziehung. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| ResourceSpecification | Liste der Ressourcenspezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | Anfangsversion oder externe ID der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalId | Anfangsversion der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalVersion | Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.name | Name der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Ressourcenspezifikation \[sn_prd_pm_resource_specification\] |
| ResourceSpecification.Version | Externe Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| Servicespezifikation | Liste der Servicespezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | Anfangsversion oder externe ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalId | Anfangsversion der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalVersion | Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Servicespezifikation \[sn_prd_pm_service_specification\] |
| ServiceSpecification.Version | Externe Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| ValidiertFür | Datumsbereich, für den die Spezifikation gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum und -Uhrzeit der Spezifikation. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum und -Uhrzeit der Spezifikation. FORMAT: JJJJ-MM-TT 00:00:00. Datentyp: Zeichenfolge |
| Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
[ ]

{#tmf_prod_order-PATCH-productSpec-id__table_xj1_jcj_4bc}  

### Curl-Anforderung

Das folgende Beispiel aktualisiert die Produktspezifikations-ID d6f8d995b020210235d85cced81c7eb mit Informationen im Anforderungstext.

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/d6f8d9995b020210235d85cced81c7eb" \ 
    --request PATCH\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'
    --data '{
      "id": "1001",
      "name": "SD-WAN 0322 test",
      "description": "This is my product specification ...",
      "validFor": {
        "startDateTime": "2017-06-19T00:00",
        "endDateTime": "2018-01-13T00:00"
      },
      "productSpecCharacteristic": [
        {
          "name": "New characteristic",
          "description": "This product has new spec characteristic.",
          "valueType": "label",
          "validFor": {
            "startDateTime": "2017-06-20T00:00"
          }
        }
      ],
      "serviceSpecification": [
        {
          "id": "e23ae2d01bb420106ba59acf034bcb56",
          "name": "IP Sec Tunnel",
          "internalVersion": "2"
        }
      ],
      "productSpecificationRelationship": [
        {
          "id": "a6514bd3534560102f18ddeeff7b1247",
          "name": "SD-WAN Security",
          "internalVersion": "2",
          "type": "bundles",
          "validFor": {
            "startDateTime": "2017-06-16T00:00"
          }
        }
      ],
      "resourceSpecification": [
        {
          "id": "493fa60b536520103b6bddeeff7b12b6",
          "name": "Customer Premise SD-WAN Router"
        }
      ],
      "@type": "ProductSpecification"
    }

Antworttext:

    {
      "result": {
        "id": "1001",
        "name": "SD-WAN 0322 test",
        "description": "This is my product specification ...",
        "validFor": {
          "startDateTime": "2017-06-19T00:00",
          "endDateTime": "2018-01-13T00:00"
        },
        "productSpecCharacteristic": [
          {
            "name": "New characteristic",
            "description": "This product has new spec characteristic.",
            "valueType": "label",
            "validFor": {
              "startDateTime": "2017-06-20T00:00"
            }
          }
        ],
        "serviceSpecification": [
          {
            "id": "e23ae2d01bb420106ba59acf034bcb56",
            "name": "IP Sec Tunnel",
            "internalVersion": "2",
            "sys_id": "dd8354205b550210235d85cced81c7cd",
            "version": "",
            "status": "published",
            "internalId": "e23ae2d01bb420106ba59acf034bcb56"
          }
        ],
        "productSpecificationRelationship": [
          {
            "id": "a6514bd3534560102f18ddeeff7b1247",
            "name": "SD-WAN Security",
            "internalVersion": "2",
            "type": "bundles",
            "validFor": {
              "startDateTime": "2017-06-16T00:00"
            },
            "sys_id": "7a491dd3776301108b2a1e599a5a99d3",
            "version": "",
            "status": "published",
            "internalId": "a6514bd3534560102f18ddeeff7b1247"
          }
        ],
        "resourceSpecification": [
          {
            "id": "493fa60b536520103b6bddeeff7b12b6",
            "name": "Customer Premise SD-WAN Router",
            "sys_id": "493fa60b536520103b6bddeeff7b12b6",
            "internalVersion": "1",
            "version": "",
            "status": "published",
            "internalId": "493fa60b536520103b6bddeeff7b12b6"
          }
        ],
        "@type": "ProductSpecification",
        "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/3d140fe85be1c210235d85cced81c73a"
      }
    }

## Produktkatalog -- API öffnen -- /sn_tmf_api/catalogmanagement/catalog VERÖFFENTLICHEN {#ariaid-title16}

Erstellt einen Produktangebotskatalog.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/catalog

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-POST-catalog__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 85. Pfad-Parameter]

{#tmf_prod_cat-POST-catalog__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 86. Abfrageparameter]

{#tmf_prod_cat-POST-catalog__entry__10}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung des Produktangebotskatalogs. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| externalId | Eindeutiger Bezeichner für den Produktangebotskatalog aus dem externen System. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Erforderlich. Name des Produktangebotskatalogs. Datentyp: Zeichenfolge |
[Tabelle : 87. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-POST-catalog__table_ett_h3z_gsb__entry__2}{#tmf_prod_cat-POST-catalog__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-POST-catalog__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 88. Anforderungskopfzeilen.]

{#tmf_prod_cat-POST-catalog__table_ett_h3z_gsb} {#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 89. Antwort-Header]

{#tmf_prod_cat-POST-catalog__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-POST-catalog__table_fbw_k3z_gsb__entry__2}

| 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\> {#tmf_prod_cat-POST-catalog__ul_nc5_myx_fsb} |
[Tabelle : 90. Statuscodes]

{#tmf_prod_cat-POST-catalog__table_fbw_k3z_gsb}

### Antworttext-Parameter (JSON)

{#tmf_prod_cat-POST-catalog__entry__34}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung des Produktangebotskatalogs. Datentyp: Zeichenfolge |
| ID | SYS_ID des Produktangebotskatalogs Datentyp: Zeichenfolge Tabelle: Produktangebotskatalog \[sn_prd_pm_product_offering_catalog\] |
| name | Name des Produktangebotskatalogs. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

In diesem Beispiel wird ein Produktangebotskatalog erstellt.

    curl --location --request POST "https://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/catalog" \
    --header "Content-Type: application/json" \
    --data-raw '{
        "id": "testId",
        "name": "Catalog",
        "description": "Description"
    }'
    --user 'username':'password'

Antworttext:

    {
       "id": "45715d02c3510110bc0526083c40dd6b",
       "description": "Description",
       "name": "Catalog1"
    }

## Produktkatalog -- offene API -- POST /sn_tmf_api/catalogmanagement/productOffering {#ariaid-title17}

Erstellt ein Produktangebot.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOffering

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 91. Pfad-Parameter]

{#tmf_prod_cat-POST-prodoffering__table_o3n_mvf_hsb} {#tmf_prod_cat-POST-prodoffering__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 92. Abfrageparameter]

{#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb__entry__2}

| Name | Beschreibung |
|-|-|
| Kategorie | Liste der Kategorien, zu denen das Produkt gehört. Datentyp: Array von Objekten "category:" [ { "id": "String", "name": "String" } ] Tabelle: Kategorie \[sc_category\] |
| Kategorie.ID | Erforderlich, wenn verwendet wird categoryParameter. ID der Kategorie. Datentyp: Zeichenfolge |
| category.name | Name der Kategorie. Datentyp: Zeichenfolge |
| Kanal | Erforderlich. Kanäle, die für den Verkauf des Produktangebots verwendet werden sollen. Datentyp: Array von Objekten "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | Beschreibung des Kanals. Datentyp: Zeichenfolge |
| Kanal.ID | Erforderlich. SYS_ID des Kanals. Datentyp: Zeichenfolge Tabelle: Verteilungskanal \[sn_prd_pm_distribution_channel\] |
| channel.name | Name des Kanals. Datentyp: Zeichenfolge |
| Beschreibung | Erforderlich. Beschreibung des Produktangebots. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner für das Produktangebot aus dem externen System. Datentyp: Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge |
| ID | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Datentyp: Zeichenfolge Tabelle: In den Feldern „initial_Version" oder „external_ID" der Tabelle „Produktangebot \[sn_prd_pm_product_offering\]". |
| internalId | Anfangsversion des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| InternalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| LastUpdate | Datum, an dem das Produktangebot zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus. Gültige Werte: * Aktiv * Entwurf * Inaktiv {#tmf_prod_cat-POST-prodoffering__ul_lj5_gg4_4bc} Datentyp: Zeichenfolge |
| name | Erforderlich. Name des Produktangebots. Datentyp: Zeichenfolge |
| Produktmerkmal | Liste der Produktmerkmale. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.Wert | Wert des Merkmals. Datentyp: Zeichenfolge |
| ProductOfferingPreis | Preisinformationen für das Produktangebot. Datentyp: Array von Objekten "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| ProduktAngebotPreis.Preis | Preisinformationen für das Produktangebot. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| ProduktangebotPreis.Preis.taxIncludedAmount | Preisinformationen für das Produktangebot. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": "String" } |
| ProduktAngebotPreis.Preis.taxIncludedAmount.unit | Währungscode Für den Produktangebotspreis. Datentyp: Zeichenfolge |
| ProduktangebotPreis.Preis.taxIncludedAmount.value | Preis des Produktangebots einschließlich Steuer. Datentyp: Zeichenfolge |
| ProductOfferingPreis.priceType | Erforderlich, wenn verwendet wird productOfferingPriceParameter. Produktangebotspreistyp, einmalige oder wiederkehrende Zahlung. Gültige Werte: * Nicht wiederkehrend (einmalig) * Wiederkehrend Datentyp: Zeichenfolge |
| ProductOfferingTerm | Gültige Vertragslaufzeit für das Produktangebot. Datentyp: Zeichenfolge |
| Produktspezifikation | Erforderlich. Produktspezifikation für das Produkt. Datentyp: Objekt "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | Erforderlich. Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „externa_ID" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| productSpecification.internalId | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| Produktspezifikation.Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProdSpecCharValueVerwenden | Produktangebotsmerkmale. Datentyp: Array von Objekten "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | Erforderlich. Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Erforderlich. Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.name | Erforderlich. Name des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProdSpecCharValueVerwenden.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueUse.valueType | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ValidiertFür | Erforderlich. Datumsbereich, für den das Produktangebot gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum des Produktangebots. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum des Produktangebots. Datentyp: Zeichenfolge |
| Version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[Tabelle : 93. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-POST-prodoffering__table_vxh_xvf_hsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-POST-prodoffering__table_ett_h3z_gsb__entry__2}{#tmf_prod_cat-POST-prodoffering__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-POST-prodoffering__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 94. Anforderungskopfzeilen.]

{#tmf_prod_cat-POST-prodoffering__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 95. Antwort-Header]

{#tmf_prod_cat-POST-prodoffering__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-POST-prodoffering__table_fbw_k3z_gsb__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Leere Nutzlast. * Ungültige Nutzlast. Pflichtfeld fehlt: \<field name\> {#tmf_prod_cat-POST-prodoffering__ul_nc5_myx_fsb} |
[Tabelle : 96. Statuscodes]

{#tmf_prod_cat-POST-prodoffering__table_fbw_k3z_gsb}

### Antworttext-Parameter (JSON)

{#tmf_prod_cat-POST-prodoffering__entry__116}

| Name | Beschreibung |
|-|-|
| Kategorie | Liste der Kategorien, zu denen das Produkt gehört. Datentyp: Array von Objekten "category:" [ { "id": "String", "name": "String" } ] |
| Kategorie.ID | ID der Kategorie. Datentyp: Zeichenfolge |
| category.name | Name der Kategorie. Datentyp: Zeichenfolge |
| Kanal | Kanäle, die für den Verkauf des Produktangebots verwendet werden sollen. Datentyp: Array von Objekten "channel:" [ { "description": "String", "id": "String", "name": "String" } ] |
| channel.description | Beschreibung des Kanals. Datentyp: Zeichenfolge |
| Kanal.ID | SYS_ID des Kanals. Datentyp: Zeichenfolge Tabelle: Verteilungskanal \[sn_prd_pm_distribution_channel\] |
| channel.name | Name des Kanals. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Produktangebots. Datentyp: Zeichenfolge |
| externalId | Externe ID des Produktangebots Datentyp: Zeichenfolge Tabelle: Im Feld external_ID der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Erforderlich. Anfangsversion oder externe ID des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktangebot \[sn_prd_pm_product_offering\]". |
| internalId | Anfangsversion des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| InternalVersion | Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| LastUpdate | Datum, an dem das Produktangebot zuletzt aktualisiert wurde. Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus des Produktangebots. Gültige Werte: * Aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name des Produktangebots. Datentyp: Zeichenfolge |
| Produktmerkmal | Liste der Produktmerkmale. Datentyp: Array von Objekten "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.Wert | Wert des Merkmals. Datentyp: Zeichenfolge |
| ProductOfferingPreis | Preisinformationen für das Produktangebot. Datentyp: Array von Objekten "productOfferingPrice": [ { "price": {Object}, "priceType": "String" } ] |
| ProduktAngebotPreis.Preis | Preisinformationen für das Produktangebot. Datentyp: Objekt "price": { "taxIncludedAmount": {Object} } |
| ProduktangebotPreis.Preis.taxIncludedAmount | Preisinformationen für das Produktangebot. Datentyp: Objekt "taxIncludedAmount": { "unit": "String", "value": "String" } |
| ProduktAngebotPreis.Preis.taxIncludedAmount.unit | Währungscode für den Produktangebotspreis. Datentyp: Zeichenfolge |
| ProduktangebotPreis.Preis.taxIncludedAmount.value | Preis des Produktangebots einschließlich Steuer. Datentyp: Zeichenfolge |
| ProductOfferingPreis.priceType | Produktangebotspreistyp, einmalige oder wiederkehrende Zahlung. Mögliche Werte: * Nicht wiederkehrend (einmalig) * Wiederkehrend Datentyp: Zeichenfolge |
| ProductOfferingTerm | Gültige Vertragslaufzeit für das Produktangebot. Datentyp: Zeichenfolge |
| Produktspezifikation | Produktspezifikation für das Produkt. Datentyp: Objekt "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalId | Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| productSpecification.internalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| Produktspezifikation.Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
| ProdSpecCharValueVerwenden | Produktangebotsmerkmale. Datentyp: Array von Objekten "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue | Liste der möglichen Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| prodSpecCharValueUse.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| prodSpecCharValueUse.name | Name des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProdSpecCharValueVerwenden.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueVerwenden.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge |
| ProdSpecCharValueUse.valueType | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ValidiertFür | Datumsbereich, für den das Produktangebot gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum des Produktangebots. Datentyp: Zeichenfolge |
| ValidFor.startDateTime | Startdatum des Produktangebots. Datentyp: Zeichenfolge |
| Version | Externe Version des Produktangebots. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. |
[ ]

### Curl-Anforderung

In diesem Beispiel wird ein Produktangebot erstellt.

    curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering" \
    --header "Content-Type: application/json" \
    --data-raw '{
       "id": "d52a756b5bde0110235d85cced81c7ab",
       "name": "Premium SD-WAN Offering New",
       "version": "",
       "internalVersion": "2",
       "description": "Premium SD-WAN Offering",
       "lastUpdate": "2021-08-16 04:55:52",
       "validFor": {
          "startDateTime": "2021-08-05",
          "endDateTime": "2026-09-04"
       },
       "productOfferingTerm": "24_months",
       "productOfferingPrice": [
          {
             "priceType": "recurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "JPY",
                   "value": 984.0913488140197
                }
             }
          },
          {
             "priceType": "nonRecurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "GBP",
                   "value": 2434
                }
             }
          }
       ],
       "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "version": "v1",
          "internalVersion": "1",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
       },
       "prodSpecCharValueUse": [
          {
             "name": "Tenancy",
             "description": "Tenancy",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:04:24"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium (>50 sites)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance (50 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base (10 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "216663aa53702010cd6dddeeff7b12b5",
                "name": "SD-WAN Controller",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "216663aa53702010cd6dddeeff7b12b5"
             }
          },
          {
             "name": "CPE Id",
             "description": "CPE Id",
             "valueType": "single_line_text",
             "validFor": {
                "startDatetime": "2021-08-15 17:50:26"
             },
             "productSpecCharacteristicValue": [],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Routing",
             "description": "Routing",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:08:20"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "WAN Optimization",
             "description": "WAN Optimization",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:10:28"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "CPE Model",
             "description": "CPE Model",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:54"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "ISR",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "ASR",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Security Type",
             "description": "Security Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-23 12:51:13"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": "v1",
                "internalVersion": "1",
                "internalId": " a6514bd3534560102f18ddeeff7b1247"
             }
          },
          {
             "name": "CPE Type",
             "description": "CPE Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:16"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Physical",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Virtual",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": "v1",
                "internalVersion": "1",
                "internalId": " 39b627aa53702010cd6dddeeff7b1202"
             }
          }
       ],
       "channel": [
          {
             "id": "e561aae4c3e710105252716b7d40dd8f",
             "name": "Web"
          }
       ],
       "category": {
          "id": "c0ed043653b02010cd6dddeeff7b1277",
          "name": "SD-WAN"
       }
    }'
    --user 'username':'password'

Antworttext:

    {
       "id": "d52a756b5bde0110235d85cced81c7ab",
       "name": "Premium SD-WAN Offering New",
       "version": null,
       "internalVersion": "5",
       "description": "Premium SD-WAN Offering",
       "lastUpdate": "2021-08-16 04:55:52",
       "validFor": {
          "startDateTime": "2021-08-05",
          "endDateTime": "2026-09-04"
       },
       "productOfferingTerm": "24_months",
       "productOfferingPrice": [
          {
             "priceType": "recurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "JPY",
                   "value": 984.0913488140197
                }
             }
          },
          {
             "priceType": "nonRecurring",
             "price": {
                "taxIncludedAmount": {
                   "unit": "GBP",
                   "value": 2434
                }
             }
          }
       ],
       "productSpecification": {
          "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
          "name": "SD-WAN Service Package",
          "version": null,
          "internalVersion": "1",
          "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
       },
       "prodSpecCharValueUse": [
          {
             "name": "Tenancy",
             "description": "Tenancy",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:04:24"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium (>50 sites)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance (50 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base (10 site)",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "216663aa53702010cd6dddeeff7b12b5",
                "name": "SD-WAN Controller",
                "version": null,
                "internalVersion": "1",
                "internalId": "216663aa53702010cd6dddeeff7b12b5"
             }
          },
          {
             "name": "CPE Id",
             "description": "CPE Id",
             "valueType": "single_line_text",
             "validFor": {
                "startDatetime": "2021-08-15 17:50:26"
             },
             "productSpecCharacteristicValue": [],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Routing",
             "description": "Routing",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:08:20"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "WAN Optimization",
             "description": "WAN Optimization",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:10:28"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "CPE Model",
             "description": "CPE Model",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:54"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "ISR",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "ASR",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          },
          {
             "name": "Security Type",
             "description": "Security Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-23 12:51:13"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Base",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Premium",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Advance",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "a6514bd3534560102f18ddeeff7b1247",
                "name": "SD-WAN Security",
                "version": null,
                "internalVersion": "1",
                "internalId": "a6514bd3534560102f18ddeeff7b1247"
             }
          },
          {
             "name": "CPE Type",
             "description": "CPE Type",
             "valueType": "choice",
             "validFor": {
                "startDatetime": "2021-07-08 21:11:16"
             },
             "productSpecCharacteristicValue": [
                {
                   "value": "Physical",
                   "validFor": {
                      "startDateTime": ""
                   }
                },
                {
                   "value": "Virtual",
                   "validFor": {
                      "startDateTime": ""
                   }
                }
             ],
             "productSpecification": {
                "id": "39b627aa53702010cd6dddeeff7b1202",
                "name": "SD-WAN Edge Device",
                "version": null,
                "internalVersion": "1",
                "internalId": "39b627aa53702010cd6dddeeff7b1202"
             }
          }
       ],
       "channel": [
          {
             "id": "e561aae4c3e710105252716b7d40dd8f",
             "name": "Web"
          }
       ],
       "category": {
          "id": "c0ed043653b02010cd6dddeeff7b1277",
          "name": "SD-WAN"
       },
       "internalId": "fbc1c0a25b030110235d85cced81c724",
       "externalId": "d52a756b5bde0110235d85cced81c7ab"
    }

## Produktkatalog -- API öffnen -- /sn_tmf_api/catalogmanagement/productOfferingPrice VERÖFFENTLICHEN {#ariaid-title18}

Erstellt einen neuen Preislistenpositionsdatensatz in der Tabelle „Preislistenposition" \[sn_csm_pricing_price_list_line\].

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice

### Unterstützte Anforderungsparameter

{#tmf_prod_order-POST-prodofferprice__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 97. Pfad-Parameter]

{#tmf_prod_order-POST-prodofferprice__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 98. Abfrageparameter]

{#tmf_prod_order-POST-prodofferprice__id_b21_1nc_f2c__entry__2}

| Name | Beschreibung |
|-|-|
| @Typ | Erforderlich. Typ der Preislistenposition. Immer ein Wert von `ProduktangebotPreis `. Datentyp: Zeichenfolge |
| externalId | Die externe ID der Preislistenposition. Datentyp: Zeichenfolge |
| IsBündel | Kennzeichnung, die angibt, ob die Preislistenposition Teil eines einzelnen Produkts oder eines Produktpakets ist. Gültige Werte: * Wahr: Preislistenposition ist Teil eines Pakets. * Falsch: Preislistenposition ist nicht Teil eines Pakets. Datentyp: Boolescher Wert Standard: Falsch |
| LastUpdate | Erforderlich. Datum, an dem die Preisposition zuletzt aktualisiert wurde. FORMAT: JJJJ-MM-TT Datentyp: Zeichenfolge |
| Lebenszyklusstatus | Erforderlich. Aktueller Lebenszyklusstatus der Produktlistenposition. Gültige Werte: * aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge Standard: Entwurf |
| name | Erforderlich. Name für die Preislistenposition. Datentyp: Zeichenfolge |
| Preis | Erforderlich. Listenpreisdetails der Preislistenposition. Datentyp: Objekt "price": { "unit": "String", "value": "String" } |
| Preis.Einheit | Erforderlich. Währungscode der Preislistenposition. Beispiel: `USD `Oder `EUR `. Tabelle: Tabelle „Währung \[fx_currency\]". Datentyp: Zeichenfolge |
| Preis.Wert | Erforderlich. Wert des Preises. Datentyp: Zeichenfolge (dargestellt durch eine Zahl. Beispiel: `„800" `.) |
| priceList | Erforderlich. Preislisteninformationen, die der Preislistenposition zugeordnet sind. Datentyp: Objekt "priceList": { "id": "String", "name": "String", "@type": "String" } |
| Preisliste.ID | Erforderlich. SYS_ID der Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| priceList.name | Name der Preislistenposition. Datentyp: Zeichenfolge |
| Preisliste.@type | Der Typ der Preislistenposition. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Wert ist immer `Preisliste `. Datentyp: Zeichenfolge |
| Preistyp | Erforderlich. Filtern Sie die Preislistenposition nach der Preismethode des Produktangebots. Gültige Werte: * Wiederkehrend: Berechnen Sie wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit. Die Häufigkeit wird in festgelegt recurringChargePeriodTypeParameter. * One_time: Unterstützt einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge Standard: Wiederkehrend |
| productOffering | Erforderlich. Produktangebot der Preislistenposition. Datentyp: Objekt "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } |
| Produktangebot.ID | Erforderlich. SYS_ID des Produktangebots. Tabelle: Produktangebot \[sn_prd_pm_product_offering\] Datentyp: Zeichenfolge |
| productOffering.internalVersion | Interne Versionsnummer des Produktangebots. Datentyp: Zeichenfolge (dargestellt durch eine Zahl. Beispiel: `„1" `.) |
| productOffering.name | Name des Produktangebots. Datentyp: Zeichenfolge |
| RecurringChargePeriodType | Erforderlich, wenn priceTypeIst wiederkehrend. Zusagebedingungen, die bei der Erstellung des Produktangebots ausgewählt werden. Gültige Werte: * Jährlich * monatlich Datentyp: Zeichenfolge |
| Einheit der Messung | Erforderlich. Details zur Maßeinheit, die der Preislistenposition zugeordnet ist. Datentyp: Objekt "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } |
| EinheitenMessung.Betrag | Betrag der Maßeinheit. Datentyp: Zahl |
| EinheitenMessung.ID | Erforderlich. SYS_ID der Maßeinheit in der Tabelle „Preispositionsliste". Tabelle: Preislistenposition \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| EinheitenMessung.Einheiten | Typ der Maßeinheit, die der Preislistenposition zugeordnet ist. Beispiel: `Jeweils `Oder `Paket `. Datentyp: Zeichenfolge |
| ValidiertFür | Erforderlich. Die Dauer, für die die Preislistenposition gültig ist. Datentyp: Objekt "validFor": { "endDate": "String", "startDate": "String" } |
| ValidFor.endDate | Enddatum, für das die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.endDateTime | Enddatum und -Uhrzeit, für die die Preislistenposition gültig ist. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge (Glide_date) |
| ValidFor.startDate | Startdatum, für das die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.startDateTime | Startdatum und -Uhrzeit, für die die Preislistenposition gültig ist. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge (Glide_date) |
[Tabelle : 99. Anforderungstext-Parameter (XML oder JSON)]

{#tmf_prod_order-POST-prodofferprice__id_b21_1nc_f2c}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-POST-prodofferprice__entry__68}{#tmf_prod_order-POST-prodofferprice__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 100. Anforderungskopfzeilen.]

{#tmf_prod_order-POST-prodofferprice__entry__72}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 101. Antwort-Header]

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_order-POST-prodofferprice__table_onp_pnw_22c__entry__2}{#tmf_prod_order-POST-prodofferprice__entry-200-status-code}{#tmf_prod_order-POST-prodofferprice__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Ungültiger Pfadparameter * Ungültiger URI {#tmf_prod_order-POST-prodofferprice__ul_qkg_2rv_22c} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 102. Statuscodes]

{#tmf_prod_order-POST-prodofferprice__table_onp_pnw_22c}

### Antworttext-Parameter (JSON oder XML)

{#tmf_prod_order-POST-prodofferprice__entry__84}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID der Preislistenposition. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| href | URL zum Preislistenpositionsdatensatz in der Instanz. Datentyp: Zeichenfolge |
| LastUpdate | Datum und Uhrzeit der letzten Aktualisierung der Preislistenposition. Format: JJJJ-MM-TT HH:mm:ss Datentyp: Zeichenfolge |
| ValidiertFür | Die Dauer, für die die Preislistenposition gültig ist. Datentyp: Objekt "validFor": { "endDate": "String", "startDate": "String" } |
| ValidFor.endDate | Enddatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| ValidFor.startDate | Startdatum und -Uhrzeit, für die die Preislistenposition gültig ist. Datentyp: Zeichenfolge (Glide_date_time) |
| IsBündel | Kennzeichnung, die angibt, ob die Preislistenposition Teil eines einzelnen Produkts oder eines Produktpakets ist. Gültige Werte: * Wahr: Preislistenposition ist Teil eines Pakets. * Falsch: Preislistenposition ist nicht Teil eines Pakets. Datentyp: Boolescher Wert |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Preislistenposition. Gültige Werte: * Aktiv * Entwurf * Inaktiv Datentyp: Zeichenfolge |
| productOffering | Produktangebot, das der Preislistenposition zugeordnet ist. Datentyp: Objekt "productOffering": { "id": "String", "name": "String", "internalVersion": "String" } |
| Produktangebot.ID | SYS_ID des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.internalVersion | Interne Versionsnummer des Produktangebots. Beispiel: `PRDOF01024 `. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| productOffering.name | Name des Produktangebots. Befindet sich in der Tabelle „Produktangebot" \[sn_prd_pm_product_offering\]. Datentyp: Zeichenfolge |
| Preistyp | Die Preisgestaltungsmethode des Produktangebots, das dieser Preislistenposition zugeordnet ist. Mögliche Werte: * Wiederkehrend: Berechnen Sie wiederkehrende Preisbeträge mit einer angegebenen Häufigkeit. Der Wert von recurringChargePeriodTypeGibt die Häufigkeit der Ladung an. * One_time: Einmalige oder wiederkehrende Add-on-Gebühren und -Gebühren für ein Produktangebot. Datentyp: Zeichenfolge |
| RecurringChargePeriodType | Die Periodizität oder Häufigkeit des Produktangebots, das dieser Preislistenposition zugeordnet ist. Gibt einen Häufigkeitstyp zurück, wenn priceTypeWurde auf festgelegt `Wiederkehrend `, Gibt andernfalls eine leere Zeichenfolge zurück. Mögliche Werte: * Jährlich * monatlich Datentyp: Zeichenfolge |
| Einheit der Messung | Details zur Maßeinheit, die der Preislistenposition zugeordnet ist. Datentyp: Objekt "unitOfMeasure": { "id": "String", "amount": Number, "units": "String" } |
| EinheitenMessung.Betrag | Betrag der Maßeinheit. Datentyp: Zahl |
| EinheitenMessung.ID | SYS_ID der Maßeinheit. Tabelle: Preislistenpositionen \[sn_csm_pricing_price_list_line\] Datentyp: Zeichenfolge |
| EinheitenMessung.Einheiten | Typ der Maßeinheit, die der Preislistenposition zugeordnet ist. Beispiel: `Jahr `Oder `Paket `. Datentyp: Zeichenfolge |
| Preis | Listenpreisdetails der Preislistenposition. Datentyp: Objekt "price": { "units": "String", "value": "String" } |
| Preis.Einheiten | Währungscode des Preises. Beispiel: `USD `Oder `EUR `. Tabelle: Währung \[fx_currency\] Datentyp: Zeichenfolge |
| Preis.Wert | Wert des Preises. Datentyp: Zeichenfolge (dargestellt durch eine Zahl) |
| priceList | Preislisteninformationen, die der Preislistenposition zugeordnet sind. Datentyp: Objekt "priceList": { "id": "String", "name": "String", "@type": "String" } |
| Preisliste.ID | SYS_ID der Preisliste in der Preislistentabelle \[sn_csm_pricing_price_list\]. Datentyp: Zeichenfolge |
| priceList.name | Name der Preisliste. Datentyp: Zeichenfolge |
| Preisliste.@type | Der Typ der Preisliste. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Hat immer einen Wert von `Preisliste `. Datentyp: Zeichenfolge |
| @Typ | Immer ein Wert von `ProduktangebotPreis `. Bei Unterklassifizierung definiert dies den erweiterbaren Namen der Unterklasse. Datentyp: Zeichenfolge |
| Staat | Der Status der Preisliste, die dieser Preislistenposition zugeordnet ist. Datentyp: Zeichenfolge |
| externalId | Die externe ID dieser Preislistenposition. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel erstellt einen neuen Preislistenpositionsdatensatz gemäß den im Anforderungstext angegebenen Daten und fügt ihn in die Tabelle „Preislistenposition" \[sn_csm_pricing_price_list_line\] ein.

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOfferingPrice " \
    --request POST\
    --user 'username':'password'
    --data {
      "name": "new Price list",
      "validFor": {
        "startDateTime": "2024-05-28 15:15:58",
        "endDateTime": "2025-06-28 15:15:58"
      },
      "priceType": "recurring",
      "recurringChargePeriodType": "monthly",
      "lastUpdate": "2023-09-23 00:00:00",
      "isBundle": false,
      "lifecycleStatus": "Draft",
      "unitOfMeasure": {
        "id": "1eaa559953020110286eddeeff7b12c7",
        "amount": 1,
        "units": "Year"
      },
      "price": {
        "unit": "USD",
        "value": "800"
      },
      "productOffering": {
        "id": "9e3dd57a4fcb5210f899f61d20ce0bf2",
        "name": "Maintenance Fee",
        "internalVersion": "1"
      },
      "priceList": {
        "name": "new price list",
        "@type": "priceList"
      },
      "externalId": "test123",
      "@type": "ProductOfferingPrice"
    }

Antworttext. Diesem neuen Preislistenpositionsdatensatz wird eine eindeutige ID zugewiesen. Der Antworttext gibt diese Informationen zusammen mit einer URL an den neuen Datensatz mithilfe von zurück hrefAntwortparameter.

    {
      "name": "new Price list",
      "validFor": {
        "startDateTime": "2024-05-28 15:15:58",
        "endDateTime": "2025-06-28 15:15:58"
      },
      "priceType": "recurring",
      "recurringChargePeriodType": "monthly",
      "lastUpdate": "2023-09-23 00:00:00",
      "isBundle": false,
      "lifecycleStatus": "Draft",
      "unitOfMeasure": {
        "id": "1eaa559953020110286eddeeff7b12c7",
        "amount": 1,
        "units": "Year"
      },
      "price": {
        "unit": "USD",
        "value": "800"
      },
      "productOffering": {
        "id": "9e3dd57a4fcb5210f899f61d20ce0bf2",
        "name": "Maintenance Fee",
        "internalVersion": "1"
      },
      "priceList": {
        "id": "194d5d364f8b5210f899f61d20ce0b7a",
        "name": "new Price list",
        "@type": "priceList"
      },
      "externalId": "test123",
      "@type": "ProductOfferingPrice",
      "id": "994d5d364f8b5210f899f61d20ce0b7c",
      "state": "draft",
      "href": "/api/sn_tmf_api/catalogmanagement/productOfferingPrice/994d5d364f8b5210f899f61d20ce0b7c"
    }

## Produktkatalog -- API öffnen -- /sn_tmf_api/catalogmanagement/Produktspezifikation VERÖFFENTLICHEN {#ariaid-title19}

Erstellt eine Produktspezifikation.

### URL-Format

Standard-URL: /api/sn_tmf_api/catalogmanagement/Produktspezifikation

### Unterstützte Anforderungsparameter

{#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 103. Pfad-Parameter]

{#tmf_prod_cat-POST-prodspec__table_jdq_g51_jsb} {#tmf_prod_cat-POST-prodspec__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 104. Abfrageparameter]

{#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Erforderlich. Beschreibung der Spezifikation. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner für die Produktspezifikation aus dem externen System. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Erforderlich. Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: In der initial_Version oder external_ID der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| internalId | Erforderlich. Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| InternalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| LastUpdate | Datum, an dem die Spezifikation zuletzt aktualisiert wurde. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| name | Erforderlich. Name der Spezifikation. Datentyp: Zeichenfolge |
| Produktspezifikation | Spezifikationsmerkmal. Datentyp: Array von Objekten "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| productSpecCharacteristic.name | Erforderlich. Name des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.productSpecCharacteristicValue | Erforderlich. Mögliche Werte des Merkmals. Datentyp: Array "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | Erforderlich. Wert des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Produktspezifikation.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| Produktspezifikation.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| ProduktSpecMerkmal.WertTyp | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProduktspezifikationBeziehung | Die Beziehungen dieser Spezifikation zu anderen Produktspezifikationen. Datentyp: Array "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] |
| productSpecificationRelationship.id | ID der zugehörigen Spezifikation. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ProductSpecificationRelationship.type | Erforderlich, wenn verwendet wird productSpecificationRelationshipParameter. Typ der Beziehung. Gültige Werte: * Pakete * Composite_of {#tmf_prod_cat-POST-prodspec__ul_kjr_xnx_fsb} Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung.validFür | Datumsbereich, für den die Beziehung gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProductSpecificationRelationship.validFor.endDateTime | Enddatum der Beziehung. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| ProductSpecificationRelationship.validFor.startDateTime | Startdatum der Beziehung. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| ResourceSpecification | Erforderlich. Ressourcenspezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | Erforderlich. Anfangsversion oder externe ID der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalId | Anfangsversion der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalVersion | Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.name | Name der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Ressourcenspezifikation \[sn_prd_pm_resource_specification\] |
| ResourceSpecification.Version | Externe Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| Servicespezifikation | Liste der Servicespezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | Anfangsversion oder externe ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalId | Anfangsversion der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalVersion | Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Servicespezifikation \[sn_prd_pm_service_specification\] |
| ServiceSpecification.Version | Externe Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| ValidiertFür | Erforderlich. Datumsbereich, für den die Spezifikation gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum der Spezifikation. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| ValidFor.startDateTime | Startdatum der Spezifikation. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Standard: Leere Zeichenfolge |
| Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
[Tabelle : 105. Anforderungstext-Parameter (JSON)]

{#tmf_prod_cat-POST-prodspec__table_db1_q51_jsb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-POST-prodspec__table_ett_h3z_gsb__entry__2}{#tmf_prod_cat-POST-prodspec__accept-JSON-only-entry-RESTAPI}{#tmf_prod_cat-POST-prodspec__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 106. Anforderungskopfzeilen.]

{#tmf_prod_cat-POST-prodspec__table_ett_h3z_gsb} {#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 107. Antwort-Header]

{#tmf_prod_cat-POST-prodspec__table_tzy_thy_ksb}

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#tmf_prod_cat-POST-prodspec__table_fbw_k3z_gsb__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 201 | Anforderung erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Leere Nutzlast. * Ungültige Nutzlast. Pflichtfeld fehlt: \<field name\> {#tmf_prod_cat-POST-prodspec__ul_nc5_myx_fsb} |
[Tabelle : 108. Statuscodes]

{#tmf_prod_cat-POST-prodspec__table_fbw_k3z_gsb}

### Antworttext-Parameter (JSON)

{#tmf_prod_cat-POST-prodspec__entry__104}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Spezifikation. Datentyp: Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| ID | Anfangsversion oder externe ID der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" oder „external_ID" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| internalId | Erforderlich. Anfangsversion der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| InternalVersion | Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
| IsBündel | Kennzeichnung, die angibt, ob productSpecificationStellt ein einzelnes Produkt oder ein Produktpaket dar. Gültige Werte: * Wahr: Die Produktspezifikation ist ein Produktpaket und enthält mehrere Produkte. * Falsch: Die Produktspezifikation enthält ein einzelnes Produkt. {#tmf_prod_cat-POST-prodspec__ul_rry_rz4_4bc} Datentyp: Boolescher Wert Standard: Falsch |
| LastUpdate | Datum, an dem die Spezifikation zuletzt aktualisiert wurde. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| Lebenszyklusstatus | Aktueller Lebenszyklusstatus der Produktspezifikation. Mögliche Werte: * Aktiv * Entwurf * Inaktiv {#tmf_prod_cat-POST-prodspec__ul_lj5_gg4_4bc} Datentyp: Zeichenfolge Standard: Leere Zeichenfolge |
| name | Name der Spezifikation. Datentyp: Zeichenfolge |
| Produktspezifikation | Spezifikationsmerkmal. Datentyp: Array von Objekten "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": [Array], "validFor": {Object}, "valueType": "String" } ] |
| productSpecCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| productSpecCharacteristic.productSpecCharacteristicValue | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "productSpecCharacteristicValue": [ { "value": "String" } ] |
| productSpecCharacteristic.productSpecCharacteristicValue.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| Produktmerkmal.validFür | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Produktspezifikation.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| Produktspezifikation.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| ProduktSpecMerkmal.WertTyp | Werttyp des Merkmals, z. B. Auswahl oder E-Mail. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung | Die Beziehungen dieser Spezifikation zu anderen Produktspezifikationen. Datentyp: Array von Objekten "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ] |
| ProduktspezifikationRelationship.ID | SYS_ID der zugehörigen Spezifikation. Datentyp: Zeichenfolge |
| ProductSpecificationRelationship.type | Typ der Beziehung. Datentyp: Zeichenfolge |
| ProduktspezifikationBeziehung.validFür | Datumsbereich, für den die Beziehung gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ProductSpecificationRelationship.validFor.endDateTime | Enddatum der Beziehung. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| ProductSpecificationRelationship.validFor.startDateTime | Startdatum der Beziehung. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| ResourceSpecification | Liste der Ressourcenspezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| resourceSpecification.id | Anfangsversion oder externe ID der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalId | Anfangsversion der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.internalVersion | Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| resourceSpecification.name | Name der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Ressourcenspezifikation \[sn_prd_pm_resource_specification\] |
| ResourceSpecification.Version | Externe Version der Ressourcenspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Ressourcenspezifikation" \[sn_prd_pm_resource_specification\]. |
| Servicespezifikation | Liste der Servicespezifikationen im Zusammenhang mit dieser Produktspezifikation. Datentyp: Array von Objekten "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ] |
| serviceSpecification.id | Anfangsversion oder externe ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalId | Anfangsversion der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „initial_Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.internalVersion | Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „Version" der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| serviceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Servicespezifikation \[sn_prd_pm_service_specification\] |
| ServiceSpecification.Version | Externe Version der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Servicespezifikation" \[sn_prd_pm_service_specification\]. |
| ValidiertFür | Datumsbereich, für den die Spezifikation gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum der Spezifikation. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| ValidFor.startDateTime | Startdatum der Spezifikation. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. |
| Version | Externe Version der Produktspezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld external_Version der Tabelle „Produktspezifikation" \[sn_prd_pm_product_specification\]. |
[ ]

### Curl-Anforderung

In diesem Beispiel wird eine Produktspezifikation erstellt.

    curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification" \
    --header "Content-Type: application/json" \
    --data-raw '{
       "name": "SD-WAN My Device",
       "description": "This is my product specification ...",
       "internalId": "1c3c9a325bc34110235d85cced81c7d5",
       "isBundle": false,
       "lastUpdate": "2017-06-17T00:00",
       "validFor": {
          "startDateTime": "2017-06-19T00:00",
          "endDateTime": "2018-01-13T00:00"
       },
       "productSpecCharacteristic": [
          {
             "name": "New characteristic",
             "description": "This product has new spec characteristic.",
             "valueType": "label",
             "validFor": {
                "startDateTime": "2017-06-20T00:00"
             },
             "productSpecCharacteristicValue": [
                {
                   "validFor": {
                      "startDateTime": "2017-06-17T00:00"
                   },
                   "value": "TestValue"
                }
             ]
          }
       ],
       "serviceSpecification": [
          {
             "id": "e23ae2d01bb420106ba59acf034bcb56",
             "name": "IP Sec Tunnel"
          }
       ],
       "productSpecificationRelationship": [
          {
             "id": "a6514bd3534560102f18ddeeff7b1247",
             "name": "SD-WAN Security",
             "type": "bundles",
             "validFor": {
                "startDateTime": "2017-06-16T00:00"
             }
          }
       ],
       "resourceSpecification": [
          {
             "id": "493fa60b536520103b6bddeeff7b12b6",
             "name": "Customer Premise SD-WAN Router"
          }
       ]
    }'
    --user 'username':'password'

Antworttext.

    {
       "id": "exter123",
       "name": "SD-WAN My Device",
       "version": "v1",
       "internalId": "63c3d946745d8150f877ca57242ff918",
       "description": "This is my product specification ...",
       "isBundle": false,
       "lastUpdate": "2017-06-17T00:00",
       "validFor": {
          "startDateTime": "2017-06-19T00:00",
          "endDateTime": "2018-01-13T00:00"
       },
       "productSpecCharacteristic": [
          {
             "name": "New characteristic",
             "description": "This product has new spec characteristic.",
             "valueType": "choice",
             "validFor": {
                "startDateTime": "2017-06-20T00:00"
             },
             "productSpecCharacteristicValue": [
                {
                   "validFor": {
                      "startDateTime": "2017-06-17T00:00"
                   },
                   "value": "TestValue"
                }
             ]
          }
       ],
       "serviceSpecification": [
          {
             "id": "e23ae2d01bb420106ba59acf034bcb56",
             "name": "IP Sec Tunnel",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "e23ae2d01bb420106ba59acf034bcb56"
          }
       ],
       "productSpecificationRelationship": [
          {
             "id": "a6514bd3534560102f18ddeeff7b1247",
             "name": "SD-WAN Security",
             "type": "bundles",
             "validFor": {
                "startDateTime": "2017-06-16T00:00"
             },
             "valid": true,
             "version": "v1",
             "internalVersion": "1",
             "internalId": "a6514bd3534560102f18ddeeff7b1247"
          }
       ],
       "resourceSpecification": [
          {
             "id": "493fa60b536520103b6bddeeff7b12b6",
             "name": "Customer Premise SD-WAN Router",
             "version": "v1",
             "internalVersion": "1",
             "internalId": "493fa60b536520103b6bddeeff7b12b6"
          }
       ]
    }


