製品カタログオープン API

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：326分

    • 製品カタログオープン API は、製品カタログ、製品オファリング、および製品仕様を作成および取得するためのエンドポイントを提供します。

    この API を使用して、外部システムと Now Platformの間の製品カタログ情報を管理します。製品カタログオープン API は、TM フォーラムの製品カタログ管理 API REST 仕様のServiceNow®実装です。この実装は、 2021 年 4 月の TMF620 製品カタログ管理 API REST 仕様バージョン 4 に基づいています。

    この API は、 ServiceNow Store で利用可能で、 sn_tmf_api 名前空間で実行される Product Catalog Advanced アプリケーションに含まれています。

    呼び出し元ユーザーには、sn_prd_pm_adv.catalog_integrator ロールが必要です。

    この API は、次のテーブルのデータを作成および更新します。
    • 特性 [sn_prd_pm_characteristic]
    • 特性オプション [sn_prd_pm_characteristic_option]
    • 製品オファリング [sn_prd_pm_product_offering]
    • 製品オファリングカタログ [sn_prd_pm_product_offering_catalog]
    • 製品オファリング特性 [sn_prd_pm_product_offering_characteristic]
    • 製品仕様 [sn_prd_pm_product_specification]
    • 仕様関係 [sn_prd_pm_specification_relationship]

    製品カタログオープン API - DELETE /sn_tmf_api/catalogmanagement/productOffering/{id}

    指定された製品オファリングを削除します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id}

    サポートされている要求パラメーター

    表 : 1. パスパラメーター
    名前 説明
    ID 削除する製品オファリングのSys_id。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    表 : 2. クエリパラメーター
    名前 説明
    なし
    表 : 3. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 4. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。サポートされているタイプ: application/json または application/xml。

    デフォルト： application/json
    表 : 5. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 6. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。不正な要求タイプまたは不正な形式の要求が検出されました。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    メッセージ 製品仕様の削除またはアーカイブに関する失敗または成功メッセージ。

    cURL 要求

    次の例では、ID が d6f8d9995b020210235d85cced81c7eb の製品オファリングを削除します。

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

    応答本文は、削除成功メッセージを返します。

    "The product offering (d6f8d9995b020210235d85cced81c7eb) is successfully deleted"

    製品カタログオープン API - DELETE /sn_tmf_api/catalogmanagement/productOfferingPrice/{id}

    特定のsys_idの価格明細を非アクティブ化しますが、削除はしません。

    価格明細を非アクティブ状態に設定するには、この DELETE メソッドで価格明細の終了日を今日の日付に更新します。終了日が今日の日付より前の価格明細も非アクティブと見なされます。非アクティブな価格明細は、関連する GET メソッドでは取得できません。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id}

    サポートされている要求パラメーター

    表 : 7. パスパラメーター
    名前 説明
    ID 削除する価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    表 : 8. クエリパラメーター
    名前 説明
    なし
    表 : 9. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 10. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。サポートされているタイプ: application/json または application/xml。

    デフォルト： application/json
    表 : 11. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 12. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。
    考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    メッセージ 価格明細の非アクティブ化の成功または失敗に関するメッセージを含むステータスコード。

    cURL 要求

    次の例は、指定されたsys_id (994 日) の価格リストを正常に非アクティブ化または削除する方法を示しています。

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

    応答。応答は、正常な非アクティブ化の詳細を含む 200 ステータスコードを返します。

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

    製品カタログオープン API - DELETE /sn_tmf_api/catalogmanagement/productSpecification/{id}

    指定された製品仕様を削除またはアーカイブします。

    この DELETE メソッドを呼び出すと、製品仕様のステータスに応じて製品仕様が削除またはアーカイブされます。
    • ドラフト状況の製品仕様が正常に削除されました。応答は成功メッセージを返します。
    • アーカイブ済みステータスの製品仕様は削除できません。応答は、仕様が既にアーカイブされているというメッセージを返します。
    • ドラフト状況ではなく、他の製品仕様またはオファリングに関連付けられている製品仕様はアーカイブされますが、削除はされません。この応答は、仕様がアクティブ状況からアーカイブ済み状況に移行したことを示すメッセージを返します。
    • アクティブな製品仕様またはオファリングに関連付けられている製品仕様は削除できません。応答はエラーメッセージを返します。

    URL 形式

    デフォルト URL: /sn_tmf_api/catalogmanagement/productSpecification/{id}

    サポートされている要求パラメーター

    表 : 13. パスパラメーター
    名前 説明
    ID 削除する製品仕様のSys_id。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification]
    表 : 14. クエリパラメーター
    名前 説明
    なし
    表 : 15. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 16. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。サポートされているタイプ: application/json または application/xml。

    デフォルト： application/json
    表 : 17. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 18. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。不正な要求タイプまたは不正な形式の要求が検出されました。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    メッセージ 製品仕様の削除またはアーカイブに関する失敗または成功メッセージ。

    cURL 要求

    次の例では、ID が 8ef57fa05b308210235d85cced81c7d8 の製品仕様を削除します。

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

    応答本文は、成功または失敗のメッセージを返します。

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

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/catalog

    すべての製品オファリングカタログのリストを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog

    サポートされている要求パラメーター

    表 : 19. パスパラメーター
    名前 説明
    なし
    表 : 20. クエリパラメーター
    名前 説明
    フィールド 応答で返すフィールドのリスト。無効なフィールドは無視されます。

    データタイプ：文字列

    デフォルト:すべてのフィールドが返されます。
    補償限度額 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ：数値

    デフォルト値：20

    最大:100
    オフセット レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。

    データタイプ：数値

    デフォルト：0
    表 : 21. 要求本文パラメーター (JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 22. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 23. 応答ヘッダー
    ヘッダー 説明
    Content-Range ページネーションされた呼び出しで返されるコンテンツの範囲。

    たとえば、 offset=2 で limit=3 の場合、 Content-Range ヘッダーの値は アイテム 3 から 5 です。
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。
    リンク クエリ結果間を移動するための次のリンクが含まれています。
    • 第 1
    • 最終
    • 次へ
    • 前へ
    X-合計-数 ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 24. ステータスコード
    ステータスコード 説明
    200 要求が正常に処理されました。応答で返された完全なリソース (ページネーションなし)。
    206 応答で返された部分的なリソース (ページネーションあり)。
    400
    要求が正しくありません。考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。

    応答本文のパラメーター (JSON)

    名前 説明
    説明 製品オファリングカタログの説明。フィールドに値が含まれている場合にのみ返されます。

    データタイプ：文字列
    ID 製品オファリングカタログのSys_id。

    データタイプ：文字列

    テーブル:製品オファリングカタログ [sn_prd_pm_product_offering_catalog]
    ライフサイクルステータス 価格明細の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    名前 製品オファリングカタログの名前。

    データタイプ：文字列
    ステータス 製品オファリングカタログのステータス。

    可能な値:published

    データタイプ：文字列

    cURL 要求

    この例では、すべての製品オファリングカタログを取得します。

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

    応答本文。

    [
  {
    "id": "341f4953b71a9910ff00f203ae11a9bb",
    "name": "Home Internet Plan",
    "lifecycleStatus": "Active",
    "status": "published"
  },
  {
    "id": "69f494792b11525047f3f3e30391bf66",
    "name": "Chemical Processing",
    "lifecycleStatus": "Active",
    "description": " Catalog for Chemical Processing Industry",
    "status": "published"
  }
]

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/catalog/{id}

    製品オファリングカタログを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog/{id}

    サポートされている要求パラメーター

    表 : 25. パスパラメーター
    名前 説明
    ID 取得する製品オファリングカタログのSys_id。

    データタイプ：文字列

    テーブル:製品オファリングカタログ [sn_prd_pm_product_offering_catalog]
    表 : 26. クエリパラメーター
    名前 説明
    フィールド 応答で返すフィールドのリスト。無効なフィールドは無視されます。

    データタイプ：文字列

    デフォルト:すべてのフィールド。
    表 : 27. 要求本文パラメーター (JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 28. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 29. 応答ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 30. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400
    要求が正しくありません。次のいずれかの理由が考えられます。
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON)

    名前 説明
    説明 製品オファリングカタログの説明。

    データタイプ：文字列
    ID 製品オファリングカタログのSys_id。

    データタイプ：文字列

    テーブル:製品オファリングカタログ [sn_prd_pm_product_offering_catalog]
    ライフサイクルステータス 価格明細の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    名前 製品オファリングカタログの名前。

    データタイプ：文字列

    cURL 要求

    この例では、エンタープライズモバイルプランの製品オファリングカタログを取得します。

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

    応答本文。

    {
  "id": "69f494792b11525047f3f3e30391bf66",
  "name": "Chemical Processing",
  "lifecycleStatus": "Active",
  "description": " Catalog for Chemical Processing Industry"
}

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOffering

    指定されたフィルター設定に基づいて、すべての製品オファリングまたは製品オファリングのサブセットを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering

    サポートされている要求パラメーター

    表 : 31. パスパラメーター
    名前 説明
    なし
    表 : 32. クエリパラメーター
    名前 説明
    フィールド 応答で返すフィールドのリスト。無効なフィールドは無視されます。
    有効なフィールド:
    • category
    • チャネル
    • 説明
    • externalId
    • ID
    • internalId
    • internalVersion
    • 前回の更新
    • 名前
    • 製品特性
    • 製品オファリング価格
    • productOfferingTerm
    • 製品仕様
    • prodSpecCharValueUse
    • validFor
    • バージョン

    データタイプ：文字列

    デフォルト:すべてのフィールドが返されます。
    補償限度額 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ：数値

    デフォルト値：20

    最大:100
    オフセット レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。

    データタイプ：数値

    デフォルト：0
    仕様 製品仕様sys_idで製品オファリングをフィルタリングします。指定された製品仕様sys_idを持つ製品オファリングのみが応答に返されます。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification]
    状況 状態別に製品オファリングをフィルタリングします。指定されたステータスの製品オファリングのみが応答に返されます。

    有効な値：

    • アーカイブ済み
    • ドラフト
    • 公開済み
    • 廃止

    データタイプ：文字列
    表 : 33. 要求本文パラメーター (JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 34. 要求ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。
    表 : 35. 応答ヘッダー
    ヘッダー 説明
    Content-Range ページネーションされた呼び出しで返されるコンテンツの範囲。

    たとえば、 offset=2 で limit=3 の場合、 Content-Range ヘッダーの値は アイテム 3 から 5 です。
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。
    リンク クエリ結果間を移動するための次のリンクが含まれています。
    • 第 1
    • 最終
    • 次へ
    • 前へ
    X-合計-数 ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 36. ステータスコード
    ステータスコード 説明
    200 要求が正常に処理されました。応答で返された完全なリソース (ページネーションなし)。
    206 応答で返された部分的なリソース (ページネーションあり)。
    400
    要求が正しくありません。考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。

    応答本文のパラメーター

    名前 説明
    バンドルされたグループ製品オファリング 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。

    データタイプ:オブジェクトのアレイ

    "bundledGroupProductOffering": [
  {
    "bundledGroupProductOfferingOption": {Object},
    "bundledProductOffering": [Array],
    "id": "String",
    "name": "String"
  }
]
    bundledGroupProductOffering。bundledGroupProductOfferingOption 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。

    データタイプ：オブジェクト

    "bundledGroupProductOfferingOption": {
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。

    データタイプ：文字列
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。

    データタイプ：文字列
    bundledGroupProductOffering。バンドルされた製品オファリング バンドルに関連付けられた製品オファリングの子グループ。以下に指定されている bundledProductOffering と同じ形式です。

    データタイプ:オブジェクトのアレイ
    bundledGroupProductOffering。ID バンドルされたグループレコードのSys_id。親製品オファリングまたは親グループに複数のグループが含まれている場合に役立ちます。

    データタイプ：文字列

    テーブル:製品オファリング関係グループ [sn_prd_pm_product_offering_relationship_group]
    bundledGroupProductOffering。名前 子製品オファリングのグループの名前。

    データタイプ：文字列
    バンドルされた製品オファリング 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。

    データタイプ:オブジェクトのアレイ

    "bundledProductOffering": [
  {
    "bundledProductOfferingOption": {Object},
    "externalId": "String",
    "href": "String",
    "id": "String",
    "name": "String",
    "version": Number
  }
]
    bundledProductOffering。bundledProductOfferingOption 製品オファリングのデフォルト数や、製品オファリングの調達制約の上下など、製品バンドルオプション。

    データタイプ：オブジェクト

    "bundledProductOfferingOption": {
  "numberRelOfferDefault": "String",
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferDefault 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリング数の下限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。externalId 製品オファリング関係の外部 ID。

    製品オファリングの関係の詳細については、「 Create product offering relationships」を参照してください。

    データタイプ：文字列
    bundledProductOffering。HREF 関連する製品オファリングへの相対リンク。

    データタイプ：文字列
    bundledProductOffering。ID バンドルされた製品オファリングの Sys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    bundledProductOffering。名前 製品オファリングバンドルの名前。

    データタイプ：文字列
    bundledProductOffering。バージョン 製品オファリングのカタログバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    category 製品が属するカテゴリのリスト。

    データタイプ:オブジェクトのアレイ

    "category:" [
  {
    "id": "String",
    "name": "String"
  }
]
    category.id カテゴリの ID。

    データタイプ：文字列
    category.name カテゴリの名前。

    データタイプ：文字列
    チャネル 製品オファリングの販売に使用するチャネル。

    データタイプ:オブジェクトのアレイ

    "channel:" [
  {
    "description": "String",
    "id": "String",
    "name": "String"
  }
]
    channel.description チャネルの説明。

    データタイプ：文字列
    channel.id チャネルのSys_id。

    データタイプ：文字列

    テーブル:流通チャネル [sn_prd_pm_distribution_channel]
    channel.name チャネルの名前。

    データタイプ：文字列
    説明 製品オファリングの説明。

    データタイプ：文字列
    displayName 製品オファリングの表示名。

    データタイプ：文字列
    externalId 製品オファリングの外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [external_id] フィールド内。
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 必須。製品オファリングの初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [initial_version] または [external_id] フィールド内。
    internalId 製品オファリングレコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    internalVersion 製品オファリングのバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    isBundle 製品オファリングがバンドルかどうかを示すフラグ。
    可能な値：
    • true:製品オファリングはバンドルです。
    • false:単一の製品オファリング。

    データタイプ：ブール

    デフォルト値：false
    販売可能 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。
    可能な値：
    • true:個別に販売できます。
    • false:バンドルの一部としてのみ販売されます。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品オファリングが最後に更新された日付。

    データタイプ：文字列
    ライフサイクルステータス 製品オファリングの現在のライフサイクルステータス。

    有効な値：

    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 製品オファリングの名前。

    データタイプ：文字列
    prodSpecCharValueUse 製品オファリング特性。

    データタイプ:オブジェクトのアレイ

    "prodSpecCharValueUse": [
   {
      "description": "String",
      "name": "String",
      "productSpecCharacteristicValue": [Array],
      "validFor": {Object},
      "valueType": "String"
   }
]
    prodSpecCharValueUse。説明 特性の説明。

    データタイプ：文字列
    prodSpecCharValueUse。名前
    特性の名前。

    データタイプ：文字列
    prodSpecCharValueUse。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    prodSpecCharValueUse。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    prodSpecCharValueUse。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。値タイプ prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品特性 製品特性のリスト。

    データタイプ:オブジェクトのアレイ

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristicです。名前 特性の名前。

    データタイプ：文字列
    productCharacteristicです。値 特性の値。

    データタイプ：文字列
    製品オファリング特性 製品オファリングの特徴的な品質または特徴。特性は、モバイルプランランクなど、設計時 (カタログ作成) で固定される個別の値を取ることができます。これらの特性は通常、在庫レベルでは変更できません。

    製品オファリング特性の詳細については、「 Create product characteristics and characteristic options」を参照してください。

    データタイプ:オブジェクトのアレイ

    productOfferingCharacteristic": [  
  {
    "characteristicValueSpecification": [Array],
    "name": "String",
    "valueType": "String"
  }
]
    productOfferingCharacteristic。特性値仕様 製品オファリング特性に関連付けられた特性値のリスト。

    データタイプ:オブジェクトのアレイ

    "characteristicValueSpecification": [  
  { 
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "value": "String"
  }  
]
    productOfferingCharacteristic。characteristicValueSpecificationです。isDefault 関連付けられた特性値が関連付けられた特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値です。
    • false:デフォルト値ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。必須 関連する特性値が関連する特性に必須かどうかを示すフラグ。
    可能な値：
    • true:必須です。
    • false:必須ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。値 関連付けられた製品仕様特性に割り当てられた番号またはテキスト。
    たとえば、次のようになります：
    "characteristicValueSpecification": [
  {
    "value": "choice 1"
  },
  {
    "value": "choice 2"
  }
]

    データタイプ：文字列
    productOfferingCharacteristic。名前 関連付けられた製品オファリング特性の名前。

    データタイプ：文字列
    productOfferingCharacteristic。値タイプ productOfferingCharacteristic.​characteristicValueSpecification.​valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品オファリング価格 製品オファリングの価格情報。

    データタイプ:オブジェクトのアレイ

    "productOfferingPrice": [
  {
    "price": {Object},
    "priceType": "String"
  }
]
    productOfferingPrice です。価格 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "price": {
  "taxIncludedAmount": {Object}
}
    productOfferingPrice です。price.taxIncludedAmount 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "taxIncludedAmount": {
  "unit": "String",
  "value": "String"
}
    productOfferingPrice.price.taxIncludedAmount.unit 製品オファリング価格の通貨コード。

    データタイプ：文字列
    productOfferingPrice.price.taxIncludedAmount.value 税込み製品オファリングの価格。

    データタイプ：文字列
    productOfferingPrice です。価格タイプ 製品オファリング価格のタイプ、1 回限りの支払いまたは繰り返し支払い。
    可能な値：
    • 非繰り返し (1 回限り)
    • 繰り返し

    データタイプ：文字列
    productOfferingTerm 製品オファリングの有効な契約期間。

    データタイプ：文字列
    製品仕様 製品の製品仕様。

    データタイプ：オブジェクト

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "name": "String",
  "version": "String"
}
    productSpecificationです。ID 製品仕様レコードのSys_id。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalId 製品仕様レコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    productSpecificationです。名前 製品仕様の名前。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの名前フィールドにあります。
    productSpecificationです。バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    ステータス 製品オファリングのステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 製品オファリングが有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 製品オファリングの終了日。

    データタイプ：文字列

    形式:YYY-MM-DD
    validFor.startDateTime 製品オファリングの開始日。

    データタイプ：文字列

    形式:YYY-MM-DD
    バージョン 製品オファリングの外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。

    次のコード例では、最初の 2 つの製品オファリングレコードを取得します。

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering?limit=2" \
--header "Accept:application/json" \
--user 'username':'password'

    応答本文:

    [
  {
    "id": "7b012c4d41ea7910f8771355f12634a4",
    "externalId": "7b012c4d41ea7910f8771355f12634a4",
    "href": "/api/sn_tmf_api/catalogmanagement/productOffering/0361dd9fd0a63110f8770dbf976be16f",
    "name": "Ultimate internet - 1Gbps Plan",
    "displayName": "Ultimate internet - 1Gbps Plan",
    "description": "Ultimate internet - 1Gbps Plan",
    "isSellable": true,
    "lifecycleStatus": "Active",
    "isBundle": false,
    "lastUpdate": "2025-03-08 02:07:04",
    "version": "",
    "internalVersion": "1",
    "internalId": "0361dd9fd0a63110f8770dbf976be16f",
    "validFor": {
      "startDateTime": "2023-11-14",
      "endDateTime": ""
    },
    "productOfferingTerm": "not_applicable",
    "productOfferingPrice": [
      {
        "priceType": "recurring",
        "price": {
          "taxIncludedAmount": {
            "unit": "USD",
            "value": 0
          }
        }
      },
      {
        "priceType": "nonRecurring",
        "price": {
          "taxIncludedAmount": {
            "unit": "USD",
            "value": 0
          }
        }
      }
    ],
    "productOfferingCharacteristic": "",
    "bundledProductOffering": [],
    "bundledGroupProductOffering": [],
    "productSpecification": {},
    "prodSpecCharValueUse": [],
    "channel": "",
    "category": [
      {
        "id": "e6f0159fd0a63110f8770dbf976be18c",
        "name": "Internet"
      }
    ],
    "status": "published"
  },
  {
    "id": "313b917843235210a82ed6085bb8f2c7",
    "externalId": "313b917843235210a82ed6085bb8f2c7",
    "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11",
    "name": "Internet bundle",
    "displayName": "Internet bundle",
    "description": "Internet bundle",
    "isSellable": false,
    "lifecycleStatus": "Draft",
    "isBundle": true,
    "lastUpdate": "2025-04-09 15:59:09",
    "version": "",
    "internalVersion": "1",
    "internalId": "03c99cb53bf066509b48d69a04e45a11",
    "validFor": {
      "startDateTime": "2028-12-15",
      "endDateTime": "2034-01-14"
    },
    "productOfferingTerm": "not_applicable",
    "productOfferingPrice": [
      {
        "priceType": "recurring",
        "price": {
          "taxIncludedAmount": {
            "unit": "USD",
            "value": 0
          }
        }
      },
      {
        "priceType": "nonRecurring",
        "price": {
          "taxIncludedAmount": {
            "unit": "USD",
            "value": 0
          }
        }
      }
    ],
    "productOfferingCharacteristic": [
      {
        "name": "Connectivity need",
        "valueType": "choice",
        "characteristicValueSpecification": [
          {
            "isMandatory": false,
            "isDefault": false,
            "value": "When in use"
          }
        ]
      },
      {
        "name": "Firewall Security",
        "valueType": "choice",
        "characteristicValueSpecification": [
          {
            "isMandatory": false,
            "isDefault": true,
            "value": "Premium"
          }
        ]
      }
    ],
    "bundledProductOffering": [
      {
        "href": "/api/sn_tmf_api/catalogmanagement/productOffering/57c99cb53bf066509b48d69a04e45a17",
        "id": "0f61dd9fd0a63110f8770dbf976be168",
        "externalId": "EXT-123",
        "name": "Solana Sports streaming channel",
        "version": "1",
        "bundledProductOfferingOption": {
          "numberRelOfferDefault": "1",
          "numberRelOfferLowerLimit": "1",
          "numberRelOfferUpperLimit": "1"
        }
      }
    ],
    "bundledGroupProductOffering": [
      {
        "id": "063b957843235210a82ed6085bb8f205",
        "name": "Streaming Channel",
        "bundledProductOffering": [
          {
            "href": "/api/sn_tmf_api/catalogmanagement/productOffering/5bc99cb53bf066509b48d69a04e45a1a",
            "id": "62619d9fd0a63110f8770dbf976be180",
            "externalId": "EXT-345",
            "name": "Solana Movie streaming channel",
            "version": "1",
            "bundledProductOfferingOption": {
              "numberRelOfferDefault": "1",
              "numberRelOfferLowerLimit": "1",
              "numberRelOfferUpperLimit": "1"
            }
          }
        ],
        "bundledGroupProductOfferingOption": {
          "numberRelOfferLowerLimit": "1",
          "numberRelOfferUpperLimit": "1"
        }
      }
    ],
    "productSpecification": {
      "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
      "name": "SD-WAN Service Package",
      "version": "",
      "internalVersion": "3",
      "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
    },
    "prodSpecCharValueUse": [
      {
        "name": "Tenancy",
        "description": "Tenancy",
        "valueType": "choice",
        "validFor": {
          "startDatetime": "2025-02-27 21:04:24"
        },
        "productSpecCharacteristicValue": [
          {
            "value": "Premium (>50 sites)",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": false
          },
          {
            "value": "Base (10 site)",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": false
          }
        ],
        "productSpecification": {
          "id": "216663aa53702010cd6dddeeff7b12b5",
          "name": "SD-WAN Controller",
          "version": "",
          "internalVersion": "1",
          "internalId": "216663aa53702010cd6dddeeff7b12b5"
        }
      }
    ],
    "channel": [
      {
        "id": "58ad5522c3702010df4773ce3640ddb2",
        "name": "Agent Assist"
      }
    ],
    "category": [
      {
        "id": "13e305a143b631105029d1529ab8f267",
        "name": "SD-WAN_all_offers"
      }
    ],
    "status": "draft"
  }
]

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOffering/{id}

    製品オファリングを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id}

    サポートされている要求パラメーター

    表 : 37. パスパラメーター
    名前 説明
    ID 取得する製品オファリングの初期バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    表 : 38. クエリパラメーター
    名前 説明
    フィールド 応答で返すフィールドのリスト。無効なフィールドは無視されます。
    有効なフィールド:
    • category
    • チャネル
    • 説明
    • externalId
    • ID
    • internalId
    • internalVersion
    • 前回の更新
    • 名前
    • 製品特性
    • 製品オファリング価格
    • productOfferingTerm
    • 製品仕様
    • prodSpecCharValueUse
    • validFor
    • バージョン

    データタイプ：文字列

    デフォルト:すべてのフィールドが返されます。
    仕様 製品仕様sys_idで製品オファリングをフィルタリングします。指定された製品仕様sys_idを持つ製品オファリングのみが応答に返されます。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification]
    状況 状態別に製品オファリングをフィルタリングします。指定されたステータスの製品オファリングのみが応答に返されます。

    有効な値：

    • アーカイブ済み
    • ドラフト
    • 公開済み
    • 廃止

    データタイプ：文字列
    表 : 39. 要求本文のパラメーター
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 40. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 41. 応答ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 42. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400
    要求が正しくありません。考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター

    名前 説明
    バンドルされたグループ製品オファリング 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。

    データタイプ:オブジェクトのアレイ

    "bundledGroupProductOffering": [
  {
    "bundledGroupProductOfferingOption": {Object},
    "bundledProductOffering": [Array],
    "id": "String",
    "name": "String"
  }
]
    bundledGroupProductOffering。bundledGroupProductOfferingOption 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。

    データタイプ：オブジェクト

    "bundledGroupProductOfferingOption": {
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。

    データタイプ：文字列
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。

    データタイプ：文字列
    bundledGroupProductOffering。バンドルされた製品オファリング バンドルに関連付けられた製品オファリングの子グループ。以下に指定されている bundledProductOffering と同じ形式です。

    データタイプ:オブジェクトのアレイ
    bundledGroupProductOffering。ID バンドルされたグループレコードのSys_id。親製品オファリングまたは親グループに複数のグループが含まれている場合に役立ちます。

    データタイプ：文字列

    テーブル:製品オファリング関係グループ [sn_prd_pm_product_offering_relationship_group]
    bundledGroupProductOffering。名前 子製品オファリングのグループの名前。

    データタイプ：文字列
    バンドルされた製品オファリング 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。

    データタイプ:オブジェクトのアレイ

    "bundledProductOffering": [
  {
    "bundledProductOfferingOption": {Object},
    "externalId": "String",
    "href": "String",
    "id": "String",
    "name": "String",
    "version": Number
  }
]
    bundledProductOffering。bundledProductOfferingOption 製品オファリングのデフォルト数や、製品オファリングの調達制約の上下など、製品バンドルオプション。

    データタイプ：オブジェクト

    "bundledProductOfferingOption": {
  "numberRelOfferDefault": "String",
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferDefault 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリング数の下限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。externalId 製品オファリング関係の外部 ID。

    製品オファリングの関係の詳細については、「 Create product offering relationships」を参照してください。

    データタイプ：文字列
    bundledProductOffering。HREF 関連する製品オファリングへの相対リンク。

    データタイプ：文字列
    bundledProductOffering。ID バンドルされた製品オファリングの Sys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    bundledProductOffering。名前 製品オファリングバンドルの名前。

    データタイプ：文字列
    bundledProductOffering。バージョン 製品オファリングのカタログバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    category 製品が属するカテゴリのリスト。

    データタイプ:オブジェクトのアレイ

    "category:" [
  {
    "id": "String",
    "name": "String"
  }
]
    category.id カテゴリのSys_id。

    データタイプ：文字列
    category.name カテゴリの名前。

    データタイプ：文字列
    チャネル 製品オファリングの販売に使用するチャネル。

    データタイプ:オブジェクトのアレイ

    "channel:" [
  {
    "description": "String",
    "id": "String",
    "name": "String"
  }
]
    チャネル。説明 チャネルの説明。

    データタイプ：文字列
    channel.id チャネルのSys_id。

    データタイプ：文字列

    テーブル:流通チャネル [sn_prd_pm_distribution_channel]
    channel.name チャネルの名前。

    データタイプ：文字列
    説明 製品オファリングの説明。

    データタイプ：文字列
    displayName 製品オファリングの表示名。

    データタイプ：文字列
    externalId 製品オファリングの外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [external_id] フィールド内。
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 必須。製品オファリングの初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [initial_version] または [external_id] フィールド内。
    internalId 製品オファリングレコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    internalVersion 製品オファリングのバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    isBundle 製品オファリングがバンドルかどうかを示すフラグ。
    可能な値：
    • true:製品オファリングはバンドルです。
    • false:単一の製品オファリング。

    データタイプ：ブール

    デフォルト値：false
    販売可能 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。
    可能な値：
    • true:個別に販売できます。
    • false:バンドルの一部としてのみ販売されます。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品オファリングが最後に更新された日付。

    データタイプ：文字列

    形式:YYYY-MM-DD HH-mm-SS
    ライフサイクルステータス 製品オファリングの現在のライフサイクルステータス。
    可能な値：
    • アクティブ
    • 非アクティブ
    • ドラフト

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 製品オファリングの名前。

    データタイプ：文字列
    prodSpecCharValueUse 製品オファリング特性。

    データタイプ:オブジェクトのアレイ

    "prodSpecCharValueUse": [
   {
      "description": "String",
      "name": "String",
      "productSpecCharacteristicValue": [Array],
      "validFor": {Object},
      "valueType": "String"
   }
]
    prodSpecCharValueUse。説明 特性の説明。

    データタイプ：文字列
    prodSpecCharValueUse。名前
    特性の名前。

    データタイプ：文字列
    prodSpecCharValueUse。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    prodSpecCharValueUse。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    prodSpecCharValueUse。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。値タイプ prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品特性 製品特性のリスト。

    データタイプ:オブジェクトのアレイ

    "productCharacteristic": [
   {
      "name": "String",
      "value": "String"
   }
]
    productCharacteristicです。名前 特性の名前。

    データタイプ：文字列
    productCharacteristicです。値 特性の値。

    データタイプ：文字列
    製品オファリング特性 製品オファリングの特徴的な品質または特徴。特性は、モバイルプランランクなど、設計時 (カタログ作成) で固定される個別の値を取ることができます。これらの特性は通常、在庫レベルでは変更できません。

    製品オファリング特性の詳細については、「 Create product characteristics and characteristic options」を参照してください。

    データタイプ:オブジェクトのアレイ

    productOfferingCharacteristic": [  
  {
    "characteristicValueSpecification": [Array],
    "name": "String",
    "valueType": "String"
  }
]
    productOfferingCharacteristic。特性値仕様 製品オファリング特性に関連付けられた特性値のリスト。

    データタイプ:オブジェクトのアレイ

    "characteristicValueSpecification": [  
  { 
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "value": "String"
  }  
]
    productOfferingCharacteristic。characteristicValueSpecificationです。isDefault 関連付けられた特性値が関連付けられた特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値です。
    • false:デフォルト値ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。必須 関連する特性値が関連する特性に必須かどうかを示すフラグ。
    可能な値：
    • true:必須です。
    • false:必須ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。値 関連付けられた製品仕様特性に割り当てられた番号またはテキスト。
    たとえば、次のようになります：
    "characteristicValueSpecification": [
  {
    "value": "choice 1"
  },
  {
    "value": "choice 2"
  }
]

    データタイプ：文字列
    productOfferingCharacteristic。名前 関連付けられた製品オファリング特性の名前。

    データタイプ：文字列
    productOfferingCharacteristic。値タイプ productOfferingCharacteristic.​characteristicValueSpecification.​valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品オファリング価格 製品オファリングの価格情報。

    データタイプ:オブジェクトのアレイ

    "productOfferingPrice": [
   {
      "price": {Object},
      "priceType": "String"
   }
]
    productOfferingPrice です。価格 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "price": {
   "taxIncludedAmount": {Object}
}
    productOfferingPrice です。価格。税込み金額 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "taxIncludedAmount": {
   "unit": "String",
   "value": "String"
}
    productOfferingPrice です。価格。taxIncludedAmount です。単位 製品オファリング価格の通貨コード。

    データタイプ：文字列
    productOfferingPrice です。価格。taxIncludedAmount です。値 税込み製品オファリングの価格。

    データタイプ：文字列
    productOfferingPrice です。価格タイプ 製品オファリングの価格が 1 回限りの支払いか繰り返し支払いかを識別します。
    可能な値：
    • 非繰り返し
    • 繰り返し

    データタイプ：文字列
    productOfferingTerm 製品オファリングの有効な契約期間。

    データタイプ：文字列
    製品仕様 製品の製品仕様。

    データタイプ：オブジェクト

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "name": "String",
  "version": "String"
}
    productSpecificationです。ID 製品仕様レコードのSys_id。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalId 製品仕様レコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    productSpecificationです。名前 製品仕様の名前。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの名前フィールドにあります。
    productSpecificationです。バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    ステータス 製品オファリングのステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 製品オファリングが有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 製品オファリングの終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD
    validFor。startDateTime 製品オファリングの開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD
    バージョン 製品オファリングの外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。

    cURL 要求

    この例では、指定された製品オファリングを取得します。

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

    応答本文:

    {
  "id": "313b917843235210a82ed6085bb8f2c7",
  "externalId": "313b917843235210a82ed6085bb8f2c7",
  "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11",
  "name": "Internet bundle",
  "displayName": "Internet bundle",
  "description": "Internet bundle",
  "isSellable": false,
  "lifecycleStatus": "Draft",
  "isBundle": true,
  "lastUpdate": "2025-04-09 15:59:09",
  "version": "",
  "internalVersion": "1",
  "internalId": "03c99cb53bf066509b48d69a04e45a11",
  "validFor": {
    "startDateTime": "2028-12-15",
    "endDateTime": "2034-01-14"
  },
  "productOfferingTerm": "not_applicable",
  "productOfferingPrice": [
    {
      "priceType": "recurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": 0
        }
      }
    },
    {
      "priceType": "nonRecurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": 0
        }
      }
    }
  ],
  "productOfferingCharacteristic": [
    {
      "name": "Connectivity need",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "isMandatory": false,
          "isDefault": false,
          "value": "When in use"
        }
      ]
    },
    {
      "name": "Firewall Security",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "isMandatory": false,
          "isDefault": true,
          "value": "Premium"
        }
      ]
    }
  ],
  "bundledProductOffering": [
    {
      "href": "/api/sn_tmf_api/catalogmanagement/productOffering/57c99cb53bf066509b48d69a04e45a17",
      "id": "0f61dd9fd0a63110f8770dbf976be168",
      "externalId": "EXT-123",
      "name": "Solana Sports streaming channel",
      "version": "1",
      "bundledProductOfferingOption": {
        "numberRelOfferDefault": "1",
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "bundledGroupProductOffering": [
    {
      "id": "063b957843235210a82ed6085bb8f205",
      "name": "Streaming Channel",
      "bundledProductOffering": [
        {
          "href": "/api/sn_tmf_api/catalogmanagement/productOffering/5bc99cb53bf066509b48d69a04e45a1a",
          "id": "62619d9fd0a63110f8770dbf976be180",
          "externalId": "EXT-345",
          "name": "Solana Movie streaming channel",
          "version": "1",
          "bundledProductOfferingOption": {
            "numberRelOfferDefault": "1",
            "numberRelOfferLowerLimit": "1",
            "numberRelOfferUpperLimit": "1"
          }
        }
      ],
      "bundledGroupProductOfferingOption": {
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "productSpecification": {
    "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
    "name": "SD-WAN Service Package",
    "version": "",
    "internalVersion": "3",
    "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
  },
  "prodSpecCharValueUse": [
    {
      "name": "Tenancy",
      "description": "Tenancy",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2025-02-27 21:04:24"
      },
      "productSpecCharacteristicValue": [
        {
          "value": "Premium (>50 sites)",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "Base (10 site)",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "productSpecification": {
        "id": "216663aa53702010cd6dddeeff7b12b5",
        "name": "SD-WAN Controller",
        "version": "",
        "internalVersion": "1",
        "internalId": "216663aa53702010cd6dddeeff7b12b5"
      }
    }
  ],
  "channel": [
    {
      "id": "58ad5522c3702010df4773ce3640ddb2",
      "name": "Agent Assist"
    }
  ],
  "category": [
    {
      "id": "13e305a143b631105029d1529ab8f267",
      "name": "SD-WAN_all_offers"
    }
  ],
  "status": "draft"
}

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOfferingPrice

    インスタンス内のすべての価格明細レコードを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice

    サポートされている要求パラメーター

    表 : 43. パスパラメーター
    名前 説明
    なし
    表 : 44. クエリパラメーター
    名前 説明
    前回の更新 価格ラインが最後に更新された日付で結果をフィルタリングします。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    名前 指定された価格リストの名前に属する価格明細をフィルタリングします。

    テーブル:価格リスト [sn_csm_pricing_price_list]

    データタイプ：文字列
    price.value 特定の表示価格値で結果をフィルタリングします。

    データタイプ：文字列
    priceList.id 結果をフィルタリングして、指定されたsys_idの価格リストのみを返します。

    テーブル:価格リスト [sn_csm_pricing_price_list]

    データタイプ：文字列
    価格タイプ 製品オファリングの価格設定方法で結果をフィルタリングします。
    有効な値：
    • recurring:企業は指定された頻度で繰り返し価格設定金額を請求できます。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。

    データタイプ：文字列
    productOffering。ID 製品オファリングのsys_idで価格明細をフィルタリングします。

    テーブル:製品オファリング [sn_prd_pm_product_offering]

    データタイプ：文字列
    unitOfMeasureです。ID 測定単位のsys_idで価格明細をフィルタリングします。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    validFor。終了日時 指定された終了日時で価格明細をフィルタリングします。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    validFor。startDateTime 指定された開始日時で価格明細をフィルタリングします。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    表 : 45. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 46. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 47. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 48. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。
    考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    @type 価格明細のタイプ。常に ProductOfferingPrice の値です。

    データタイプ：文字列
    href インスタンス内の価格明細レコードへの URL。

    データタイプ：文字列
    ID 価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    isBundle 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。
    有効な値：
    • true:価格明細はバンドルの一部です。
    • false:価格明細はバンドルの一部ではありません。

    データタイプ：ブール
    前回の更新 価格明細が最後に更新された日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    ライフサイクルステータス 価格明細の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    価格 価格明細の表示価格の詳細。

    データタイプ：オブジェクト

    "price": {
  "units": "String",
  "value": "String"
}
    price.units 価格の通貨コード。たとえば、 USD や EUR などです。

    テーブル:通貨 [fx_currency]

    データタイプ：文字列
    price.value 価格の値。

    データタイプ:文字列 (数値で表される)
    priceList 価格明細に関連付けられた価格リスト情報。

    データタイプ：オブジェクト

    "priceList": {
  "id": "String",
  "name": "String",
  "@type": "String"
}
    priceList.id 価格リスト [sn_csm_pricing_price_list] テーブルの価格リストのSys_id。

    データタイプ：文字列
    priceList.name 価格リストの名前。

    データタイプ：文字列
    priceList.@type 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に priceList の値を持ちます。

    データタイプ：文字列
    価格タイプ この価格明細に関連付けられている製品オファリングの価格設定方法。
    可能な値：
    • recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。

    データタイプ：文字列
    productOffering 価格明細に関連付けられている製品オファリング。

    データタイプ：オブジェクト

    "productOffering": {
  "id": "String",
  "name": "String",
  "internalVersion": "String"
}
    productOffering.id 製品オファリングのSys_id。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。internalVersion 製品オファリングの内部バージョン番号。たとえば、 PRDOF01024 などです。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。名前 製品オファリングの名前。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    recurringChargePeriodType この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返しに設定されている場合は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。
    可能な値：
    • 年次
    • 月次

    データタイプ：文字列
    測定単位 価格明細に関連付けられた測定単位に関する詳細。

    データタイプ：オブジェクト

    "unitOfMeasure": {
  "id": "String",
  "amount": Number,
  "units": "String"
}
    unitOfMeasure.amount 測定単位の金額。

    データタイプ：数値
    unitOfMeasure.id 測定単位のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    unitOfMeasureです。単位 価格明細に関連付けられた測定単位のタイプ。たとえば、 年 や バンドルなどです。

    データタイプ：文字列
    validFor 価格明細が有効な期間。

    データタイプ：オブジェクト

    "validFor": {
  "endDate": "String",
  "startDate": "String"
}
    validFor.endDate 価格明細が有効な終了日時。

    データタイプ:文字列 (glide_date_time)
    validFor.startDate 価格明細が有効な開始日時。

    データタイプ:文字列 (glide_date_time)

    cURL 要求

    次の例では、インスタンスに存在する 2 つの価格明細をすべて返します。

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

    応答本文。

    [
  {
    "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"
  }
]

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productOfferingPrice/{id}

    特定の価格明細に関する詳細を取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id}

    サポートされている要求パラメーター

    表 : 49. パスパラメーター
    名前 説明
    ID 必須。取得する価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    表 : 50. クエリパラメーター
    名前 説明
    前回の更新 価格ラインが最後に更新された日付で結果をフィルタリングします。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    名前 指定された価格リストの名前に属する価格明細をフィルタリングします。

    テーブル:価格リスト [sn_csm_pricing_price_list]

    データタイプ：文字列
    price.value 特定の表示価格値で結果をフィルタリングします。

    データタイプ：文字列
    priceList.id 結果をフィルタリングして、指定されたsys_idの価格リストのみを返します。

    テーブル:価格リスト [sn_csm_pricing_price_list]

    データタイプ：文字列
    価格タイプ 製品オファリングの価格設定方法で結果をフィルタリングします。
    有効な値：
    • recurring:企業は指定された頻度で繰り返し価格設定金額を請求できます。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。

    データタイプ：文字列
    productOffering。ID 製品オファリングのsys_idで価格明細をフィルタリングします。

    テーブル:製品オファリング [sn_prd_pm_product_offering]

    データタイプ：文字列
    unitOfMeasureです。ID 測定単位のsys_idで価格明細をフィルタリングします。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    validFor。終了日時 指定された終了日時で価格明細をフィルタリングします。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    validFor。startDateTime 指定された開始日時で価格明細をフィルタリングします。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    表 : 51. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 52. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 53. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 54. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。
    考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    @type 価格明細のタイプ。常に ProductOfferingPrice の値です。

    データタイプ：文字列
    href インスタンス内の価格明細レコードへの URL。

    データタイプ：文字列
    ID 価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    isBundle 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。
    有効な値：
    • true:価格明細はバンドルの一部です。
    • false:価格明細はバンドルの一部ではありません。

    データタイプ：ブール
    前回の更新 価格明細が最後に更新された日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    ライフサイクルステータス 価格明細の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    価格 価格明細の表示価格の詳細。

    データタイプ：オブジェクト

    "price": {
  "units": "String",
  "value": "String"
}
    price.units 価格の通貨コード。たとえば、 USD や EUR などです。

    テーブル:通貨 [fx_currency]

    データタイプ：文字列
    price.value 価格の値。

    データタイプ:文字列 (数値で表される)
    priceList 価格明細に関連付けられた価格リスト情報。

    データタイプ：オブジェクト

    "priceList": {
  "id": "String",
  "name": "String",
  "@type": "String"
}
    priceList.id 価格リスト [sn_csm_pricing_price_list] テーブルの価格リストのSys_id。

    データタイプ：文字列
    priceList.name 価格リストの名前。

    データタイプ：文字列
    priceList.@type 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に priceList の値を持ちます。

    データタイプ：文字列
    価格タイプ この価格明細に関連付けられている製品オファリングの価格設定方法。
    可能な値：
    • recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。

    データタイプ：文字列
    productOffering 価格明細に関連付けられている製品オファリング。

    データタイプ：オブジェクト

    "productOffering": {
  "id": "String",
  "name": "String",
  "internalVersion": "String"
}
    productOffering.id 製品オファリングのSys_id。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。internalVersion 製品オファリングの内部バージョン番号。たとえば、 PRDOF01024 などです。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。名前 製品オファリングの名前。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    recurringChargePeriodType この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返しに設定されている場合は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。
    可能な値：
    • 年次
    • 月次

    データタイプ：文字列
    測定単位 価格明細に関連付けられた測定単位に関する詳細。

    データタイプ：オブジェクト

    "unitOfMeasure": {
  "id": "String",
  "amount": Number,
  "units": "String"
}
    unitOfMeasure.amount 測定単位の金額。

    データタイプ：数値
    unitOfMeasure.id 測定単位のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    unitOfMeasureです。単位 価格明細に関連付けられた測定単位のタイプ。たとえば、 年 や バンドルなどです。

    データタイプ：文字列
    validFor 価格明細が有効な期間。

    データタイプ：オブジェクト

    "validFor": {
  "endDate": "String",
  "startDate": "String"
}
    validFor.endDate 価格明細が有効な終了日時。

    データタイプ:文字列 (glide_date_time)
    validFor.startDate 価格明細が有効な開始日時。

    データタイプ:文字列 (glide_date_time)

    cURL 要求

    次の例は、ID dfb7ec60...

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

    応答。

    {
  "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"
}

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productSpecification

    すべての製品仕様レコードを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification

    サポートされている要求パラメーター

    表 : 55. パスパラメーター
    名前 説明
    なし
    表 : 56. クエリパラメーター
    名前 説明
    フィールド 応答で返すフィールドのリスト。無効なフィールドは無視されます。
    有効なフィールド:
    • 説明
    • externalId
    • ID
    • internalId
    • internalVersion
    • 前回の更新
    • 名前
    • 製品仕様特性
    • 製品仕様関係
    • リソース仕様
    • サービス仕様
    • validFor
    • バージョン

    データタイプ：文字列

    デフォルト:すべてのフィールドが返されます。
    補償限度額 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ：数値

    デフォルト値：20

    最大:100
    オフセット レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。

    データタイプ：数値

    デフォルト：0
    状況 製品仕様をステータス別にフィルタリングします。指定されたステータスの製品仕様のみが応答に返されます。

    許容値:

    • アーカイブ済み
    • ドラフト
    • 公開済み
    • 廃止

    データタイプ：文字列
    表 : 57. 要求本文パラメーター (JSON)
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 58. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。サポートされているタイプ: application/json または application/xml。

    デフォルト： application/json
    表 : 59. 応答ヘッダー
    ヘッダー 説明
    Content-Range ページネーションされた呼び出しで返されるコンテンツの範囲。

    たとえば、 offset=2 で limit=3 の場合、 Content-Range ヘッダーの値は アイテム 3 から 5 です。
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。
    リンク クエリ結果間を移動するための次のリンクが含まれています。
    • 第 1
    • 最終
    • 次へ
    • 前へ
    X-合計-数 ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 60. ステータスコード
    ステータスコード 説明
    200 要求が正常に処理されました。応答で返された完全なリソース (ページネーションなし)。
    206 応答で返された部分的なリソース (ページネーションあり)。
    400
    要求が正しくありません。考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。

    応答本文のパラメーター (JSON)

    名前 説明
    説明 仕様の説明。

    データタイプ：文字列
    displayName 製品仕様の表示名。

    データタイプ：文字列
    externalId
    製品仕様の外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのexternal_idフィールド内。
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの sys_id または external_id フィールド内。
    internalId
    製品仕様のSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version フィールド内。
    internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのバージョンフィールドにあります。
    isBundle productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。
    可能な値：
    • true:製品仕様は製品バンドルであり、複数の製品が含まれています。
    • false:製品仕様には単一の製品が含まれています。
    データタイプ：ブール
    前回の更新 仕様が最後に更新された日付。

    データタイプ：文字列
    ライフサイクルステータス 製品仕様の現在のライフサイクル状況。

    可能な値：

    • アクティブ
    • 非アクティブ
    • ドラフト

    データタイプ：文字列
    名前 仕様の名前。

    データタイプ：文字列
    製品仕様特性 製品仕様特性。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristic": [
  {
    "description": "String",
    "name": "String",
    "productSpecCharacteristicValue": [Array],
    "validFor": {Object},
    "valueType": "String"
  }
]
    productSpecCharacteristic。説明 特性の説明。

    データタイプ：文字列
    productSpecCharacteristic。名前 特性の名前。

    データタイプ：文字列
    productSpecCharacteristic。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    productSpecCharacteristic。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    productSpecCharacteristic。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。値タイプ 特性の値タイプ (選択肢やメールなど)。

    データタイプ：文字列
    製品仕様関係 この仕様と他の製品仕様との関係。

    データタイプ:オブジェクトのアレイ

    "productSpecificationRelationship": [
  {
    "compatibilityRelationshipType": "String",
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "prodSpecRelationshipOption": {Object},
    "type": "String",
    "validFor": {Object},
    "version": "String"
]
    productSpecificationRelationship です。compatibilityRelationshipType 製品仕様の必要な値の互換性関係タイプ。

    互換性関係の詳細については、「 」を参照してください。

    テーブル:互換性 [sn_compt_mgmt_compatibles]
    productSpecificationRelationship.id 関連仕様のSys_id。

    データタイプ：文字列
    productSpecificationRelationship です。internalId 製品仕様関係のSys_id (内部 ID)。

    データタイプ：文字列
    productSpecificationRelationship です。internalVersion 製品仕様関係のバージョン。

    データタイプ：文字列
    productSpecificationRelationship です。名前 製品仕様関係の名前。

    データタイプ：文字列
    productSpecificationRelationship です。製品仕様リレーションシップオプション 製品仕様関係のカーディナリティ。

    データタイプ：オブジェクト

    "prodSpecRelationshipOption": {
  "numberSpecRelDefault": "String",
  "numberSpecRelLowerLimit": "String",
  "numberSpecRelUpperLimit": "String"
}
    productSpecificationRelationship です。prodSpecRelationshipOption です。numberSpecRelDefault 製品仕様のデフォルト値。

    データタイプ：文字列
    productSpecificationRelationship です。prodSpecRelationshipOption です。numberSpecRelLowerLimit 購入可能な注文の最小数。

    データタイプ：文字列
    productSpecificationRelationship です。prodSpecRelationshipOption です。数値仕様 RelUpperLimit 購入可能な注文の最大数。

    データタイプ：文字列
    productSpecificationRelationship です。タイプ 製品仕様関係のタイプ。

    データタイプ：文字列
    productSpecificationRelationship です。validFor 製品仕様関係が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecificationRelationship です。validFor。終了日時 関係の終了日。

    データタイプ：文字列
    productSpecificationRelationship です。validFor。startDateTime 関係の開始日。

    データタイプ：文字列
    productSpecificationRelationship です。バージョン 製品仕様関係のバージョン。

    データタイプ：文字列
    リソース仕様 この製品仕様に関連するリソース仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "resourceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    resourceSpecification です。ID リソース仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの sys_id または external_id フィールド。
    resourceSpecification です。internalId リソース仕様レコードの初期バージョン (sys_id)。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの initial_version フィールド内。
    resourceSpecification です。internalVersion リソース仕様のバージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルのバージョンフィールド内。
    resourceSpecification です。名前 リソース仕様の名前。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification]
    resourceSpecification です。バージョン リソース仕様の外部バージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの external_version フィールド内。
    サービス仕様 この製品仕様に関連するサービス仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "serviceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    serviceSpecification です。ID サービス仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの sys_id または external_id フィールド内。
    serviceSpecification です。internalId サービス仕様の初期バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの initial_version フィールド内。
    serviceSpecification です。internalVersion サービス仕様のバージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルのバージョンフィールド内。
    serviceSpecification です。名前 サービス仕様の名前。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification]
    serviceSpecification です。バージョン サービス仕様の外部バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの external_version フィールド内。
    ステータス 製品仕様のステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 仕様が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 仕様の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD
    validFor。startDateTime 仕様の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD
    バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの external_version フィールド内。

    cURL 要求

    この例では、最初の 2 つの製品仕様レコードを取得します。

    curl --location --request GET "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification?limit=2" \
--header "Accept:application/json" \
--user 'username':'password'

    応答本文:

    [
  {
    "id": "0435b48a742e4a10f877468e695efa3c",
    "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/0435b48a742e4a10f877468e695efa3c",
    "name": "Managed PoS PS",
    "displayName": "Managed PoS PS",
    "version": "",
    "internalVersion": "1",
    "internalId": "0435b48a742e4a10f877468e695efa3c",
    "description": "Managed PoS PS",
    "lastUpdate": "2032-09-26 20:07:12",
    "lifecycleStatus": "Active",
    "isBundle": false,
    "validFor": {
      "startDateTime": "2032-09-26",
      "endDateTime": ""
    },
    "serviceSpecification": [],
    "productSpecificationRelationship": [],
    "resourceSpecification": [],
    "productSpecCharacteristic": [
      {
        "productSpecCharacteristicValue": [
          {
            "value": "4",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": true
          },
          {
            "value": "2",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": true
          },
          {
            "value": "1",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": true
          }
        ],
        "name": "Number of POS Terminals",
        "description": "Number of POS Terminals",
        "valueType": "choice",
        "validFor": {
          "startDatetime": "2024-05-31 21:43:14"
        }
      },
      {
        "productSpecCharacteristicValue": [
          {
            "value": "Gold",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": true
          },
          {
            "value": "Bronze",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": true
          },
          {
            "value": "Silver",
            "validFor": {
              "startDateTime": ""
            },
            "isDefault": false,
            "isMandatory": true
          }
        ],
        "name": "Managed Service Level",
        "description": "Managed Service Level",
        "valueType": "choice",
        "validFor": {
          "startDatetime": "2024-05-31 21:15:24"
        }
      }
    ],
    "status": "published"
  },
  {
    "id": "1a0936f840102610f87798b149fd435d",
    "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/1a0936f840102610f87798b149fd435d",
    "name": "Wi-Fi Configuration Setup Service PS",
    "displayName": "Wi-Fi Configuration Setup Service PS",
    "version": "",
    "internalVersion": "1",
    "internalId": "1a0936f840102610f87798b149fd435d",
    "description": "Wi-Fi Configuration Setup Service PS",
    "lastUpdate": "2025-03-13 21:01:14",
    "lifecycleStatus": "Active",
    "isBundle": false,
    "validFor": {
      "startDateTime": "2025-03-12",
      "endDateTime": ""
    },
    "serviceSpecification": [],
    "productSpecificationRelationship": [],
    "resourceSpecification": [],
    "productSpecCharacteristic": [],
    "status": "published"
  }
]

    製品カタログオープン API - GET /sn_tmf_api/catalogmanagement/productSpecification/{id}

    指定された製品仕様レコードを取得します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification/{id}

    サポートされている要求パラメーター

    表 : 61. パスパラメーター
    名前 説明
    ID 取得する製品仕様のSys_idバージョンまたは初期バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの [sys_id] または [initial_version] フィールド内。
    表 : 62. クエリパラメーター
    名前 説明
    フィールド 応答で返すフィールドのリスト。無効なフィールドは無視されます。
    有効なフィールド:
    • 説明
    • externalId
    • ID
    • internalId
    • internalVersion
    • 前回の更新
    • 名前
    • 製品仕様特性
    • 製品仕様関係
    • リソース仕様
    • サービス仕様
    • validFor
    • バージョン

    データタイプ：文字列

    デフォルト:すべてのフィールドが返されます。
    状況 製品仕様をステータス別にフィルタリングします。指定されたステータスの製品仕様のみが応答に返されます。

    許容値:

    • アーカイブ済み
    • ドラフト
    • 公開済み
    • 廃止

    データタイプ：文字列
    表 : 63. 要求本文のパラメーター
    名前 説明
    なし

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 64. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 65. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 66. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400
    要求が正しくありません。考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON)

    名前 説明
    説明 仕様の説明。

    データタイプ：文字列
    displayName 製品仕様の表示名。

    データタイプ：文字列
    externalId
    製品仕様の外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのexternal_idフィールド内。
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの sys_id または external_id フィールド内。
    internalId
    製品仕様のSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version フィールド内。
    internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのバージョンフィールドにあります。
    isBundle productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。
    有効な値：
    • true:製品仕様は製品バンドルであり、複数の製品が含まれています。
    • false:製品仕様には単一の製品が含まれています。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品仕様が最後に更新された日付。

    データタイプ：文字列
    ライフサイクルステータス 製品仕様の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 製品仕様の名前。

    データタイプ：文字列
    製品仕様特性 製品仕様特性。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristic": [
  {
    "description": "String",
    "name": "String",
    "productSpecCharacteristicValue": [Array],
    "validFor": {Object},
    "valueType": "String"
  }
]
    productSpecCharacteristic。説明 特性の説明。

    データタイプ：文字列
    productSpecCharacteristic。名前 特性の名前。

    データタイプ：文字列
    productSpecCharacteristic。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    productSpecCharacteristic。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。productSpecCharacteristicValue。値 特性の値。

    データタイプ：文字列
    productSpecCharacteristic。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。validFor。startDateTime 特性の開始日。

    データタイプ：文字列
    productSpecCharacteristic。値タイプ 特性の値タイプ (選択肢やメールなど)。

    データタイプ：文字列
    製品仕様関係 この仕様と他の製品仕様との関係。

    データタイプ:オブジェクトのアレイ

    "productSpecificationRelationship": [
  {
    "compatibilityRelationshipType": "String",
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "prodSpecRelationshipOption": {Object},
    "type": "String",
    "validFor": {Object},
    "version": "String"
]
    productSpecificationRelationship です。compatibilityRelationshipType 製品仕様の必要な値の互換性関係タイプ。

    互換性関係の詳細については、「 」を参照してください。

    テーブル:互換性 [sn_compt_mgmt_compatibles]
    productSpecificationRelationship.id 関連仕様のSys_id。

    データタイプ：文字列
    productSpecificationRelationship です。internalId 製品仕様関係のSys_id (内部 ID)。

    データタイプ：文字列
    productSpecificationRelationship です。internalVersion 製品仕様関係のバージョン。

    データタイプ：文字列
    productSpecificationRelationship です。名前 製品仕様関係の名前。

    データタイプ：文字列
    productSpecificationRelationship です。製品仕様リレーションシップオプション 製品仕様関係のカーディナリティ。

    データタイプ：オブジェクト

    "prodSpecRelationshipOption": {
  "numberSpecRelDefault": "String",
  "numberSpecRelLowerLimit": "String",
  "numberSpecRelUpperLimit": "String"
}
    productSpecificationRelationship です。prodSpecRelationshipOption です。numberSpecRelDefault 製品仕様のデフォルト値。

    データタイプ：文字列
    productSpecificationRelationship です。prodSpecRelationshipOption です。numberSpecRelLowerLimit 購入可能な注文の最小数。

    データタイプ：文字列
    productSpecificationRelationship です。prodSpecRelationshipOption です。数値仕様 RelUpperLimit 購入可能な注文の最大数。

    データタイプ：文字列
    productSpecificationRelationship です。タイプ 製品仕様関係のタイプ。

    データタイプ：文字列
    productSpecificationRelationship です。validFor 製品仕様関係が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecificationRelationship です。validFor。終了日時 関係の終了日。

    データタイプ：文字列
    productSpecificationRelationship です。validFor。startDateTime 関係の開始日。

    データタイプ：文字列
    productSpecificationRelationship です。バージョン 製品仕様関係のバージョン。

    データタイプ：文字列
    リソース仕様 この製品仕様に関連するリソース仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "resourceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    resourceSpecification です。ID リソース仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの sys_id または external_id フィールド。
    resourceSpecification です。internalId リソース仕様レコードの初期バージョン (sys_id)。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの initial_version フィールド内。
    resourceSpecification です。internalVersion リソース仕様のバージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルのバージョンフィールド内。
    resourceSpecification です。名前 リソース仕様の名前。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification]
    resourceSpecification です。バージョン リソース仕様の外部バージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの external_version フィールド内。
    サービス仕様 この製品仕様に関連するサービス仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "serviceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    serviceSpecification です。ID サービス仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの sys_id または external_id フィールド内。
    serviceSpecification です。internalId サービス仕様の初期バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの initial_version フィールド内。
    serviceSpecification です。internalVersion サービス仕様のバージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルのバージョンフィールド内。
    serviceSpecification です。名前 サービス仕様の名前。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification]
    serviceSpecification です。バージョン サービス仕様の外部バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの external_version フィールド内。
    ステータス 製品仕様のステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 仕様が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 仕様の終了日。

    データタイプ：文字列
    validFor。startDateTime 仕様の開始日。

    データタイプ：文字列
    バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの external_version フィールド内。

    この例では、指定された製品仕様レコードを取得します。

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

    応答本文:

    {
  "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/497a39a7c3d312105acc9e62b540dd14",
  "name": "SD-WAN Service Package",
  "displayName": "SD-WAN Service Package v4",
  "version": "",
  "internalVersion": "4",
  "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "description": "SD WAN Service Package",
  "lastUpdate": "2029-04-15 20:05:37",
  "lifecycleStatus": "Active",
  "isBundle": true,
  "validFor": {
    "startDateTime": "2033-04-15",
    "endDateTime": ""
  },
  "serviceSpecification": [],
  "productSpecificationRelationship": [
    {
      "id": "a6514bd3534560102f18ddeeff7b1247",
      "name": "SD-WAN Security",
      "version": "",
      "internalVersion": "2",
      "internalId": "a6514bd3534560102f18ddeeff7b1247",
      "type": "Service",
      "compatibilityRelationshipType": "",
      "validFor": {
        "startDateTime": "2030-09-25",
        "endDateTime": "2035-10-27"
      }
    },
    {
      "id": "39b627aa53702010cd6dddeeff7b1202",
      "name": "SD-WAN Edge Device",
      "version": "",
      "internalVersion": "2",
      "internalId": "39b627aa53702010cd6dddeeff7b1202",
      "type": "Service",
      "compatibilityRelationshipType": "",
      "validFor": {
        "startDateTime": "2030-09-27",
        "endDateTime": "2035-10-27"
      }
    },
    {
      "id": "216663aa53702010cd6dddeeff7b12b5",
      "name": "SD-WAN Controller",
      "version": "",
      "internalVersion": "2",
      "internalId": "216663aa53702010cd6dddeeff7b12b5",
      "type": "Service",
      "compatibilityRelationshipType": "",
      "validFor": {
        "startDateTime": "2029-04-03",
        "endDateTime": ""
      }
    }
  ],
  "resourceSpecification": [],
  "productSpecCharacteristic": [
    {
      "productSpecCharacteristicValue": [
        {
          "value": "0.01",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "0.25",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "0.5",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "1",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Down Time",
      "description": "Down Time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-12-13 02:36:15"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1 hr",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "2 hrs",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "4 hrs",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Mean Time to Restore (MTR)",
      "description": "Mean Time to Restore (MTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-12-13 02:39:05"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1 hr",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "4 hrs",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "2 hrs",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Time to Restore (TTR)",
      "description": "Time to Restore (TTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-12-13 02:37:25"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "99.50",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "99.99",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "99.00",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "99.75",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Up Time",
      "description": "Up time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-12-13 02:34:30"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "5 Gbps",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "1 Gbps",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "500 Mbps",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "2 Gbps",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Bandwidth",
      "description": "Bandwidth",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-12-13 02:32:11"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "No",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Application Encryption",
      "description": "Application Encryption",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-12-13 02:29:08"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        },
        {
          "value": "No",
          "validFor": {
            "startDateTime": ""
          },
          "isDefault": false,
          "isMandatory": false
        }
      ],
      "name": "Application Flow Backup",
      "description": "Application Flow Backup",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-12-13 02:30:39"
      }
    }
  ],
  "status": "published"
}

    製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productOffering/{id}

    指定された製品オファリングを更新します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering/{id}

    サポートされている要求パラメーター

    表 : 67. パスパラメーター
    名前 説明
    ID 更新する製品オファリングのSys_id。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    表 : 68. クエリパラメーター
    名前 説明
    なし
    表 : 69. 要求本文のパラメーター
    名前 説明
    バンドルされたグループ製品オファリング 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。

    データタイプ:オブジェクトのアレイ

    "bundledGroupProductOffering": [
  {
    "bundledGroupProductOfferingOption": {Object},
    "bundledProductOffering": [Array],
    "id": "String",
    "name": "String"
  }
]
    bundledGroupProductOffering。bundledGroupProductOfferingOption 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。

    データタイプ：オブジェクト

    "bundledGroupProductOfferingOption": {
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。

    データタイプ：文字列
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。

    データタイプ：文字列
    bundledGroupProductOffering。バンドルされた製品オファリング バンドルに関連付けられた製品オファリングの子グループ。以下に指定されている bundledProductOffering と同じ形式です。

    データタイプ:オブジェクトのアレイ
    bundledGroupProductOffering。ID バンドルされたグループレコードのSys_id。親製品オファリングまたは親グループに複数のグループが含まれている場合に役立ちます。

    データタイプ：文字列

    テーブル:製品オファリング関係グループ [sn_prd_pm_product_offering_relationship_group]
    bundledGroupProductOffering。名前 子製品オファリングのグループの名前。

    データタイプ：文字列
    バンドルされた製品オファリング 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。

    データタイプ:オブジェクトのアレイ

    "bundledProductOffering": [
  {
    "bundledProductOfferingOption": {Object},
    "externalId": "String",
    "id": "String",
    "name": "String",
    "version": Number
  }
]
    bundledProductOffering。bundledProductOfferingOption 製品オファリングのデフォルト数や、製品オファリングの調達制約の上下など、製品バンドルオプション。

    データタイプ：オブジェクト

    "bundledProductOfferingOption": {
  "numberRelOfferDefault": "String",
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferDefault 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリング数の下限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。ID バンドルされた製品オファリングの Sys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    bundledProductOffering。externalId 製品オファリング関係の外部 ID。

    製品オファリングの関係の詳細については、「 Create product offering relationships」を参照してください。

    データタイプ：文字列
    bundledProductOffering。名前 製品オファリングバンドルの名前。

    データタイプ：文字列
    bundledProductOffering。バージョン 製品オファリングのカタログバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    category 製品が属するカテゴリのリスト。

    データタイプ:オブジェクトのアレイ

    "category:" [
  {
    "id": "String",
    "name": "String"
  }
]

    テーブル:カテゴリ [sc_category]
    category.id category パラメーターを使用する場合は必須です。カテゴリの ID。

    データタイプ：文字列

    テーブル:カテゴリ [sc_category]
    category.name カテゴリの名前。

    データタイプ：文字列

    デフォルト:空白の文字列
    チャネル 必須。製品オファリングの販売に使用するチャネル。

    データタイプ:オブジェクトのアレイ

    "channel:" [
  {
    "description": "String",
    "id": "String",
    "name": "String"
  }
]
    channel.description チャネルの説明。

    データタイプ：文字列

    デフォルト:空白の文字列
    channel.id 必須。チャネルのSys_id。

    データタイプ：文字列

    テーブル:流通チャネル [sn_prd_pm_distribution_channel]
    channel.name チャネルの名前。

    データタイプ：文字列

    デフォルト:空白の文字列
    説明 必須。製品オファリングの説明。

    データタイプ：文字列
    displayName 製品オファリングの表示名。

    データタイプ：文字列
    externalId 製品オファリングの外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [external_id] フィールド内。
    ID 必須。製品オファリングの初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [initial_version] または [external_id] フィールド内。
    internalId 製品オファリングレコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    internalVersion 製品オファリングのバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    isBundle 製品オファリングがバンドルかどうかを示すフラグ。
    可能な値：
    • true:製品オファリングはバンドルです。
    • false:単一の製品オファリング。

    データタイプ：ブール

    デフォルト値：false
    販売可能 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。
    可能な値：
    • true:個別に販売できます。
    • false:バンドルの一部としてのみ販売されます。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品オファリングが最後に更新された日付。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS

    デフォルト:空白の文字列
    ライフサイクルステータス 製品オファリングの現在のライフサイクルステータス。
    可能な値：
    • アクティブ
    • 非アクティブ
    • ドラフト

    データタイプ：文字列
    名前 必須。製品オファリングの名前。

    データタイプ：文字列
    prodSpecCharValueUse 製品オファリング特性。

    データタイプ:オブジェクトのアレイ

    "prodSpecCharValueUse": [
   {
      "description": "String",
      "name": "String",
      "productSpecCharacteristicValue": [Array],
      "validFor": {Object},
      "valueType": "String"
   }
]
    prodSpecCharValueUse。説明 特性の説明。

    データタイプ：文字列
    prodSpecCharValueUse.name 必須。
    特性の名前。

    データタイプ：文字列
    prodSpecCharValueUse。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    prodSpecCharValueUse。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    prodSpecCharValueUse。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。値タイプ prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品特性 製品特性のリスト。

    データタイプ:オブジェクトのアレイ

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristic.name 特性の名前。

    データタイプ：文字列

    デフォルト:空白の文字列
    productCharacteristic.value 特性の値。

    データタイプ：文字列

    デフォルト:空白の文字列
    製品オファリング特性 製品オファリングの特徴的な品質または特徴。特性は、モバイルプランランクなど、設計時 (カタログ作成) で固定される個別の値を取ることができます。これらの特性は通常、在庫レベルでは変更できません。

    製品オファリング特性の詳細については、「 Create product characteristics and characteristic options」を参照してください。

    データタイプ:オブジェクトのアレイ

    productOfferingCharacteristic": [  
  {
    "characteristicValueSpecification": [Array],
    "name": "String",
    "valueType": "String"
  }
]
    productOfferingCharacteristic。特性値仕様 製品オファリング特性に関連付けられた特性値のリスト。

    データタイプ:オブジェクトのアレイ

    "characteristicValueSpecification": [  
  { 
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "value": "String"
  }  
]
    productOfferingCharacteristic。characteristicValueSpecificationです。isDefault 関連付けられた特性値が関連付けられた特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値です。
    • false:デフォルト値ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。必須 関連する特性値が関連する特性に必須かどうかを示すフラグ。
    可能な値：
    • true:必須です。
    • false:必須ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。値 関連付けられた製品仕様特性に割り当てられた番号またはテキスト。
    たとえば、次のようになります：
    "characteristicValueSpecification": [
  {
    "value": "choice 1"
  },
  {
    "value": "choice 2"
  }
]

    データタイプ：文字列
    productOfferingCharacteristic。名前 関連付けられた製品オファリング特性の名前。

    データタイプ：文字列
    productOfferingCharacteristic。値タイプ productOfferingCharacteristic.​characteristicValueSpecification.​valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品オファリング価格 製品オファリングの価格情報。

    データタイプ:オブジェクトのアレイ

    "productOfferingPrice": [
  {
    "price": {Object},
    "priceType": "String"
  }
]
    productOfferingPrice.price 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "price": {
  "taxIncludedAmount": {Object}
}
    productOfferingPrice.price.taxIncludedAmount 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "taxIncludedAmount": {
  "unit": "String",
  "value": "String"
}
    productOfferingPrice.price.taxIncludedAmount.unit 製品オファリング価格の通貨コード。

    データタイプ：文字列

    デフォルト:空白の文字列
    productOfferingPrice.price.taxIncludedAmount.value 税込み製品オファリングの価格。

    データタイプ：文字列

    デフォルト:空白の文字列
    productOfferingPrice.priceType 製品オファリングタイプのタイプ。productOfferingPrice パラメーターを使用する場合は必須です。
    有効な値：
    • 非繰り返し (1 回限り)
    • 繰り返し

    データタイプ：文字列
    productOfferingTerm 製品オファリング 有効な契約期間。

    データタイプ：文字列

    デフォルト:空白の文字列
    製品仕様 必須。製品の製品仕様。

    データタイプ：オブジェクト

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "name": "String",
  "version": "String"
}
    productSpecification.id 必須。製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] のsys_idフィールドまたはexternal_idフィールド
    productSpecificationです。internalId 製品仕様レコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    productSpecificationです。名前 製品仕様の名前。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの名前フィールドにあります。
    productSpecificationです。バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    ステータス 製品オファリングのステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 必須。製品オファリングが有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor.endDateTime 必須。製品オファリングの終了日時。

    データタイプ：文字列

    形式:YYYY-MM-DD
    validFor.startDateTime 必須。製品オファリングの開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD
    バージョン 製品オファリングの外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。

    応答本文のパラメーター (JSON)

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 70. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。
    表 : 71. 応答ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 72. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。不正な要求タイプまたは不正な形式の要求が検出されました。
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    バンドルされたグループ製品オファリング 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。

    データタイプ:オブジェクトのアレイ

    "bundledGroupProductOffering": [
  {
    "bundledGroupProductOfferingOption": {Object},
    "bundledProductOffering": [Array],
    "id": "String",
    "name": "String"
  }
]
    bundledGroupProductOffering。bundledGroupProductOfferingOption 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。

    データタイプ：オブジェクト

    "bundledGroupProductOfferingOption": {
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。

    データタイプ：文字列
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。

    データタイプ：文字列
    bundledGroupProductOffering。バンドルされた製品オファリング バンドルに関連付けられた製品オファリングの子グループ。以下に指定されている bundledProductOffering と同じ形式です。

    データタイプ:オブジェクトのアレイ
    bundledGroupProductOffering。ID バンドルされたグループレコードのSys_id。親製品オファリングまたは親グループに複数のグループが含まれている場合に役立ちます。

    データタイプ：文字列

    テーブル:製品オファリング関係グループ [sn_prd_pm_product_offering_relationship_group]
    bundledGroupProductOffering。名前 子製品オファリングのグループの名前。

    データタイプ：文字列
    バンドルされた製品オファリング 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。

    データタイプ:オブジェクトのアレイ

    "bundledProductOffering": [
  {
    "bundledProductOfferingOption": {Object},
    "externalId": "String",
    "id": "String",
    "name": "String",
    "version": Number
  }
]
    bundledProductOffering。bundledProductOfferingOption 製品オファリングのデフォルト数や、製品オファリングの調達制約の上下など、製品バンドルオプション。

    データタイプ：オブジェクト

    "bundledProductOfferingOption": {
  "numberRelOfferDefault": "String",
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferDefault 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリング数の下限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。ID バンドルされた製品オファリングの Sys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    bundledProductOffering。externalId 製品オファリング関係の外部 ID。

    製品オファリングの関係の詳細については、「 Create product offering relationships」を参照してください。

    データタイプ：文字列
    bundledProductOffering。名前 製品オファリングバンドルの名前。

    データタイプ：文字列
    bundledProductOffering。バージョン 製品オファリングのカタログバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    category 製品が属するカテゴリのリスト。

    データタイプ:オブジェクトのアレイ

    "category:" [
  {
    "id": "String",
    "name": "String"
  }
]
    category.id カテゴリの ID。

    データタイプ：文字列
    category.name カテゴリの名前。

    データタイプ：文字列
    チャネル 製品オファリングの販売に使用するチャネル。

    データタイプ:オブジェクトのアレイ

    "channel:" [
  {
    "description": "String",
    "id": "String",
    "name": "String"
  }
]
    channel.description チャネルの説明。

    データタイプ：文字列
    channel.id チャネルのSys_id。

    データタイプ：文字列

    テーブル:流通チャネル [sn_prd_pm_distribution_channel]
    channel.name チャネルの名前。

    データタイプ：文字列
    説明 製品オファリングの説明。

    データタイプ：文字列
    displayName 製品オファリングの表示名。

    データタイプ：文字列
    externalId 製品オファリングの外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [external_id] フィールド内。
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 必須。製品オファリングの初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [initial_version] または [external_id] フィールド内。
    internalId 製品オファリングレコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    internalVersion 製品オファリングのバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    isBundle 製品オファリングがバンドルかどうかを示すフラグ。
    可能な値：
    • true:製品オファリングはバンドルです。
    • false:単一の製品オファリング。

    データタイプ：ブール

    デフォルト値：false
    販売可能 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。
    可能な値：
    • true:個別に販売できます。
    • false:バンドルの一部としてのみ販売されます。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品オファリングが最後に更新された日付。

    データタイプ：文字列
    リフトサイクルステータス 現在のライフサイクルステータス。許容値:
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 製品オファリングの名前。

    データタイプ：文字列
    prodSpecCharValueUse 製品オファリング特性。

    データタイプ:オブジェクトのアレイ

    "prodSpecCharValueUse": [
   {
      "description": "String",
      "name": "String",
      "productSpecCharacteristicValue": [Array],
      "validFor": {Object},
      "valueType": "String"
   }
]
    prodSpecCharValueUse。説明 特性の説明。

    データタイプ：文字列
    prodSpecCharValueUse。名前
    特性の名前。

    データタイプ：文字列
    prodSpecCharValueUse。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    prodSpecCharValueUse。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    prodSpecCharValueUse。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。値タイプ prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品特性 製品特性のリスト。

    データタイプ:オブジェクトのアレイ

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristicです。名前 特性の名前。

    データタイプ：文字列
    productCharacteristicです。値 特性の値。

    データタイプ：文字列
    製品オファリング特性 製品オファリングの特徴的な品質または特徴。特性は、モバイルプランランクなど、設計時 (カタログ作成) で固定される個別の値を取ることができます。これらの特性は通常、在庫レベルでは変更できません。

    製品オファリング特性の詳細については、「 Create product characteristics and characteristic options」を参照してください。

    データタイプ:オブジェクトのアレイ

    productOfferingCharacteristic": [  
  {
    "characteristicValueSpecification": [Array],
    "name": "String",
    "valueType": "String"
  }
]
    productOfferingCharacteristic。特性値仕様 製品オファリング特性に関連付けられた特性値のリスト。

    データタイプ:オブジェクトのアレイ

    "characteristicValueSpecification": [  
  { 
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "value": "String"
  }  
]
    productOfferingCharacteristic。characteristicValueSpecificationです。isDefault 関連付けられた特性値が関連付けられた特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値です。
    • false:デフォルト値ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。必須 関連する特性値が関連する特性に必須かどうかを示すフラグ。
    可能な値：
    • true:必須です。
    • false:必須ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。値 関連付けられた製品仕様特性に割り当てられた番号またはテキスト。
    たとえば、次のようになります：
    "characteristicValueSpecification": [
  {
    "value": "choice 1"
  },
  {
    "value": "choice 2"
  }
]

    データタイプ：文字列
    productOfferingCharacteristic。名前 関連付けられた製品オファリング特性の名前。

    データタイプ：文字列
    productOfferingCharacteristic。値タイプ productOfferingCharacteristic.​characteristicValueSpecification.​valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品オファリング価格 製品オファリングの価格情報。

    データタイプ:オブジェクトのアレイ

    "productOfferingPrice": [
  {
    "price": {Object},
    "priceType": "String"
  }
]
    productOfferingPrice です。価格 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "price": {
  "taxIncludedAmount": {Object}
}
    productOfferingPrice です。価格。税込み金額 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "taxIncludedAmount": {
  "unit": "String",
  "value": "String"
}
    productOfferingPrice です。価格。taxIncludedAmount.unit 製品オファリング価格の通貨コード。

    データタイプ：文字列
    productOfferingPrice です。価格。taxIncludedAmount です。値 税込み製品オファリングの価格。

    データタイプ：文字列
    productOfferingPrice です。価格タイプ 製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。
    可能な値：
    • 非繰り返し (1 回限り)
    • 繰り返し

    データタイプ：文字列
    productOfferingTerm 製品オファリングの有効な契約期間。

    データタイプ：文字列
    製品仕様 製品の製品仕様。

    データタイプ：オブジェクト

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "name": "String",
  "status": "String",
  "sys_id": "String",
  "version": "String"
}
    productSpecificationです。ID 製品仕様レコードのSys_id。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalId 製品仕様レコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    productSpecificationです。ステータス 公開済みやドラフトなどの製品仕様のステータス。

    データタイプ：文字列
    productSpecificationです。sys_id 製品仕様のSys_id。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification]
    productSpecificationです。バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    ステータス 製品オファリングのステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 製品オファリングが有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 製品オファリングの終了日。

    データタイプ：文字列
    validFor。startDateTime 製品オファリングの開始日。

    データタイプ：文字列
    バージョン 製品オファリングの外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。

    次の例では、要求本文で指定された情報を使用して、製品オファリングを sys_id 313b917843235210a82ed6085bb8f2c7 で更新します。

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productOffering/313b917843235210a82ed6085bb8f2c7" \ 
--request PATCH\ 
--header "Accept:application/json" \ 
--user 'username':'password'
--data '{
  "id": "313b917843235210a82ed6085bb8f2c7",
  "name": "Internet bundle",
  "displayName": "Internet bundle",
  "description": "Internet bundle",
  "isSellable": false,
  "lifecycleStatus": "Draft",
  "isBundle": true,
  "lastUpdate": "2025-02-05 06:39:45",
  "version": "",
  "internalVersion": "1",
  "internalId": "313b917843235210a82ed6085bb8f2c7",
  "validFor": {
    "startDateTime": "2028-12-15",
    "endDateTime": "2034-01-14"
  },
  "productOfferingTerm": "not_applicable",
  "productOfferingPrice": [
    {
      "priceType": "recurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    },
    {
      "priceType": "nonRecurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    }
  ],
  "productOfferingCharacteristic": [
    {
      "name": "Firewall Security",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "Premium",
          "isMandatory": false,
          "isDefault": true
        }
      ]
    },
    {
      "name": "Connectivity need",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "When in use",
          "isMandatory": false,
          "isDefault": false
        }
      ]
    }
  ],
  "bundledProductOffering": [
    {
     
      "id": "0f61dd9fd0a63110f8770dbf976be168",
      "name": "Solana Sports streaming channel",
      "version": "1",
      "externalId": "EXT-123",

      "bundledProductOfferingOption": {
        "numberRelOfferDefault": "1",
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "bundledGroupProductOffering": [
    {
      "id": "063b957843235210a82ed6085bb8f205",
      "name": "Streaming Channel",
      "bundledProductOffering": [
        {
          "id": "62619d9fd0a63110f8770dbf976be180",
          "name": "Solana Movie streaming channel",
          "version": "1",
          "externalId": "EXT-123",
          "bundledProductOfferingOption": {
            "numberRelOfferDefault": "1",
            "numberRelOfferLowerLimit": "1",
            "numberRelOfferUpperLimit": "1"
          }
        }
      ],
      "bundledGroupProductOfferingOption": {
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "productSpecification": {
    "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
    "name": "SD-WAN Service Package",
    "version": "",
    "internalVersion": "3",
    "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
  },
  "prodSpecCharValueUse": [
    {
      "name": "Tenancy",
      "description": "Tenancy",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2024-12-18 21:04:24"
      },
      "productSpecCharacteristicValue": [
        {
          "value": "Premium (>50 sites)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Base (10 site)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "productSpecification": {
        "id": "216663aa53702010cd6dddeeff7b12b5",
        "name": "SD-WAN Controller",
        "version": "",
        "internalVersion": "1",
        "internalId": "216663aa53702010cd6dddeeff7b12b5"
      }
    }
  ],
  "channel": [
    {
      "id": "58ad5522c3702010df4773ce3640ddb2",
      "name": "Agent Assist"
    }
  ],
  "category": [
    {
      "id": "13e305a143b631105029d1529ab8f267",
      "name": "SD-WAN_all_offers"
    }
  ],
  "status": "draft"
}'

    応答本文:

    {
  "id": "313b917843235210a82ed6085bb8f2c7",
  "href": "/api/sn_tmf_api/catalogmanagement/productOffering/313b917843235210a82ed6085bb8f2c7",
 "name": "Internet",
  "displayName": "Internet",
  "description": "Internet bundle",
  "isSellable": false,
  "lifecycleStatus": "Draft",
  "isBundle": true,
  "lastUpdate": "2025-02-05 06:39:45",
  "version": "",
  "internalVersion": "1",
  "internalId": "313b917843235210a82ed6085bb8f2c7",
  "validFor": {
    "startDateTime": "2028-12-15",
    "endDateTime": "2034-01-14"
  },
  "productOfferingTerm": "not_applicable",
  "productOfferingPrice": [
    {
      "priceType": "recurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    },
    {
      "priceType": "nonRecurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    }
  ],
  "productOfferingCharacteristic": [
    {
      "name": "Firewall Security",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "Premium",
          "isMandatory": false,
          "isDefault": true
        }
      ]
    },
    {
      "name": "Connectivity need",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "When in use",
          "isMandatory": false,
          "isDefault": false
        }
      ]
    }
  ],
  "bundledProductOffering": [
    {
            "id": "0f61dd9fd0a63110f8770dbf976be168",
      "name": "Solana Sports streaming channel",
      "version": "1",
      "externalId": "EXT-123",
      "bundledProductOfferingOption": {
        "numberRelOfferDefault": "1",
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    },
    {
      "id": "0f61dd9fd0a63110f8770dbf976be16c",
      "name": "Solana TV shows streaming channel",
      "version": "1",
      "externalId": "EXT-456",

      "bundledProductOfferingOption": {
        "numberRelOfferDefault": "1",
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "bundledGroupProductOffering": [
    {
      "id": "063b957843235210a82ed6085bb8f205",
      "name": "Streaming Channel",
      "bundledProductOffering": [
        {
          
          "name": "Internet",
          "version": "1",
          "externalId": "EXT-678",
          "bundledProductOfferingOption": {
            "numberRelOfferDefault": "1",
            "numberRelOfferLowerLimit": "1",
            "numberRelOfferUpperLimit": "1"
          }
        }
      ],
      "bundledGroupProductOfferingOption": {
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "3"
      }
    },
    {
      "id": "313b917843235210a82ed6085bb8f2c7",
      "name": "Streaming Channel",
      "bundledProductOffering": [
        {
          "id": "1161a4f8436b1210a82ed6085bb8f216",
          "name": "Internet",
          "version": "1",
          "externalId": "EXT-910",
          "bundledProductOfferingOption": {
            "numberRelOfferDefault": "1",
            "numberRelOfferLowerLimit": "1",
            "numberRelOfferUpperLimit": "1"
          }
        }
      ],
      "bundledGroupProductOfferingOption": {
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "productSpecification": {
    "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
    "name": "SD-WAN Service Package",
    "version": "",
    "internalVersion": "3",
    "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
  },
  "prodSpecCharValueUse": [
    {
      "name": "Tenancy",
      "description": "Tenancy",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2024-12-18 21:04:24"
      },
      "productSpecCharacteristicValue": [
        {
          "value": "Premium (>50 sites)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Advance (50 site)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Base (10 site)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "productSpecification": {
        "id": "216663aa53702010cd6dddeeff7b12b5",
        "name": "SD-WAN Controller",
        "version": "",
        "internalVersion": "1",
        "internalId": "216663aa53702010cd6dddeeff7b12b5"
      }
    }
  ],
  "channel": [
    {
      "id": "58ad5522c3702010df4773ce3640ddb2",
      "name": "Agent Assist"
    }
  ],
  "category": [
    {
      "id": "13e305a143b631105029d1529ab8f267",
      "name": "SD-WAN_all_offers"
    }
  ],
  "status": "draft"
}

    製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productOfferingPrice/{id}

    価格明細 [sn_csm_pricing_price_list_line] テーブルの指定されたsys_idで価格明細レコードを更新します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice/{id}

    サポートされている要求パラメーター

    表 : 73. パスパラメーター
    名前 説明
    ID 必須。取得する価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    表 : 74. クエリパラメーター
    名前 説明
    なし
    表 : 75. 要求本文パラメーター (XML または JSON)
    名前 説明
    @type 必須。価格明細のタイプ。常に ProductOfferingPrice の値です。

    データタイプ：文字列
    externalId 価格明細の外部 ID。

    データタイプ：文字列
    isBundle 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。
    有効な値：
    • true:価格明細はバンドルの一部です。
    • false:価格明細はバンドルの一部ではありません。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 必須。価格行が最後に更新された日付。

    形式:YYYY-MM-DD

    データタイプ：文字列
    ライフサイクルステータス 必須。製品リスト明細の現在のライフサイクルステータス。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:ドラフト
    名前 必須。価格明細に付ける名前。

    データタイプ：文字列
    価格 必須。価格明細の表示価格の詳細。

    データタイプ：オブジェクト

    "price": {
  "unit": "String",
  "value": "String"
}
    price.unit 必須。価格明細の通貨コード。たとえば、 USD や EUR などです。

    テーブル:通貨 [fx_currency] テーブル。

    データタイプ：文字列
    price.value 必須。価格の値。

    データタイプ:文字列 (数値で表されます。例:「 800」)。
    priceList 必須。価格明細に関連付けられた価格リスト情報。

    データタイプ：オブジェクト

    "priceList": {
  "id": "String",
  "name": "String",
  "@type": "String"
}
    priceList.id 必須。価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    priceList.name 価格明細の名前。

    データタイプ：文字列
    priceList.@type 価格明細のタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。値は常に priceList です。

    データタイプ：文字列
    価格タイプ 必須。製品オファリングの価格設定方法で価格明細をフィルタリングします。
    有効な値：
    • recurring:指定された頻度で繰り返し価格設定金額を請求します。頻度は recurringChargePeriodType パラメーターで設定します。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。

    データタイプ：文字列

    デフォルト:繰り返し
    productOffering 必須。価格明細の製品オファリング。

    データタイプ：オブジェクト

    "productOffering": {
  "id": "String",
  "name": "String",
  "internalVersion": "String"
}
    productOffering。ID 必須。製品オファリングのSys_id。

    テーブル:製品オファリング [sn_prd_pm_product_offering]

    データタイプ：文字列
    productOffering。internalVersion 製品オファリングの内部バージョン番号。

    データタイプ:文字列 (数値で表されます。たとえば、「 1」などです。
    productOffering。名前 製品オファリングの名前。

    データタイプ：文字列
    recurringChargePeriodType priceTypeを繰り返す場合は必須です。製品オファリングの作成時に選択されたコミットメント期間。
    有効な値：
    • 年次
    • 月次

    データタイプ：文字列
    測定単位 必須。価格明細に関連付けられた測定単位に関する詳細。

    データタイプ：オブジェクト

    "unitOfMeasure": {
  "id": "String",
  "amount": Number,
  "units": "String"
}
    unitOfMeasureです。総計 測定単位の金額。

    データタイプ：数値
    unitOfMeasureです。ID 必須。価格ラインリストテーブルの測定単位のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    unitOfMeasureです。単位 価格明細に関連付けられた測定単位のタイプ。たとえば、各またはバンドルです。

    データタイプ：文字列
    validFor 必須。価格明細が有効な期間。

    データタイプ：オブジェクト

    "validFor": {
  "endDate": "String",
  "startDate": "String"
}
    validFor.endDate 価格明細が有効な終了日。

    データタイプ:文字列 (glide_date_time)
    validFor.endDateTime 価格明細が有効な終了日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ:文字列 (glide_date)
    validFor.startDate 価格明細が有効な開始日。

    データタイプ:文字列 (glide_date_time)
    validFor.startDateTime 価格明細が有効な開始日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ:文字列 (glide_date)

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 76. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 77. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 78. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。
    考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    ID 価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    href インスタンス内の価格明細レコードへの URL。

    データタイプ：文字列
    前回の更新 価格明細が最後に更新された日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    validFor 価格明細が有効な期間。

    データタイプ：オブジェクト

    "validFor": {
  "endDate": "String",
  "startDate": "String"
}
    validFor.endDate 価格明細が有効な終了日時。

    データタイプ:文字列 (glide_date_time)
    validFor.startDate 価格明細が有効な開始日時。

    データタイプ:文字列 (glide_date_time)
    isBundle 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。
    有効な値：
    • true:価格明細はバンドルの一部です。
    • false:価格明細はバンドルの一部ではありません。

    データタイプ：ブール
    ライフサイクルステータス 価格明細の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    productOffering 価格明細に関連付けられている製品オファリング。

    データタイプ：オブジェクト

    "productOffering": {
  "id": "String",
  "name": "String",
  "internalVersion": "String"
}
    productOffering.id 製品オファリングのSys_id。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。internalVersion 製品オファリングの内部バージョン番号。たとえば、 PRDOF01024 などです。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。名前 製品オファリングの名前。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    価格タイプ この価格明細に関連付けられている製品オファリングの価格設定方法。
    可能な値：
    • recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。

    データタイプ：文字列
    recurringChargePeriodType この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返しに設定されている場合は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。
    可能な値：
    • 年次
    • 月次

    データタイプ：文字列
    測定単位 価格明細に関連付けられた測定単位に関する詳細。

    データタイプ：オブジェクト

    "unitOfMeasure": {
  "id": "String",
  "amount": Number,
  "units": "String"
}
    unitOfMeasure.amount 測定単位の金額。

    データタイプ：数値
    unitOfMeasure.id 測定単位のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    unitOfMeasureです。単位 価格明細に関連付けられた測定単位のタイプ。たとえば、 年 や バンドルなどです。

    データタイプ：文字列
    価格 価格明細の表示価格の詳細。

    データタイプ：オブジェクト

    "price": {
  "units": "String",
  "value": "String"
}
    price.units 価格の通貨コード。たとえば、 USD や EUR などです。

    テーブル:通貨 [fx_currency]

    データタイプ：文字列
    price.value 価格の値。

    データタイプ:文字列 (数値で表される)
    priceList 価格明細に関連付けられた価格リスト情報。

    データタイプ：オブジェクト

    "priceList": {
  "id": "String",
  "name": "String",
  "@type": "String"
}
    priceList.id 価格リスト [sn_csm_pricing_price_list] テーブルの価格リストのSys_id。

    データタイプ：文字列
    priceList.name 価格リストの名前。

    データタイプ：文字列
    priceList.@type 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に priceList の値を持ちます。

    データタイプ：文字列
    @type 常に ProductOfferingPrice の値です。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。

    データタイプ：文字列
    状況 この価格明細に関連付けられている価格リストのステータス。

    データタイプ：文字列
    externalId この価格明細の外部 ID。

    データタイプ：文字列

    cURL 要求

    次の例では、ID が 3ddd0 の製品オファリング価格の日付を更新します...は有効です。

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

    応答本文:

    {
  "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"
}

    製品カタログオープン API - PATCH /sn_tmf_api/catalogmanagement/productSpecification/{id}

    指定された製品仕様を更新します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification/{id}

    サポートされている要求パラメーター

    表 : 79. パスパラメーター
    名前 説明
    ID 更新する製品オファリングのSys_id。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification]
    表 : 80. クエリパラメーター
    名前 説明
    なし
    表 : 81. 要求本文パラメーター (JSON)
    名前 説明
    説明 必須。仕様の説明。

    データタイプ：文字列
    externalId 必須。
    製品仕様の外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのexternal_idフィールド内。
    ID 製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの sys_id または external_id フィールド内。
    internalId 必須。
    製品仕様のSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version フィールド内。
    internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのバージョンフィールドにあります。
    isBundle productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。
    有効な値：
    • true:製品仕様は製品バンドルであり、複数の製品が含まれています。
    • false:製品仕様には単一の製品が含まれています。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 仕様が最後に更新された日付。

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 必須。仕様の名前。

    データタイプ：文字列
    製品仕様特性 仕様特性。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristic": [
  {
    "description": "String",
    "name": "String",
    "productSpecCharacteristicValue": [Array],
    "validFor": {Object},
    "valueType": "String"
  }
]
    productSpecCharacteristic。説明 特性の説明。

    データタイプ：文字列
    productSpecCharacteristic。名前 必須。特性の名前。

    データタイプ：文字列
    productSpecCharacteristic。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    productSpecCharacteristic。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    productSpecCharacteristic。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
   "endDateTime": "String",
   "startDateTime": "String"
}
    productSpecCharacteristic。validFor。終了日時 特性の終了日時。

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    データタイプ：文字列
    productSpecCharacteristic。validFor。startDateTime 特性の開始日時。

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    データタイプ：文字列
    productSpecCharacteristic。値タイプ 特性の値タイプ (選択肢やメールなど)。

    データタイプ：文字列
    製品仕様関係 仕様と他の製品仕様との関係の詳細。

    データタイプ:オブジェクトのアレイ

    "productSpecificationRelationship": [
  {
    "id": "String",
    "type": "String",
    "validFor": {Object}
  }
]
    productSpecificationRelationship です。ID 関連仕様の ID。

    データタイプ：文字列
    productSpecificationRelationship です。タイプ productSpecificationRelationship パラメーターを使用する場合は必須です。関係のタイプ。
    有効な値：
    • バンドル
    • composed_of

    データタイプ：文字列
    productSpecificationRelationship です。validFor 関係が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecificationRelationship です。validFor。終了日時 関係の終了日。

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    データタイプ：文字列
    productSpecificationRelationship です。validFor。startDateTime 関係の開始日。

    形式:YYYY-MM-DD 00:00:00。例: 2025-01-31 09:35:43。

    データタイプ：文字列
    リソース仕様 必須。この製品仕様に関連するリソース仕様の詳細。

    データタイプ:オブジェクトのアレイ

    "resourceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    resourceSpecification です。ID 必須。リソース仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの sys_id または external_id フィールド。
    resourceSpecification です。internalId リソース仕様レコードの初期バージョン (sys_id)。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの initial_version フィールド内。
    resourceSpecification です。internalVersion リソース仕様のバージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルのバージョンフィールド内。
    resourceSpecification です。名前 リソース仕様の名前。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification]
    resourceSpecification です。バージョン リソース仕様の外部バージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの external_version フィールド内。
    サービス仕様 この製品仕様に関連するサービス仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "serviceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    serviceSpecification です。ID サービス仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの sys_id または external_id フィールド内。
    serviceSpecification です。internalId サービス仕様の初期バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの initial_version フィールド内。
    serviceSpecification です。internalVersion サービス仕様のバージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルのバージョンフィールド内。
    serviceSpecification です。名前 サービス仕様の名前。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification]
    serviceSpecification です。バージョン サービス仕様の外部バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの external_version フィールド内。
    validFor 必須。仕様が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 仕様の終了日時。

    形式:YYYY-MM-DD 00:00:00。例: 2025-01-31 09:35:43。

    データタイプ：文字列
    validFor。startDateTime 仕様の開始日時。

    形式:YYYY-MM-DD 00:00:00。例: 2025-01-31 09:35:43。

    データタイプ：文字列
    バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの external_version フィールド内。

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 82. 要求ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 83. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 84. ステータスコード
    ステータスコード 説明
    200 要求が正常に処理されました。
    400 要求が正しくありません。考えられる理由：
    • 空のペイロード。
    • 無効なペイロードです。必須フィールドがありません:<フィールド名>
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター

    名前 説明
    説明 仕様の説明。

    データタイプ：文字列
    href リソースレコードへの相対リンク。

    データタイプ：文字列
    ID 製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの sys_id または external_id フィールド内。
    internalId 必須。
    製品仕様のSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version フィールド内。
    internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのバージョンフィールドにあります。
    前回の更新 仕様が最後に更新された日付。

    形式:YYYY-MM-DD 00:00:00。

    データタイプ：文字列
    名前 仕様の名前。

    データタイプ：文字列
    製品仕様特性 仕様の特性。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristic": [
  {
    "description": "String",
    "name": "String",
    "productSpecCharacteristicValue": [Array],
    "validFor": {Object},
    "valueType": "String"
  }
]
    productSpecCharacteristic。説明 特性の説明。

    データタイプ：文字列
    productSpecCharacteristic。名前 特性の名前。

    データタイプ：文字列
    productSpecCharacteristic。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    productSpecCharacteristic。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    productSpecCharacteristic。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecCharacteristic。validFor。終了日時 特性の終了日時。

    形式:YYYY-MM-DD 00:00:00。

    データタイプ：文字列
    productSpecCharacteristic。validFor。startDateTime 特性の開始日時。

    形式:YYYY-MM-DD 00:00:00。

    データタイプ：文字列
    productSpecCharacteristic。値タイプ 特性の値タイプ (選択肢やメールなど)。

    データタイプ：文字列
    製品仕様関係 この仕様と他の製品仕様との関係。

    データタイプ:オブジェクトのアレイ

    "productSpecificationRelationship": [
  {
    "id": "String",
    "type": "String",
    "validFor": {Object}
  }
]
    productSpecificationRelationship です。ID 関連仕様のSys_id。

    データタイプ：文字列
    productSpecificationRelationship です。タイプ 関係のタイプ。

    データタイプ：文字列
    productSpecificationRelationship です。validFor 関係が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecificationRelationship です。validFor。終了日時 関係の終了日とタイプ。

    形式:YYYY-MM-DD

    データタイプ：文字列
    productSpecificationRelationship です。validFor。startDateTime 関係の開始日とタイプ。

    形式:YYYY-MM-DD

    データタイプ：文字列
    リソース仕様 この製品仕様に関連するリソース仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "resourceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    resourceSpecification です。ID リソース仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの sys_id または external_id フィールド。
    resourceSpecification です。internalId リソース仕様レコードの初期バージョン (sys_id)。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの initial_version フィールド内。
    resourceSpecification です。internalVersion リソース仕様のバージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルのバージョンフィールド内。
    resourceSpecification です。名前 リソース仕様の名前。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification]
    resourceSpecification です。バージョン リソース仕様の外部バージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの external_version フィールド内。
    サービス仕様 この製品仕様に関連するサービス仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "serviceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    serviceSpecification です。ID サービス仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの sys_id または external_id フィールド内。
    serviceSpecification です。internalId サービス仕様の初期バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの initial_version フィールド内。
    serviceSpecification です。internalVersion サービス仕様のバージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルのバージョンフィールド内。
    serviceSpecification です。名前 サービス仕様の名前。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification]
    serviceSpecification です。バージョン サービス仕様の外部バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの external_version フィールド内。
    validFor 仕様が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 仕様の終了日時。

    形式:YYYY-MM-DD HH:mm:SS。

    データタイプ：文字列
    validFor。startDateTime 仕様の開始日時。

    形式:YYYY-MM-DD HH:mm:SS。

    データタイプ：文字列
    バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの external_version フィールド内。

    次の例では、製品仕様 ID d6f8d9995b020210235d85cced81c7eb を要求本文で指定された情報で更新します。

    curl "http://instance.servicenow.com/api/sn_tmf_api/catalogmanagement/productSpecification/d6f8d9995b020210235d85cced81c7eb" \ 
--request PATCH\ 
--header "Accept:application/json" \ 
--user 'username':'password'
--data '{
  "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6",
  "name": "SD-WAN Service Package",
  "displayName": "SD-WAN Service Package v3",
  "version": "",
  "internalVersion": "3",
  "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "description": "SD WAN Service Package",
  "lastUpdate": "2027-10-11 06:58:12",
  "isBundle": true,
  "validFor": {
    "startDateTime": "2029-02-05",
    "endDateTime": ""
  },
  "serviceSpecification": [],
  "productSpecificationRelationship": [
    {
      "id": "216663aa53702010cd6dddeeff7b12b5",
      "name": "SD-WAN Controller",
      "version": "",
      "internalVersion": "1",
      "internalId": "216663aa53702010cd6dddeeff7b12b5",
      "type": "Service",
      "validFor": {
        "startDateTime": "2025-01-24",
        "endDateTime": ""
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "1",
        "numberSpecRelUpperLimit": "1"
      }
    },
    {
      "id": "39b627aa53702010cd6dddeeff7b1202",
      "name": "SD-WAN Edge Device",
      "version": "",
      "internalVersion": "2",
      "internalId": "39b627aa53702010cd6dddeeff7b1202",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-05",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "2",
        "numberSpecRelUpperLimit": "4"
      }
    },
    {
      "id": "a6514bd3534560102f18ddeeff7b1247",
      "name": "SD-WAN Security",
      "version": "",
      "internalVersion": "2",
      "internalId": "a6514bd3534560102f18ddeeff7b1247",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-03",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "4",
        "numberSpecRelUpperLimit": "20"
      }
    }
  ],
  "resourceSpecification": [],
  "productSpecCharacteristic": [
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.25",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.01",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.5",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Down Time",
      "description": "Down Time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:36:15"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "500 Mbps",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "5 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Bandwidth",
      "description": "Bandwidth",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:32:11"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "4 hrs",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 hr",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Time to Restore (TTR)",
      "description": "Time to Restore (TTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:37:25"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1 hr",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "4 hrs",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Mean Time to Restore (MTR)",
      "description": "Mean Time to Restore (MTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:39:05"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Flow Backup",
      "description": "Application Flow Backup",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:30:39"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "99.00",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.50",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.75",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.99",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Up Time",
      "description": "Up time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:34:30"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Encryption",
      "description": "Application Encryption",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:29:08"
      }
    }
  ],
  "status": "published"
}'

    応答本文:

    { 
  "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6",
  "name": "SD-WAN Service Package",
  "displayName": "SD-WAN Service Package v3",
  "version": "",
  "internalVersion": "3",
  "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "description": "SD WAN Service Package",
  "lastUpdate": "2027-10-11 06:58:12",
  "isBundle": true,
  "validFor": {
    "startDateTime": "2029-02-05",
    "endDateTime": ""
  },
  "serviceSpecification": [],
  "productSpecificationRelationship": [
    {
      "id": "216663aa53702010cd6dddeeff7b12b5",
      "name": "SD-WAN Controller",
      "version": "",
      "internalVersion": "1",
      "internalId": "216663aa53702010cd6dddeeff7b12b5",
      "type": "Service",
      "validFor": {
        "startDateTime": "2025-01-24",
        "endDateTime": ""
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "1",
        "numberSpecRelUpperLimit": "1"
      }
    },
    {
      "id": "39b627aa53702010cd6dddeeff7b1202",
      "name": "SD-WAN Edge Device",
      "version": "",
      "internalVersion": "2",
      "internalId": "39b627aa53702010cd6dddeeff7b1202",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-05",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "2",
        "numberSpecRelUpperLimit": "4"
      }
    },
    {
      "id": "a6514bd3534560102f18ddeeff7b1247",
      "name": "SD-WAN Security",
      "version": "",
      "internalVersion": "2",
      "internalId": "a6514bd3534560102f18ddeeff7b1247",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-03",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "4",
        "numberSpecRelUpperLimit": "20"
      }
    }
  ],
  "resourceSpecification": [],
  "productSpecCharacteristic": [
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.25",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.01",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.5",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Down Time",
      "description": "Down Time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:36:15"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "500 Mbps",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "5 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Bandwidth",
      "description": "Bandwidth",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:32:11"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "4 hrs",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 hr",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Time to Restore (TTR)",
      "description": "Time to Restore (TTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:37:25"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1 hr",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "4 hrs",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Mean Time to Restore (MTR)",
      "description": "Mean Time to Restore (MTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:39:05"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Flow Backup",
      "description": "Application Flow Backup",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:30:39"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "99.00",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.50",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.75",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.99",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Up Time",
      "description": "Up time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:34:30"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Encryption",
      "description": "Application Encryption",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:29:08"
      }
    }
  ],
  "status": "published"
}'

    製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/catalog

    製品オファリングカタログを作成します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/catalog

    サポートされている要求パラメーター

    表 : 85. パスパラメーター
    名前 説明
    なし
    表 : 86. クエリパラメーター
    名前 説明
    なし
    表 : 87. 要求本文パラメーター (JSON)
    名前 説明
    説明 製品オファリングカタログの説明。

    データタイプ：文字列

    デフォルト:空白の文字列
    externalId 外部システムからの製品オファリングカタログの一意の識別子。

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 必須。製品オファリングカタログの名前。

    データタイプ：文字列

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 88. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。
    表 : 89. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 90. ステータスコード
    ステータスコード 説明
    201 要求が正常に処理されました。
    400 要求が正しくありません。次のいずれかの理由が考えられます。
    • 空のペイロード。
    • 無効なペイロードです。必須フィールドがありません:<フィールド名>

    応答本文のパラメーター (JSON)

    名前 説明
    説明 製品オファリングカタログの説明。

    データタイプ：文字列
    ID 製品オファリングカタログのSys_id

    データタイプ：文字列

    テーブル:製品オファリングカタログ [sn_prd_pm_product_offering_catalog]
    名前 製品オファリングカタログの名前。

    データタイプ：文字列

    cURL 要求

    この例では、製品オファリングカタログを作成します。

    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'

    応答本文:

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

    製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productOffering

    製品オファリングおよび関連する製品オファリングバンドルを作成します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOffering

    サポートされている要求パラメーター

    表 : 91. パスパラメーター
    名前 説明
    なし
    表 : 92. クエリパラメーター
    名前 説明
    なし
    表 : 93. 要求本文パラメーター (JSON)
    名前 説明
    バンドルされたグループ製品オファリング 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。

    データタイプ:オブジェクトのアレイ

    "bundledGroupProductOffering": [
  {
    "bundledGroupProductOfferingOption": {Object},
    "bundledProductOffering": [Array],
    "id": "String",
    "name": "String"
  }
]
    bundledGroupProductOffering。bundledGroupProductOfferingOption 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。

    データタイプ：オブジェクト

    "bundledGroupProductOfferingOption": {
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。

    データタイプ：文字列
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。

    データタイプ：文字列
    bundledGroupProductOffering。バンドルされた製品オファリング バンドルに関連付けられた製品オファリングの子グループ。以下に指定されている bundledProductOffering と同じ形式です。

    データタイプ:オブジェクトのアレイ
    bundledGroupProductOffering。ID バンドルされたグループレコードのSys_id。親製品オファリングまたは親グループに複数のグループが含まれている場合に役立ちます。

    データタイプ：文字列

    テーブル:製品オファリング関係グループ [sn_prd_pm_product_offering_relationship_group]
    bundledGroupProductOffering。名前 子製品オファリングのグループの名前。

    データタイプ：文字列
    バンドルされた製品オファリング 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。

    データタイプ:オブジェクトのアレイ

    "bundledProductOffering": [
  {
    "bundledProductOfferingOption": {Object},
    "externalId": "String",
    "id": "String",
    "name": "String",
    "version": Number
  }
]
    bundledProductOffering。bundledProductOfferingOption 製品オファリングのデフォルト数や、製品オファリングの調達制約の上下など、製品バンドルオプション。

    データタイプ：オブジェクト

    "bundledProductOfferingOption": {
  "numberRelOfferDefault": "String",
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferDefault 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリング数の下限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。externalId 製品オファリング関係の外部 ID。

    製品オファリングの関係の詳細については、「 Create product offering relationships」を参照してください。

    データタイプ：文字列
    bundledProductOffering。ID バンドルされた製品オファリングの Sys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    bundledProductOffering。名前 製品オファリングバンドルの名前。

    データタイプ：文字列
    bundledProductOffering。バージョン 製品オファリングのカタログバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    category 製品が属するカテゴリのリスト。

    データタイプ:オブジェクトのアレイ

    "category:" [
  {
    "id": "String",
    "name": "String"
  }
]
    category.id category パラメーターを使用する場合は必須です。カテゴリの ID。

    データタイプ：文字列

    テーブル:カテゴリ [sc_category]
    category.name カテゴリの名前。

    データタイプ：文字列

    テーブル:カテゴリ [sc_category]
    チャネル 必須。製品オファリングの販売に使用するチャネル。

    データタイプ:オブジェクトのアレイ

    "channel:" [
  {
    "description": "String",
    "id": "String",
    "name": "String"
  }
]
    channel.description チャネルの説明。

    データタイプ：文字列
    channel.id 必須。チャネルのSys_id。

    データタイプ：文字列

    テーブル:流通チャネル [sn_prd_pm_distribution_channel]
    channel.name チャネルの名前。

    データタイプ：文字列
    説明 必須。製品オファリングの説明。

    データタイプ：文字列
    displayName 製品オファリングの表示名。

    データタイプ：文字列
    externalId 外部システムからの製品オファリングの一意の識別子。

    データタイプ：文字列
    href リソースレコードへの相対リンク。

    データタイプ：文字列
    ID 必須。製品オファリングの初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのinitial_versionフィールドまたはexternal_idフィールド内。
    internalId 製品オファリングレコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    internalVersion 製品オファリングのバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    isBundle 製品オファリングがバンドルかどうかを示すフラグ。
    可能な値：
    • true:製品オファリングはバンドルです。
    • false:単一の製品オファリング。

    データタイプ：ブール

    デフォルト値：false
    販売可能 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。
    可能な値：
    • true:個別に販売できます。
    • false:バンドルの一部としてのみ販売されます。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品オファリングが最後に更新された日付。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    ライフサイクルステータス 現在のライフサイクルステータス。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    名前 必須。製品オファリングの名前。

    データタイプ：文字列
    prodSpecCharValueUse 製品オファリング特性。

    データタイプ:オブジェクトのアレイ

    "prodSpecCharValueUse": [
   {
      "description": "String",
      "name": "String",
      "productSpecCharacteristicValue": [Array],
      "validFor": {Object},
      "valueType": "String"
   }
]
    prodSpecCharValueUse。説明 特性の説明。

    データタイプ：文字列
    prodSpecCharValueUse。名前
    特性の名前。

    データタイプ：文字列
    prodSpecCharValueUse。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    prodSpecCharValueUse。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    prodSpecCharValueUse。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。値タイプ prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品特性 製品特性のリスト。

    データタイプ:オブジェクトのアレイ

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristic.name 特性の名前。

    データタイプ：文字列
    productCharacteristic.value 特性の値。

    データタイプ：文字列
    製品オファリング特性 製品オファリングの特徴的な品質または特徴。特性は、モバイルプランランクなど、設計時 (カタログ作成) で固定される個別の値を取ることができます。これらの特性は通常、在庫レベルでは変更できません。

    製品オファリング特性の詳細については、「 Create product characteristics and characteristic options」を参照してください。

    データタイプ:オブジェクトのアレイ

    productOfferingCharacteristic": [  
  {
    "characteristicValueSpecification": [Array],
    "name": "String",
    "valueType": "String"
  }
]
    productOfferingCharacteristic。特性値仕様 製品オファリング特性に関連付けられた特性値のリスト。

    データタイプ:オブジェクトのアレイ

    "characteristicValueSpecification": [  
  { 
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "value": "String"
  }  
]
    productOfferingCharacteristic。characteristicValueSpecificationです。isDefault 関連付けられた特性値が関連付けられた特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値です。
    • false:デフォルト値ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。必須 関連する特性値が関連する特性に必須かどうかを示すフラグ。
    可能な値：
    • true:必須です。
    • false:必須ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。値 関連付けられた製品仕様特性に割り当てられた番号またはテキスト。
    たとえば、次のようになります：
    "characteristicValueSpecification": [
  {
    "value": "choice 1"
  },
  {
    "value": "choice 2"
  }
]

    データタイプ：文字列
    productOfferingCharacteristic。名前 関連付けられた製品オファリング特性の名前。

    データタイプ：文字列
    productOfferingCharacteristic。値タイプ productOfferingCharacteristic.​characteristicValueSpecification.​valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品オファリング価格 製品オファリングの価格情報。

    データタイプ:オブジェクトのアレイ

    "productOfferingPrice": [
  {
    "price": {Object},
    "priceType": "String"
  }
]
    productOfferingPrice.price 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "price": {
  "taxIncludedAmount": {Object}
}
    productOfferingPrice.price.taxIncludedAmount 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "taxIncludedAmount": {
  "unit": "String",
  "value": "String"
}
    productOfferingPrice.price.taxIncludedAmount.unit 製品オファリング価格の通貨コード。

    データタイプ：文字列

    フォーマット:ISO 4217
    productOfferingPrice.price.taxIncludedAmount.value 税込み製品オファリングの価格。

    データタイプ：文字列
    productOfferingPrice.priceType productOfferingPrice パラメーターを使用する場合は必須です。製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。
    有効な値：
    • 非繰り返し (1 回限り)
    • 繰り返し

    データタイプ：文字列
    productOfferingTerm 製品オファリングの有効な契約期間 (12 か月、24 か月、not_applicableなど)。

    データタイプ：文字列
    製品仕様 必須。製品の製品仕様。

    データタイプ：オブジェクト

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "name"
  "version": "String"
}
    productSpecification.id 必須。製品仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version または externa_id フィールド内。
    productSpecificationです。internalId 製品仕様レコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    productSpecificationです。名前 製品仕様の名前。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの名前フィールドにあります。
    productSpecificationです。バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    validFor 必須。製品オファリングが有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor.endDateTime 製品オファリングの終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD
    validFor.startDateTime 製品オファリングの開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD
    バージョン 製品オファリングの外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 94. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。
    表 : 95. 応答ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 96. ステータスコード
    ステータスコード 説明
    201 成功。要求が正常に処理されました。
    400 要求が正しくありません。考えられる理由：
    • 空のペイロード。
    • 無効なペイロードです。必須フィールドがありません:<フィールド名>

    応答本文のパラメーター

    名前 説明
    バンドルされたグループ製品オファリング 製品オファリングの子グループ。これらは階層的なサブグループ化を示しています。

    データタイプ:オブジェクトのアレイ

    "bundledGroupProductOffering": [
  {
    "bundledGroupProductOfferingOption": {Object},
    "bundledProductOffering": [Array],
    "id": "String",
    "name": "String"
  }
]
    bundledGroupProductOffering。bundledGroupProductOfferingOption 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の下限と上限を指定する数値の範囲。

    データタイプ：オブジェクト

    "bundledGroupProductOfferingOption": {
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの下限。

    データタイプ：文字列
    bundledGroupProductOffering。bundledGroupProductOfferingOption。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる製品オファリングの上限。

    データタイプ：文字列
    bundledGroupProductOffering。バンドルされた製品オファリング バンドルに関連付けられた製品オファリングの子グループ。以下に指定されている bundledProductOffering と同じ形式です。

    データタイプ:オブジェクトのアレイ
    bundledGroupProductOffering。ID バンドルされたグループレコードのSys_id。親製品オファリングまたは親グループに複数のグループが含まれている場合に役立ちます。

    データタイプ：文字列

    テーブル:製品オファリング関係グループ [sn_prd_pm_product_offering_relationship_group]
    bundledGroupProductOffering。名前 子製品オファリングのグループの名前。

    データタイプ：文字列
    バンドルされた製品オファリング 製品オファリングバンドルに含まれる製品オファリングのリスト。製品オファリングバンドルは、含まれている製品オファリングのすべての属性を継承します。

    データタイプ:オブジェクトのアレイ

    "bundledProductOffering": [
  {
    "bundledProductOfferingOption": {Object},
    "externalId": "String",
    "href": "String",
    "id": "String",
    "name": "String",
    "version": Number
  }
]
    bundledProductOffering。bundledProductOfferingOption 製品オファリングのデフォルト数や、製品オファリングの調達制約の上下など、製品バンドルオプション。

    データタイプ：オブジェクト

    "bundledProductOfferingOption": {
  "numberRelOfferDefault": "String",
  "numberRelOfferLowerLimit": "String",
  "numberRelOfferUpperLimit": "String"
}
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferDefault 関連するバンドル製品オファリングの一部として調達する必要がある製品オファリングのデフォルト数。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferLowerLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリング数の下限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。bundledProductOfferingOptionです。numberRelOfferUpperLimit 関連するバンドル製品オファリングの一部として調達できる関連製品オファリングの数の上限。

    データタイプ：文字列

    可能な値:0 でバインド解除。
    bundledProductOffering。externalId 製品オファリング関係の外部 ID。

    製品オファリングの関係の詳細については、「 Create product offering relationships」を参照してください。

    データタイプ：文字列
    bundledProductOffering。HREF 関連する製品オファリングへの相対リンク。

    データタイプ：文字列
    bundledProductOffering。ID バンドルされた製品オファリングの Sys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering]
    bundledProductOffering。名前 製品オファリングバンドルの名前。

    データタイプ：文字列
    bundledProductOffering。バージョン 製品オファリングのカタログバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    category 製品が属するカテゴリのリスト。

    データタイプ:オブジェクトのアレイ

    "category:" [
  {
    "id": "String",
    "name": "String"
  }
]
    category.id カテゴリの ID。

    データタイプ：文字列
    category.name カテゴリの名前。

    データタイプ：文字列
    チャネル 製品オファリングの販売に使用するチャネル。

    データタイプ:オブジェクトのアレイ

    "channel:" [
  {
    "description": "String",
    "id": "String",
    "name": "String"
  }
]
    チャネル。説明 チャネルの説明。

    データタイプ：文字列
    channel.id チャネルのSys_id。

    データタイプ：文字列

    テーブル:流通チャネル [sn_prd_pm_distribution_channel]
    channel.name チャネルの名前。

    データタイプ：文字列
    説明 製品オファリングの説明。

    データタイプ：文字列
    externalId 製品オファリングの外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [external_id] フィールド内。
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 必須。製品オファリングの初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの [initial_version] または [external_id] フィールド内。
    internalId 製品オファリングレコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    internalVersion 製品オファリングのバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    isBundle 製品オファリングがバンドルかどうかを示すフラグ。
    可能な値：
    • true:製品オファリングはバンドルです。
    • false:単一の製品オファリング。

    データタイプ：ブール

    デフォルト値：false
    販売可能 関連付けられた製品オファリングを単独で販売できるか、または製品オファリングバンドルの一部にする必要があるかを示すフラグ。
    可能な値：
    • true:個別に販売できます。
    • false:バンドルの一部としてのみ販売されます。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 製品オファリングが最後に更新された日付。

    データタイプ：文字列
    ライフサイクルステータス 製品オファリングの現在のライフサイクルステータス。

    有効な値：

    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 製品オファリングの名前。

    データタイプ：文字列
    prodSpecCharValueUse 製品オファリング特性。

    データタイプ:オブジェクトのアレイ

    "prodSpecCharValueUse": [
   {
      "description": "String",
      "name": "String",
      "productSpecCharacteristicValue": [Array],
      "validFor": {Object},
      "valueType": "String"
   }
]
    prodSpecCharValueUse。説明 特性の説明。

    データタイプ：文字列
    prodSpecCharValueUse。名前
    特性の名前。

    データタイプ：文字列
    prodSpecCharValueUse。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    prodSpecCharValueUse。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    prodSpecCharValueUse。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    prodSpecCharValueUse。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    prodSpecCharValueUse。値タイプ prodSpecCharValueUse.productSpecCharacteristicValue.valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品特性 製品特性のリスト。

    データタイプ:オブジェクトのアレイ

    "productCharacteristic": [
  {
    "name": "String",
    "value": "String"
  }
]
    productCharacteristicです。名前 特性の名前。

    データタイプ：文字列
    productCharacteristicです。値 特性の値。

    データタイプ：文字列
    製品オファリング特性 製品オファリングの特徴的な品質または特徴。特性は、モバイルプランランクなど、設計時 (カタログ作成) で固定される個別の値を取ることができます。これらの特性は通常、在庫レベルでは変更できません。

    製品オファリング特性の詳細については、「 Create product characteristics and characteristic options」を参照してください。

    データタイプ:オブジェクトのアレイ

    productOfferingCharacteristic": [  
  {
    "characteristicValueSpecification": [Array],
    "name": "String",
    "valueType": "String"
  }
]
    productOfferingCharacteristic。特性値仕様 製品オファリング特性に関連付けられた特性値のリスト。

    データタイプ:オブジェクトのアレイ

    "characteristicValueSpecification": [  
  { 
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "value": "String"
  }  
]
    productOfferingCharacteristic。characteristicValueSpecificationです。isDefault 関連付けられた特性値が関連付けられた特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値です。
    • false:デフォルト値ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。必須 関連する特性値が関連する特性に必須かどうかを示すフラグ。
    可能な値：
    • true:必須です。
    • false:必須ではありません。

    データタイプ：ブール

    デフォルト値：false
    productOfferingCharacteristic。characteristicValueSpecificationです。値 関連付けられた製品仕様特性に割り当てられた番号またはテキスト。
    たとえば、次のようになります：
    "characteristicValueSpecification": [
  {
    "value": "choice 1"
  },
  {
    "value": "choice 2"
  }
]

    データタイプ：文字列
    productOfferingCharacteristic。名前 関連付けられた製品オファリング特性の名前。

    データタイプ：文字列
    productOfferingCharacteristic。値タイプ productOfferingCharacteristic.​characteristicValueSpecification.​valueパラメーターのデータタイプ。
    可能な値：
    • 選択
    • メール
    • 番号
    • テキスト
    • はい/いいえ

    データタイプ：文字列
    製品オファリング価格 製品オファリングの価格情報。

    データタイプ:オブジェクトのアレイ

    "productOfferingPrice": [
  {
    "price": {Object},
    "priceType": "String"
  }
]
    productOfferingPrice です。価格 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "price": {
  "taxIncludedAmount": {Object}
}
    productOfferingPrice です。価格。税込み金額 製品オファリングの価格情報。

    データタイプ：オブジェクト

    "taxIncludedAmount": {
  "unit": "String",
  "value": "String"
}
    productOfferingPrice です。価格。taxIncludedAmount.unit 製品オファリング価格の通貨コード。

    データタイプ：文字列
    productOfferingPrice です。価格。taxIncludedAmount です。値 税込み製品オファリングの価格。

    データタイプ：文字列
    productOfferingPrice です。価格タイプ 製品オファリング価格タイプ (1 回払いまたは繰り返し支払い)。
    可能な値：
    • 非繰り返し (1 回限り)
    • 繰り返し

    データタイプ：文字列
    productOfferingTerm 製品オファリングの有効な契約期間。

    データタイプ：文字列
    製品仕様 製品の製品仕様。

    データタイプ：オブジェクト

    "productSpecification": {
  "id": "String",
  "internalId": "String",
  "internalVersion": "String",
  "name": "String",
  "version": "String"
}
    productSpecificationです。ID 製品仕様レコードのSys_id。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalId 製品仕様レコードのSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの initial_version フィールド内。
    productSpecificationです。internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルのバージョンフィールド内。
    productSpecificationです。バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。
    ステータス 製品オファリングのステータス。
    可能な値：
    • ドラフト
    • 公開済み

    データタイプ：文字列
    validFor 製品オファリングが有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 製品オファリングの終了日。

    データタイプ：文字列
    validFor。startDateTime 製品オファリングの開始日。

    データタイプ：文字列
    バージョン 製品オファリングの外部バージョン。

    データタイプ：文字列

    テーブル:製品オファリング [sn_prd_pm_product_offering] テーブルの external_version フィールド内。

    この例では、製品オファリングを作成します。

    curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productOffering" \
--header "Content-Type: application/json" \
--header "Accept:application/json" \
--data-raw '{
  "id": "313b917843235210a82ed6085bb8f2c7",
  "name": "Internet bundle",
  "displayName": "Internet bundle",
  "description": "Internet bundle",
  "isSellable": false,
  "lifecycleStatus": "Draft",
  "isBundle": true,
  "lastUpdate": "2025-02-05 06:39:45",
  "version": "",
  "internalVersion": "1",
  "internalId": "313b917843235210a82ed6085bb8f2c7",
  "validFor": {
    "startDateTime": "2028-12-15",
    "endDateTime": "2034-01-14"
  },
  "productOfferingTerm": "not_applicable",
  "productOfferingPrice": [
    {
      "priceType": "recurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    },
    {
      "priceType": "nonRecurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    }
  ],
  "productOfferingCharacteristic": [
    {
      "name": "Firewall Security",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "Premium",
          "isMandatory": false,
          "isDefault": true
        }
      ]
    },
    {
      "name": "Connectivity need",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "When in use",
          "isMandatory": false,
          "isDefault": false
        }
      ]
    }
  ],
  "bundledProductOffering": [
    {
      

      "id": "0f61dd9fd0a63110f8770dbf976be168",
      "name": "Solana Sports streaming channel",
      "version": "1",
      "externalId": "EXT-123",
      "bundledProductOfferingOption": {
        "numberRelOfferDefault": "1",
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "bundledGroupProductOffering": [
    {
      "id": "063b957843235210a82ed6085bb8f205",
      "name": "Streaming Channel",
      "bundledProductOffering": [
        { 
        

          "id": "62619d9fd0a63110f8770dbf976be180",
          "name": "Solana Movie streaming channel",
          "version": "1",
          "externalId": "EXT-345",
          "bundledProductOfferingOption": {
            "numberRelOfferDefault": "1",
            "numberRelOfferLowerLimit": "1",
            "numberRelOfferUpperLimit": "1"
          }
        }
      ],
      "bundledGroupProductOfferingOption": {
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "productSpecification": {
    "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
    "name": "SD-WAN Service Package",
    "version": "",
    "internalVersion": "3",
    "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
  },
  "prodSpecCharValueUse": [
    {
      "name": "Tenancy",
      "description": "Tenancy",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2024-12-18 21:04:24"
      },
      "productSpecCharacteristicValue": [
        {
          "value": "Premium (>50 sites)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Base (10 site)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "productSpecification": {
        "id": "216663aa53702010cd6dddeeff7b12b5",
        "name": "SD-WAN Controller",
        "version": "",
        "internalVersion": "1",
        "internalId": "216663aa53702010cd6dddeeff7b12b5"
      }
    }
  ],
  "channel": [
    {
      "id": "58ad5522c3702010df4773ce3640ddb2",
      "name": "Agent Assist"
    }
  ],
  "category": [
    {
      "id": "13e305a143b631105029d1529ab8f267",
      "name": "SD-WAN_all_offers"
    }
  ],
  "status": "draft"
}'
--user 'username':'password'

    応答本文:

    {
  "id": "313b917843235210a82ed6085bb8f2c7",
  "name": "Internet bundle",
  "displayName": "Internet bundle",
  "description": "Internet bundle",
  "isSellable": false,
  "lifecycleStatus": "Draft",
  "isBundle": true,
  "lastUpdate": "2025-04-09 15:59:09",
  "version": "",
  "internalVersion": "1",
  "validFor": {
    "startDateTime": "2028-12-15",
    "endDateTime": "2034-01-14"
  },
  "productOfferingTerm": "not_applicable",
  "productOfferingPrice": [
    {
      "priceType": "recurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    },
    {
      "priceType": "nonRecurring",
      "price": {
        "taxIncludedAmount": {
          "unit": "USD",
          "value": "0"
        }
      }
    }
  ],
  "productOfferingCharacteristic": [
    {
      "name": "Firewall Security",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "Premium",
          "isMandatory": false,
          "isDefault": true
        }
      ]
    },
    {
      "name": "Connectivity need",
      "valueType": "choice",
      "characteristicValueSpecification": [
        {
          "value": "When in use",
          "isMandatory": false,
          "isDefault": false
        }
      ]
    }
  ],
  "bundledProductOffering": [
    {
      "id": "0f61dd9fd0a63110f8770dbf976be168",
      "name": "Solana Sports streaming channel",
      "version": "1",
      "externalId": "EXT-123",
      "bundledProductOfferingOption": {
        "numberRelOfferDefault": "1",
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "bundledGroupProductOffering": [
    {
      "id": "063b957843235210a82ed6085bb8f205",
      "name": "Streaming Channel",
      "bundledProductOffering": [
        {
          "id": "62619d9fd0a63110f8770dbf976be180",
          "name": "Solana Movie streaming channel",
          "version": "1",
          "externalId": "EXT-345",
          "bundledProductOfferingOption": {
            "numberRelOfferDefault": "1",
            "numberRelOfferLowerLimit": "1",
            "numberRelOfferUpperLimit": "1"
          }
        }
      ],
      "bundledGroupProductOfferingOption": {
        "numberRelOfferLowerLimit": "1",
        "numberRelOfferUpperLimit": "1"
      }
    }
  ],
  "productSpecification": {
    "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
    "name": "SD-WAN Service Package",
    "version": "",
    "internalVersion": "3",
    "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6"
  },
  "prodSpecCharValueUse": [
    {
      "name": "Tenancy",
      "description": "Tenancy",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2024-12-18 21:04:24"
      },
      "productSpecCharacteristicValue": [
        {
          "value": "Premium (>50 sites)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Base (10 site)",
          "isDefault": false,
          "isMandatory": false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "productSpecification": {
        "id": "216663aa53702010cd6dddeeff7b12b5",
        "name": "SD-WAN Controller",
        "version": "",
        "internalVersion": "1",
        "internalId": "216663aa53702010cd6dddeeff7b12b5"
      }
    }
  ],
  "channel": [
    {
      "id": "58ad5522c3702010df4773ce3640ddb2",
      "name": "Agent Assist"
    }
  ],
  "category": [
    {
      "id": "13e305a143b631105029d1529ab8f267",
      "name": "SD-WAN_all_offers"
    }
  ],
  "status": "draft",
  "externalId": "313b917843235210a82ed6085bb8f2c7",
  "internalId": "03c99cb53bf066509b48d69a04e45a11",
  "href": "/api/sn_tmf_api/catalogmanagement/productOffering/03c99cb53bf066509b48d69a04e45a11"
}

    製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productOfferingPrice

    価格明細 [sn_csm_pricing_price_list_line] テーブルに新しい価格明細レコードを作成します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productOfferingPrice

    サポートされている要求パラメーター

    表 : 97. パスパラメーター
    名前 説明
    なし
    表 : 98. クエリパラメーター
    名前 説明
    なし
    表 : 99. 要求本文パラメーター (XML または JSON)
    名前 説明
    @type 必須。価格明細のタイプ。常に ProductOfferingPrice の値です。

    データタイプ：文字列
    externalId 価格明細の外部 ID。

    データタイプ：文字列
    isBundle 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。
    有効な値：
    • true:価格明細はバンドルの一部です。
    • false:価格明細はバンドルの一部ではありません。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 必須。価格行が最後に更新された日付。

    形式:YYYY-MM-DD

    データタイプ：文字列
    ライフサイクルステータス 必須。製品リスト明細の現在のライフサイクルステータス。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:ドラフト
    名前 必須。価格明細に付ける名前。

    データタイプ：文字列
    価格 必須。価格明細の表示価格の詳細。

    データタイプ：オブジェクト

    "price": {
  "unit": "String",
  "value": "String"
}
    price.unit 必須。価格明細の通貨コード。たとえば、 USD や EUR などです。

    テーブル:通貨 [fx_currency] テーブル。

    データタイプ：文字列
    price.value 必須。価格の値。

    データタイプ:文字列 (数値で表されます。例:「 800」)。
    priceList 必須。価格明細に関連付けられた価格リスト情報。

    データタイプ：オブジェクト

    "priceList": {
  "id": "String",
  "name": "String",
  "@type": "String"
}
    priceList.id 必須。価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    priceList.name 価格明細の名前。

    データタイプ：文字列
    priceList.@type 価格明細のタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。値は常に priceList です。

    データタイプ：文字列
    価格タイプ 必須。製品オファリングの価格設定方法で価格明細をフィルタリングします。
    有効な値：
    • recurring:指定された頻度で繰り返し価格設定金額を請求します。頻度は recurringChargePeriodType パラメーターで設定します。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金と料金をサポートします。

    データタイプ：文字列

    デフォルト:繰り返し
    productOffering 必須。価格明細の製品オファリング。

    データタイプ：オブジェクト

    "productOffering": {
  "id": "String",
  "name": "String",
  "internalVersion": "String"
}
    productOffering。ID 必須。製品オファリングのSys_id。

    テーブル:製品オファリング [sn_prd_pm_product_offering]

    データタイプ：文字列
    productOffering。internalVersion 製品オファリングの内部バージョン番号。

    データタイプ:文字列 (数値で表されます。たとえば、「 1」などです。
    productOffering。名前 製品オファリングの名前。

    データタイプ：文字列
    recurringChargePeriodType priceTypeを繰り返す場合は必須です。製品オファリングの作成時に選択されたコミットメント期間。
    有効な値：
    • 年次
    • 月次

    データタイプ：文字列
    測定単位 必須。価格明細に関連付けられた測定単位に関する詳細。

    データタイプ：オブジェクト

    "unitOfMeasure": {
  "id": "String",
  "amount": Number,
  "units": "String"
}
    unitOfMeasureです。総計 測定単位の金額。

    データタイプ：数値
    unitOfMeasureです。ID 必須。価格ラインリストテーブルの測定単位のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    unitOfMeasureです。単位 価格明細に関連付けられた測定単位のタイプ。たとえば、各またはバンドルです。

    データタイプ：文字列
    validFor 必須。価格明細が有効な期間。

    データタイプ：オブジェクト

    "validFor": {
  "endDate": "String",
  "startDate": "String"
}
    validFor.endDate 価格明細が有効な終了日。

    データタイプ:文字列 (glide_date_time)
    validFor.endDateTime 価格明細が有効な終了日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ:文字列 (glide_date)
    validFor.startDate 価格明細が有効な開始日。

    データタイプ:文字列 (glide_date_time)
    validFor.startDateTime 価格明細が有効な開始日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ:文字列 (glide_date)

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 100. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 101. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 102. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。
    考えられる理由：
    • 無効なパスパラメーター
    • 無効な URI
    404 見つかりません。要求されたアイテムが見つかりませんでした。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    ID 価格明細のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    href インスタンス内の価格明細レコードへの URL。

    データタイプ：文字列
    前回の更新 価格明細が最後に更新された日時。

    形式:YYYY-MM-DD HH:mm:ss

    データタイプ：文字列
    validFor 価格明細が有効な期間。

    データタイプ：オブジェクト

    "validFor": {
  "endDate": "String",
  "startDate": "String"
}
    validFor.endDate 価格明細が有効な終了日時。

    データタイプ:文字列 (glide_date_time)
    validFor.startDate 価格明細が有効な開始日時。

    データタイプ:文字列 (glide_date_time)
    isBundle 価格明細が単一の製品の一部であるか、製品のバンドルの一部であるかを示すフラグ。
    有効な値：
    • true:価格明細はバンドルの一部です。
    • false:価格明細はバンドルの一部ではありません。

    データタイプ：ブール
    ライフサイクルステータス 価格明細の現在のライフサイクル状況。
    有効な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列
    productOffering 価格明細に関連付けられている製品オファリング。

    データタイプ：オブジェクト

    "productOffering": {
  "id": "String",
  "name": "String",
  "internalVersion": "String"
}
    productOffering.id 製品オファリングのSys_id。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。internalVersion 製品オファリングの内部バージョン番号。たとえば、 PRDOF01024 などです。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    productOffering。名前 製品オファリングの名前。製品オファリング [sn_prd_pm_product_offering] テーブルにあります。

    データタイプ：文字列
    価格タイプ この価格明細に関連付けられている製品オファリングの価格設定方法。
    可能な値：
    • recurring:指定された頻度で繰り返し価格設定金額を請求します。recurringChargePeriodTypeの値は、充電の頻度を示します。
    • one_time:製品オファリングの 1 回限りまたは繰り返しのアドオン課金および料金。

    データタイプ：文字列
    recurringChargePeriodType この価格明細に関連付けられた製品オファリングの周期性または頻度。繰り返しに設定されている場合は頻度タイプpriceType返し、それ以外の場合は空の文字列を返します。
    可能な値：
    • 年次
    • 月次

    データタイプ：文字列
    測定単位 価格明細に関連付けられた測定単位に関する詳細。

    データタイプ：オブジェクト

    "unitOfMeasure": {
  "id": "String",
  "amount": Number,
  "units": "String"
}
    unitOfMeasure.amount 測定単位の金額。

    データタイプ：数値
    unitOfMeasure.id 測定単位のSys_id。

    テーブル:価格明細 [sn_csm_pricing_price_list_line]

    データタイプ：文字列
    unitOfMeasureです。単位 価格明細に関連付けられた測定単位のタイプ。たとえば、 年 や バンドルなどです。

    データタイプ：文字列
    価格 価格明細の表示価格の詳細。

    データタイプ：オブジェクト

    "price": {
  "units": "String",
  "value": "String"
}
    price.units 価格の通貨コード。たとえば、 USD や EUR などです。

    テーブル:通貨 [fx_currency]

    データタイプ：文字列
    price.value 価格の値。

    データタイプ:文字列 (数値で表される)
    priceList 価格明細に関連付けられた価格リスト情報。

    データタイプ：オブジェクト

    "priceList": {
  "id": "String",
  "name": "String",
  "@type": "String"
}
    priceList.id 価格リスト [sn_csm_pricing_price_list] テーブルの価格リストのSys_id。

    データタイプ：文字列
    priceList.name 価格リストの名前。

    データタイプ：文字列
    priceList.@type 価格リストのタイプ。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。常に priceList の値を持ちます。

    データタイプ：文字列
    @type 常に ProductOfferingPrice の値です。サブクラス化する場合、これはサブクラスの拡張可能名を定義します。

    データタイプ：文字列
    状況 この価格明細に関連付けられている価格リストのステータス。

    データタイプ：文字列
    externalId この価格明細の外部 ID。

    データタイプ：文字列

    cURL 要求

    次の例では、要求本文で指定されたデータに従って新しい価格明細レコードを作成し、価格明細 [sn_csm_pricing_price_list_line] テーブルに挿入します。

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

    応答本文。この新しい価格明細レコードには一意の ID が割り当てられます。応答本文は、 href 応答パラメーターを使用して、この情報と新しいレコードへの URL を返します。

    {
  "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"
}

    製品カタログオープン API - POST /sn_tmf_api/catalogmanagement/productSpecification

    指定された値で製品仕様レコードを作成します。

    URL 形式

    デフォルト URL: /api/sn_tmf_api/catalogmanagement/productSpecification

    サポートされている要求パラメーター

    表 : 103. パスパラメーター
    名前 説明
    なし
    表 : 104. クエリパラメーター
    名前 説明
    なし
    表 : 105. 要求本文パラメーター (JSON)
    名前 説明
    説明 必須。仕様の説明。

    データタイプ：文字列
    externalId 外部システムからの製品仕様の一意の識別子。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 必須。製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのinitial_versionまたはexternal_id内。
    internalId 必須。
    製品仕様のSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version フィールド内。
    internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのバージョンフィールドにあります。
    前回の更新 仕様が最後に更新された日付。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    名前 必須。仕様の名前。

    データタイプ：文字列
    製品仕様特性 仕様特性。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristic": [
  {
    "description": "String",
    "name": "String",
    "productSpecCharacteristicValue": [Array],
    "validFor": {Object},
    "valueType": "String"
  }
]
    productSpecCharacteristic。説明 特性の説明。

    データタイプ：文字列

    デフォルト:空白の文字列
    productSpecCharacteristic。名前 必須。特性の名前。

    データタイプ：文字列
    productSpecCharacteristic。製品仕様特性値 必須。
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    productSpecCharacteristic。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    productSpecCharacteristic。productSpecCharacteristicValue。値 必須。
    特性の値。

    データタイプ：文字列
    productSpecCharacteristic。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecCharacteristic。validFor。終了日時 特性の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    productSpecCharacteristic。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    productSpecCharacteristic。値タイプ 特性の値タイプ (選択肢やメールなど)。

    データタイプ：文字列

    デフォルト:空白の文字列
    製品仕様関係 この仕様と他の製品仕様との関係。

    データタイプ：アレイ

    "productSpecificationRelationship": [
  {
    "id": "String",
    "type": "String",
    "validFor": Object
  }
]
    productSpecificationRelationship です。ID 関連仕様の ID。

    データタイプ：文字列

    デフォルト:空白の文字列
    productSpecificationRelationship です。タイプ productSpecificationRelationship パラメーターを使用する場合は必須です。関係のタイプ。
    有効な値：
    • バンドル
    • composed_of

    データタイプ：文字列
    productSpecificationRelationship です。validFor 関係が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
   "endDateTime": "String",
   "startDateTime": "String"
}
    productSpecificationRelationship です。validFor。終了日時 関係の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    productSpecificationRelationship です。validFor。startDateTime 関係の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    リソース仕様 必須。この製品仕様に関連するリソース仕様。

    データタイプ:オブジェクトのアレイ

    "resourceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    resourceSpecification です。ID 必須。リソース仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの sys_id または external_id フィールド。
    resourceSpecification です。internalId リソース仕様レコードの初期バージョン (sys_id)。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの initial_version フィールド内。
    resourceSpecification です。internalVersion リソース仕様のバージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルのバージョンフィールド内。
    resourceSpecification です。名前 リソース仕様の名前。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification]
    resourceSpecification です。バージョン リソース仕様の外部バージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの external_version フィールド内。
    サービス仕様 この製品仕様に関連するサービス仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "serviceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    serviceSpecification です。ID サービス仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの sys_id または external_id フィールド内。
    serviceSpecification です。internalId サービス仕様の初期バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの initial_version フィールド内。
    serviceSpecification です。internalVersion サービス仕様のバージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルのバージョンフィールド内。
    serviceSpecification です。名前 サービス仕様の名前。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification]
    serviceSpecification です。バージョン サービス仕様の外部バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの external_version フィールド内。
    validFor 必須。仕様が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 仕様の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    validFor。startDateTime 仕様の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS。例: 2025-01-31 09:35:43。

    デフォルト:空白の文字列
    バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの external_version フィールド内。

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 106. 要求ヘッダー
    ヘッダー 説明
    受容 応答本文のデータ形式。application/jsonのみをサポートしています。
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。
    表 : 107. 応答ヘッダー
    ヘッダー 説明
    Content-Type 応答本文のデータ形式。application/jsonのみをサポートしています。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 108. ステータスコード
    ステータスコード 説明
    201 要求が正常に処理されました。
    400 要求が正しくありません。考えられる理由：
    • 空のペイロード。
    • 無効なペイロードです。必須フィールドがありません:<フィールド名>

    応答本文のパラメーター

    名前 説明
    説明 仕様の説明。

    データタイプ：文字列
    href リソースレコードへの相対リンク。

    データタイプ：文字列

    デフォルト:空白の文字列
    ID 製品仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの sys_id または external_id フィールド内。
    internalId 必須。
    製品仕様のSys_id ID または内部 ID。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの initial_version フィールド内。
    internalVersion 製品仕様のバージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルのバージョンフィールドにあります。
    isBundle productSpecificationが単一の製品を表すか、製品のバンドルを表すかを示すフラグ。
    有効な値：
    • true:製品仕様は製品バンドルであり、複数の製品が含まれています。
    • false:製品仕様には単一の製品が含まれています。

    データタイプ：ブール

    デフォルト値：false
    前回の更新 仕様が最後に更新された日付。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    ライフサイクルステータス 製品仕様の現在のライフサイクルステータス。
    可能な値：
    • アクティブ
    • ドラフト
    • 非アクティブ

    データタイプ：文字列

    デフォルト:空白の文字列
    名前 仕様の名前。

    データタイプ：文字列
    製品仕様特性 仕様特性。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristic": [
  {
    "description": "String",
    "name": "String",
    "productSpecCharacteristicValue": [Array],
    "validFor": {Object},
    "valueType": "String"
  }
]
    productSpecCharacteristic。説明 特性の説明。

    データタイプ：文字列
    productSpecCharacteristic。名前 特性の名前。

    データタイプ：文字列
    productSpecCharacteristic。製品仕様特性値
    特性の可能な値のリスト。

    データタイプ:オブジェクトのアレイ

    "productSpecCharacteristicValue": [
 {
    "isDefault": Boolean,
    "isMandatory": Boolean,
    "validFor": {Object},
    "value": "String"
 }
]
    productSpecCharacteristic。productSpecCharacteristicValue。isDefault 関連付けられた特性値が特性のデフォルト値であるかどうかを示すフラグ。
    可能な値：
    • true:デフォルト値。
    • false:デフォルト値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。必須 関連付けられた特性値が特性の必須値であるかどうかを示すフラグ。
    可能な値：
    • true:必須値。
    • false:必須の値ではありません。

    デフォルト値：false
    productSpecCharacteristic。productSpecCharacteristicValue。validFor 特性が有効になった日時。

    データタイプ：オブジェクト

    "validFor": {
  "startDateTime": "String"
}
    productSpecCharacteristic。productSpecCharacteristicValue。validFor。startDateTime 特性値が有効になる開始日時。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。productSpecCharacteristicValue。値
    特性の値。

    データタイプ：文字列
    productSpecCharacteristic。validFor 特性が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecCharacteristic。validFor。終了日時 特性の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。validFor。startDateTime 特性の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecCharacteristic。値タイプ 特性の値タイプ (選択肢やメールなど)。

    データタイプ：文字列
    製品仕様関係 この仕様と他の製品仕様との関係。

    データタイプ:オブジェクトのアレイ

    "productSpecificationRelationship": [
  {
    "id": "String",
    "type": "String",
    "validFor": Object
  }
]
    productSpecificationRelationship です。ID 関連仕様のSys_id。

    データタイプ：文字列
    productSpecificationRelationship です。タイプ 関係のタイプ。

    データタイプ：文字列
    productSpecificationRelationship です。validFor 関係が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    productSpecificationRelationship です。validFor。終了日時 関係の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    productSpecificationRelationship です。validFor。startDateTime 関係の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    リソース仕様 この製品仕様に関連するリソース仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "resourceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    resourceSpecification です。ID リソース仕様のSys_id ID または外部 ID。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの sys_id または external_id フィールド。
    resourceSpecification です。internalId リソース仕様レコードの初期バージョン (sys_id)。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの initial_version フィールド内。
    resourceSpecification です。internalVersion リソース仕様のバージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルのバージョンフィールド内。
    resourceSpecification です。名前 リソース仕様の名前。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification]
    resourceSpecification です。バージョン リソース仕様の外部バージョン。

    データタイプ：文字列

    テーブル:リソース仕様 [sn_prd_pm_resource_specification] テーブルの external_version フィールド内。
    サービス仕様 この製品仕様に関連するサービス仕様のリスト。

    データタイプ:オブジェクトのアレイ

    "serviceSpecification": [
  {
    "id": "String",
    "internalId": "String",
    "internalVersion": "String",
    "name": "String",
    "version": "String"
  }
]
    serviceSpecification です。ID サービス仕様の初期バージョンまたは外部 ID。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの sys_id または external_id フィールド内。
    serviceSpecification です。internalId サービス仕様の初期バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの initial_version フィールド内。
    serviceSpecification です。internalVersion サービス仕様のバージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルのバージョンフィールド内。
    serviceSpecification です。名前 サービス仕様の名前。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification]
    serviceSpecification です。バージョン サービス仕様の外部バージョン。

    データタイプ：文字列

    テーブル:サービス仕様 [sn_prd_pm_service_specification] テーブルの external_version フィールド内。
    validFor 仕様が有効な日付範囲。

    データタイプ：オブジェクト

    "validFor": {
  "endDateTime": "String",
  "startDateTime": "String"
}
    validFor。終了日時 仕様の終了日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    validFor。startDateTime 仕様の開始日。

    データタイプ：文字列

    形式:YYYY-MM-DD HH:mm:SS
    バージョン 製品仕様の外部バージョン。

    データタイプ：文字列

    テーブル:製品仕様 [sn_prd_pm_product_specification] テーブルの external_version フィールド内。

    この例では、指定した値で製品仕様レコードを作成します。

    curl --location --request POST "https://instance.service-now.com/api/sn_tmf_api/catalogmanagement/productSpecification" \
--header "Content-Type: application/json" \
--data-raw '{
  "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6",
  "name": "SD-WAN Service Package",
  "displayName": "SD-WAN Service Package v3",
  "version": "",
  "internalVersion": "3",
  "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "description": "SD WAN Service Package",
  "lastUpdate": "2027-10-11 06:58:12",
  "isBundle": true,
  "validFor": {
    "startDateTime": "2029-02-05",
    "endDateTime": ""
  },
  "serviceSpecification": [],
  "productSpecificationRelationship": [
    {
      "id": "216663aa53702010cd6dddeeff7b12b5",
      "name": "SD-WAN Controller",
      "version": "",
      "internalVersion": "1",
      "internalId": "216663aa53702010cd6dddeeff7b12b5",
      "type": "Service",
      "validFor": {
        "startDateTime": "2025-01-24",
        "endDateTime": ""
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "1",
        "numberSpecRelUpperLimit": "1"
      }
    },
    {
      "id": "39b627aa53702010cd6dddeeff7b1202",
      "name": "SD-WAN Edge Device",
      "version": "",
      "internalVersion": "2",
      "internalId": "39b627aa53702010cd6dddeeff7b1202",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-05",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "2",
        "numberSpecRelUpperLimit": "4"
      }
    },
    {
      "id": "a6514bd3534560102f18ddeeff7b1247",
      "name": "SD-WAN Security",
      "version": "",
      "internalVersion": "2",
      "internalId": "a6514bd3534560102f18ddeeff7b1247",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-03",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "4",
        "numberSpecRelUpperLimit": "20"
      }
    }
  ],
  "resourceSpecification": [],
  "productSpecCharacteristic": [
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.25",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.01",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.5",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Down Time",
      "description": "Down Time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:36:15"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "500 Mbps",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "5 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Bandwidth",
      "description": "Bandwidth",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:32:11"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "4 hrs",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 hr",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Time to Restore (TTR)",
      "description": "Time to Restore (TTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:37:25"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1 hr",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "4 hrs",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Mean Time to Restore (MTR)",
      "description": "Mean Time to Restore (MTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:39:05"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Flow Backup",
      "description": "Application Flow Backup",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:30:39"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "99.00",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.50",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.75",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.99",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Up Time",
      "description": "Up time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:34:30"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Encryption",
      "description": "Application Encryption",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:29:08"
      }
    }
  ],
  "status": "published"
}'

