Product Catalog Open API

The Product Catalog Open API provides endpoints to create and retrieve product catalogs, product offerings, and product specifications.

Use this API to manage product catalog information between external systems and the ServiceNow AI Platform. The Product Catalog Open API is a ServiceNow® implementation of the TM Forum Product Catalog Management API REST specification. This implementation is based on the TMF620 Product Catalog Management API REST Specification Version 4, April 2021.

This API is included in the Product Catalog Advanced application, which is available on the ServiceNow Store.

This API is provided within the sn_prd_pm_adv namespace.

The calling user must have the sn_prd_pm_adv.catalog_integrator role.

This API creates and updates data in the following tables.

• Characteristic [sn_prd_pm_characteristic]
• Characteristic Option [sn_prd_pm_characteristic_option]
• Product Offering [sn_prd_pm_product_offering]
• Product Offering Catalog [sn_prd_pm_product_offering_catalog]
• Product Offering Characteristic [sn_prd_pm_product_offering_characteristic]
• Product Specification [sn_prd_pm_product_specification]
• Specification Relationship [sn_prd_pm_specification_relationship]

Product Catalog Open API - GET /sn_prd_pm_adv/catalogmanagement/catalog

Retrieves a list of all product offering catalogs.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/catalog

Supported request parameters

Table 1. Path parameters

Name	Description
None

Table 2. Query parameters

Name	Description
fields	List of fields to return in the response. Invalid fields are ignored. If this parameter is not used, all fields are returned. Data type: String
limit	Maximum number of records to return. For requests that exceed this number of records, use the offset parameter to paginate record retrieval. Default: 20 Maximum: 100 Data type: Number
offset	Starting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks. Default: 0 Data type: Number

Table 3. Request body parameters (JSON)

Name	Description
None

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 4. Request headers

Header	Description
None

Table 5. Response headers

Header	Description
Content-Range	Specifies the range of content returned in a paginated call. For example, if offset=2 and limit=3, the value of the Content-Range header is items 3-5.
Content-Type	Data format of the response body. Only supports application/json.
Link	Contains the following links to navigate through query results. first last next previous
X-Total-Count	For paginated queries, this header specifies the total number of records available on the server.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 6. Status codes

Status code	Description
200	Request successfully processed. Full resource returned in response (no pagination).
206	Partial resource returned in response (with pagination).
400	Bad request. Possible reasons: Invalid path parameter Invalid URI
404	Record not found. No records matching the query parameters are found in the table.

Response body parameters (JSON)

Name	Description
description	Description of the product offering catalog. Data type: String
id	Sys_id of the product offering catalog from the Product Offering Catalog [sn_prd_pm_product_offering_catalog] table. Data type: String
name	Name of the product offering catalog. Data type: String

cURL request

This example retrieves all product offering catalogs.

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

Response body.

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

Product Catalog Open API - GET /sn_prd_pm_adv/catalogmanagement/catalog/{catalogId}

Retrieves a product offering catalog.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/catalog/{catalogId}

Supported request parameters

Table 7. Path parameters

Name	Description
catalogId	Sys_id of the product offering catalog to retrieve. Located in the Product Offering Catalog [sn_prd_pm_product_offering_catalog] table. Data type: String

Table 8. Query parameters

Name	Description
fields	List of fields to return in the response. Invalid fields are ignored. If this parameter is not used, all fields are returned. Data type: String

Table 9. Request body parameters (JSON)

Name	Description
None

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 10. Request headers

Header	Description
None

Table 11. Response headers

Header	Description
Content-Type	Data format of the response body. Only supports application/json.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 12. Status codes

Status code	Description
200	Request successfully processed.
400	Bad Request. Could be any of the following reasons: Invalid path parameter Invalid URI
404	Record not found. Record associated with the ID is not found in the table.

Response body parameters (JSON)

Name	Description
description	Description of the product offering catalog. Data type: String
id	Sys_id of the product offering catalog from the Product Offering Catalog [sn_prd_pm_product_offering_catalog] table. Data type: String
name	Name of the product offering catalog. Data type: String

cURL request

This example retrieves a product offering catalog for an enterprise mobile plan.

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

Response body.

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

Product Catalog Open API - GET /sn_prd_pm_adv/catalogmanagement/productoffering

Retrieves all product offerings.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/productoffering

Supported request parameters

Table 13. Path parameters

Name	Description
None

Table 14. Query parameters

