POST products/update
Available from CRM.COM R14.0.0
This method updates a product. A single product is updated by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
product_identifier (mandatory) | Identifier | The identifier of the product. The allowed product identifier fields are the following:
| ||||||||||||
code (optional) | String | The code of the product | ||||||||||||
alternative_code (optional) | String | The alternative code of the product | ||||||||||||
description (optional) | String | The description of the product | ||||||||||||
short_description (optional) | String | A short description of the product Available from CRM.COM R16.3.0 and onwards | ||||||||||||
long_description (optional) | String | A long description of the product | ||||||||||||
priority_level (optional) | Integer | The priority level of the product | ||||||||||||
non_stockable | Boolean | The flag shows if the retrieved product is non-stockable. Applicable only for products of classification physical goods Available from CRM.COM R18.0.0 | ||||||||||||
type_identifier (optional) | Identifier | The product type identifier of the product. The allowed product type identifier fields are the following:
| ||||||||||||
brand_identifier (optional) | Identifier | The product brand identifier of the product. The allowed product type identifier fields are the following:
| ||||||||||||
family_identifier (optional) | Identifier | The product family identifier of the product. The allowed product type identifier fields are the following:
| ||||||||||||
udf_string_1 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_2 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_3 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_4 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_5 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_6 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_7 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_8 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_9 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_10 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_11 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_12 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_13 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_14 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_15 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_16 (optional) | String | User Defined Field of type String | ||||||||||||
udf_float_1 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_float_2 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_float_3 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_float_4 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_date_1 (optional) | Date | User Defined Field of type Date | ||||||||||||
udf_date_2 (optional) | Date | User Defined Field of type Date | ||||||||||||
udf_date_3 (optional) | Date | User Defined Field of type Date | ||||||||||||
udf_date_4 (optional) | Date | User Defined Field of type Date | ||||||||||||
(optional) | Global Rate object | The rate (price) that the product will have in the Global Price Plan Available from CRM.COM R15.0.0 | ||||||||||||
(optional) | Set of Product Validity Objects | The time periods during which the product will be available to be used. If not specified then the product will be always be available Applicable only for products of classification SERVICE with type EXPENSE or TERMED If no records are specified in the set then nothing will be updated. To remove a record use "action" : "remove". To add a record use "action" : "add". Different actions can be used within the same set. For example: "set": [ { "action": "remove", ........... }, { "action": "add", ........... } ] | ||||||||||||
(optional) | Set of Product Category Objects | The product category of the product If no records are specified in the set then nothing will be updated. To remove a record use "action" : "remove". To add a record use "action" : "add". Different actions can be used within the same set. For example: "set": [ { "action": "remove", ........... }, { "action": "add", ........... } ] | ||||||||||||
(optional) | Set of Tax Rate Objects | The Tax rates of the current period If no records are specified in the set then nothing will be updated. To add a record use "action" : "add". For example: "set": [ { "action": "add", ........... } ] | ||||||||||||
(optional) | Set of Vat Rate Objects | The Vat rates of the current period If no records are specified in the set then nothing will be updated. To add a record use "action" : "add". For example: "set": [ { "action": "add", ........... } ] Deprecated from CRM.COM R17.0.0 | ||||||||||||
(mandatory on conditions) | Set of Components Objects | The bundle components of the product The "bundle_components" parameter is applicable and possibly mandatory only if the product is classified as a fixed or flexible bundle If no records are specified in the set then nothing will be updated. To remove a record use "action" : "remove". To add a record use "action" : "add". Different actions can be used within the same set. For example: "set": [ { "action": "remove", ........... }, { "action": "add", ........... } ] | ||||||||||||
(optional) | Bundle Restrictions Object | The bundle restrictions of the product The "bundle_restrictions" parameter is applicable only if the product is classified as flexible bundle | ||||||||||||
(optional) | Set of Upsell Products Object | The upsell products associated to the specific product Available from CRM.COM R15.0.0 | ||||||||||||
(optional) | Set of cross-sell Products Object | The cross-sell products associated to the specific product Available from CRM.COM R15.0.0 | ||||||||||||
(optional) | Set of Metadata Object | The set of metadata attributes and values associated to the specific product Available from CRM.COM R15.0.0 | ||||||||||||
allowed_metadata_attributes_set (optional) | Set of Allowed Metadata Object | The set of allowed metadata attributes whose values will be set upon the creation of the installed items Applicable only for products of the following product classification
Available from CRM.COM R15.0.0 | ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Referred Parameter Objects Data
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved product |
code | String | The code of the retrieved product |
alternative_code | String | The alternative code of the retrieved product |
description | String | The description of the retrieved product |
short_description | String | A short description of the retrieved product Available from CRM.COM R16.3.0 and onwards |
long_description | String | A long description of the retrieved product Available from CRM.COM R12.3.0 and CRM.COM R13.1.0 onwards |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
non_stockable | Boolean | The flag shoes if the retrieved product is non-stockable Available from CRM.COM R18.0.0 |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_string_9 | String | User Defined Field of type String |
udf_string_10 | String | User Defined Field of type String |
udf_string_11 | String | User Defined Field of type String |
udf_string_12 | String | User Defined Field of type String |
udf_string_13 | String | User Defined Field of type String |
udf_string_14 | String | User Defined Field of type String |
udf_string_15 | String | User Defined Field of type String |
udf_string_16 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
Product Type Object | The type of the retrieved product | |
Product Brand Object | The brand of the retrieved product | |
Product Family Object | The product family of the retrieved product | |
Log Information Object | The Log Information related with the retrieved product | |
Bundle Restrictions Object | The bundle restrictions of the new product This parameter is applicable only if the product is classified as a flexible bundle Available from CRM.COM R14.0.0 | |
Set of Price Plans Object | The Price Plans containing the retrieved product | |
Set of Product Validity Object | The Product validity of the retrieved product (If is empty then the product is always valid) | |
Set of Product to Product Category Object | The Product Categories of the retrieved product | |
Set of Product Components Object | The components of the retrieved product. This is applicable only if the product type composition method is set to fixed or flexible bundle | |
usage_service_catalogs_set | Set of Usage Service Catalogs Object | The Usage Service Catalogs containing the retrieved product. Available only when the retrieved product is a usage service. Available from CRM.COM R9.0.0 |
tax_rate_set | Set of Tax Rate Objects | The TAX Rate of the retrieved product Available from CRM.COM R14.0.0 |
Set of Vat Rate Objects | The VAT Rate of the retrieved product Deprecate from CRM.COM R17.0.0 | |
metadata_set | Set of Metadata Attributes | The set of metadata attributes available for the retrieved product Available from CRM.COM R15.0.0 |
allowed_metadata_set | Set of Metadata Attributes | The allowed set of metadata attributes whose values will be set on the installed items. Available only for traceable physical goods Available from CRM.COM R15.0.0 |
Referred Objects Response Data