Create a product group

post

/crmRestApi/resources/11.13.18.05/setupSalesCatalogs

Request

Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Active
    Maximum Length: 1
    Default Value: Y
    Indicates whether the product group is active or not. The default value is true.
  • Title: Allow Duplicate Children
    Maximum Length: 1
    Default Value: Y
    Indicates whether a duplicate product or product group can be allowed in this product group hierarchy. The default value is true.
  • Title: Allow Selection
    Maximum Length: 1
    Indicates whether the product group can be selected. If enabled, the value is Y, else the value is N. The defalt is Y.
  • Maximum Length: 255
    Default Value: QSC_PROD_GROUPS_B
    The name of the attachment entity type.
  • Title: Effective to Date
    The date and time when the product group becomes inactive.
  • Title: Name
    Maximum Length: 150
    The internal name of the product group.
  • Title: Model Attributes
    Maximum Length: 4000
    The model configurations of the product.
  • Title: Model Family
    Maximum Length: 1000
    The name of the model family associated with the Product Group.
  • Title: Model Line
    Maximum Length: 1000
    The name of the model line associated with the Product Group.
  • Title: Model
    Maximum Length: 1000
    The model name of the product group.
  • The number used to implement locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to determine whether another session has updated the row.
  • Title: Description
    Maximum Length: 1000
    The translated product group description used for runtime display.
  • The unique identifier of the product group.
  • Title: Display
    Maximum Length: 250
    The translated name of the product group used for runtime display.
  • The unique identifier of the product group details.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, update, and delete the attachments associated with a product group. The attachments are typically used to associate images to the product groups so that you can identify the product groups visually in browse sales catalog.
  • Filter Attributes
    Title: Filter Attributes
    The filter attributes resource is used to view, create, update, and delete the filter attributes associated with a product group. Filter attributes allows a customer to sort through the products based on their preference, such as Color, Texture, and other such material properties.
  • Products
    Title: Products
    The products resource is used to view, create, update, and delete the product association to a product group. Typically, products are associated to the leaf most nodes of the product group hierarchy. These products are sourced from items defined in Product Information Management.
  • Title: Reference Number
    Maximum Length: 50
    The unique identifier used for integration with external systems.
  • Related Groups
    Title: Related Groups
    The related groups resource is used to view, create, update, and delete the association between sub product groups and parent product groups. While the Subgroups resource can be used to create or update the product group to sub group association, the deletion of such association can only be done using the Related Groups resource.
  • Subgroups
    Title: Subgroups
    The subgroups resources is used to view, create, and update the association of a sub product group to a parent product group so that a hierarchy of product groups can be built.
  • Title: Revenue Category
    Maximum Length: 30
    The code indicating the revenue category associated with the product group. For example, Software, Maintenance, Service, Training, Hardware, or Back Maintenance.
  • Title: Revenue Role
    Maximum Length: 30
    The code indicating the revenue role associated with the product group. For example, Sales revenue line set or Sales revenue line set member.
  • Title: Effective from Date
    The date and time when the product group becomes active.
  • Title: Root Catalog
    Maximum Length: 1
    Default Value: N
    Indicates whether the product group can be assigned and displayed as a root product group in the context of an application usage type. The default value is false.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, update, and delete the attachments associated with a product group. The attachments are typically used to associate images to the product groups so that you can identify the product groups visually in browse sales catalog.