Name	Description
fields	List of fields to return in the response. Invalid fields are ignored. Valid fields: category channel description externalId id internalId internalVersion lastUpdate name productCharacteristic productOfferingPrice productOfferingTerm productSpecification prodSpecCharValueUse validFor version Default: All fields are returned. Data type: String
limit	Maximum number of records to return. For requests that exceed this number of records, use the offset parameter to paginate record retrieval. Default: 20 Maximum: 100 Data type: Number
offset	Starting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks. Default: 0 Data type: Number
specification	Filter product offerings by product specification sys_id. Only product offerings with the specified product specification sys_id are returned in the response. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
state	Filter product offerings by state. Only product offerings in the specified state are returned in the response. Data type: String

Table 15. Request body parameters (JSON)

Name	Description
None

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 16. Request headers

Header	Description
None

Table 17. Response headers

Header	Description
Content-Range	Specifies the range of content returned in a paginated call. For example, if offset=2 and limit=3, the value of the Content-Range header is items 3-5.
Content-Type	Data format of the response body. Only supports application/json.
Link	Contains the following links to navigate through query results. first last next previous
X-Total-Count	For paginated queries, this header specifies the total number of records available on the server.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 18. Status codes

Status code	Description
200	Request successfully processed. Full resource returned in response (no pagination).
206	Partial resource returned in response (with pagination).
400	Bad request. Possible reasons: Invalid path parameter Invalid URI
404	Record not found. No records matching the query parameters are found in the table.

Response body parameters (JSON)

Name	Description
category	List of categories that the product belongs to. Data type: Array of Objects "category:" [ { "id": "String", "name": "String" } ]
category.id	Id of the category. Data type: String
category.name	Name of the category. Data type: String
channel	Channels to use for selling the product offering. Data type: Array of Objects "channel:" [ { "description": "String", "id": "String", "name": "String" } ]
channel.description	Description of the channel. Data type: String
channel.id	Sys_id of the channel from the Distribution Channel [sn_prd_pm_distribution_channel] table. Data type: String
channel.name	Name of the channel. Data type: String
description	Description of the product offering. Data type: String
externalId	External_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
id	Initial_version or external_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalId	Initial_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalVersion	Version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
lastUpdate	Date the product offering was last updated. Data type: String
name	Name of the product offering. Data type: String
productCharacteristic	List of product characteristics. Data type: Array of Objects "productCharacteristic": [ { "name": "String", "value": "String" } ]
productCharacteristic.name	Name of the characteristic. Data type: String
productCharacteristic.value	Value of the characteristic. Data type: String
productOfferingPrice	Price information for the product offering. Data type: Array of Objects "productOfferingPrice": [ { "price": Object, "priceType": "String" } ]
productOfferingPrice.price	Price information for the product offering. Data type: Object "price": { "taxIncludedAmount": Object }
productOfferingPrice.price.taxIncludedAmount	Price information for the product offering. Data type: Object "taxIncludedAmount": { "unit": "String", "value": "String" }
productOfferingPrice.price.taxIncludedAmount.unit	Currency code for the product offering price. Data type: String
productOfferingPrice.price.taxIncludedAmount.value	Price of the product offering including tax. Data type: String
productOfferingPrice.priceType	Type of product offering price, one-time or recurring payment. Valid values: nonRecurring (one-time) recurring Data type: String
productOfferingTerm	Valid contract term length for the product offering. Data type: String
productSpecification	Product specification for the product. Data type: Object "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" }
productSpecification.id	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalId	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalVersion	Version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.version	External_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
prodSpecCharValueUse	Product offering characteristics. Data type: Array of Objects "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue	Possible values of the characteristic. Data type: Array of Objects "productSpecCharacteristicValue": [ { "value": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue.value	Value of the characteristic. Data type: String
prodSpecCharValueUse.description	Description of the characteristic. Data type: String
prodSpecCharValueUse.name	Name of the characteristic. Data type: String
prodSpecCharValueUse.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
prodSpecCharValueUse.validFor.endDateTime	End date of the characteristic. Data type: String
prodSpecCharValueUse.validFor.startDateTime	Start date of the characteristic. Data type: String
prodSpecCharValueUse.valueType	Value type of the characteristic, such as choice or email.
validFor	Date range the product offering is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the product offering. Data type: String
validFor.startDateTime	Start date of the product offering. Data type: String
version	External_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String

cURL request

This example retrieves all product offerings.

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

Response body:

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