--user 'username':'password'

    応答本文。

    {
  "id": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "href": "/api/sn_tmf_api/catalogmanagement/productSpecification/cfe5ef6a53702010cd6dddeeff7b12f6",
  "name": "SD-WAN Service Package",
  "displayName": "SD-WAN Service Package v3",
  "version": "",
  "internalVersion": "3",
  "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6",
  "description": "SD WAN Service Package",
  "lastUpdate": "2027-10-11 06:58:12",
  "isBundle": true,
  "validFor": {
    "startDateTime": "2029-02-05",
    "endDateTime": ""
  },
  "serviceSpecification": [],
  "productSpecificationRelationship": [
    {
      "id": "216663aa53702010cd6dddeeff7b12b5",
      "name": "SD-WAN Controller",
      "version": "",
      "internalVersion": "1",
      "internalId": "216663aa53702010cd6dddeeff7b12b5",
      "type": "Service",
      "validFor": {
        "startDateTime": "2025-01-24",
        "endDateTime": ""
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "1",
        "numberSpecRelUpperLimit": "1"
      }
    },
    {
      "id": "39b627aa53702010cd6dddeeff7b1202",
      "name": "SD-WAN Edge Device",
      "version": "",
      "internalVersion": "2",
      "internalId": "39b627aa53702010cd6dddeeff7b1202",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-05",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "2",
        "numberSpecRelUpperLimit": "4"
      }
    },
    {
      "id": "a6514bd3534560102f18ddeeff7b1247",
      "name": "SD-WAN Security",
      "version": "",
      "internalVersion": "2",
      "internalId": "a6514bd3534560102f18ddeeff7b1247",
      "type": "Service",
      "validFor": {
        "startDateTime": "2026-06-03",
        "endDateTime": "2031-07-05"
      },
      "relationshipType": "bundles",
      "ProdSpecRelationshipOption": {
        "numberSpecRelLowerLimit": "1",
        "numberSpecRelDefault": "4",
        "numberSpecRelUpperLimit": "20"
      }
    }
  ],
  "resourceSpecification": [],
  "productSpecCharacteristic": [
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.25",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.01",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "0.5",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Down Time",
      "description": "Down Time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:36:15"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "500 Mbps",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "5 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 Gbps",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Bandwidth",
      "description": "Bandwidth",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:32:11"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "4 hrs",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "1 hr",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Time to Restore (TTR)",
      "description": "Time to Restore (TTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:37:25"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "1 hr",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "2 hrs",
          "isMandatory":true,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "4 hrs",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Mean Time to Restore (MTR)",
      "description": "Mean Time to Restore (MTR)",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:39:05"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Flow Backup",
      "description": "Application Flow Backup",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:30:39"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "99.00",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.50",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.75",
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "99.99",
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Up Time",
      "description": "Up time",
      "valueType": "choice",
      "validFor": {
        "startDatetime": "2027-10-11 02:34:30"
      }
    },
    {
      "productSpecCharacteristicValue": [
        {
          "value": "No",
          "isMandatory":true,
          "isDefault":true,
          "validFor": {
            "startDateTime": ""
          }
        },
        {
          "value": "Yes",
          "isMandatory":false,
          "isDefault":false,
          "validFor": {
            "startDateTime": ""
          }
        }
      ],
      "name": "Application Encryption",
      "description": "Application Encryption",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2027-10-11 02:29:08"
      }
    }
  ],
  "status": "published"
}'