Show Source
Nested Schema : Filter Attributes
Type: array
Title: Filter Attributes
The filter attributes resource is used to view, create, update, and delete the filter attributes associated with a product group. Filter attributes allows a customer to sort through the products based on their preference, such as Color, Texture, and other such material properties.
Show Source
Nested Schema : Products
Type: array
Title: Products
The products resource is used to view, create, update, and delete the product association to a product group. Typically, products are associated to the leaf most nodes of the product group hierarchy. These products are sourced from items defined in Product Information Management.
Show Source
Nested Schema : Related Groups
Type: array
Title: Related Groups
The related groups resource is used to view, create, update, and delete the association between sub product groups and parent product groups. While the Subgroups resource can be used to create or update the product group to sub group association, the deletion of such association can only be done using the Related Groups resource.
Show Source
Nested Schema : Subgroups
Type: array
Title: Subgroups
The subgroups resources is used to view, create, and update the association of a sub product group to a parent product group so that a hierarchy of product groups can be built.
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : Filter Attribute Values
Type: array
Title: Filter Attribute Values
The filter attribute values resource is used to view, create, update, and delete the values of the filter attributes associated with a product group. For example, values such as Blue or Red for the color filter attribute.
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : EligibilityRules
Type: array
Title: EligibilityRules
The eligibility rules resource is used to view, create, update, and delete the various eligibility rules so that only a few products are available for selection at run time. For each item, you can add one or more eligibility rules specifying whether a rule is valid for a particular country or for all countries.
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : setupSalesCatalogs-item-response
Type: object
Show Source
  • Title: Active
    Maximum Length: 1
    Default Value: Y
    Indicates whether the product group is active or not. The default value is true.
  • Title: Allow Duplicate Children
    Maximum Length: 1
    Default Value: Y
    Indicates whether a duplicate product or product group can be allowed in this product group hierarchy. The default value is true.
  • Title: Allow Selection
    Maximum Length: 1
    Indicates whether the product group can be selected. If enabled, the value is Y, else the value is N. The defalt is Y.
  • Maximum Length: 255
    Default Value: QSC_PROD_GROUPS_B
    The name of the attachment entity type.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the product group record.
  • Title: Creation Date
    Read Only: true
    The date and time when the record was created.
  • Read Only: true
    Indicates whether the sales catalog can be deleted. The default value is true.
  • Title: Effective to Date
    The date and time when the product group becomes inactive.
  • Title: Name
    Maximum Length: 150
    The internal name of the product group.
  • Title: Last Updated Date
    Read Only: true
    The date when the record was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the product group record.
  • Read Only: true
    Maximum Length: 32
    The session login of the user who last updated the record.
  • Links
  • Title: Model Attributes
    Maximum Length: 4000
    The model configurations of the product.
  • Title: Model Family
    Maximum Length: 1000
    The name of the model family associated with the Product Group.
  • Title: Model Line
    Maximum Length: 1000
    The name of the model line associated with the Product Group.
  • Title: Model
    Maximum Length: 1000
    The model name of the product group.
  • The number used to implement locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to determine whether another session has updated the row.
  • Title: Description
    Maximum Length: 1000
    The translated product group description used for runtime display.
  • The unique identifier of the product group.
  • Title: Display
    Maximum Length: 250
    The translated name of the product group used for runtime display.
  • The unique identifier of the product group details.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, update, and delete the attachments associated with a product group. The attachments are typically used to associate images to the product groups so that you can identify the product groups visually in browse sales catalog.
  • Filter Attributes
    Title: Filter Attributes
    The filter attributes resource is used to view, create, update, and delete the filter attributes associated with a product group. Filter attributes allows a customer to sort through the products based on their preference, such as Color, Texture, and other such material properties.
  • Read Only: true
    The name or ID of the user who locked the product group.
  • Read Only: true
    The date when the product group was locked.
  • Read Only: true
    Indicates whether the product group is locked or not. The default value is true.
  • Products
    Title: Products
    The products resource is used to view, create, update, and delete the product association to a product group. Typically, products are associated to the leaf most nodes of the product group hierarchy. These products are sourced from items defined in Product Information Management.
  • Title: Reference Number
    Maximum Length: 50
    The unique identifier used for integration with external systems.
  • Related Groups
    Title: Related Groups
    The related groups resource is used to view, create, update, and delete the association between sub product groups and parent product groups. While the Subgroups resource can be used to create or update the product group to sub group association, the deletion of such association can only be done using the Related Groups resource.
  • Subgroups
    Title: Subgroups
    The subgroups resources is used to view, create, and update the association of a sub product group to a parent product group so that a hierarchy of product groups can be built.
  • Title: Revenue Category
    Maximum Length: 30
    The code indicating the revenue category associated with the product group. For example, Software, Maintenance, Service, Training, Hardware, or Back Maintenance.
  • Title: Revenue Role
    Maximum Length: 30
    The code indicating the revenue role associated with the product group. For example, Sales revenue line set or Sales revenue line set member.
  • Title: Effective from Date
    The date and time when the product group becomes active.
  • Read Only: true
    Indicates whether the sales catalog can be updated. The default value is true.
  • Title: Root Catalog
    Maximum Length: 1
    Default Value: N
    Indicates whether the product group can be assigned and displayed as a root product group in the context of an application usage type. The default value is false.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, update, and delete the attachments associated with a product group. The attachments are typically used to associate images to the product groups so that you can identify the product groups visually in browse sales catalog.