Product Catalog Open API - GET /sn_prd_pm_adv/catalogmanagement/productoffering/{offeringId}

Retrieves a product offering.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/productoffering/{offeringId}

Supported request parameters

Table 19. Path parameters

Name	Description
offeringId	Initial_version of the product offering to retrieve. Located in the Product Offering [sn_prd_pm_product_offering] table. Data type: String

Table 20. Query parameters

Name	Description
fields	List of fields to return in the response. Invalid fields are ignored. Valid fields: category channel description externalId id internalId internalVersion lastUpdate name productCharacteristic productOfferingPrice productOfferingTerm productSpecification prodSpecCharValueUse validFor version Default: All fields are returned. Data type: String
specification	Filter product offerings by product specification sys_id. Only product offerings with the specified product specification sys_id are returned in the response. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
state	Filter product offerings by state. Only product offerings in the specified state are returned in the response. Data type: String

Table 21. Request body parameters (JSON)

Name	Description
None

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 22. Request headers

Header	Description
None

Table 23. Response headers

Header	Description
Content-Type	Data format of the response body. Only supports application/json.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 24. Status codes

Status code	Description
200	Request successfully processed.
400	Bad request. Possible reasons: Invalid path parameter Invalid URI
404	Record not found. Record associated with the ID is not found in the table.

Response body parameters (JSON)

Name	Description
category	List of categories that the product belongs to. Data type: Array "category:" [ { "id": "String", "name": "String" } ]
category.id	Id of the category. Data type: String
category.name	Name of the category. Data type: String
channel	Channels to use for selling the product offering. Data type: Array "channel:" [ { "description": "String", "id": "String", "name": "String" } ]
channel.description	Description of the channel. Data type: String
channel.id	Sys_id of the channel from the Distribution Channel [sn_prd_pm_distribution_channel] table. Data type: String
channel.name	Name of the channel. Data type: String
description	Description of the product offering. Data type: String
externalId	External_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
id	Initial_version or external_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalId	Initial_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalVersion	Version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
lastUpdate	Date the product offering was last updated. Data type: String
name	Name of the product offering. Data type: String
productCharacteristic	List of product characteristics. Data type: Array "productCharacteristic": [ { "name": "String", "value": "String" } ]
productCharacteristic.name	Name of the characteristic. Data type: String
productCharacteristic.value	Value of the characteristic. Data type: String
productOfferingPrice	Price information for the product offering. Data type: Array "productOfferingPrice": [ { "price": Object, "priceType": "String" } ]
productOfferingPrice.price	Price information for the product offering. Data type: Object "price": { "taxIncludedAmount": Object }
productOfferingPrice.price.taxIncludedAmount	Price information for the product offering. Data type: Object "taxIncludedAmount": { "unit": "String", "value": "String" }
productOfferingPrice.price.taxIncludedAmount.unit	Currency code for the product offering price. Data type: String
productOfferingPrice.price.taxIncludedAmount.value	Price of the product offering including tax. Data type: String
productOfferingPrice.priceType	Identifies if the product offering price is a one-time or recurring payment. Valid values: nonRecurring recurring Data type: String
productOfferingTerm	Valid contract term length for the product offering. Data type: String
productSpecification	Product specification for the product. Data type: Object "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" }
productSpecification.id	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalId	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalVersion	Version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.version	External_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
prodSpecCharValueUse	Product offering characteristic. Data type: Array "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue	Array containing the possible values of the characteristic. Data type: Array "productSpecCharacteristicValue": [ { "value": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue.value	Value of the characteristic. Data type: String
prodSpecCharValueUse.description	Description of the characteristic. Data type: String
prodSpecCharValueUse.name	Name of the characteristic. Data type: String
prodSpecCharValueUse.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
prodSpecCharValueUse.validFor.endDateTime	End date of the characteristic. Data type: String
prodSpecCharValueUse.validFor.startDateTime	Start date of the characteristic. Data type: String
prodSpecCharValueUse.valueType	The value type of the characteristic, such as choice or email.
validFor	Date range the product offering is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the product offering. Data type: String
validFor.startDateTime	Start date of the product offering. Data type: String
version	External_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String

cURL request

This example retrieves a product offering.

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

Response body:

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

Product Catalog Open API - GET /sn_prd_pm_adv/catalogmanagement/productspecification

Retrieves all product specifications.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/productspecification

Supported request parameters

Table 25. Path parameters

Name	Description
None

Table 26. Query parameters

