---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference
Release :
- australia
ft:locale :
- ja-JP
ft:publication_title :
- オーストラリア API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# 製品インベントリオープン API
# 製品インベントリオープン API {#ariaid-title1}
* リリースバージョン: Australia
*
* 更新日 2026年03月12日
*
*  所要時間：93分
Product Inventory Open API は、製品インベントリを作成および取得するためのエンドポイントを提供します。
この API を使用して、外部システムと ServiceNow AI Platform間の製品インベントリ情報を管理します。
この API は、 ServiceNow Store で入手可能な Product Inventory Advanced アプリケーションに含まれています。
この API は、 `sn_prd_invt` 名前空間内で提供されます。
呼び出し元ユーザーには、sn_prd_invt.product_inventory_integrator ロールが必要です。
この API は、次のテーブルのデータを作成および更新します。
* 製品特性 \[sn_prd_invt_product_characteristics\]
* 製品インベントリ \[sn_prd_invt_product_inventory\]
* 製品モデル \[cmdb_model\]
* 製品モデル特性 \[sn_prd_pm_product_model_characteristic\]
{#product-inventory-open-api__ul_fhn_pjj_hsb}
Product Inventory Open API は、TM Forum Product Inventory Management API REST 仕様のServiceNow®実装です。この実装は、 [TMF637 Product Inventory Management API ユーザーガイド v5.0.0](https://www.tmforum.org/resources/specifications/tmf637-product-inventory-management-api-user-guide-v5-0-0/) (2024 年 9 月) に基づいています。Product Inventory Open API は、TM フォーラムによって適合性認定を受けています。
## 製品インベントリオープン API -- DELETE /sn_prd_invt/order/product/{id} {#ariaid-title2}
指定したプロダクトインベントリレコードを削除します。
### URL 形式
デフォルト URL: /api/sn_prd_invt/order/product/{id}
### サポートされている要求パラメーター
{#tmf_prod_inv-DELETE-ord-product__entry__2}
| 名前 | 説明 |
|-|-|
| ID | 削除する製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
[表 : 1. パスパラメーター]
{#tmf_prod_inv-DELETE-ord-product__entry__6}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 2. クエリパラメーター]
{#tmf_prod_inv-DELETE-ord-product__entry__10}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 3. 要求本文パラメーター (JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-DELETE-ord-product__entry__14}{#tmf_prod_inv-DELETE-ord-product__accept-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 4. 要求ヘッダー]
{#tmf_prod_inv-DELETE-ord-product__entry__18}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 5. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-DELETE-ord-product__entry__22}{#tmf_prod_inv-DELETE-ord-product__entry-400-status-code}
| ステータスコード | 説明 |
|-|-|
| 204 | コンテンツがありません。レコードが正常に削除されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
[表 : 6. ステータスコード]
### 応答本文のパラメーター (JSON)
{#tmf_prod_inv-DELETE-ord-product__entry__28}
| 名前 | 説明 |
|-|-|
| なし | |
[ ]
### cURL 要求
この例では、プロダクトインベントリレコードを削除します。
curl "https://instance.service-now.com/api/sn_prd_invt/product/01b2f9972b8c72d07a83f395f291bf53" \
--request DELETE \
--header "Accept:application/json" \
--user 'username':'password'
製品インベントリレコードが正常に削除された場合、応答本文は返されません。
## 製品インベントリオープン API - GET /sn_prd_invt/product {#ariaid-title3}
すべての製品在庫のリストを取得します。
### URL 形式
デフォルト URL: api/sn_prd_invt/product
### サポートされている要求パラメーター
{#tmf_prod_inv-GET-product__table_ofr_vgy_fsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 7. パスパラメーター]
{#tmf_prod_inv-GET-product__table_ofr_vgy_fsb} {#tmf_prod_inv-GET-product__table_pfr_vgy_fsb__entry__2}
| 名前 | 説明 |
|-|-|
| カスタマー | 顧客別に製品在庫をフィルタリングします。このパラメーターの値と一致する顧客sys_idまたは外部 ID を持つ製品オファリングのみが応答に返されます。 データタイプ：文字列 デフォルト:顧客別にフィルタリングしません。 |
| フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 データタイプ：文字列 デフォルト:すべてのフィールドを返します。 |
| limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト値：20 最大:100 |
| オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 データタイプ：数値 デフォルト：0 |
| ロケーション | 製品在庫を場所別にフィルタリングします。 データタイプ: オブジェクト "place": { "id": "String" } |
| place.id | 製品インベントリレコードに関連付けられた場所のSys_id ID または外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| ステータス | ステータス別に製品在庫をフィルタリングします。このパラメーターの値と一致するステータスの製品在庫のみが応答に返されます。 データタイプ：文字列 デフォルト:ステータスでフィルタリングしません。 |
[表 : 8. クエリパラメーター]
{#tmf_prod_inv-GET-product__table_pfr_vgy_fsb} {#tmf_prod_inv-GET-product__table_gld_vkz_gsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 9. 要求本文パラメーター (JSON)]
{#tmf_prod_inv-GET-product__table_gld_vkz_gsb}
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-GET-product__table_kqy_wgy_fsb__entry__2}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 10. 要求ヘッダー]
{#tmf_prod_inv-GET-product__table_kqy_wgy_fsb} {#tmf_prod_inv-GET-product__table_idy_qgm_lsb__entry__2}{#tmf_prod_inv-GET-product__content-range-row}{#tmf_prod_inv-GET-product__content-type-row}{#tmf_prod_inv-GET-product__links-pagination-row}{#tmf_prod_inv-GET-product__x-total-count-descr}
| ヘッダー | 説明 |
|-|-|
| Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲。 たとえば、 `offset=2` で `limit=3` の場合、 Content-Range ヘッダーの値は `アイテム 3 から 5` です。 |
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#tmf_prod_inv-GET-product__ul_zzk_sdm_lsb} |
| X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 |
[表 : 11. 応答ヘッダー]
{#tmf_prod_inv-GET-product__table_idy_qgm_lsb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-GET-product__table_hl1_rcm_lsb__entry__2}{#tmf_prod_inv-GET-product__tmf-get-status-200-p}{#tmf_prod_inv-GET-product__tmf-get-status-206-entry}{#tmf_prod_inv-GET-product__tmf-get-status-400-entry}{#tmf_prod_inv-GET-product__tmf-get-status-404-entry}
| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。応答で返された完全なリソース (ページネーションなし)。 |
| 206 | 応答で返された部分的なリソース (ページネーションあり)。 |
| 400 | 要求が正しくありません。考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_inv-GET-product__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 |
[表 : 12. ステータスコード]
{#tmf_prod_inv-GET-product__table_hl1_rcm_lsb}
### 応答本文のパラメーター (JSON) {#tmf_prod_inv-GET-product__section_rhr_nvy_3sb}
{#tmf_prod_inv-GET-product__table_shr_nvy_3sb__entry__2}{#tmf_prod_inv-GET-product__realRes-id-entry}{#tmf_prod_inv-GET-product__realServ-id-entry}
| 名前 | 説明 |
|-|-|
| href | 製品インベントリレコードへの相対リンク。 データタイプ：文字列 |
| ID | 製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| name | 製品在庫の名前。 データタイプ：文字列 |
| ロケーション | 製品の場所。 データタイプ：アレイ "place": [ { "id": "String", "name": "String" } ] |
| place.id | 場所sys_idまたは外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| place.name | 場所の名前。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:名前 |
| 製品特性 | 製品特性のリスト。 製品特性の詳細については、 [Create a product offering category](https://www.servicenow.com/docs/access?context=som-create-product-offering-category&version=australia&pubname=australia-order-management&ft:locale=en-US)を参照してください。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productCharacteristic.valueType | 特性値のタイプ。 指定できる値: * address * array.date * array.datetime * array.decimal * array.integer * array.object * array.single_line_text * 添付ファイル * チェックボックス * 選択 * date * date_time * decimal * duration * email * 整数 * オブジェクト * single_line_text * yes_no {#tmf_prod_inv-GET-product__ul_gzj_drn_3hc} データタイプ：文字列 |
| productId | 製品インベントリの製品モデルのSys_id。 データタイプ：文字列 テーブル:製品モデル \[cmdb_model\] |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } |
| productOffering.id | 製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:initial_version または external_id |
| productOffering.internalId | 製品オファリングの内部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:internal_version |
| productOffering.internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:バージョン |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.version | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:external_version |
| 製品価格 | 空のアレイを返します。 データタイプ：アレイ |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | 関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 データタイプ：文字列 |
| 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:internal_versionまたはexternal_id |
| productSpecification.internalId | 製品仕様の初期バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:initial_version |
| productSpecification.internalVersion | 製品仕様のバージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:バージョン |
| productSpecification.version | 製品仕様の外部バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:external_version |
| リソースの実現 | 製品を実現するリソース。実現リソースは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | 実現リソースのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 有効な値:child データタイプ：文字列 |
| 実現サービス | 製品を実現するサービス。実現サービスは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | 実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 有効な値:child データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.@referredType | 顧客のタイプ。 可能な値： * コンシューマー * 顧客 * 顧客連絡先 {#tmf_prod_inv-GET-product__ul_jqs_vbh_fwb} データタイプ：文字列 |
| 状況 | 製品の現在のステータス。 データタイプ：文字列 |
[ ]
{#tmf_prod_inv-GET-product__table_shr_nvy_3sb}
### cURL 要求 {#tmf_prod_inv-GET-product__example_ld5_lnz_3sb}
この例では、すべての製品在庫を取得します。
curl --location --request GET "https://instance.service-now.com/api/sn_prd_invt/product" \
--user 'username':'password'
応答本文。
[
{
"id": "037fd87ec3603010abc8b5183c40ddf2",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Example Company",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "Routing and Configuration PI0000318",
"productSpecification": {
"id": "aec57e981bb420106ba59acf034bcb08",
"name": "Routing and Configuration",
"version": "",
"internalVersion": "1",
"internalId": "aec57e981bb420106ba59acf034bcb08"
},
"status": "Active",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"version": "",
"internalVersion": "1",
"internalId": "69017a0f536520103b6bddeeff7b127d"
},
"productId": "ce0b52c7532520103b6bddeeff7b12f5",
"place": [
{
"id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
"name": "100 South Charles Street, Baltimore, MD"
}
],
"productCharacteristic": [],
"productRelationship": [],
"realizingService": [],
"realizingResource": [
{
"id": "9b2fa60b536520103b6bddeeff7b1233",
"name": "Route Target"
}
],
"productPrice": [],
"href": "/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2",
"billingAccount": "Not Specified."
}
]
## 製品インベントリオープン API - GET /sn_prd_invt/product/{id} {#ariaid-title4}
指定されたプロダクトインベントリレコードを取得します。
### URL 形式
デフォルト URL: /api/sn_prd_invt/product/{id}
### サポートされている要求パラメーター {#tmf_prod_inv-GET-product-id__section_esr_w5y_3sb}
{#tmf_prod_inv-GET-product-id__table_apt_nkz_gsb__entry__2}
| 名前 | 説明 |
|-|-|
| ID | 取得する製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
[表 : 13. パスパラメーター]
{#tmf_prod_inv-GET-product-id__table_apt_nkz_gsb} {#tmf_prod_inv-GET-product-id__table_pfr_vgy_fsb__entry__2}
| 名前 | 説明 |
|-|-|
| カスタマー | 顧客別に製品在庫をフィルタリングします。このパラメーターの値と一致する顧客sys_idまたは外部 ID を持つ製品オファリングのみが応答に返されます。 データタイプ：文字列 デフォルト:顧客に申告しません。 |
| フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 データタイプ：文字列 デフォルト:すべてのフィールドが返されます。 |
| ロケーション | 製品在庫を場所別にフィルタリングします。 データタイプ: オブジェクト "place": { "id": "String" } |
| place.id | 製品インベントリレコードに関連付けられた場所のSys_id ID または外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| ステータス | ステータス別に製品在庫をフィルタリングします。このパラメーターの値と一致するステータスの製品在庫のみが応答に返されます。 データタイプ：文字列 デフォルト:ステータスでフィルタリングしません。 |
[表 : 14. クエリパラメーター]
{#tmf_prod_inv-GET-product-id__table_pfr_vgy_fsb} {#tmf_prod_inv-GET-product-id__table_gld_vkz_gsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 15. 要求本文パラメーター (JSON)]
{#tmf_prod_inv-GET-product-id__table_gld_vkz_gsb}
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-GET-product-id__table_kqy_wgy_fsb__entry__2}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 16. 要求ヘッダー]
{#tmf_prod_inv-GET-product-id__table_kqy_wgy_fsb} {#tmf_prod_inv-GET-product-id__table_tzy_thy_ksb__entry__2}
| ヘッダー | 説明 |
|-|-|
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 17. 応答ヘッダー]
{#tmf_prod_inv-GET-product-id__table_tzy_thy_ksb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-GET-product-id__table_nxj_ykz_gsb__entry__2}
| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。以下のいずれかの理由が考えられます。 * 無効なパスパラメーター * 無効な URI {#tmf_prod_inv-GET-product-id__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。ID に関連付けられたレコードがテーブルに見つかりません。 |
[表 : 18. ステータスコード]
{#tmf_prod_inv-GET-product-id__table_nxj_ykz_gsb}
### 応答本文のパラメーター (JSON) {#tmf_prod_inv-GET-product-id__section_rhr_nvy_3sb}
{#tmf_prod_inv-GET-product-id__table_shr_nvy_3sb__entry__2}{#tmf_prod_inv-GET-product-id__realRes-id-entry}{#tmf_prod_inv-GET-product-id__realServ-id-entry}
| 名前 | 説明 |
|-|-|
| 請求アカウント | プロダクトインベントリレコードの請求アカウント。 データタイプ：文字列 |
| href | 製品インベントリレコードへの相対リンク。 データタイプ：文字列 |
| ID | 製品インベントリのSys_id データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| name | 製品在庫の名前。 データタイプ：文字列 |
| ロケーション | 製品の場所。 データタイプ：アレイ "place": [ { "id": "String", "name": "String" } ] |
| place.id | 場所sys_idまたは外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| place.name | 場所の名前。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:名前 |
| 製品特性 | 製品特性のリスト。 製品特性の詳細については、 [Create a product offering category](https://www.servicenow.com/docs/access?context=som-create-product-offering-category&version=australia&pubname=australia-order-management&ft:locale=en-US)を参照してください。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productCharacteristic.valueType | 特性値のタイプ。 指定できる値: * address * array.date * array.datetime * array.decimal * array.integer * array.object * array.single_line_text * 添付ファイル * チェックボックス * 選択 * date * date_time * decimal * duration * email * 整数 * オブジェクト * single_line_text * yes_no {#tmf_prod_inv-GET-product-id__ul_gzj_drn_3hc} データタイプ：文字列 |
| productId | 製品インベントリの製品モデルのSys_id。 データタイプ：文字列 テーブル:製品モデル \[cmdb_model\] |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } |
| productOffering.id | 製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:initial_version または external_id |
| productOffering.internalId | 製品オファリングの内部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:internal_version |
| productOffering.internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:バージョン |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.version | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:external_version |
| 製品価格 | 空のアレイを返します。 データタイプ：アレイ |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | 関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 データタイプ：文字列 |
| 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:internal_versionまたはexternal_id |
| productSpecification.internalId | 製品仕様の初期バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:initial_version |
| productSpecification.internalVersion | 製品仕様のバージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:バージョン |
| productSpecification.version | 製品仕様の外部バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:external_version |
| リソースの実現 | 製品を実現するリソース。実現リソースは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | 実現リソースのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 有効な値:child データタイプ：文字列 |
| 実現サービス | 製品を実現するサービス。実現サービスは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | 実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 有効な値:child データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.type | 関係者のタイプ。値は常に `関係者です`。 データタイプ：文字列 |
| relatedParty.@referredType | 顧客や顧客の連絡先など、顧客のタイプ。 データタイプ：文字列 |
| ステータス | 製品の現在のステータス。 データタイプ：文字列 |
[ ]
{#tmf_prod_inv-GET-product-id__table_shr_nvy_3sb}
### cURL 要求
この例では、指定された製品インベントリを取得します。
curl -X GET 'https://instance.service-now.com/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2' \
--user 'username':'password'
出力:
{
"id": "037fd87ec3603010abc8b5183c40ddf2",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Example Company",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "Routing and Configuration PI0000318",
"productSpecification": {
"id": "aec57e981bb420106ba59acf034bcb08",
"name": "Routing and Configuration",
"version": "",
"internalVersion": "1",
"internalId": "aec57e981bb420106ba59acf034bcb08"
},
"status": "Active",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"version": "",
"internalVersion": "1",
"internalId": "69017a0f536520103b6bddeeff7b127d"
},
"productId": "ce0b52c7532520103b6bddeeff7b12f5",
"place": [
{
"id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
"name": "100 South Charles Street, Baltimore, MD"
}
],
"productCharacteristic": [],
"productRelationship": [],
"realizingService": [],
"realizingResource": [
{
"id": "9b2fa60b536520103b6bddeeff7b1233",
"name": "Route Target"
}
],
"productPrice": [],
"href": "/api/sn_prd_invt/product/037fd87ec3603010abc8b5183c40ddf2",
"billingAccount": "Not Specified."
}
## 製品インベントリオープン API - GET /sn_prd_invt/productinventory {#ariaid-title5}
すべての製品在庫のリストを取得します。
重要:
Tokyoリリース以降、このエンドポイントは廃止されました。このエンドポイントの新しいバージョンは [製品インベントリオープン API - GET /sn_prd_invt/product](https://servicenow-prod.fluidtopics.net/3ivxJjoWmYrh7wn~qdlw0A#tmf_prod_inv-GET-product "すべての製品在庫のリストを取得します。") です。
### URL 形式
デフォルト URL: api/sn_prd_invt/productinventory
### サポートされている要求パラメーター
{#tmf_prod_inv-GET-prodinv__table_ofr_vgy_fsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 19. パスパラメーター]
{#tmf_prod_inv-GET-prodinv__table_ofr_vgy_fsb} {#tmf_prod_inv-GET-prodinv__table_pfr_vgy_fsb__entry__2}
| 名前 | 説明 |
|-|-|
| カスタマー | 顧客別に製品在庫をフィルタリングします。このパラメーターの値と一致する顧客sys_idまたは外部 ID を持つ製品オファリングのみが応答に返されます。 データタイプ：文字列 デフォルト:顧客別にフィルタリングしません。 |
| フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 データタイプ：文字列 デフォルト：すべてのフィールドを返します。 |
| limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト値：20 最大:100 |
| オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 データタイプ：数値 デフォルト：0 |
| ロケーション | 製品在庫を場所別にフィルタリングします。 データタイプ: オブジェクト "place": { "id": "String" } |
| place.id | 製品インベントリレコードに関連付けられた場所のSys_id ID または外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| ステータス | ステータス別に製品在庫をフィルタリングします。このパラメーターの値と一致するステータスの製品在庫のみが応答に返されます。 データタイプ：文字列 デフォルト:インベントリステータスではフィルタリングしません。 |
[表 : 20. クエリパラメーター]
{#tmf_prod_inv-GET-prodinv__table_pfr_vgy_fsb} {#tmf_prod_inv-GET-prodinv__table_gld_vkz_gsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 21. 要求本文パラメーター (JSON)]
{#tmf_prod_inv-GET-prodinv__table_gld_vkz_gsb}
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-GET-prodinv__table_kqy_wgy_fsb__entry__2}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 22. 要求ヘッダー]
{#tmf_prod_inv-GET-prodinv__table_kqy_wgy_fsb} {#tmf_prod_inv-GET-prodinv__table_idy_qgm_lsb__entry__2}{#tmf_prod_inv-GET-prodinv__content-range-row}{#tmf_prod_inv-GET-prodinv__content-type-row}{#tmf_prod_inv-GET-prodinv__links-pagination-row}{#tmf_prod_inv-GET-prodinv__x-total-count-descr}
| ヘッダー | 説明 |
|-|-|
| Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲。 たとえば、 `offset=2` で `limit=3` の場合、 Content-Range ヘッダーの値は `アイテム 3 から 5` です。 |
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#tmf_prod_inv-GET-prodinv__ul_zzk_sdm_lsb} |
| X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 |
[表 : 23. 応答ヘッダー]
{#tmf_prod_inv-GET-prodinv__table_idy_qgm_lsb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-GET-prodinv__table_hl1_rcm_lsb__entry__2}{#tmf_prod_inv-GET-prodinv__tmf-get-status-200-p}{#tmf_prod_inv-GET-prodinv__tmf-get-status-206-entry}{#tmf_prod_inv-GET-prodinv__tmf-get-status-400-entry}{#tmf_prod_inv-GET-prodinv__tmf-get-status-404-entry}
| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。応答で返された完全なリソース (ページネーションなし)。 |
| 206 | 応答で返された部分的なリソース (ページネーションあり)。 |
| 400 | 要求が正しくありません。考えられる理由: * 無効なパスパラメーター * 無効な URI {#tmf_prod_inv-GET-prodinv__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 |
[表 : 24. ステータスコード]
{#tmf_prod_inv-GET-prodinv__table_hl1_rcm_lsb}
### 応答本文のパラメーター (JSON) {#tmf_prod_inv-GET-prodinv__section_rhr_nvy_3sb}
{#tmf_prod_inv-GET-prodinv__table_shr_nvy_3sb__entry__2}
| 名前 | 説明 |
|-|-|
| ID | 製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| name | 製品在庫の名前。 データタイプ：文字列 |
| ロケーション | 製品に関連付けられた場所。 データタイプ: オブジェクト "place": { "id": "String", "name": "String" } |
| place.id | 製品インベントリの場所sys_idまたはexternal_id。 テーブル:場所 \[cmn_location\] データ:文字列 |
| place.name | 製品インベントリに関連付けられた場所の名前。 テーブル:場所 \[cmn_location\] データ:文字列 |
| 製品特性 | 製品特性のリスト。 製品特性の詳細については、 [Create a product offering category](https://www.servicenow.com/docs/access?context=som-create-product-offering-category&version=australia&pubname=australia-order-management&ft:locale=en-US)を参照してください。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productCharacteristic.valueType | 特性値のタイプ。 指定できる値: * address * array.date * array.datetime * array.decimal * array.integer * array.object * array.single_line_text * 添付ファイル * チェックボックス * 選択 * date * date_time * decimal * duration * email * 整数 * オブジェクト * single_line_text * yes_no {#tmf_prod_inv-GET-prodinv__ul_gzj_drn_3hc} データタイプ：文字列 |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String" } |
| productOffering.id | 製品オファリングのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | 関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 データタイプ：文字列 |
| 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String" } |
| productSpecification.id | 製品仕様の sys_id。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] |
| リソースの実現 | リソースの実現。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | 実現リソースのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 データタイプ：文字列 |
| 実現サービス | サービスを実現する。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | 実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.@referredType | 関係者のタイプ。値は常に `関係者です`。 データタイプ：文字列 |
| relatedParty.type | 顧客のタイプ。 可能な値： * consumer * カスタマー * 顧客連絡先 {#tmf_prod_inv-GET-prodinv__ul_obs_231_cgc} データタイプ：文字列 |
| ステータス | 製品の現在のステータス。 データタイプ：文字列 |
[ ]
{#tmf_prod_inv-GET-prodinv__table_shr_nvy_3sb}
### cURL 要求 {#tmf_prod_inv-GET-prodinv__example_ld5_lnz_3sb}
この例では、すべての製品在庫を取得します。
curl "https://instance.servicenow.com/api/sn_prd_invt/productinventory" \
--request GET \
--user 'username':'password'
応答本文。
[
{
"id": "075072aec3a83010abc8b5183c40dd44",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "Firewall Administration PI0000300",
"productSpecification": {
"id": "31c5caff07266010a7955b7e0ad3006b",
"name": "Firewall Administration"
},
"status": "Active",
"productOffering": {
"id": "",
"name": ""
},
"place": {
"id": "920cf6ac73d423002728660c4cf6a799",
"name": "200 South James street,Atlanta, GA"
},
"productCharacteristic": [
{
"name": "Firewall Administration CPE Type",
"valueType": "Choice",
"value": "Physical"
},
{
"name": "Configuration and Policy backup",
"valueType": "Choice",
"value": ""
},
{
"name": "Firewall Administration CPE ID",
"valueType": "Single Line Text",
"value": "CPE123456789"
},
{
"name": "Remote CLI troubleshoot support",
"valueType": "Choice",
"value": ""
},
{
"name": "Firewall Administration CPE Model",
"valueType": "Choice",
"value": "9300 series"
}
],
"productRelationship": [],
"realizingService": [],
"realizingResource": [
{
"id": "3546463307666010a7955b7e0ad3005d",
"name": "Cisco Firewall Management system"
}
]
},
{
"id": "0303a8ea74418510f877ca57242ff96d",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "SD-WAN Edge Device PI0001114",
"productSpecification": {
"id": "39b627aa53702010cd6dddeeff7b1202",
"name": "SD-WAN Edge Device"
},
"status": "Installation Pending",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering"
},
"place": "",
"productCharacteristic": [],
"productRelationship": [],
"realizingService": [
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
},
{
"id": "16d79ec3532520103b6bddeeff7b12a6",
"name": "SD WAN Optimization Service"
},
{
"id": "16d79ec3532520103b6bddeeff7b12a6",
"name": "SD WAN Optimization Service"
},
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
},
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
},
{
"id": "bf65eadc1b7420106ba59acf034bcb57",
"name": "SD-WAN Routing"
}
],
"realizingResource": [
{
"id": "493fa60b536520103b6bddeeff7b12b6",
"name": "Customer Premise SD-WAN Router"
}
]
}
]
## 製品インベントリオープン API - GET /sn_prd_invt/productinventory/{inventoryId} {#ariaid-title6}
製品インベントリを取得します。
重要:
Tokyoリリース以降、このエンドポイントは廃止されました。このエンドポイントの新しいバージョンは [製品インベントリオープン API - GET /sn_prd_invt/product/{id}](https://servicenow-prod.fluidtopics.net/3ivxJjoWmYrh7wn~qdlw0A#tmf_prod_inv-GET-product-id "指定されたプロダクトインベントリレコードを取得します。") です。
### URL 形式
デフォルト URL: /api/sn_prd_invt/productinventory/{inventoryId}
### サポートされている要求パラメーター {#tmf_prod_inv-GET-prodinv-id__section_esr_w5y_3sb}
{#tmf_prod_inv-GET-prodinv-id__table_apt_nkz_gsb__entry__2}
| 名前 | 説明 |
|-|-|
| インベントリ ID | 取得する製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
[表 : 25. パスパラメーター]
{#tmf_prod_inv-GET-prodinv-id__table_apt_nkz_gsb} {#tmf_prod_inv-GET-prodinv-id__table_pfr_vgy_fsb__entry__2}
| 名前 | 説明 |
|-|-|
| カスタマー | 顧客別に製品在庫をフィルタリングします。このパラメーターの値と一致する顧客sys_idまたは外部 ID を持つ製品オファリングのみが応答に返されます。 データタイプ：文字列 |
| フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 データタイプ：文字列 デフォルト:すべてのフィールドが返されます。 |
| ロケーション | 製品在庫を場所別にフィルタリングします。 データタイプ: オブジェクト "place": { "id": "String" } |
| place.id | 製品インベントリレコードに関連付けられた場所のSys_id ID または外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| ステータス | ステータス別に製品在庫をフィルタリングします。このパラメーターの値と一致するステータスの製品在庫のみが応答に返されます。 データタイプ：文字列 |
[表 : 26. クエリパラメーター]
{#tmf_prod_inv-GET-prodinv-id__table_pfr_vgy_fsb} {#tmf_prod_inv-GET-prodinv-id__table_gld_vkz_gsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 27. 要求本文パラメーター (JSON)]
{#tmf_prod_inv-GET-prodinv-id__table_gld_vkz_gsb}
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-GET-prodinv-id__table_kqy_wgy_fsb__entry__2}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 28. 要求ヘッダー]
{#tmf_prod_inv-GET-prodinv-id__table_kqy_wgy_fsb} {#tmf_prod_inv-GET-prodinv-id__table_tzy_thy_ksb__entry__2}
| ヘッダー | 説明 |
|-|-|
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 29. 応答ヘッダー]
{#tmf_prod_inv-GET-prodinv-id__table_tzy_thy_ksb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-GET-prodinv-id__table_nxj_ykz_gsb__entry__2}
| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。以下のいずれかの理由が考えられます。 * 無効なパスパラメーター * 無効な URI {#tmf_prod_inv-GET-prodinv-id__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。ID に関連付けられたレコードがテーブルに見つかりません。 |
[表 : 30. ステータスコード]
{#tmf_prod_inv-GET-prodinv-id__table_nxj_ykz_gsb}
### 応答本文のパラメーター (JSON) {#tmf_prod_inv-GET-prodinv-id__section_rhr_nvy_3sb}
{#tmf_prod_inv-GET-prodinv-id__table_shr_nvy_3sb__entry__2}
| 名前 | 説明 |
|-|-|
| ID | 製品インベントリのSys_id データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| name | 製品在庫の名前。 データタイプ：文字列 |
| ロケーション | 製品に関連付けられた場所。 データタイプ: オブジェクト "place": { "id": "String", "name": "String" } |
| place.id | 製品インベントリの場所sys_idまたはexternal_id。 テーブル:場所 \[cmn_location\] データ:文字列 |
| place.name | 製品インベントリに関連付けられた場所の名前。 テーブル:場所 \[cmn_location\] データ:文字列 |
| 製品特性 | 製品特性のリスト。 製品特性の詳細については、 [Create a product offering category](https://www.servicenow.com/docs/access?context=som-create-product-offering-category&version=australia&pubname=australia-order-management&ft:locale=en-US)を参照してください。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productCharacteristic.valueType | 特性値のタイプ。 指定できる値: * address * array.date * array.datetime * array.decimal * array.integer * array.object * array.single_line_text * 添付ファイル * チェックボックス * 選択 * date * date_time * decimal * duration * email * 整数 * オブジェクト * single_line_text * yes_no {#tmf_prod_inv-GET-prodinv-id__ul_gzj_drn_3hc} データタイプ：文字列 |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String" } |
| productOffering.id | 製品オファリングのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | 関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 データタイプ：文字列 |
| 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String" } |
| productSpecification.id | 製品仕様の sys_id。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] |
| リソースの実現 | リソースの実現。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | 実現リソースのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 データタイプ：文字列 |
| 実現サービス | サービスを実現する。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | 実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.@referredType | 関係者のタイプ。値は常に `関係者です`。 データタイプ：文字列 |
| relatedParty.type | 顧客のタイプ。 可能な値： * consumer * カスタマー * 顧客連絡先 {#tmf_prod_inv-GET-prodinv-id__ul_obs_231_cgc} データタイプ：文字列 |
| ステータス | 製品の現在のステータス。 データタイプ：文字列 |
[ ]
{#tmf_prod_inv-GET-prodinv-id__table_shr_nvy_3sb}
### cURL 要求
この例では、SD-WAN サービスパッケージの製品インベントリを取得します。
curl --location --request GET 'https:// instance.servicenow.com/api/sn_prd_invt/productinventory/074450fc74918d10f877ca57242ff9e3' \
--user 'username':'password'
出力:
{
"id": "074450fc74918d10f877ca57242ff9e3",
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
}
],
"name": "SD-WAN Service Package PI0001576",
"productSpecification": {
"id": "cfe5ef6a53702010cd6dddeeff7b12f6",
"name": "SD-WAN Service Package"
},
"status": "Installation Pending",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering"
},
"place": "",
"productCharacteristic": [],
"productRelationship": [
{
"id": "a74490fc74918d10f877ca57242ff942",
"name": "SD-WAN Edge Device PI0001582",
"relationshipType": "Bundles"
},
{
"id": "b85414fc74918d10f877ca57242ff90e",
"name": "SD-WAN Controller PI0001602",
"relationshipType": "Bundles"
},
{
"id": "d74490fc74918d10f877ca57242ff907",
"name": "SD-WAN Security PI0001577",
"relationshipType": "Bundles"
}
],
"realizingService": [],
"realizingResource": []
}
## 製品インベントリオープン API -- PATCH /sn_prd_invt/order/product/{id} {#ariaid-title7}
指定されたプロダクトインベントリレコードを更新します。
### URL 形式
デフォルト URL: /api/sn_prd_invt/order/product/{id}
### サポートされている要求パラメーター
{#tmf_prod_inv-PATCH-ord-product__table_vvs_bvr_1hc__entry__2}
| 名前 | 説明 |
|-|-|
| ID | 更新する製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
[表 : 31. パスパラメーター]
{#tmf_prod_inv-PATCH-ord-product__table_vvs_bvr_1hc} {#tmf_prod_inv-PATCH-ord-product__entry__6}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 32. クエリパラメーター]
{#tmf_prod_inv-PATCH-ord-product__entry__10}
| 名前 | 説明 |
|-|-|
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-PATCH-ord-product__ul_fq3_gj1_cgc} データタイプ：ブーリアン |
| 名前 | 製品在庫の名前。 データタイプ：文字列 |
| ロケーション | 製品の場所。 データタイプ：アレイ "place": [ { "id": "String", "name": "String" } ] |
| place.id | 場所sys_idまたは外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| place.name | 場所の名前。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:名前 |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "@referredType": "String", "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "status": "String", "version": "String" } |
| productOffering.@referredType | この値は常に `ProductOffering` です。 データタイプ：文字列 |
| productOffering.id | 製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:initial_version または external_id |
| productOffering.internalId | 製品オファリングの内部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:internal_version |
| productOffering.internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:バージョン |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:名前 |
| productOffering.status | 製品オファリングのステータス。 可能な値： * アーカイブ済み * ドラフト * 公開済み * 廃止 {#tmf_prod_inv-PATCH-ord-product__ul_f5d_crs_1hc} データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:ステータス |
| productOffering.version | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:external_version |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "@type": "String", "id": "String", "name": "String" } ] |
| relatedParty.@referredType | 関係者のタイプ。 可能な値： * コンシューマー * 顧客 * 顧客連絡先 {#tmf_prod_inv-PATCH-ord-product__ul_obs_231_cgc} データタイプ：文字列 |
| relatedParty.@type | この値は常に `RelatedParty` です。 データタイプ：文字列 |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.name | チケットに関連付けられているアカウントまたは顧客の連絡先の名前。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
[表 : 33. 要求本文パラメーター (JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-PATCH-ord-product__entry__48}{#tmf_prod_inv-PATCH-ord-product__accept-JSON-only-entry-RESTAPI}{#tmf_prod_inv-PATCH-ord-product__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 34. 要求ヘッダー]
{#tmf_prod_inv-PATCH-ord-product__entry__54}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 35. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-PATCH-ord-product__entry__58}{#tmf_prod_inv-PATCH-ord-product__entry-200-status-code}{#tmf_prod_inv-PATCH-ord-product__entry-400-status-code}{#tmf_prod_inv-PATCH-ord-product__entry-404-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
[表 : 36. ステータスコード]
### 応答本文のパラメーター (JSON)
{#tmf_prod_inv-PATCH-ord-product__entry__66}
| 名前 | 説明 |
|-|-|
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-PATCH-ord-product__ul_acx_wtz_1hc} データタイプ：ブーリアン |
| 名前 | 製品在庫の名前。 データタイプ：文字列 |
| ロケーション | 製品の場所。 データタイプ：アレイ "place": [ { "id": "String", "name": "String" } ] |
| place.id | 場所sys_idまたは外部 ID。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:sys_id または sn_tmt_core_external_id |
| place.name | 場所の名前。 データタイプ：文字列 テーブル:場所 \[cmn_location\] フィールド:名前 |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "@referredType": "String", "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "status": "String", "version": "String" } |
| productOffering.@referredType | この値は常に `ProductOffering` です。 データタイプ：文字列 |
| productOffering.id | 製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:initial_version または external_id |
| productOffering.internalId | 製品オファリングの内部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:internal_version |
| productOffering.internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:バージョン |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:名前 |
| productOffering.status | 製品オファリングのステータス。 可能な値： * アーカイブ済み * ドラフト * 公開済み * 廃止 {#tmf_prod_inv-PATCH-ord-product__ul_bcx_wtz_1hc} データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:ステータス |
| productOffering.version | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:external_version |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "@type": "String", "id": "String", "name": "String" } ] |
| relatedParty.@referredType | 関係者のタイプ。 可能な値： * コンシューマー * 顧客 * 顧客連絡先 {#tmf_prod_inv-PATCH-ord-product__ul_ccx_wtz_1hc} データタイプ：文字列 |
| relatedParty.@type | この値は常に `RelatedParty` です。 データタイプ：文字列 |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.name | チケットに関連付けられているアカウントまたは顧客の連絡先の名前。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
[ ]
### cURL 要求
この例では、プロダクトインベントリレコードを更新します。
curl "https://instance.service-now.com/api/sn_prd_invt/product/036e506510322250f8777d910acbd77f" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"name\": \"Internet Plan\",
\"productOffering\": {
\"@referredType\": \"ProductOffering\",
\"name\": \"Premium SD-WAN Offering\",
\"id\": \"0361dd9fd0a63110f8770dbf976be16f\"
},
\"relatedParty\": [
{
\"@referredType\": \"CustomerContact\",
\"@type\": \"RelatedParty\",
\"name\": \"Sally Thomas\",
\"id\": \"f3af54c413651200042ab3173244b053\"
},
{
\"@referredType\": \"Customer\",
\"@type\": \"RelatedParty\",
\"name\": \"Funco Intl\",
\"id\": \"ffc68911c35420105252716b7d40dd55\"
}
],
\"bundle\": false,
\"place\": [
{
\"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",
\"name\": \"100 South Charles Street, Baltimore, MD\"
}
]
}" \
--user 'username':'password'
応答本文。
{
"name": "Internet Plan",
"productOffering": {
"@referredType": "ProductOffering",
"name": "Premium SD-WAN Offering",
"id": "0361dd9fd0a63110f8770dbf976be16f",
"internalVersion": "1",
"version": "",
"status": "published",
"internalId": "0361dd9fd0a63110f8770dbf976be16f"
},
"relatedParty": [
{
"@referredType": "CustomerContact",
"@type": "RelatedParty",
"name": "Sally Thomas",
"id": "f3af54c413651200042ab3173244b053"
},
{
"@referredType": "Customer",
"@type": "RelatedParty",
"name": "Funco Intl",
"id": "ffc68911c35420105252716b7d40dd55"
}
],
"bundle": false,
"place": [
{
"id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
"name": "100 South Charles Street, Baltimore, MD"
}
],
"productPrice": [],
"id": "036e506510322250f8777d910acbd77f",
"href": "/api/sn_prd_invt/product/036e506510322250f8777d910acbd77f"
}
## 製品インベントリオープン API - POST /sn_prd_invt/product {#ariaid-title8}
プロダクトインベントリレコードを作成します。
### URL 形式
デフォルト URL: /api/sn_prd_invt/product
### サポートされている要求パラメーター
{#tmf_prod_inv-POST-product__table_o3n_mvf_hsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 37. パスパラメーター]
{#tmf_prod_inv-POST-product__table_o3n_mvf_hsb} {#tmf_prod_inv-POST-product__table_nbq_zds_3sb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 38. クエリパラメーター]
{#tmf_prod_inv-POST-product__table_nbq_zds_3sb} {#tmf_prod_inv-POST-product__entry__10}
| 名前 | 説明 |
|-|-|
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-POST-product__ul_m5c_qj1_cgc} データタイプ：ブーリアン デフォルト値：false |
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-POST-product__ul_d14_pj1_cgc} データタイプ：ブーリアン デフォルト値：false |
| 名前 | 必須です。製品在庫の名前。 データタイプ：文字列 |
| pid | 外部システムからの製品インベントリの一意の識別子。 データタイプ：文字列 デフォルト：空白の文字列 |
| 製品特性 | 製品特性のリスト。 製品特性の詳細については、 [Create a product offering category](https://www.servicenow.com/docs/access?context=som-create-product-offering-category&version=australia&pubname=australia-order-management&ft:locale=en-US)を参照してください。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 デフォルト：空白の文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 デフォルト：空白の文字列 |
| productCharacteristic.valueType | 特性値のタイプ。 指定できる値: * address * array.date * array.datetime * array.decimal * array.integer * array.object * array.single_line_text * 添付ファイル * チェックボックス * 選択 * date * date_time * decimal * duration * email * 整数 * オブジェクト * single_line_text * yes_no {#tmf_prod_inv-POST-product__ul_gzj_drn_3hc} データタイプ：文字列 |
| productOffering | 必須です。製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } |
| productOffering.id | 必須です。製品オファリングのInitial_versionまたはexternal_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:バージョン |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 デフォルト：空白の文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.version | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:external_version |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | productRelationship パラメーターを使用する場合は必須です。関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 有効な値は 子のみです。 データタイプ：文字列 デフォルト：空白の文字列 |
| 製品仕様 | 必須です。製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 必須です。製品仕様のInitial_versionまたはexternal_id。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] |
| productSpecification.internalVersion | 製品仕様のバージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:バージョン |
| productSpecification.version | 製品仕様の外部バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:external_version |
| リソースの実現 | 製品を実現するリソース。実現リソースは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | realizingResource パラメーターを使用する場合は必須です。 実現リソースのSys_id。 データタイプ：文字列 |
| realizingResource.type | 実現リソースのタイプ。 有効な値:child データタイプ：文字列 |
| 実現サービス | 製品を実現するサービス。実現サービスは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | realizingService パラメーターを使用する場合は必須です。 実現サービスのSys_id。 データタイプ：文字列 |
| realizingService.type | 実現サービスのタイプ。 有効な値:child データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 顧客のタイプ。 可能な値： * consumer * カスタマー * customer_contact {#tmf_prod_inv-POST-product__ul_dhg_ngs_3sb} データタイプ：文字列 デフォルト：空白の文字列 |
| relatedParty.id | relatedParty パラメーターを使用する場合は必須です。チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| 状況 | 製品の現在のステータス。 可能な値： * アクティブ * change_pending * inactivation_pending * inactive * installation_pending {#tmf_prod_inv-POST-product__ul_blq_yw5_4sb} データタイプ：文字列 デフォルト:installation_pending |
[表 : 39. 要求本文パラメーター (JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-POST-product__table_ett_h3z_gsb__entry__2}{#tmf_prod_inv-POST-product__accept-JSON-only-entry-RESTAPI}{#tmf_prod_inv-POST-product__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 40. 要求ヘッダー]
{#tmf_prod_inv-POST-product__table_ett_h3z_gsb} {#tmf_prod_inv-POST-product__table_tzy_thy_ksb__entry__2}
| ヘッダー | 説明 |
|-|-|
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 41. 応答ヘッダー]
{#tmf_prod_inv-POST-product__table_tzy_thy_ksb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-POST-product__table_fbw_k3z_gsb__entry__2}
| ステータスコード | 説明 |
|-|-|
| 201 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。以下のいずれかの理由が考えられます。 * 空のペイロード。 * 無効なペイロードです。必須フィールドがありません：\<フィールド名\> {#tmf_prod_inv-POST-product__ul_nc5_myx_fsb} |
[表 : 42. ステータスコード]
{#tmf_prod_inv-POST-product__table_fbw_k3z_gsb}
### 応答本文のパラメーター (JSON)
{#tmf_prod_inv-POST-product__entry__88}{#tmf_prod_inv-POST-product__realRes-id-entry}{#tmf_prod_inv-POST-product__realServ-id-entry}
| 名前 | 説明 |
|-|-|
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-POST-product__ul_fq3_gj1_cgc} データタイプ：ブーリアン |
| href | 製品インベントリレコードへの相対リンク。 データタイプ：文字列 |
| ID | 製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-POST-product__ul_ud4_kj1_cgc} データタイプ：ブーリアン |
| 名前 | 製品在庫の名前。 データタイプ：文字列 |
| pid | 外部システムからの製品インベントリの一意の識別子。 データタイプ：文字列 |
| 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } |
| productOffering.id | 製品オファリングの初期バージョンまたは外部 ID。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:initial_version または external_id |
| productOffering.internalId | 製品オファリングの内部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:internal_version |
| productOffering.internalVersion | 製品オファリングのバージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:バージョン |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.version | 製品オファリングの外部バージョン。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] フィールド:external_version |
| 製品価格 | 空のアレイを返します。 データタイプ：アレイ |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | 関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 データタイプ：文字列 |
| 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" } |
| productSpecification.id | 製品仕様の初期バージョンまたは外部 ID。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:internal_versionまたはexternal_id |
| productSpecification.internalId | 製品仕様の初期バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:initial_version |
| productSpecification.internalVersion | 製品仕様のバージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:バージョン |
| productSpecification.version | 製品仕様の外部バージョン。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] フィールド:external_version |
| リソースの実現 | 製品を実現するリソース。実現リソースは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | 実現リソースのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 有効な値:child データタイプ：文字列 |
| 実現サービス | 製品を実現するサービス。実現サービスは、この製品インベントリの子製品インベントリです。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | 実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 有効な値:child データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 関係者のタイプ。値は常に `関係者です`。 データタイプ：文字列 |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.type | 顧客のタイプ。 可能な値： * consumer * カスタマー * 顧客連絡先 {#tmf_prod_inv-POST-product__ul_obs_231_cgc} データタイプ：文字列 |
| ステータス | 製品の現在のステータス。 データタイプ：文字列 |
[ ]
### cURL 要求
この例では、ユーザーの Voice over IP ソリューションの製品インベントリを作成します。
curl -X POST "https://instance.service-now.com/api/sn_prd_invt/product" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data "[
{
"pid": "PO-456",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"@referredType": "ProductOffering",
"name": "Premium SD-WAN Offering",
"id": "69017a0f536520103b6bddeeff7b127d"
},
"productCharacteristic": [],
"productRelationship": [
{
"productId": "fa6d13f45b5620102dff5e92dc81c77f",
"relationshipType": "child"
}
],
"realizingService": {
"id": "fe6d13f45b5620102dff5e92dc81c786",
"relationshipType": "child"
},
"realizingResource": {
"id": "326d13f45b5620102dff5e92dc81c78c",
"relationshipType": "child"
},
"relatedParty": [
{
"@referredType": "CustomerContact",
"@type": "RelatedParty",
"name": "Sally Thomas",
"id": "eaf68911c35420105252716b7d40ddde"
},
{
"@referredType": "Customer",
"@type": "RelatedParty",
"name": "Funco Intl",
"id": "ffc68911c35420105252716b7d40dd55"
}
],
"productSpecification": {
"@referredType": "ProductSpecification",
"@type": null,
"name": null,
"id": "3ee1fdb1c3331010d216b5183c40dd81",
"internalVersion": "1"
},
"bundle": false
}
]"
応答本文。
{
"pid": "PO-456",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"@referredType": "ProductOffering",
"name": "Premium SD-WAN Offering",
"id": "69017a0f536520103b6bddeeff7b127d",
"internalVersion": "1",
"version": null,
"status": "published",
"internalId": "69017a0f536520103b6bddeeff7b127d"
},
"productCharacteristic": [],
"productRelationship": [
{
"productId": "fa6d13f45b5620102dff5e92dc81c77f",
"relationshipType": "child"
}
],
"realizingService": {
"id": "fe6d13f45b5620102dff5e92dc81c786",
"relationshipType": "child"
},
"realizingResource": {
"id": "326d13f45b5620102dff5e92dc81c78c",
"relationshipType": "child"
},
"relatedParty": [
{
"@referredType": "CustomerContact",
"@type": "RelatedParty",
"name": "Sally Thomas",
"id": "eaf68911c35420105252716b7d40ddde"
},
{
"@referredType": "Customer",
"@type": "RelatedParty",
"name": "Example Company",
"id": "ffc68911c35420105252716b7d40dd55"
}
],
"productSpecification": {
"@referredType": "ProductSpecification",
"@type": null,
"name": null,
"id": "3ee1fdb1c3331010d216b5183c40dd81",
"internalVersion": "1",
"version": null,
"status": "published",
"internalId": "3ee1fdb1c3331010d216b5183c40dd81"
},
"bundle": false,
"productPrice": [],
"id": "25b07475471789108761b955d36d439d",
"href": "/api/sn_prd_invt/product/25b07475471789108761b955d36d439d"
}
## 製品インベントリオープン API - POST /sn_prd_invt/productinventory {#ariaid-title9}
製品インベントリを作成します。
重要:
Tokyoリリース以降、このエンドポイントは廃止されました。このエンドポイントの新しいバージョンは [製品インベントリオープン API - POST /sn_prd_invt/product](https://servicenow-prod.fluidtopics.net/3ivxJjoWmYrh7wn~qdlw0A#tmf_prod_inv-POST-product "プロダクトインベントリレコードを作成します。") です。
### URL 形式
デフォルト URL: /api/sn_prd_invt/productinventory
### サポートされている要求パラメーター
{#tmf_prod_inv-POST-prodinv__table_o3n_mvf_hsb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 43. パスパラメーター]
{#tmf_prod_inv-POST-prodinv__table_o3n_mvf_hsb} {#tmf_prod_inv-POST-prodinv__table_nbq_zds_3sb__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 44. クエリパラメーター]
{#tmf_prod_inv-POST-prodinv__table_nbq_zds_3sb} {#tmf_prod_inv-POST-prodinv__entry__10}
| 名前 | 説明 |
|-|-|
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 データタイプ：ブーリアン デフォルト値：false |
| 名前 | 必須です。製品在庫の名前。 データタイプ：文字列 |
| pid | 外部システムからの製品インベントリの一意の識別子。 データタイプ：文字列 デフォルト：空白の文字列 |
| 製品特性 | 製品特性のリスト。 製品特性の詳細については、 [Create a product offering category](https://www.servicenow.com/docs/access?context=som-create-product-offering-category&version=australia&pubname=australia-order-management&ft:locale=en-US)を参照してください。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 デフォルト：空白の文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 デフォルト：空白の文字列 |
| productCharacteristic.valueType | 特性値のタイプ。 指定できる値: * address * array.date * array.datetime * array.decimal * array.integer * array.object * array.single_line_text * 添付ファイル * チェックボックス * 選択 * date * date_time * decimal * duration * email * 整数 * オブジェクト * single_line_text * yes_no {#tmf_prod_inv-POST-prodinv__ul_gzj_drn_3hc} データタイプ：文字列 |
| productOffering | 必須です。製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String" } |
| productOffering.id | 必須です。製品オファリングのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 デフォルト：空白の文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | productRelationship パラメーターを使用する場合は必須です。関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 有効な値は 子のみです。 データタイプ：文字列 デフォルト：空白の文字列 |
| 製品仕様 | 必須です。製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String" } |
| productSpecification.id | 必須です。製品仕様の sys_id。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] |
| リソースの実現 | リソースの実現。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | realizingResource パラメーターを使用する場合は必須です。実現リソースのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 有効な値は 子のみです。 データタイプ：文字列 デフォルト：空白の文字列 |
| 実現サービス | サービスを実現する。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | realizingService パラメーターを使用する場合は必須です。実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 有効な値は 子のみです。 データタイプ：文字列 デフォルト：空白の文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 顧客のタイプ。 可能な値： * consumer * カスタマー * customer_contact {#tmf_prod_inv-POST-prodinv__ul_dhg_ngs_3sb} データタイプ：文字列 デフォルト：空白の文字列 |
| relatedParty.id | relatedParty パラメーターを使用する場合は必須です。チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_Consumer\] |
| 状況 | 製品の現在のステータス。 可能な値： * アクティブ * change_pending * inactivation_pending * inactive * installation_pending {#tmf_prod_inv-POST-prodinv__ul_blq_yw5_4sb} データタイプ：文字列 デフォルト:installation_pending |
[表 : 45. 要求本文パラメーター (JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#tmf_prod_inv-POST-prodinv__table_ett_h3z_gsb__entry__2}{#tmf_prod_inv-POST-prodinv__accept-JSON-only-entry-RESTAPI}{#tmf_prod_inv-POST-prodinv__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 46. 要求ヘッダー]
{#tmf_prod_inv-POST-prodinv__table_ett_h3z_gsb} {#tmf_prod_inv-POST-prodinv__table_tzy_thy_ksb__entry__2}
| ヘッダー | 説明 |
|-|-|
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 47. 応答ヘッダー]
{#tmf_prod_inv-POST-prodinv__table_tzy_thy_ksb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#tmf_prod_inv-POST-prodinv__table_fbw_k3z_gsb__entry__2}
| ステータスコード | 説明 |
|-|-|
| 201 | 要求が正常に処理されました。 |
| 400 | 要求が正しくありません。以下のいずれかの理由が考えられます。 * 空のペイロード。 * 無効なペイロードです。必須フィールドがありません：\<フィールド名\> {#tmf_prod_inv-POST-prodinv__ul_nc5_myx_fsb} |
[表 : 48. ステータスコード]
{#tmf_prod_inv-POST-prodinv__table_fbw_k3z_gsb}
### 応答本文のパラメーター (JSON)
{#tmf_prod_inv-POST-prodinv__entry__78}
| 名前 | 説明 |
|-|-|
| ID | 製品インベントリのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| バンドル | プロダクトインベントリレコードがバンドル製品の一部であるかどうかを示すフラグ。 有効な値： * true:バンドルの一部です。 * false:バンドルに含まれません。 {#tmf_prod_inv-POST-prodinv__ul_ud4_kj1_cgc} データタイプ：ブーリアン |
| 名前 | 製品在庫の名前。 データタイプ：文字列 |
| pid | 外部システムからの製品インベントリの一意の識別子。 データタイプ：文字列 |
| 製品特性 | 製品特性のリスト。 データタイプ：オブジェクトのアレイ "productCharacteristic": [ { "name": "String", "value": "String" } ] |
| productCharacteristic.name | 特性の名前。 データタイプ：文字列 |
| productCharacteristic.value | 特性の値。 データタイプ：文字列 |
| productOffering | 製品インベントリが関連付けられている製品オファリング。 データタイプ: オブジェクト "productOffering": { "id": "String", "name": "String" } |
| productOffering.id | 製品オファリングのSys_id。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| productOffering.name | 製品オファリングの名前。 データタイプ：文字列 テーブル:製品オファリング \[sn_prd_pm_product_offering\] |
| 製品リレーションシップ | 関連製品のリスト。 データタイプ：オブジェクトのアレイ "productRelationship": [ { "productId": "String", "relationshipType": "String" } ] |
| productRelationship.productId | 関連製品のSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| productRelationship.relationshipType | 関係のタイプ。 データタイプ：文字列 |
| 製品仕様 | 製品の製品仕様。 データタイプ: オブジェクト "productSpecification": { "id": "String" } |
| productSpecification.id | 製品仕様の sys_id。 データタイプ：文字列 表:製品仕様 \[sn_prd_pm_product_specification\] |
| リソースの実現 | リソースの実現。 データタイプ: オブジェクト "realizingResource": { "id": "String", "type": "String" } |
| realizingResource.id | 実現リソースのSys_id データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingResource.type | 実現リソースのタイプ。 データタイプ：文字列 |
| 実現サービス | サービスを実現する。 データタイプ: オブジェクト "realizingService": { "id": "String", "type": "String" } |
| realizingService.id | 実現サービスのSys_id。 データタイプ：文字列 テーブル:プロダクトインベントリ \[sn_prd_invt_product_inventory\] |
| realizingService.type | 実現サービスのタイプ。 データタイプ：文字列 |
| 関連パーティー | チケットに関連付けられている当事者のリスト。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | チケットに関連付けられたアカウントまたは顧客の連絡先のSys_id。 データタイプ：文字列 テーブル:アカウント \[customer_account\]、連絡先 \[customer_contact\]、またはコンシューマー \[csm_consumer\] |
| relatedParty.@referredType | 顧客のタイプ。 可能な値： * コンシューマー * 顧客 * 顧客連絡先 {#tmf_prod_inv-POST-prodinv__ul_jqs_vbh_fwb} データタイプ：文字列 |
| 状況 | 製品の現在のステータス。 データタイプ：文字列 |
[ ]
### cURL 要求
この例では、ユーザーの Voice over IP ソリューションの製品インベントリを作成します。
curl --location --request POST "https://instance.servicenow.com/api/sn_prd_invt/productinventory" \
--header "Content-Type: application/json" \
--data-raw '[
{
"pid": "demoInventory",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"@referredType": "ProductOffering"
},
"productCharacteristic": [
{
"name": "CPE Type",
"valueType": "choice",
"value": "Virtual"
},
{
"name":"Routing",
"valueType": "choice",
"value": "Premium"
}
],
"productRelationship": [
{
"productId": "7e6d13f45b5620102dff5e92dc81c787",
"relationshipType": "child"
}
],
"relatedParty": [
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"role": "User",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
},
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
}
],
"productSpecification": {
"id": "cfe5ef6a53702010cd6dddeeff7b12f6",
"@referredType": "ProductSpecification",
"version": "1"
}
}
]'
--user 'username':'password'
応答本文。
{
"pid": "demoInventory",
"description": "inventory description",
"isBundle": false,
"name": "Voice Over IP Basic instance for Jean",
"productOffering": {
"id": "69017a0f536520103b6bddeeff7b127d",
"name": "Premium SD-WAN Offering",
"@referredType": "ProductOffering"
},
"productCharacteristic": [
{
"name": "CPE Type",
"valueType": "choice",
"value": "Virtual"
},
{
"name": "Routing",
"valueType": "choice",
"value": "Premium"
}
],
"productRelationship": [
{
"productId": "7e6d13f45b5620102dff5e92dc81c787",
"relationshipType": "child"
}
],
"relatedParty": [
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"role": "User",
"@type": "RelatedParty",
"@referredType": "CustomerContact"
},
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@type": "RelatedParty",
"@referredType": "Customer"
}
],
"productSpecification": {
"id": "cfe5ef6a53702010cd6dddeeff7b12f6",
"@referredType": "ProductSpecification",
"version": "1"
},
"id": "3ac715c6745d8150f877ca57242ff97a"
}