Show Source
Nested Schema : Filter Attributes
Type: array
Title: Filter Attributes
The filter attributes resource is used to view, create, update, and delete the filter attributes associated with a product group. Filter attributes allows a customer to sort through the products based on their preference, such as Color, Texture, and other such material properties.
Show Source
Nested Schema : Products
Type: array
Title: Products
The products resource is used to view, create, update, and delete the product association to a product group. Typically, products are associated to the leaf most nodes of the product group hierarchy. These products are sourced from items defined in Product Information Management.
Show Source
Nested Schema : Related Groups
Type: array
Title: Related Groups
The related groups resource is used to view, create, update, and delete the association between sub product groups and parent product groups. While the Subgroups resource can be used to create or update the product group to sub group association, the deletion of such association can only be done using the Related Groups resource.
Show Source
Nested Schema : Subgroups
Type: array
Title: Subgroups
The subgroups resources is used to view, create, and update the association of a sub product group to a parent product group so that a hierarchy of product groups can be built.
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupAttachments-item-response
Type: object
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupAttributeSetup-item-response
Type: object
Show Source
Nested Schema : Filter Attribute Values
Type: array
Title: Filter Attribute Values
The filter attribute values resource is used to view, create, update, and delete the values of the filter attributes associated with a product group. For example, values such as Blue or Red for the color filter attribute.
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupAttributeSetup-ProductGroupAttributeValueSetup-item-response
Type: object
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupProductSetup-item-response
Type: object
Show Source
Nested Schema : EligibilityRules
Type: array
Title: EligibilityRules
The eligibility rules resource is used to view, create, update, and delete the various eligibility rules so that only a few products are available for selection at run time. For each item, you can add one or more eligibility rules specifying whether a rule is valid for a particular country or for all countries.
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupProductSetup-EligibilityRules-item-response
Type: object
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupRelationSetup-item-response
Type: object
Show Source
Nested Schema : setupSalesCatalogs-ProductGroupSubgroupAdministration-item-response
Type: object
Show Source
Back to Top

Examples

The following example shows how to create a product group by submitting a POST request on the REST resource using cURL.

cURL Command

curl -u <username:password> \ -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/setupSalesCatalogs

Example of Request Body

The following shows an example of the request body in JSON format.

{   
 "ProdGroupName": "WAVE_Demo/PG2/REST",
 "ProdGroupDescription" : "WAVE_Demo/PG2/REST",
 "InternalName":"WAVE_Demo/PG2/REST",
 "StartDate" : "2016-06-09T00:00:00-07:00",
 "EndDate" : "2016-12-31T00:00:00-07:00",
 "ActiveFlag" : "Y",
 "AllowDuplicateContentFlag":"N",
 "UsageRootFlag":"Y"
}

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
"ProdGrpDetailsId": 300100109717769,
"UsageRootFlag": "Y",
"ProductGroupReferenceNumber": "300100109717769",
"ActiveFlag": "Y",
"StartDate": "2016-06-09T07:00:00+00:00",
"EndDate": "2016-12-31T07:00:00+00:00",
"RevenueRoleCode": null,
"RevenueCategoryCode": null,
"AllowDuplicateContentFlag": "N",
"ProdGroupId": 300100109717770,
"ObjectVersionNumber": 1,
"InternalName": "WAVE_Demo/PG2/REST",
"UpdateFlag": true,
"DeleteFlag": true,
"ProductGroupLockedBy": "MHoope",
"ProductGroupLockedFlag": true,
"ProductGroupLockedDate": "2016-12-20 09:11:33.171",
"ProdGroupName": "WAVE_Demo/PG2/REST",
"ProdGroupDescription": "WAVE_Demo/PG2/REST",
"AttachmentEntityName": "QSC_PROD_GROUPS_B",
"LastUpdateDate": "2016-12-20T09:11:33+00:00",
"LastUpdateLogin": "4412DB28251C603BE053368FF00A28CD",
"LastUpdatedBy": "MHoope",
"CreatedBy": "MHoope",
"CreationDate": "2016-12-20T09:11:33+00:00",
...
}
Back to Top