Name	Description
fields	List of fields to return in the response. Invalid fields are ignored. Valid fields: description externalId id internalId internalVersion lastUpdate name productSpecCharacteristic productSpecificationRelationship resourceSpecification serviceSpecification validFor version Default: All fields are returned. Data type: String
limit	Maximum number of records to return. For requests that exceed this number of records, use the offset parameter to paginate record retrieval. Default: 20 Maximum: 100 Data type: Number
offset	Starting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks. Default: 0 Data type: Number
state	Filter product specifications by state. Only product specifications in the specified state are returned in the response. Data type: String

Table 27. Request body parameters (JSON)

Name	Description
None

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 28. Request headers

Header	Description
None

Table 29. Response headers

Header	Description
Content-Range	Specifies the range of content returned in a paginated call. For example, if offset=2 and limit=3, the value of the Content-Range header is items 3-5.
Content-Type	Data format of the response body. Only supports application/json.
Link	Contains the following links to navigate through query results. first last next previous
X-Total-Count	For paginated queries, this header specifies the total number of records available on the server.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 30. Status codes

Status code	Description
200	Request successfully processed. Full resource returned in response (no pagination).
206	Partial resource returned in response (with pagination).
400	Bad request. Possible reasons: Invalid path parameter Invalid URI
404	Record not found. No records matching the query parameters are found in the table.

Response body parameters (JSON)

Name	Description
description	Description of the specification. Data type: String
externalId	External_id of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
id	Initial_version or external_id of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalId	Initial_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalVersion	Version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
lastUpdate	Date the specification was last updated. Data type: String
name	Name of the specification. Data type: String
productSpecCharacteristic	Specification characteristic. Data type: Array of Objects "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ]
productSpecCharacteristic.description	Description of the characteristic. Data type: String
productSpecCharacteristic.name	Name of the characteristic. Data type: String
productSpecCharacteristic.productSpecCharacteristicValue	List of possible values of the characteristic. Data type: Array of Objects "productSpecCharacteristicValue": [ { "value": "String" } ]
productSpecCharacteristic.productSpecCharacteristicValue.value	Value of the characteristic. Data type: String
productSpecCharacteristic.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecCharacteristic.validFor.endDateTime	End date of the characteristic. Data type: String
productSpecCharacteristic.validFor.startDateTime	Start date of the characteristic. Data type: String
productSpecCharacteristic.valueType	Value type of the characteristic, such as choice or email. Data type: String
productSpecificationRelationship	This specification's relationships to other product specifications. Data type: Array of Objects "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ]
productSpecificationRelationship.id	ID of the related specification. Data type: String
productSpecificationRelationship.type	Type of relationship. Data type: String
productSpecificationRelationship.validFor	Date range the relationship is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecificationRelationship.validFor.endDateTime	End date of the relationship. Data type: String
productSpecificationRelationship.validFor.startDateTime	Start date of the relationship. Data type: String
resourceSpecification	List of resource specifications related to this product specification. Data type: Array of Objects "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
resourceSpecification.id	Initial_version or external_id of the resource specification. Located in the sys_id or external_id field of the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalId	Initial_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalVersion	Version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.name	Name of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.version	External_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
serviceSpecification	List of service specifications related to this product specification. Data type: Array of Objects "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
serviceSpecification.id	Initial_version or external_id of the service specification. Located in the sys_id or external_id field of the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalId	Initial_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalVersion	Version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.name	Name of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.version	External_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
validFor	Date range the specification is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the specification. Data type: String
validFor.startDateTime	Start date of the specification. Data type: String
version	External_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String

cURL request

This example retrieves all product specifications.

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

Response body:

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

Product Catalog Open API - GET /sn_prd_pm_adv/catalogmanagement/productspecification/{specificationId}

Retrieves a specified product specification.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/productspecification/{specificationId}

Supported request parameters

Table 31. Path parameters

Name	Description
specificationId	Initial_version of the product specification to retrieve. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String

Table 32. Query parameters

Name	Description
fields	List of fields to return in the response. Invalid fields are ignored. Valid fields: description externalId id internalId internalVersion lastUpdate name productSpecCharacteristic productSpecificationRelationship resourceSpecification serviceSpecification validFor version Default: All fields are returned. Data type: String
state	Filter product specifications by state. Only product specifications in the specified state are returned in the response. Data type: String

Table 33. Request body parameters (JSON)

Name	Description
None

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 34. Request headers

Header	Description
None

Table 35. Response headers

Header	Description
Content-Type	Data format of the response body. Only supports application/json.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 36. Status codes

Status code	Description
200	Request successfully processed.
400	Bad request. Possible reasons: Invalid path parameter Invalid URI
404	Record not found. Record associated with the ID is not found in the table.

Response body parameters (JSON)

Name	Description
description	Description of the specification. Data type: String
externalId	External_id of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
id	Initial_version or external_id of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalId	Initial_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalVersion	Version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
lastUpdate	Date the specification was last updated. Data type: String
name	Name of the specification. Data type: String
productSpecCharacteristic	Specification characteristics. Data type: Array of Objects "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ]
productSpecCharacteristic.description	Description of the characteristic. Data type: String
productSpecCharacteristic.name	Name of the characteristic. Data type: String
productSpecCharacteristic.productSpecCharacteristicValue	Possible values of the characteristic. Data type: Array of Objects "productSpecCharacteristicValue": [ { "value": "String" } ]
productSpecCharacteristic.productSpecCharacteristicValue.value	Value of the characteristic. Data type: String
productSpecCharacteristic.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecCharacteristic.validFor.endDateTime	End date of the characteristic. Data type: String
productSpecCharacteristic.validFor.startDateTime	Start date of the characteristic. Data type: String
productSpecCharacteristic.valueType	Value type of the characteristic, such as choice or email. Data type: String
productSpecificationRelationship	This specification's relationships to other product specifications. Data type: Array of Objects "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ]
productSpecificationRelationship.id	ID of the related specification. Data type: String
productSpecificationRelationship.type	Type of relationship. Data type: String
productSpecificationRelationship.validFor	Date range that the relationship is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecificationRelationship.validFor.endDateTime	End date of the relationship. Data type: String
productSpecificationRelationship.validFor.startDateTime	Start date of the relationship. Data type: String
resourceSpecification	List of resource specifications related to this product specification. Data type: Array of Objects "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
resourceSpecification.id	Initial_version or external_id of the resource specification. Located in the sys_id or external_id field of the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalId	Initial_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalVersion	Version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.name	Name of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.version	External_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
serviceSpecification	List of service specifications related to this product specification. Data type: Array of Objects "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
serviceSpecification.id	Initial_version or external_id of the service specification. Located in the sys_id or external_id field of the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalId	Initial_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalVersion	Version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.name	Name of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.version	External_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
validFor	Date range that the specification is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the specification. Data type: String
validFor.startDateTime	Start date of the specification. Data type: String
version	External_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String

cURL request

This example retrieves a product specification.

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

Response body:

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

Product Catalog Open API - POST /sn_prd_pm_adv/catalogmanagement/catalog

Creates a product offering catalog.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/catalog

Supported request parameters

Table 37. Path parameters

Name	Description
None

Table 38. Query parameters

Name	Description
None

Table 39. Request body parameters (JSON)

Name	Description
description	Description of the product offering catalog. Data type: String Default: Blank string
externalId	Unique identifier for the product offering catalog from the external system. Data type: String Default: Blank string
name	Required. Name of the product offering catalog. Data type: String

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 40. Request headers

Header	Description
Accept	Data format of the response body. Only supports application/json.
Content-Type	Data format of the request body. Only supports application/json.

Table 41. Response headers

Header	Description
Content-Type	Data format of the response body. Only supports application/json.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 42. Status codes

Status code	Description
201	Request successfully processed.
400	Bad Request. Could be any of the following reasons: Empty payload. Invalid payload. Mandatory field missing: <field name>

Response body parameters (JSON)

Name	Description
description	Description of the product offering catalog. Data type: String
id	Sys_id of the product offering catalog from the Product Offering Catalog [sn_prd_pm_product_offering_catalog] table. Data type: String
name	Name of the product offering catalog. Data type: String

cURL request

This example creates a product offering catalog.

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

Response body.

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

Product Catalog Open API - POST /sn_prd_pm_adv/catalogmanagement/productoffering

Creates a product offering.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/productoffering

Supported request parameters

Table 43. Path parameters

Name	Description
None

Table 44. Query parameters

Name	Description
None

Table 45. Request body parameters (JSON)

Name	Description
category	List of categories that the product belongs to. Data type: Array of Objects "category:" [ { "id": "String", "name": "String" } ]
category.id	Required if using the category parameter. ID of the category. Data type: String
category.name	Name of the category. Data type: String Default: Blank string
channel	Required. Channels to use for selling the product offering. Data type: Array "channel:" [ { "description": "String", "id": "String", "name": "String" } ]
channel.description	Description of the channel. Data type: String Default: Blank string
channel.id	Required. Sys_id of the channel from the Distribution Channel [sn_prd_pm_distribution_channel] table. Data type: String
channel.name	Name of the channel. Data type: String Default: Blank string
description	Required. Description of the product offering. Data type: String
externalId	Unique identifier for the product offering from the external system. Data type: String Default: Blank string
id	Required. Initial_version or external_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalId	Initial_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalVersion	Version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
lastUpdate	Date the product offering was last updated. Data type: String Default: Blank string
name	Required. Name of the product offering. Data type: String
productCharacteristic	List of product characteristics. Data type: Array of Objects "productCharacteristic": [ { "name": "String", "value": "String" } ]
productCharacteristic.name	Name of the characteristic. Data type: String Default: Blank string
productCharacteristic.value	Value of the characteristic. Data type: String Default: Blank string
productOfferingPrice	Price information for the product offering. Data type: Array of Objects "productOfferingPrice": [ { "price": Object, "priceType": "String" } ]
productOfferingPrice.price	Price information for the product offering. Data type: Object "price": { "taxIncludedAmount": Object }
productOfferingPrice.price.taxIncludedAmount	Price information for the product offering. Data type: Object "taxIncludedAmount": { "unit": "String", "value": "String" }
productOfferingPrice.price.taxIncludedAmount.unit	Currency code for the product offering price. Data type: String Default: Blank string
productOfferingPrice.price.taxIncludedAmount.value	Price of the product offering including tax. Data type: String Default: Blank string
productOfferingPrice.priceType	Required if using the productOfferingPrice parameter. Product offering price type, one-time or recurring payment. Valid values: nonRecurring (one-time) recurring Data type: String
productOfferingTerm	Valid contract term length for the product offering. Data type: String Default: Blank string
productSpecification	Required. Product specification for the product. Data type: Object "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" }
productSpecification.id	Required. Initial_version or external_id of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalId	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalVersion	Version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.version	External_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
prodSpecCharValueUse	Product offering characteristics. Data type: Array of Objects "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue	Required. List of the possible values of the characteristic. Data type: Array of Objects "productSpecCharacteristicValue": [ { "value": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue.value	Required. Value of the characteristic. Data type: String
prodSpecCharValueUse.description	Description of the characteristic. Data type: String Default: Blank string
prodSpecCharValueUse.name	Required. Name of the characteristic. Data type: String
prodSpecCharValueUse.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
prodSpecCharValueUse.validFor.endDateTime	End date of the characteristic. Data type: String Default: Blank string
prodSpecCharValueUse.validFor.startDateTime	Start date of the characteristic. Data type: String Default: Blank string
prodSpecCharValueUse.valueType	Value type of the characteristic, such as choice or email.
validFor	Required. Date range the product offering is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the product offering. Data type: String Default: Blank string
validFor.startDateTime	Start date of the product offering. Data type: String Default: Blank string
version	External_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 46. Request headers

Header	Description
Accept	Data format of the response body. Only supports application/json.
Content-Type	Data format of the request body. Only supports application/json.

Table 47. Response headers

Header	Description
Content-Type	Data format of the response body. Only supports application/json.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 48. Status codes

Status code	Description
201	Request successfully processed.
400	Bad request. Possible reasons: Empty payload. Invalid payload. Mandatory field missing: <field name>

Response body parameters (JSON)

Name	Description
category	List of categories that the product belongs to. Data type: Array "category:" [ { "id": "String", "name": "String" } ]
category.id	ID of the category. Data type: String
category.name	Name of the category. Data type: String
channel	Channels to use for selling the product offering. Data type: Array of Objects "channel:" [ { "description": "String", "id": "String", "name": "String" } ]
channel.description	Description of the channel. Data type: String
channel.id	Sys_id of the channel from the Distribution Channel [sn_prd_pm_distribution_channel] table. Data type: String
channel.name	Name of the channel. Data type: String
description	Description of the product offering. Data type: String
externalId	External_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
id	Initial_version or external_id of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalId	Initial_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
internalVersion	Version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String
lastUpdate	Date the product offering was last updated. Data type: String
name	Name of the product offering. Data type: String
productCharacteristic	List of product characteristics. Data type: Array of Objects "productCharacteristic": [ { "name": "String", "value": "String" } ]
productCharacteristic.name	Name of the characteristic. Data type: String
productCharacteristic.value	Value of the characteristic. Data type: String
productOfferingPrice	Price information for the product offering. Data type: Array of Objects "productOfferingPrice": [ { "price": Object, "priceType": "String" } ]
productOfferingPrice.price	Price information for the product offering. Data type: Object "price": { "taxIncludedAmount": Object }
productOfferingPrice.price.taxIncludedAmount	Price information for the product offering. Data type: Object "taxIncludedAmount": { "unit": "String", "value": "String" }
productOfferingPrice.price.taxIncludedAmount.unit	Currency code for the product offering price. Data type: String
productOfferingPrice.price.taxIncludedAmount.value	Price of the product offering including tax. Data type: String
productOfferingPrice.priceType	Product offering price type, one-time or recurring payment. Possible values: nonRecurring (one-time) recurring Data type: String
productOfferingTerm	Valid contract term length for the product offering. Data type: String
productSpecification	Product specification for the product. Data type: Object "productSpecification": { "id": "String", "internalId": "String", "internalVersion": "String", "version": "String" }
productSpecification.id	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalId	Initial_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.internalVersion	Version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
productSpecification.version	External_version of the product specification. Located in the Product Specification [sn_prd_pm_product_specification] table. Data type: String
prodSpecCharValueUse	Product offering characteristics. Data type: Array of Objects "prodSpecCharValueUse": [ { "productSpecCharacteristicValue": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue	List of the possible values of the characteristic. Data type: Array of Objects "productSpecCharacteristicValue": [ { "value": "String" } ]
prodSpecCharValueUse.productSpecCharacteristicValue.value	Value of the characteristic. Data type: String
prodSpecCharValueUse.description	Description of the characteristic. Data type: String
prodSpecCharValueUse.name	Name of the characteristic. Data type: String
prodSpecCharValueUse.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
prodSpecCharValueUse.validFor.endDateTime	End date of the characteristic. Data type: String
prodSpecCharValueUse.validFor.startDateTime	Start date of the characteristic. Data type: String
prodSpecCharValueUse.valueType	Value type of the characteristic, such as choice or email.
validFor	Date range the product offering is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the product offering. Data type: String
validFor.startDateTime	Start date of the product offering. Data type: String
version	External_version of the product offering from the Product Offering [sn_prd_pm_product_offering] table. Data type: String

cURL request

This example creates a product offering.

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

Response body:

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

Product Catalog Open API - POST /sn_prd_pm_adv/catalogmanagement/productspecification

Creates a product specification.

URL format

Default URL: /api/sn_prd_pm_adv/catalogmanagement/productspecification

Supported request parameters

Table 49. Path parameters

Name	Description
None

Table 50. Query parameters

Name	Description
None

Table 51. Request body parameters (JSON)

Name	Description
description	Required. Description of the specification. Data type: String
externalId	Unique identifier for the product specification from the external system. Data type: String Default: Blank string
id	Required. Initial_version or external_id of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalId	Initial_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalVersion	Version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
lastUpdate	Date the specification was last updated. Data type: String Default: Blank string
name	Required. Name of the specification. Data type: String
productSpecCharacteristic	Specification characteristic. Data type: Array "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ]
productSpecCharacteristic.description	Description of the characteristic. Data type: String Default: Blank string
productSpecCharacteristic.name	Required. Name of the characteristic. Data type: String
productSpecCharacteristic.productSpecCharacteristicValue	Required. Array containing the possible values of the characteristic. Data type: Array "productSpecCharacteristicValue": [ { "value": "String" } ]
productSpecCharacteristic.productSpecCharacteristicValue.value	Required. Value of the characteristic. Data type: String
productSpecCharacteristic.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecCharacteristic.validFor.endDateTime	End date of the characteristic. Data type: String Default: Blank string
productSpecCharacteristic.validFor.startDateTime	Start date of the characteristic. Data type: String Default: Blank string
productSpecCharacteristic.valueType	The value type of the characteristic, such as choice or email. Data type: String Default: Blank string
productSpecificationRelationship	This specification's relationships to other product specifications. Data type: Array "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ]
productSpecificationRelationship.id	Id of the related specification. Data type: String Default: Blank string
productSpecificationRelationship.type	Required if using the productSpecificationRelationship parameter. Type of relationship. Valid values: composed_of bundles Data type: String
productSpecificationRelationship.validFor	Date range the relationship is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecificationRelationship.validFor.endDateTime	End date of the relationship. Data type: String Default: Blank string
productSpecificationRelationship.validFor.startDateTime	Start date of the relationship. Data type: String Default: Blank string
resourceSpecification	Required. Array of resource specifications related to this product specification. Data type: Array "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
resourceSpecification.id	Required. Initial_version or external_id of the resource specification. Located in the sys_id or external_id field of the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalId	Initial_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalVersion	Version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.name	Name of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.version	External_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
serviceSpecification	List of service specifications related to this product specification. Data type: Array of Objects "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
serviceSpecification.id	Initial_version or external_id of the service specification. Located in the sys_id or external_id field of the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalId	Initial_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalVersion	Version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.name	Name of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.version	External_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
validFor	Required. Date range the specification is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the specification. Data type: String Default: Blank string
validFor.startDateTime	Start date of the specification. Data type: String Default: Blank string
version	External_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 52. Request headers

Header	Description
Accept	Data format of the response body. Only supports application/json.
Content-Type	Data format of the request body. Only supports application/json.

Table 53. Response headers

Header	Description
Content-Type	Data format of the response body. Only supports application/json.

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.

Table 54. Status codes

Status code	Description
201	Request successfully processed.
400	Bad request. Possible reasons: Empty payload. Invalid payload. Mandatory field missing: <field name>

Response body parameters (JSON)

Name	Description
description	Description of the specification. Data type: String
id	Initial_version or external_id of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalId	Initial_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
internalVersion	Version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String
lastUpdate	Date the specification was last updated. Data type: String
name	Name of the specification. Data type: String
productSpecCharacteristic	Specification characteristic. Data type: Array "productSpecCharacteristic": [ { "description": "String", "name": "String", "productSpecCharacteristicValue": Array, "validFor": Object, "valueType": "String" } ]
productSpecCharacteristic.description	Description of the characteristic. Data type: String
productSpecCharacteristic.name	Name of the characteristic. Data type: String
productSpecCharacteristic.productSpecCharacteristicValue	Array containing the possible values of the characteristic. Data type: Array "productSpecCharacteristicValue": [ { "value": "String" } ]
productSpecCharacteristic.productSpecCharacteristicValue.value	Value of the characteristic. Data type: String
productSpecCharacteristic.validFor	Date range the characteristic is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecCharacteristic.validFor.endDateTime	End date of the characteristic. Data type: String
productSpecCharacteristic.validFor.startDateTime	Start date of the characteristic. Data type: String
productSpecCharacteristic.valueType	The value type of the characteristic, such as choice or email. Data type: String
productSpecificationRelationship	This specification's relationships to other product specifications. Data type: Array "productSpecificationRelationship": [ { "id": "String", "type": "String", "validFor": Object } ]
productSpecificationRelationship.id	Id of the related specification. Data type: String
productSpecificationRelationship.type	Type of relationship. Data type: String
productSpecificationRelationship.validFor	Date range the relationship is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
productSpecificationRelationship.validFor.endDateTime	End date of the relationship. Data type: String
productSpecificationRelationship.validFor.startDateTime	Start date of the relationship. Data type: String
resourceSpecification	List of resource specifications related to this product specification. Data type: Array of Objects "resourceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
resourceSpecification.id	Initial_version or external_id of the resource specification. Located in the sys_id or external_id field of the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalId	Initial_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.internalVersion	Version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.name	Name of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
resourceSpecification.version	External_version of the resource specification. Located in the Resource Specification [sn_prd_pm_resource_specification] table. Data type: String
serviceSpecification	List of service specifications related to this product specification. Data type: Array of Objects "serviceSpecification": [ { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } ]
serviceSpecification.id	Initial_version or external_id of the service specification. Located in the sys_id or external_id field of the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalId	Initial_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.internalVersion	Version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.name	Name of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
serviceSpecification.version	External_version of the service specification. Located in the Service Specification [sn_prd_pm_service_specification] table. Data type: String
validFor	Date range the specification is valid for. Data type: Object "validFor": { "endDateTime": "String", "startDateTime": "String" }
validFor.endDateTime	End date of the specification. Data type: String
validFor.startDateTime	Start date of the specification. Data type: String
version	External_version of the product specification from the Product Specification [sn_prd_pm_product_specification] table. Data type: String

cURL request

This example creates a product specification.

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

Response body.

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